WhatsApp Cloud API (oficial)
Para a maioria dos provedores, este é o canal mais importante. O WhatsApp Cloud API é o canal oficial da Meta — regulado, seguro, com suporte a templates, mídia e webhook de eventos. É por aqui que a IA atende o cliente final.
Onde fica
Menu Configuração › Integrações › WhatsApp Cloud API — rota /config/integracoes/whatsapp-cloud. A página tem 5 abas: Visão geral, Credenciais, Perfil, Saúde do número e Templates.
O registro do número na Cloud API e o PIN de 2 fatores são feitos no Business Manager da Meta, fora do painel. O conecta/ai recebe as credenciais já provisionadas — ele não cria a conta na Meta por você.
Aba Visão geral
Lista os números já conectados como cards de canal. O botão Adicionar número abre o formulário de credenciais. Sem nenhum número, mostra “Nenhum número WhatsApp Cloud conectado ainda.”
Aba Credenciais
Onde você informa as credenciais do app Meta. Campos:
| Campo | O que é |
|---|---|
| Nome do canal * | Rótulo interno (ex. “WhatsApp Principal”) |
| App ID * | ID do app Meta |
| Business Account ID * | O WABA ID da conta |
| Phone Number ID * | ID do número que vai operar |
| Access Token (permanente) * | Token do System User (campo protegido, com olho) |
| App Secret * | Segredo do app (protegido) |
| Verify Token * | Token do handshake do webhook |
Nunca mostramos segredos em claro. Access Token, App Secret e Verify Token chegam ao navegador mascarados (4chars••••4chars). Ao editar, deixar um campo mascarado em branco mantém o valor atual — você não precisa redigitar o token só para trocar outro campo.
- Preencha e teste. Ao criar, o conecta/ai valida as credenciais com a Meta antes de salvar. Se algo estiver errado, o canal volta com erro e a mensagem exata da Meta aparece.
- Teste a conexão. Depois de salvo, o botão Testar conexão confirma o número e o nome verificado direto na Meta.
- Cadastre o webhook na Meta. Use a Callback URL do número (ela carrega o
phoneNumberId, então é única por número) e o Verify Token, e faça Subscribe ao campomessages. Com tudo certo, o agente responde em 1 a 3 segundos.
O estado do canal aparece como badge (Conectado / Erro / Desconectado) com o número e, em caso de falha, a mensagem de erro.
Aba Perfil
Edita o perfil de negócio que os clientes veem no WhatsApp. Ao salvar, publica direto na Meta. Campos: Sobre (até 139 caracteres), Descrição (até 512), E-mail, Vertical (categoria do negócio), Endereço e até dois sites. A foto de perfil atual aparece na tela — a troca da foto, por enquanto, é feita pelo WhatsApp Manager.
Aba Saúde do número
Mostra dados ao vivo da Meta (com fallback ao cache do webhook se a chamada falhar). É onde você acompanha se o número está saudável:
| Indicador | O que informa |
|---|---|
| Nome verificado / Número | Identidade do canal na Meta |
| Qualidade | 🟢 GREEN, 🟡 YELLOW ou 🔴 RED |
| Limite de envio (Tier) | Quantas conversas você pode iniciar por dia (250 / 1K / 10K / 100K / Ilimitado) |
| Throughput | Capacidade de mensagens por segundo |
| Status do nome | Aprovado / Em revisão / Recusado / Expirado |
| Verificação OTP / Plataforma | Detalhes de conformidade do número |
Se a Meta não responder mas houver dados guardados do webhook, a tela avisa que está mostrando o valor em cache (“Qualidade (cache)” / “Limite (cache)”).
Qualidade baixa derruba o seu limite diário. A nota (GREEN/YELLOW/RED) reflete como os clientes reagem às suas mensagens. Envie só para quem deu opt-in, evite disparos em massa irrelevantes e a qualidade se mantém alta — o que sobe o tier de envios.
Janela de 24 horas e templates
Depois que um cliente te escreve, você tem 24 horas para responder com texto livre. Para iniciar conversa fora dessa janela — cobrança proativa, confirmação de visita, lembrete — é preciso um template HSM aprovado pela Meta. A aba Templates é a mesma tela descrita em Templates HSM.
Veja também
- Templates HSM
- Atendimento — onde as conversas acontecem
- Campanhas — disparos proativos com template
- Status e diagnóstico