OneTrace.pro Central de ajuda

Assistentes de IA dos compradores

Cada vez mais compradores escolhem produtos no ChatGPT, no Claude, no Perplexity e em outros assistentes de IA. O OneTrace.pro entrega ao assistente o catálogo da sua loja pelo protocolo MCP (Model Context Protocol): o assistente busca produtos, mostra fichas com preço e disponibilidade, sugere produtos semelhantes e complementares e responde a perguntas sobre os produtos em nome da loja. O comprador pode comprar no site por um link, por um carrinho montado pelo assistente ou direto na conversa — quem escolhe é você.

Este é o MCP para compradores. Para a sua equipe existe outro, Assistentes de IA (MCP): por ele, o assistente trabalha com o projeto em seu nome. Já o bot do chat online recebe os dados dos pedidos pelo MCP da loja para o bot.

A seção fica no menu Site → Assistentes de IA e está disponível a partir do plano “Crescimento”; veja Planos. Podem alterar as configurações “Proprietário”, “Administrador” e “Gerente”; os demais participantes as veem, mas não podem salvar.

Página “Assistentes de IA dos compradores”: ativação, endereço, texto sobre a loja e modo de compra

Ativação e endereço

  1. Carregue o catálogo de produtos: o assistente busca e mostra apenas produtos do catálogo.
  2. Abra Site → Assistentes de IA, ative Responder a assistentes de IA e clique em Salvar.
  3. Vai aparecer o Endereço MCP da loja — https://{domínio da marca}/shop/{token}/mcp. Clique em Copiar e adicione o endereço ao assistente; veja Conexão no ChatGPT e no Claude.

O endereço não exige login: o catálogo da loja é público, como a vitrine do site. O assistente não recebe dados pessoais dos compradores. O botão Novo endereço emite outro endereço, e o anterior para de funcionar na hora para todos os assistentes que o receberam. Com a chave desligada, o endereço fica fechado até você ativá-lo de novo.

Sobre a loja para o assistente

No campo Sobre a loja, para o assistente, escreva o que o assistente precisa saber ao responder: condições de entrega e devolução, tabela de tamanhos, garantia, particularidades do sortimento. O assistente leva esse texto em conta em todas as respostas sobre a loja. Escreva apenas o que é verdade e está no site — até 2000 caracteres.

O que o assistente sabe fazer

Ferramenta O que faz
Busca de produtos Busca inteligente no catálogo: corrige erros de digitação, entende preço, marca e o sentido da busca. Mostra apenas produtos em estoque. Cada busca conta no limite de buscas do plano
Ficha do produto Nome, preço, descrição e características no idioma do comprador, disponibilidade e estoque, se a loja envia o estoque
Recomendações Produtos semelhantes, “comprados juntos”, “vistos juntos”, populares e em alta — sem dados do comprador
Pergunta sobre o produto Resposta da IA com base na descrição e nas características do produto e na base de conhecimento da loja — do mesmo jeito e com a mesma cobrança no saldo que a pergunta sobre o produto no site

O OneTrace.pro passa ao assistente uma regra: oferecer apenas produtos, preços e disponibilidade das respostas das ferramentas, sem inventá-los.

Compra

A configuração Compra define como o comprador passa da escolha ao pedido.

Modo O que acontece
Ir para a página do produto O assistente envia o link do produto, e o comprador finaliza o pedido no site
Carrinho por link O assistente monta um carrinho — até 20 produtos com quantidades — e envia um link: ele abre no site o carrinho com os produtos escolhidos, e a finalização e o pagamento acontecem no site
Pedido pelo MCP da loja O assistente cria o pedido direto na conversa e envia um link para pagamento no site

Todos os links passam pelo domínio da marca e recebem os parâmetros utm_source com o nome do assistente e utm_medium=ai_assistant: cliques, visitas e compras aparecem no relatório “Assistentes de IA” e nas fontes de tráfego.

Carrinho por link

