> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Jumpseller > Como conectar sua loja Jumpseller a um agente do ChatNorris para responder preço e estoque ao vivo, consultar pedidos verificados, montar a compra com links para o carrinho, confirmar o pagamento no chat e importar o catálogo para a base de conhecimento. # 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](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * 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. > [!WARNING] > > 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. | Capacidade | O que faz | | - | - | | **Consultar produtos, preço e estoque** | Busca produtos e variantes por nome ou SKU e responde o preço e as unidades em estoque naquele momento. Também pode contar o que há na loja quando o visitante pergunta de forma geral. | | **Consultar pedidos** | O visitante informa o número do pedido (por exemplo, 1001) e o agente informa o status de pagamento e de envio, com o código de rastreamento se existir, depois de verificar que o pedido é dele. | | **Montar compra** | Monta a lista de compra com preço e estoque ao vivo e entrega um link por produto que o adiciona ao carrinho com a quantidade pedida. Requer a consulta de produtos. | | **Confirmação de pagamento** | Quando o visitante paga na sua loja, o agente confirma isso na mesma conversa. Requer Montar compra. | > [!NOTE] > > 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](https://docs.chatnorris.ai/pt/guias/acciones.md), 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. > [!TIP] > > 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. > [!WARNING] > > 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**. > [!NOTE] > > 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 > [accordion] O agente diz que não encontra um produto que existe > > 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. > [accordion] O visitante abriu os links, mas o carrinho ficou vazio ou incompleto > > Cada link adiciona um produto somente se houver estoque suficiente naquele momento. Além disso, ele precisa abri-los no mesmo navegador: se abrir um no celular e outro no computador, eles ficam em carrinhos diferentes. > [accordion] O visitante pagou e o agente não confirmou > > 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. > [accordion] Não consigo ativar a confirmação de pagamento > > 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. > [accordion] A integração aparece como vencida > > 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**. > [accordion] Posso usar Jumpseller e WooCommerce no mesmo agente? > > 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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.