---
title: Conectar WhatsApp
description: Como vincular um canal WhatsApp a um fluxo no Atende Direito para receber e responder mensagens automaticamente.
---

# 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.

<Captura legenda="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." src="/img/flow-exemplo-canvas.png" />

## 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).

</Dica>

<Secao icon="list-checks">Passo a passo</Secao>

<Passos>
  <Passo>

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

<Captura legenda="Flow Builder aberto com o fluxo no canvas, mostrando os nós de início e fim conectados." src="/img/flowbuilder-canvas.png" />

  </Passo>
  <Passo>

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.

<Captura legenda="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." src="/img/flowbuilder-inspector-no-agent.png" />

  </Passo>
  <Passo>

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

  </Passo>
  <Passo>

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

  </Passo>
  <Passo>

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

<Captura legenda="Modal de conexão do WhatsApp, com as opções WhatsApp Cloud, UAZAPI e Atende Direito Connection disponíveis para vincular o canal." src="/img/canais-conectar-whatsapp.png" />

  </Passo>
  <Passo>

**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.

  </Passo>
</Passos>

## 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.

</Dica>

## 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.

<Cuidado>

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.

</Cuidado>

## Saiba mais

- [Conectar Google Workspace](/guia/conectar/google-workspace) — conecte Google Calendar e Google Sheets aos agents do fluxo
- [Ferramentas do Agent](/guia/agents/ferramentas) — dê acesso a sistemas externos ao Agent que responde no fluxo
- [Controle da IA no chat](/guia/atendimento/controle-da-ia-no-chat) — assuma, pause ou devolva a conversa ao bot