Saltar para o conteúdo principal

​
Jumpseller

Com a integração do Jumpseller, seu agente do ChatNorris atende os clientes da sua loja com os dados reais da loja. De acordo com o que você ativar, o agente:
  • busca produtos e variantes (por nome ou SKU) e responde o preço e o estoque naquele momento;
  • informa o status de pagamento e de envio de um pedido, somente depois de verificar que ele é do visitante;
  • monta a compra e entrega um link por produto que o adiciona ao carrinho da sua loja;
  • confirma o pagamento na mesma conversa quando o visitante paga;
  • usa o catálogo da sua loja como fonte de conhecimento (descrições, variantes e links para as páginas dos produtos).
Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API.

​
Requisitos

  • Uma conta do ChatNorris com plano Standard ou Premium. Você pode ver os planos em chatnorris.ai/pricing.
  • Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga Criar um agente.
  • Uma loja Jumpseller e acesso ao admin dela para copiar o login e o token da API.
  • Função Owner ou Admin na sua organização do ChatNorris.

​
Conectar a loja

Cada agente se conecta a uma loja Jumpseller.
1

Copie o login e o token da API

No admin da sua loja Jumpseller, abra Cuenta › Preferencias. No cartão API y MCP, copie o login e, com Mostrar token, o token.
2

Abra o hub de Integrações do agente

No ChatNorris, acesse Agentes → [seu agente] → Integrações e escolha Jumpseller.
3

Cole as duas chaves e conecte

Cole o login e o token e clique em Conectar. O ChatNorris testa as chaves com o Jumpseller antes de salvá-las: se não funcionarem, ele diz o motivo e não salva nada.
A conta dona do token precisa das permissões de produtos, pedidos, hooks e configuração. Se você usa um usuário dedicado, verifique se ele as tem. Sem a permissão de hooks não é possível ativar a confirmação de pagamento.
O login e o token são salvos criptografados e nunca são exibidos no dashboard. Com Testar conexão você os verifica novamente quando quiser.

​
Configurar a Ação

Conectar a loja ainda não ativa nada. Para escolher o que o agente faz:
1

Crie a Ação Jumpseller

Acesse Agentes → [seu agente] → Ações, clique em Nova ação e escolha Jumpseller.
2

Escolha as capacidades

Ative as que quiser (veja a tabela abaixo). Algumas dependem de outras.
3

Ative a Ação e salve

A partir desse momento, o agente usa sua loja em todas as conversas.
Um agente usa uma única loja. Além disso, Montar compra não pode ser ativada se o agente já vende com a Ação Pagamento, e vice-versa: um agente monta compras a partir de uma única fonte.

​
Consulta de pedidos

Em Verificação do comprador você escolhe com qual dado o visitante comprova que o pedido é dele: o email da compra (padrão), o telefone ou o CEP de cobrança. Basta que um deles coincida.
O checkout do Jumpseller não pede telefone nem CEP por padrão. Ative-os somente se a sua loja os exigir na compra (Configuración › Checkout): se o pedido não os tiver, a verificação com esse dado falha.
Para proteger os dados dos seus clientes:
  • um pedido que não existe e um dado que não coincide recebem exatamente a mesma resposta, para que ninguém consiga adivinhar números de pedido;
  • após 5 tentativas com falha na mesma conversa, a consulta de pedidos é bloqueada;
  • no widget web, o agente mostra um formulário para o número do pedido e o dado de verificação.
Para essa capacidade, recomendamos Claude Sonnet ou superior como modelo do agente (Configurações → IA). Em nossos testes, os modelos menores às vezes respondem como se o pedido já estivesse verificado.

​
Montar compra

Quando o visitante diz o que quer, o agente monta a lista com as quantidades, o preço de cada produto e um total de referência, conferindo o estoque naquele momento. Se faltar um dado (por exemplo, o tamanho), ele pergunta antes de adicioná-lo. Ao confirmar, o agente responde com um link por produto. Cada link adiciona esse produto ao carrinho da sua loja com a quantidade pedida. O visitante os abre um após o outro no mesmo navegador, assim eles se somam no mesmo carrinho, e paga no seu checkout do Jumpseller, onde o frete é calculado.
  • O Jumpseller não tem um link com vários produtos ao mesmo tempo: por isso vai um link por produto.
  • Se naquele momento a loja tiver menos unidades do que as pedidas, esse link não adiciona o produto. O agente avisa o visitante.
  • O ChatNorris não cobra nem cria pedidos: a venda acontece na sua loja, com seus meios de pagamento.
  • Em Conversas, uma nota interna mostra a lista que o agente montou.

