Conectar o BotConversa

Com o BotConversa conectado, o Vipter envia cada evento de venda para um webhook do BotConversa, com o telefone do comprador, o código do PIX, o link de recuperação, o rastreio e os outros dados da venda. No BotConversa, você mapeia esses campos uma vez e monta as ações de cada evento: enviar um fluxo, aplicar uma etiqueta, salvar um campo.

Antes de começar, vale ler como funcionam as automações.

Passo 1: criar o webhook no BotConversaCopiar link da seção

1. No BotConversa, abra Automação›Webhooks e crie um webhook.
2. Copie a URL do webhook e guarde para o passo 2. Deixe a tela aberta: você volta a ela no passo 3.

Passo 2: conectar no VipterCopiar link da seção

1. No painel do Vipter, abra Geral›Integrações›Automações›BotConversa.
2. Em Conexão, preencha o campo.

3. Em Eventos enviados, desmarque o que você não quer enviar.
4. Deixe ligado Ativo — enviar eventos para esta plataforma e clique em Salvar.

O BotConversa não usa regras por oferta nem valores por evento: todos os eventos vão para o mesmo webhook. Quem decide o que fazer com cada um são as condições que você monta lá, no passo 4.

Passo 3: enviar um exemplo e mapear os camposCopiar link da seção

O BotConversa só mostra os campos depois de receber o primeiro envio. O botão de teste do Vipter manda um exemplo completo para você mapear tudo antes da primeira venda.

1. No webhook do BotConversa, clique em Receber dados. Ele fica esperando um envio.
2. No Vipter, clique em Testar conexão. Aparece Conexão funcionando.
3. De volta ao BotConversa, o exemplo aparece com todos os campos da Vipter. Ligue o campo telefone ao telefone do contato e salve os outros que você vai usar em campos personalizados, como primeiro_nome, produto, pix_copia_e_cola, link_recuperacao e codigo_rastreio.

O exemplo traz evento: "teste", um telefone com DDD 00, que não existe, e um e-mail example.com. Nenhuma pessoa de verdade recebe mensagem por causa dele.

A lista completa dos campos está em o registro de venda.

Passo 4: montar as ações de cada eventoCopiar link da seção

Todos os eventos chegam no mesmo webhook. Use o campo evento (ou status) numa condição para escolher o que fazer em cada caso. Alguns exemplos:

Para tratar um produto de um jeito diferente, acrescente uma condição em produto_id ou oferta_id.

Passo 5: testar com uma compraCopiar link da seção

Abra o checkout de uma oferta, preencha com o seu e-mail e o seu telefone e gere um PIX, sem pagar. Depois recarregue a página do BotConversa no Vipter.

O que o BotConversa recebeCopiar link da seção

Cada evento chega no webhook com os campos evento (pix_generated, order_paid, checkout_abandoned…) e status. Use esses campos nas condições do BotConversa para escolher o fluxo. Vendas sem telefone são ignoradas.

• O corpo é o registro de venda do Vipter: campos com nomes em português, sempre os mesmos, todos presentes em todo envio. Um campo sem valor chega vazio.
• O telefone vai em dois formatos: telefone, com o + e o código do país (+5511988887777), e telefone_numeros, só com os números (5511988887777). Use o que o seu fluxo aceitar.
• O valor vai pronto para a mensagem em valor (R$ 169,00) e como número em valor_decimal e valor_centavos.
• link_pedido abre o pedido no painel do Vipter, para a sua equipe.

O Vipter não aplica etiquetas nem dispara fluxos por conta própria: quem faz isso são as ações do webhook no BotConversa.

Envios, novas tentativas e reenvioCopiar link da seção

Cada evento aparece em Envios recentes:

• enviado: o BotConversa respondeu com sucesso.
• ignorado: a venda não tem telefone. O motivo aparece em vermelho: customer has no phone (BotConversa needs a WhatsApp number).
• falhou: o BotConversa recusou ou não respondeu. Se a falha for passageira, o Vipter tenta de novo sozinho em 5 minutos, 30 minutos, 2 horas, 6 horas e 24 horas. Se o BotConversa recusar de vez, como numa URL apagada, não há nova tentativa.

Depois de corrigir a causa, use Reenviar na linha do evento. Veja novas tentativas e reenvio.

Problemas comunsCopiar link da seção

• Informe uma URL https://

  A URL precisa começar com https://. Copie de novo no webhook do BotConversa.

• O evento aparece como ignorado com "customer has no phone"

  O comprador não informou telefone. Faça o checkout pedir o telefone. O BotConversa encontra e cria contatos pelo número do WhatsApp.

• O teste deu certo, mas o BotConversa não mostrou os campos

  O webhook precisa estar esperando dados quando o exemplo chega. Clique em Receber dados no BotConversa e depois em Testar conexão no Vipter.

• O evento falhou com 404 ou 410

  O webhook foi apagado ou a URL mudou no BotConversa. Copie a URL nova, salve no Vipter e use Reenviar nos eventos que falharam.

• O fluxo rodou duas vezes para a mesma venda

  Um reenvio manda o evento de novo, e o BotConversa roda as ações de novo. Antes de reenviar, confira no BotConversa se o primeiro envio já não chegou.

O que fazer a seguirCopiar link da seção

• Veja todos os campos do registro de venda.
• Recupere carrinhos com o checkout abandonado.
• Avise o comprador do envio com Marcar o envio e a entrega.