Conectar WhatsApp

O WhatsApp e a integracao mais exigente. Voce precisa ter uma WhatsApp Business Account (WABA) no Meta Business Manager, com pelo menos um numero verificado, antes de conectar. O UltronChat usa a WhatsApp Cloud API oficial.

Pre-requisitos

1. Plano Pro — WhatsApp nao esta disponivel no Essencial.
2. WhatsApp Business Account (WABA) criada em business.facebook.com.
3. Numero verificado pela Meta dentro da WABA.
4. Permissoes de administrador no Meta Business Manager onde esta a WABA.
5. Voce nao precisa ter o app WhatsApp Business instalado no celular. A Cloud API desconecta o numero do app quando voce conecta — o UltronChat passa a ser o unico remetente oficial desse numero.

Atencao: o UltronChat usa um app Meta dedicado (App B) para WhatsApp, separado do app de Instagram e Messenger. Isso e uma decisao de seguranca/isolamento — nao tem impacto na UX alem do OAuth ser pelo app B.

Passo a passo

1. Em /dashboard/connect, clicar em "Conectar WhatsApp"

Screenshot: /dashboard/connect com card WhatsApp em destaque.

2. Autenticar no Facebook Login for Business

O fluxo abre o "Login for Business" do App B, que lista WABAs e numeros disponiveis.

3. Selecionar a WABA e o numero

Apos autenticar, voce volta para /dashboard/connect/select-phone com a lista de numeros disponiveis na WABA selecionada. Escolha um.

Screenshot: /dashboard/connect/select-phone com numeros listados.

4. Confirmar

Clique em Conectar este numero. O UltronChat:

1. Troca o user token por um System User Token permanente da WABA (nao expira, diferente de Instagram/Messenger).
2. Registra o numero no sistema (phone registration) se ainda nao estava.
3. Faz subscribe dos webhooks (mensagens recebidas, status de entrega, erros).
4. Cria a conexao em connections com platform = whatsapp.

Pronto — o numero agora responde DM no UltronChat.

Templates de mensagem

WhatsApp tem a regra da janela de 24 horas (veja mais em janela 24h na secao de Live Chat, em desenvolvimento): depois que o cliente escreve, voce tem 24 horas para responder com qualquer mensagem. Passado isso, so templates aprovados pela Meta podem ser enviados.

O UltronChat sincroniza os templates aprovados automaticamente. Veja em /dashboard/[connectionId]/templates. Detalhes em uma proxima secao de WhatsApp Templates (em breve).

Erros comuns

Erro	Causa	Solucao
"Nenhuma conta WhatsApp Business encontrada"	Usuario nao tem WABA criada	Criar WABA em business.facebook.com
"invalid_state" no callback	Problema legado, ja corrigido	Se reaparecer, abrir ticket
Mensagens nao chegam	Webhook nao registrado no App B	Abrir ticket; problema de infraestrutura
Envio falha apos 24h	Janela de 24h expirada	Use template aprovado

O que o UltronChat le e escreve

Le:

• Mensagens recebidas no numero.
• Status de entrega (enviado, entregue, lido, falhou).

Escreve:

• Envia mensagens via API (texto, imagem, template).
• Envia templates aprovados quando a janela de 24h expira.

Nada de grupos, nada de status publico — apenas 1:1 com clientes.

Proximo passo

Configurar o agente de IA para responder automaticamente no numero conectado.