Referência do nó

KindstartCategoriaGatilhos

Gatilho por WhatsApp Flow Concluído

Para que serve

Dispara o fluxo quando um contato conclui um WhatsApp Flow (o formulário interativo do WhatsApp) e essa é a primeira vez dele na campanha. O evento no catálogo se chama WhatsApp Flow respondido.

É uma opção de evento do nó Start, escolhida em "Quando iniciar" no grupo Campanhas.

Quando usar

• Continuar o atendimento automaticamente assim que o contato envia as respostas de um Flow.
• Usar as respostas (ex.: CPF, tipo de caso) para classificar ou rotear o lead.

Passo a passo

1. ·
   Abra o nó **Start** do fluxo.
2. ·
   No campo "Quando iniciar", escolha o evento **WhatsApp Flow respondido** no grupo **Campanhas**.
3. ·
   Se quiser, use o filtro por campanha.
4. ·
   Conecte a saída do Start ao próximo bloco do fluxo.

Quando dispara e quando não dispara

• Dispara na primeira resposta de um Flow daquele contato na campanha.
• Não dispara em respostas seguintes do mesmo contato na mesma campanha.

Como o Flow é identificado

• Flow criado na plataforma (veja WhatsApp Flows): a resposta é ligada ao Flow pelo próprio formulário (o flow_token) ou, se faltar, pela mensagem que o originou (envio pelo chat ou template com botão de Flow). A campanha é sempre a da raiz do Flow, então todas as versões caem na mesma campanha e o event.campaign.external_id é o id da raiz.
• Flow legado (criado fora da plataforma): a campanha é identificada pelo template da mensagem enviada, e o external_id é o nome do template.
• Quando nenhuma das duas formas funciona, a resposta cai em uma campanha com external_id igual a unidentified, uma por canal.

Variáveis disponíveis

Variável	O que traz
event.campaign.id	Id interno da campanha
event.campaign.name	Nome da campanha (editável)
event.campaign.source_type	Origem: ctwa, lead_form ou whatsapp_flow
event.campaign.platform	Plataforma: facebook, instagram ou whatsapp
event.campaign.external_id	Id externo (id do anúncio, id do formulário, id da raiz do Flow da plataforma ou template do Flow legado)
event.campaign.ad_id	Id do anúncio na Meta (pode vir vazio)
event.campaign.ad_name	Nome do anúncio (pode vir vazio)
event.campaign.campaign_name	Nome da campanha na Meta (só Lead Ads; pode vir vazio)
event.campaign_id	Id interno da campanha
event.campaign_lead_id	Id do lead da campanha
event.contact_id	Id do contato
event.conversation_id	Id da conversa onde o Flow foi respondido
event.flow_token	flow_token da resposta, quando presente (Flows da plataforma trazem wf: seguido do id da versão)
event.fields	Respostas do Flow, com o nome do campo como chave (ex.: event.fields.cpf). Valores de seleção múltipla e de arquivos chegam como o enviado pela Meta

Filtros

O painel do Start ganha a seção Filtros com um único campo: Campanha (lista das campanhas de WhatsApp Flow do workspace). Funciona do mesmo jeito descrito em Filtros do Start.

Dica

Sem o filtro, o fluxo dispara para a resposta de **qualquer** Flow do workspace. Use o filtro de **Campanha** para amarrar o fluxo a um Flow específico. A campanha de um Flow da plataforma é criada na publicação, com 0 leads, e já aparece na lista do filtro antes da primeira resposta.

Exemplo

1. Start → evento WhatsApp Flow respondido.
2. Se / Senão → verifica {{event.fields.cpf}} preenchido.
3. Enviar Mensagem → confirma o recebimento dos dados.

Cuidados

Atenção

`event.fields` contém dados pessoais informados pelo contato. Não os copie para logs ou destinos que não deveriam recebê-los.

Saiba mais

• WhatsApp Flows — criar, publicar e enviar o formulário
• Start (Início do fluxo) — outras formas de iniciar um fluxo e como funcionam os filtros
• Gatilho por Comentário Recebido — outro gatilho configurado como opção do Start
• Se / Senão (condição) — para tratar as variáveis do evento dentro do fluxo