O Link do carrinho depende da plataforma do site:

  • Nosso plugin para WooCommerce, 1C-Bitrix, Magento — o módulo OneTrace.pro nas versões 1.16, 1.12 e 1.13, respectivamente, ou posteriores. O módulo coloca os produtos no carrinho do visitante pelo link ?onetrace_cart= e abre o carrinho. O endereço do site é obtido dos links dos produtos no catálogo.
  • Shopify — o link nativo de carrinho do Shopify. Os ids dos produtos no catálogo devem ser os ids das variantes do Shopify.
  • Modelo próprio — para um site que sabe colocar produtos no carrinho por link: um endereço https com o marcador {items}, que é substituído pelos produtos no formato id:quantidade separados por vírgulas, por exemplo https://shop.example.com/cart/add?items={items}.

Pedido pelo MCP da loja

Neste modo, quem cria o pedido é a própria loja, pelo seu servidor MCP — o mesmo conectado ao bot do chat online, mas na versão 2. O que é necessário:

  1. O módulo OneTrace.pro com pedidos pelo assistente: WooCommerce 1.17, 1C-Bitrix 1.13, Magento 1.14 ou posterior. Outro servidor da loja precisa cumprir a versão 2 do contrato MCP da loja.
  2. O MCP da loja conectado na seção Chats (aba Bot → Loja (MCP)); veja Conexão.
  3. As ferramentas Cálculo do pedido e Criação do pedido liberadas nas configurações do módulo — por padrão, elas vêm desativadas.

Na página “Assistentes de IA” você vê qual servidor recebe os pedidos. Se não houver um servidor adequado, o assistente monta um carrinho por link — por isso, configure-o também.

Como funciona o pedido:

  1. O comprador informa o e-mail ou o telefone, e a loja envia um código para ele. Não é preciso ter conta na loja — sem ela, o pedido é feito como visitante.
  2. O comprador informa o código ao assistente.
  3. O assistente calcula o pedido — preços, formas de entrega disponíveis para o endereço, total e formas de pagamento — e mostra ao comprador.
  4. Só depois do consentimento explícito do comprador o assistente cria o pedido. O comprador recebe o número do pedido e o link para pagamento no site da loja.

O assistente não vê a chave de acesso do comprador: o próprio OneTrace.pro a repassa à loja. Repetir o mesmo pedido não cria um segundo. Se o preço ou a disponibilidade mudarem depois do cálculo, a loja pede para calcular o pedido de novo. O pedido chega ao OneTrace.pro com a marca do assistente e entra no relatório.

Particularidades das plataformas:

  • WooCommerce — o pedido não pago aguarda pagamento na página “Pagar pedido”. O comprador com conta faz login no site para pagar.
  • 1C-Bitrix — a página de pagamento é definida nas configurações do módulo. Para que um visitante possa pagar pelo link, permita que visitantes vejam pedidos nas configurações da loja virtual.
  • Magento — o Magento não aceita pagamento online de um pedido já criado, por isso o assistente oferece apenas as formas de pagamento definidas nas configurações do módulo: transferência, pagamento na entrega e outras que não exigem o comprador no site. O link leva à página do pedido com as instruções de pagamento.

Conexão no ChatGPT e no Claude

O endereço MCP da loja é adicionado ao assistente como conector:

  • ChatGPT — nas configurações Apps & Connectors, ative o modo de desenvolvedor e crie um conector: nome, endereço MCP da loja, sem autenticação.
  • Claude — Settings → Connectors → Add custom connector: nome e endereço MCP da loja.

Assim, quem conecta a loja é você e os compradores a quem você deu o endereço. Para que todos os usuários do assistente encontrem a loja, publique-a no catálogo de apps do assistente — por exemplo, ChatGPT Apps ou o catálogo de conectores do Claude. A solicitação é enviada pela loja em nome próprio, com esse mesmo endereço.

Limites

  • No máximo 120 solicitações por minuto de um mesmo endereço e 1200 por minuto por loja. Acima disso, o assistente recebe a resposta “tente de novo em um minuto”.
  • O assistente é identificado pelo cabeçalho das suas solicitações. Clientes MCP desconhecidos aparecem no relatório como “Outros”.
  • O endereço funciona apenas no domínio da marca do projeto.