--- type: use-case title: Experiência Shop url: "https://hub.jelou.ai/use-cases/experiencia-shop" markdown: "https://hub.jelou.ai/use-cases/experiencia-shop.md" jobs: - cobrar dentro do WhatsApp - manter o checkout da minha loja ao vender pelo chat products: - payments - shop access: public --- # Experiência Shop O cliente compra sem sair do WhatsApp; você decide se o pagamento é fechado dentro do chat com o Jelou Payments ou no checkout que sua loja já tem na Shopify ou WooCommerce. O Shop administra o comércio, o checkout é o fluxo de fechamento, e o pagamento é só o passo final. O Jelou Payments e o checkout nativo da sua loja resolvem esse passo de duas formas diferentes. ## Rota A · Jelou Payments O Jelou Payments é só a plataforma de cobrança: abre o checkout oficial do provedor dentro do WhatsApp (WebView) e confirma a compra quando esse provedor retorna o status real do pagamento. Ele resolve o passo de pagamento — não gerencia catálogo, estoque nem regras de frete. ### O que você precisa - Um provedor de pagamento conectado por BYOK — Mercado Pago, Stripe, PayPal, PayPhone, Wompi, Conekta, Kushki, Placetopay ou Niubiz — instalado a partir do Marketplace com suas próprias credenciais. - Uma conta do WhatsApp Business verificada. Sem verificação, o checkout cai no navegador externo do aparelho. - O nó Pagamentos no seu fluxo, apontando para a integração conectada. - Regras de status: o que o fluxo responde se o pagamento vier aprovado, recusado ou pendente. Confira o [catálogo de provedores](https://docs.jelou.ai/guides/integraciones/pagos/proveedores.md) antes de instalar, para confirmar que ele suporta WebView no seu país. ### Como se constrói 1. **Instale o provedor a partir do Marketplace** — Escolha a plataforma de pagamento que o negócio já usa — ou quer usar — e confirme que ela suporta WebView incorporado no país. 2. **Teste e depois conecte sua conta real** — "Testar com Jelou" valida o fluxo completo sem credenciais próprias, com até 10 testes por configuração. Depois de validado, conecte suas credenciais de produção na mesma instalação — o workflow não precisa ser remontado. [Docs](https://docs.jelou.ai/guides/integraciones/pagos/modo-prueba.md) 3. **Adicione o nó Pagamentos ao seu fluxo** — No Canvas, aponte o nó Pagamentos para a integração conectada. O WebView abre automaticamente se o provedor suportar e a conta estiver verificada. 4. **Teste no seu WhatsApp real, não no tester** — O tester não abre o WebView do checkout. Envie um pedido de teste para você mesmo pelo WhatsApp, em modo teste e sem fundos reais, antes de publicar. ![Modal para escolher entre Testar com Jelou ou Conectar minha conta](https://cdn.sanity.io/images/sz9welmm/production/3417f02420ab1b13f99af3ff6871008438ade5ec-1024x694.jpg) *Modo teste: você valida o fluxo completo antes de conectar a conta real do provedor.* > O frete não vem incluído: o Jelou Payments resolve só o passo de pagamento — a logística de entrega depende da jornada e da sua implementação. ## Rota B · Jelou Shop / checkout nativo da sua loja Em vez de cobrar dentro do chat, o pedido é fechado no checkout que sua loja Shopify ou WooCommerce já tem — mantendo seus próprios meios de pagamento e suas regras de frete e logística exatamente como estão na loja. Não passa pelo nó Pagamentos nem por nenhuma plataforma BYOK do Jelou. ### O que você precisa - Loja conectada por OAuth — Shopify ou WooCommerce — a partir do Marketplace ou do Jelou Agent. O MCP do Jelou Shop é incluído automaticamente. - Ativar use_external_checkout: true ao executar get_and_clear_cart, para que o Jelou entregue o link do seu checkout real em vez de abrir o próprio fluxo de pagamento. - Sua loja já pronta para vender: meios de pagamento, impostos e regras de frete configurados na Shopify ou WooCommerce. ### Como se constrói 1. **Conecte sua loja a partir do Marketplace** — Shopify: faça login, escolha a loja e autorize o app Jelou Commerce. WooCommerce: informe o domínio da sua loja, faça login no WordPress e aprove as permissões. [Docs](https://docs.jelou.ai/guides/integraciones/e-commerce/woocommerce.md) 2. **Confirme a autorização** — Você verá a mensagem de conexão bem-sucedida, e a ficha da integração vai mostrar a conta conectada. Já pode sincronizar produtos e pedidos. 3. **O agente monta o carrinho e fecha no seu checkout** — Com o Jelou Shop conectado, o agente busca produtos e adiciona itens ao carrinho por WebView ou de forma conversacional. Ao fechar o pedido com use_external_checkout: true, o Jelou entrega o link real do seu checkout em vez de abrir o próprio fluxo de pagamento. 4. **O cliente paga fora do chat, na sua loja** — Ele completa a compra no checkout oficial da Shopify ou WooCommerce, com os meios de pagamento, impostos e fretes que você já configurou lá. ![Jornada do catálogo no WebView: busca no chat, ficha de produto com variantes e adicionar ao carrinho](https://cdn.sanity.io/images/sz9welmm/production/15d590877f6df5dcddf84a3c28c79d2c1c2b65bc-1536x1024.jpg) *O agente monta o carrinho no chat antes de você decidir por qual rota o pagamento é fechado.* > Essa é a diferença-chave em relação ao Jelou Payments: aqui suas regras de frete e logística são mantidas exatamente como configuradas na loja. ## Fique de olho - O fluxo não deve avançar como se o pagamento estivesse aprovado enquanto o status for pendente; isso é comum em transferências e carteiras digitais. - O modo teste não processa pagamentos reais e tem limite de 10 testes por configuração — não confunda com produção. - use_external_checkout só está disponível se você conectou a loja via Shopify ou WooCommerce. - Não confunda as rotas: o Jelou Payments cobra por plataformas BYOK; o checkout nativo cobra 100% na sua plataforma de e-commerce. ## Dicas - Comece pela plataforma de pagamento ou pela loja que o negócio já usa, se ela for suportada. - Devolva o número do pedido e o status do pagamento na mesma mensagem. - Valide o fluxo completo em modo teste antes de conectar a conta real. [Ver o detalhe completo nos Docs](https://docs.jelou.ai/guides/integraciones/pagos/experiencias/tipos-de-experiencia.md)