## 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

1. Na área de **Catálogo & Comércio**, crie uma **fonte de comércio** para a plataforma desejada.
2. Copie a **URL de webhook** gerada para essa fonte e defina o **segredo de verificação** quando a
   plataforma exigir.
3. Cole a URL no painel da plataforma externa (ou use o **registro automático** quando disponível, por
   exemplo em Kiwify e Nuvemshop).
4. Faça uma venda de teste (ou um carrinho de teste) para confirmar que o evento chega.
5. Veja o **card do evento** aparecer na conversa do cliente, com itens, valores e link/dados de
   pagamento conforme o estágio.
6. 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.

## Veja também

- [Visão geral de Catálogo & Comércio](/hc/ajuda/articles/catalog-commerce-overview-pt-br)
- [Enviar produto e receber pedidos na conversa](/hc/ajuda/articles/catalog-commerce-enviar-produto-pedido-na-conversa-pt-br)
- [Catálogo nativo: produtos, categorias, imagens e preços](/hc/ajuda/articles/catalog-commerce-catalogo-nativo-pt-br)