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.

Canvas do Flow Builder com um fluxo de exemplo: gatilho 'Mensagem Recebida' seguido de envio de mensagem, condição SE/SENÃO, ação na plataforma, nó de IA e mensagem final.

Como funciona

O Atende Direito guarda o vínculo entre um canal e um fluxo. Quando uma mensagem chega no canal WhatsApp vinculado, a plataforma dispara automaticamente o gatilho Mensagem Recebida no fluxo correspondente.

Mensagem WhatsApp recebida
  → Canal identifica o fluxo vinculado
    → Fluxo é iniciado pelo gatilho Mensagem Recebida
      → 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

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 (o acesso que a Meta fornece para conectar um número de WhatsApp a sistemas externos).

Passo a passo

1. ·

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

   

   Flow Builder aberto com o fluxo no canvas, mostrando os nós de início e fim conectados.

2. ·

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

   

   Painel de configuração do nó Início, aberto ao lado do canvas, com as opções 'Quando iniciar' e o próximo passo do fluxo.

3. ·

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

4. ·

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

5. ·

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

   

   Modal de conexão do WhatsApp, com as opções WhatsApp Cloud, UAZAPI e Atende Direito Connection disponíveis para vincular o canal.

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 histórico da execução.

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	Identificador 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	Identificador 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	Identificador 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ê.

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.

Saiba mais

• Conectar Google Workspace — conecte Google Calendar e Google Sheets aos agents do fluxo
• Ferramentas do Agent — dê acesso a sistemas externos ao Agent que responde no fluxo
• Controle da IA no chat — assuma, pause ou devolva a conversa ao bot