Conectar WhatsApp

Imagina que você montou um fluxo incrível de atendimento — mas ele está desconectado do mundo. Sem um canal conectado, é como ter um atendente pronto na sala sem nenhum telefone para receber chamadas.

Vincular um canal WhatsApp ao seu fluxo é o passo que faz tudo funcionar de verdade: cada mensagem recebida no WhatsApp dispara automaticamente o fluxo que você configurou.

CAPTURAR: diagrama simplificado mostrando mensagem no WhatsApp → canal conectado → fluxo disparado → resposta automática

Como funciona

O Atende Direito usa uma estrutura chamada ChannelProject (tabela flow_channel_projects) para vincular um canal a um fluxo. Quando uma mensagem chega no canal WhatsApp vinculado, a plataforma dispara automaticamente o gatilho inbound_message no fluxo correspondente.

Mensagem WhatsApp recebida
  → Canal (ChannelProject) identifica o fluxo vinculado
    → Fluxo é iniciado com o gatilho inbound_message
      → Variáveis iniciais são injetadas automaticamente
        → Seu fluxo roda normalmente

Pré-requisitos

• Ter um canal WhatsApp já configurado na plataforma (seção Canais)
• Ter um fluxo publicado com o gatilho Mensagem Recebida (inbound_message)

Dica

Se você ainda não criou um canal WhatsApp, acesse o menu Canais no painel lateral e siga o assistente de configuração. Você vai precisar das credenciais da API do WhatsApp Business.

Passo a passo

1. ·

   Abra o fluxo que você quer vincular ao WhatsApp no Flow Builder.

   

   CAPTURAR: Flow Builder aberto com o fluxo desejado no canvas

2. ·

   Certifique-se de que o primeiro nó do fluxo é um gatilho do tipo Mensagem Recebida (inbound_message). Esse gatilho é o ponto de entrada para mensagens vindas de canais.

   

   CAPTURAR: nó de gatilho 'Mensagem Recebida' como primeiro bloco do canvas, com o painel de configuração aberto

3. ·

   Acesse as configurações do fluxo (ícone de engrenagem ou menu Configurações) e procure a seção Canais Conectados ou Vincular Canal.

   

   CAPTURAR: painel de configurações do fluxo com a seção 'Canais Conectados' visível

4. ·

   Clique em Vincular Canal e selecione o canal WhatsApp desejado na lista de canais disponíveis.

   

   CAPTURAR: modal de seleção de canal com a lista de canais WhatsApp disponíveis e o botão 'Vincular'

5. ·

   Confirme a vinculação. A partir desse momento, toda mensagem recebida naquele canal WhatsApp vai disparar este fluxo.

   

   CAPTURAR: tela de configurações do fluxo com o canal WhatsApp aparecendo como 'Conectado' com um indicador verde

6. ·

   Teste em produção: envie uma mensagem real pelo WhatsApp para o número do canal vinculado e verifique se o fluxo é acionado. Acompanhe em Monitoramento → Execuções para ver o log da execução.

   CAPTURAR—CAPTURAR: painel de monitoramento com uma execução recente do fluxo originada por uma mensagem WhatsApp, com o status 'Concluído'

Variáveis disponíveis no fluxo

Quando uma mensagem chega pelo WhatsApp, a plataforma injeta automaticamente um conjunto de variáveis no fluxo. Você pode usá-las em qualquer nó para personalizar a resposta.

Entrada do usuário

Variável	O que contém
userinput.query	O texto da mensagem enviada pelo cliente

Dados do contato (contact.*)

Variável	O que contém
contact.id	ID interno do contato na plataforma
contact.name	Nome do contato
contact.phone	Número de telefone
contact.email	E-mail (se cadastrado)
contact.custom_fields	Campos personalizados do contato

Dados do canal (channel.*)

Variável	O que contém
channel.id	ID do canal WhatsApp
channel.name	Nome do canal configurado na plataforma
channel.type	Tipo do canal (ex.: whatsapp)

Dados da conversa (conversation.*)

Variável	O que contém
conversation.id	ID da conversa atual
conversation.status	Status da conversa (aberta, fechada, etc.)
conversation.created_at	Data/hora de abertura da conversa

Variáveis de sistema (sys.*)

Variável	O que contém
sys.is_interacted_in_last_24h	true se o cliente enviou alguma mensagem nas últimas 24 horas. Útil para controlar janelas de conversa ativa.

Dica

A variável sys.is_interacted_in_last_24h é especialmente importante para respeitar a janela de 24 horas do WhatsApp Business API. Dentro dessa janela você pode enviar mensagens livres; fora dela, precisa usar templates aprovados.

Exemplo de uso das variáveis

No nó Enviar Mensagem, você pode usar:

Olá, {{contact.name}}! Recebi sua mensagem: "{{userinput.query}}". 
Já estou verificando aqui para você.

O resultado será algo como:

Olá, João Silva! Recebi sua mensagem: "Quero saber sobre honorários". 
Já estou verificando aqui para você.

CAPTURAR—CAPTURAR: nó 'Enviar Mensagem' com uma mensagem usando variáveis de contato e userinput.query, e o preview da mensagem renderizada ao lado

Um canal, um fluxo

Cada canal WhatsApp pode ser vinculado a um fluxo por vez. Se você precisar de comportamentos diferentes para o mesmo número (ex.: horário comercial vs. fora do horário), use lógica condicional dentro do mesmo fluxo — não crie dois fluxos separados para o mesmo canal.

Atenção

Se você publicar um novo fluxo e vincular ao mesmo canal, o fluxo anterior perde a vinculação automaticamente. Sempre teste o novo fluxo em ambiente de homologação antes de migrar o canal de produção.