Conectar o WhatsApp

Sem um canal conectado, Conversas e campanhas não enviam mensagem. O cadastro fica em Configurações, seção Canais e mensagens, card Canais de entrada. A descrição do card é "Conecte canais como WhatsApp."

Abrir o cadastro

1. No menu lateral, abra Configurações.
2. Clique em Canais de entrada.
3. Clique em Adicionar canal. Se a lista estiver vazia, use Adicionar primeiro canal.

O diálogo Conectar um canal WhatsApp diz: "Conecte pela API oficial da Meta. Você pode adicionar mais canais depois."

Conectar pela Meta (recomendado)

1. No card WhatsApp Business API (oficial Meta), com o selo Recomendado, avance no fluxo.
2. Em Nome do canal, o placeholder é WhatsApp principal. Escolha um nome fácil de reconhecer se a conta tiver mais de um número.
3. Clique em Criar canal. Enquanto provisiona, o botão mostra Provisionando….
4. Na etapa WhatsApp Business API (oficial), o texto pede para autorizar a conta no fluxo da Meta.
5. Clique em Conectar com Meta. O botão pode mostrar Carregando… ou Conectando WABA….
6. Conclua o login e as permissões na janela da Meta.
7. De volta ao painel, o aviso de sucesso é Canal WhatsApp Business conectado!

Se a Meta pedir cartão de pagamento no Business Manager antes de enviar mensagens, o próprio fluxo avisa. Sem cartão, o canal pode conectar e ainda assim bloquear envio.

Conectar com WABA e token

Use quando o login da Meta não servir nesta conta.

1. No fluxo Cloud, clique em Conectar manualmente com WABA e token.
2. A descrição muda para: "Informe WABA, ID do número e token. Use só quando o login da Meta não servir."
3. Em Onde encontrar essas informações e Webhook no seu app Meta (obrigatório), confira URL de callback e Verificar token. Se precisar de um token novo, clique em Gerar.
4. Preencha WABA ID, Phone Number ID, Access token (system user) e App Secret.
5. Nome do canal (opcional) usa o placeholder WhatsApp comercial.
6. Em Mostrar configurações avançadas, ajuste Versão da Graph API só se a Meta indicar outra.
7. Clique em Conectar canal. Durante a validação, o rótulo é Validando com a Meta….
8. Em sucesso, a tela mostra Canal conectado! e, se ainda faltar, o passo Assine o webhook manualmente.

Voltar ao login da Meta retorna ao fluxo com Conectar com Meta.

Depois de conectar

No card do canal:

• Verificar saúde confere se o número responde.
• Ligações, Boas-vindas CTWA, Ver histórico, Agente e roteamento, Horário comercial e Avançado abrem ajustes do número.
• Pausar canal / Reativar canal controlam o uso sem excluir.
• Excluir canal pede confirmação em Excluir canal?.

Com número novo ou coexistência, pode aparecer o pedido para escolher quem recebe o histórico e iniciar a importação. O aviso típico é "Número conectado. Escolha quem recebe o histórico para iniciar a importação."

QR Code (não oficial)

No diálogo inicial também existe Conectar com QR Code (não oficial) e o título WhatsApp Live via QR Code. Esse caminho não usa a API Cloud da Meta. Prefira WhatsApp Business API (oficial Meta) para templates, Flows e ligações oficiais.

Se não funcionar

Sem nome amigável: "Informe um nome amigável para o canal."

Falha geral: "Não deu para conectar o canal." Confira se o Business Manager da Meta está no mesmo login e se o app tem permissão no WABA.

Se o SDK ainda carrega: "SDK do Facebook ainda carregando…" Espere e clique de novo em Conectar com Meta.

Canal criado sem sessão: "Canal criado. Clique em Conectar para escanear o QR Code." ou use Conectar agora no card.

Saúde ok: "Canal saudável e conectado." Sessão encerrada: "Sessão do WhatsApp encerrada." Reconecte pelo card.