Visão geral
O ciclo de vida de e-commerce conecta plataformas externas — Kiwify, Hotmart, Nuvemshop e Shopify — para que os eventos de venda cheguem dentro do atendimento. Quando algo acontece na plataforma externa (carrinho abandonado, PIX/boleto gerado, compra aprovada, recusada ou reembolsada), a ConversaLabs recebe o webhook, normaliza o evento e mostra um card na conversa do cliente, com os dados de pagamento quando disponíveis.
Com isso, você recupera vendas sem trocar de ferramenta: o time vê o estágio da compra na própria conversa e pode acionar Follow-ups automáticos para reconquistar quem não finalizou.
Pré-requisitos
- Módulo de Catálogo & Comércio habilitado e permissão para configurar fontes de comércio.
- Acesso à plataforma externa (Kiwify, Hotmart, Nuvemshop ou Shopify) para configurar o webhook.
- Para recuperação automática: o módulo de Follow-ups configurado com sequências por evento.
Passo a passo
- Na área de Catálogo & Comércio, crie uma fonte de comércio para a plataforma desejada.
- Copie a URL de webhook gerada para essa fonte e defina o segredo de verificação quando a plataforma exigir.
- Cole a URL no painel da plataforma externa (ou use o registro automático quando disponível, por exemplo em Kiwify e Nuvemshop).
- Faça uma venda de teste (ou um carrinho de teste) para confirmar que o evento chega.
- Veja o card do evento aparecer na conversa do cliente, com itens, valores e link/dados de pagamento conforme o estágio.
- Configure Follow-ups acionados por evento (por exemplo, "carrinho abandonado") para recuperar a venda automaticamente.
Configurações & opções
- Fonte de comércio: uma por plataforma, com URL de webhook e segredo de verificação próprios.
- Registro automático do webhook: disponível em parte das plataformas (ex.: Kiwify e Nuvemshop); nas demais, a configuração é manual no painel da própria plataforma.
- Card do evento: mostra o estágio da compra e, quando a plataforma expõe, dados de PIX/boleto e o link de checkout.
- Variáveis de comércio: dados do último evento ficam disponíveis para uso em mensagens de Follow-up (link de pagamento, valor, código PIX/boleto, etc.).
Casos de uso
- Carrinho abandonado: dispara uma sequência de Follow-up lembrando o cliente de concluir.
- PIX/boleto pendente: reenvia o código de pagamento e acompanha até confirmar.
- Compra aprovada: confirma com o cliente e libera o próximo passo do atendimento.
- Reembolso/recusa: alerta o time para tratar o caso na própria conversa.
Dicas, limites e boas práticas
- O que cada plataforma expõe varia: algumas enviam o código PIX e a linha do boleto no evento (recuperação completa dentro da conversa); outras só fornecem o link de checkout — nesses casos, o card mostra o link para o cliente concluir.
- Valores e formatos diferem por plataforma: a ConversaLabs normaliza cada evento; você não precisa se preocupar com a conversão — o card já exibe o valor correto.
- Segredo de verificação: mantenha-o configurado para que apenas eventos legítimos da plataforma sejam aceitos.
- Combine com Follow-ups para automatizar a recuperação em vez de depender de ação manual.
Solução de problemas
- O evento não aparece: confira se a URL de webhook foi colada corretamente na plataforma e se o segredo de verificação confere.
- Não vejo PIX/boleto no card: nem toda plataforma expõe esses dados; quando não há, o card traz o link de checkout.
- Eventos duplicados: a plataforma trata repetições do mesmo evento; se notar algo estranho, verifique se há mais de um webhook configurado para a mesma fonte.