BotConversa

BotConversa é uma integração: um nó do fluxo que leva o lead para a sua conta BotConversa e dispara um fluxo de lá — é o fluxo que manda a mensagem de WhatsApp: o resultado do quiz, o link de um material, o convite para conversar. Você o arrasta da paleta, aberta pelo botão Criar, do grupo Integrações — ao lado de HTTP Request, ActiveCampaign, RD Station, Google Sheets, Zapier e E-mail. Tem uma entrada e uma única saída. Como toda integração, não pode ser ligado direto ao Início — ponha-o depois da página que captura o telefone. Na aba Configurações há só o campo Nome, identificação interna.

Antes de começar

A chave não fica no nó: cadastre-a na tela Credenciais, no menu da sua conta. Em Nova credencial, escolha o tipo BotConversa e cole em Chave API a chave da sua conta — na BotConversa, ela fica em Configurações → Geral → Integrações, aba Externo, bloco API. Gerar uma chave nova lá desativa a anterior: troque-a também na credencial. A credencial serve a vários funis da organização.

Na BotConversa, monte o fluxo que manda a mensagem. Na conexão oficial do WhatsApp, o fluxo precisa começar por um template aprovado: o lead acabou de chegar e nunca escreveu para o seu número, e fora da janela de 24 horas o WhatsApp só entrega template. Os campos personalizados que a mensagem usa precisam existir na conta antes de você ligá-los aqui.

Peça no funil, antes do nó, o consentimento do lead para receber mensagens no WhatsApp — por exemplo, uma pergunta de sim ou não seguida da função Condições, levando ao nó só quem aceitou. O nó registra o contato na BotConversa como quem deu esse consentimento.

O que você configura

Na aba Conteúdo:

• Credencial — obrigatória; a lista traz o atalho Gerenciar credenciais.
• Telefone — obrigatório; o WhatsApp do lead. Use a variável do elemento Telefone, como {{telefone}}: ele já grava o número com o código do país. Um número com só DDD e telefone (10 ou 11 dígitos) ganha o código do Brasil.
• Nome — opcional; o nome do contato, como {{nome}}. A primeira palavra vira o nome e o resto, o sobrenome. Um contato que já existe na BotConversa mantém o nome que tem.
• Fluxo — obrigatório; o fluxo da sua conta que vai disparar. A lista vem da BotConversa; se o fluxo for apagado lá, o campo avisa.
• Campos personalizados — cada linha liga um campo personalizado da sua conta a um valor que aceita {{variavel}} — veja Variável. O nó preenche os campos antes de disparar o fluxo, então a mensagem pode usar o resultado do quiz e as respostas do lead.

Telefone, Nome e os valores dos campos usam o valor do momento em que o lead passa pelo nó. Variável sem valor fica vazia — nunca chega como {{nome}}. Campo com valor vazio não é alterado na BotConversa.

Testando

O modo Testar do editor não dispara o fluxo. Para ver a mensagem, digite o seu número em Seu WhatsApp para o teste e use Enviar teste, no próprio nó: ele dispara o fluxo para esse número — nunca para o telefone do lead —, com os valores como {{nome}}, mostrando onde cada resposta entra. O teste grava de verdade na sua conta: o contato do número de teste é criado (ou reaproveitado) e os campos personalizados dele recebem esses textos. O resultado aparece abaixo do botão; se falhar, ele diz o motivo (chave recusada, fluxo apagado…).

No funil publicado

Ao passar pelo nó, o envio acontece em segundo plano e o fluxo segue na hora: o lead não espera nem vê erro. O nó acha o contato pelo telefone ou o cria, preenche os campos personalizados e dispara o fluxo. O nó usa a versão publicada — alterações só valem depois de publicar de novo.

Na mesma visita, o fluxo não dispara duas vezes: voltar e avançar pelo nó não reenvia. Se uma resposta mudou — o lead voltou e corrigiu o telefone, por exemplo —, o nó dispara de novo. A proteção vale enquanto a página estiver aberta.

Um campo personalizado que a BotConversa recusar — uma data fora do formato dela, por exemplo — fica sem valor, e o fluxo dispara mesmo assim. O limite é de 10 segundos por chamada, não há reenvio e a falha é silenciosa. A BotConversa aceita até 600 chamadas por minuto por conta, somando todos os seus funis, e cada lead usa algumas delas.

Onde conferir o resultado

Não há histórico de envios em Leads nem em Analytics: confira o contato e o disparo do fluxo na própria BotConversa. Use o Enviar teste para conferir o fluxo antes de publicar.

Ao exportar o funil para outra conta, a credencial, o fluxo e os campos personalizados vão vazios: são da sua conta BotConversa. Telefone e Nome seguem.