​
Confirmação de pagamento

Ao ativá-la, o ChatNorris registra na sua loja um aviso de pagamentos (webhook order_paid). Quando um pedido é pago, o ChatNorris o associa à conversa se as três condições forem atendidas:
  1. o email do comprador é o email que o visitante deixou no chat (por exemplo, no Lead Form);
  2. o agente enviou links de compra a ele nos últimos 7 dias;
  3. o pedido tem pelo menos um dos produtos dessa lista.
Se forem atendidas, o agente escreve na conversa «Recebemos seu pagamento! Seu pedido foi confirmado» («¡Recibimos tu pago! Tu pedido quedó confirmado»), fica registrada uma nota interna com o que foi cobrado e, se a conversa estava sendo atendida pelo agente, ela passa para Resolvida.
Se o visitante não deixou o email no chat, ou pagou com outro email, a venda é registrada normalmente na sua loja, mas o agente não a confirma na conversa.
Ao desligar a capacidade, excluir a Ação ou desconectar a loja, o ChatNorris apaga o aviso de pagamentos que criou. É a única coisa que o ChatNorris cria na sua loja: ele não cria nem modifica produtos ou pedidos.

​
Importar o catálogo para a base de conhecimento

Com a loja conectada, você pode adicionar seu catálogo como fonte de conhecimento para que o agente responda sobre descrições, materiais ou características de cada produto, com o link para a página dele.
1

Adicione a fonte

Acesse Agentes → [seu agente] → Base de conhecimento → Adicionar fonte e escolha Jumpseller.
2

Importe o catálogo

Clique em Importar catálogo. Os produtos disponíveis da sua loja são importados.
  • Cada produto vira um documento com nome, marca, categorias, descrição, variantes com SKU e o link para a página dele.
  • Preços e estoque não são salvos: o agente os consulta ao vivo com a Ação Jumpseller, assim nunca responde um preço desatualizado.
  • A fonte é sincronizada novamente de forma automática com a frequência do seu plano (semanal no Standard, diária no Premium). Com Importar novamente você a atualiza quando quiser.
Com a Ação ativa, a lista de fontes mostra também a linha Catálogo do Jumpseller ao vivo. Não é uma fonte: indica que o agente consulta preço e estoque diretamente na loja.

​
Créditos

Conectar a loja não consome créditos. Cada resposta do agente que consulta sua loja ao vivo (produtos, preço e estoque, ou pedidos) soma 0,5 crédito de IA ao custo normal da resposta. O catálogo importado ocupa caracteres da sua base de conhecimento como qualquer outra fonte.

​
Desconectar

Em Agentes → [seu agente] → Integrações → Jumpseller, clique em Desconectar. A Ação Jumpseller é desligada e mantém sua configuração, e o ChatNorris apaga o aviso de pagamentos se o tiver criado. Se você não vai mais usar o token, redefina-o em Cuenta › Preferencias da sua loja.

​
Perguntas frequentes

O agente só vê os produtos disponíveis da sua loja. Verifique no Jumpseller se o produto não está desativado. Se você busca por SKU, verifique se o SKU está cadastrado no produto ou na variante.
Verifique se o email com que ele pagou é o mesmo que deixou no chat, se os links foram enviados há menos de 7 dias e se o pedido inclui pelo menos um produto da lista. Verifique também se a capacidade Confirmação de pagamento continua ativa.
A mensagem «Não foi possível registrar o aviso de pagamentos no Jumpseller» («No se pudo registrar el aviso de pagos en Jumpseller») significa que a conta dona do token não tem a permissão de hooks. Adicione-a no Jumpseller, clique em Testar conexão e ative-a novamente.
O Jumpseller rejeitou as chaves salvas, por exemplo porque o token foi redefinido. Copie o novo token e cole-o na integração com Substituir credenciais.
Não. Um agente usa uma única loja para não responder dois preços diferentes para o mesmo produto. Se você tem duas lojas, crie um agente para cada uma.