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 Loja › WhatsApp Cloud API, rota /config/integracoes/whatsapp-cloud. A página tem as abas Visão geral, Credenciais, Perfil, Saúde do número, Consumo e custo, Templates e Voz (chamada de voz pelo WhatsApp, fora do escopo desta página).
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
Abre com uma frase que resume os seus números: quantos estão na Meta Cloud API, quantas interações tiveram no mês e, quando há, quantos estão com erro ou desligados. Abaixo, cada número é uma linha da lista, com o nome, o número e o estado em palavra (Conectado, Erro, Desconectado, Desligado, Sem eventos ou Sem sinal há N d). Um número com erro ganha uma barra vermelha na margem; um número marcado como conectado que não recebe evento há dias, uma barra âmbar. Clique na linha para ver quando foi conectado, o último evento recebido, as interações do mês e as ações: Reconectar (quando há erro ou ele está desconectado), Testar conexão, Editar e Remover. Remover pede confirmação na própria tela.
O botão Adicionar número abre o formulário de credenciais. Sem nenhum número, mostra “Nenhum número WhatsApp Cloud conectado ainda.”
Quem abre o atendimento neste número
Em cada número, Quem abre o atendimento neste número escolhe o agente de IA que recebe a primeira mensagem de quem escreve para ele. Cada número pode ter o seu. Deixado no padrão (Agente principal da empresa), vale o agente principal.
- A troca vale para as conversas novas: quem já está conversando segue com o agente atual.
- Escolha um agente de triagem (recepção). É ele quem transfere para os especialistas ou para a equipe; um especialista posto aqui vira a porta de entrada de todo assunto.
- Conversa que chega sem o número identificado segue o agente principal.
- Sem nenhum agente habilitado na empresa, a tela avisa que o número não vai responder.
A mesma escolha existe no Telegram, no chat do site e na Telefonia.
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 uma frase dizendo o que corrigir.
- 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 em palavra (Conectado / Erro / Desconectado) com o número e, em caso de falha, a mensagem de erro ao lado de uma barra vermelha.
Quando o canal diz que está ligado a outro App
O App ID, o App Secret e o Access Token precisam ser do mesmo App da Meta. A conta do WhatsApp fica ligada ao App em que o token foi gerado, e a Meta assina cada mensagem com o segredo desse App. Se o App ID e o App Secret informados forem de outro App, nenhuma mensagem de cliente chega.
O conecta/ai confere isso com a Meta ao salvar e quando as mensagens começam a ser recusadas. Nos dois casos o canal fica em Erro com uma frase que diz qual App está ligado ao número, por exemplo: “A conta do WhatsApp deste número está ligada ao App “Minha Empresa” (…) na Meta, mas o canal está configurado com o App ID …”.
Como corrigir: informe o App ID e o App Secret do App citado na frase (em Meta for Developers › Configurações do app › Básico) e salve. Ou, se preferir manter o App atual, gere o token de acesso nele. Ao salvar com o App corrigido, o canal é conferido de novo e só volta a Conectado se a Meta confirmar.
Canal desligado não mostra erro: a linha diz Desligado. Se ele tinha um erro, a mensagem volta a aparecer quando você o religar.
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 o último aviso do webhook se a consulta falhar). A aba abre com uma frase, por exemplo “A qualidade do número está alta, e ele pode abrir até 1.000 conversas por dia.” Com mais de um número, a frase diz quantos estão com qualidade baixa ou média, e cada número vem na sua própria seção. Os códigos da Meta aparecem traduzidos:
| Indicador | O que informa |
|---|---|
| Nome verificado / Número | Identidade do canal na Meta |
| Qualidade | Alta, Média ou Baixa (na Meta, GREEN, YELLOW e RED) |
| Limite de envio | Quantas conversas você pode iniciar por dia (250 / 1.000 / 10.000 / 100.000 / sem limite) |
| Vazão de envio | Capacidade de mensagens por segundo (Padrão ou Alta) |
| Nome de exibição | Aprovado / Em revisão / Recusado / Expirado |
| Verificação por código / Plataforma | Detalhes de conformidade do número |
Quando a qualidade cai, um aviso aparece acima das linhas: âmbar na qualidade média, vermelho na baixa, com o que fazer.
Se a consulta à Meta falhar, a tela diz o motivo numa frase: token recusado (gere um novo e salve em Credenciais), token sem permissão para ler a saúde, ou falha momentânea. Havendo aviso guardado do webhook, ela mostra Qualidade no último aviso e Limite de envio no último aviso.
Qualidade baixa derruba o seu limite diário. A qualidade (alta, média ou baixa) 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.
Custo por mensagem (desde 01/10/2026)
A partir de 01/10/2026 a Meta cobra cada mensagem de serviço entregue, inclusive as respostas de atendimento, que antes eram grátis dentro da janela de 24h. A cobrança é feita pela Meta, na conta de negócios do seu provedor. Não é uma cobrança da ConectaAI.
A aba Consumo e custo (dentro de WhatsApp Cloud API) mostra a estimativa dessa fatura. Ela abre com uma frase com o custo do mês até agora e a projeção até o fim dele. Abaixo vêm os números do mês (mensagens cobradas, custo por conversa, custo por mensagem e o mês anterior), dicas de como gastar menos, quem gerou o custo (agentes de IA, atendentes ou campanhas e avisos), o custo por tipo de mensagem e por número, e as conversas mais caras do mês. Um resumo da mesma informação também aparece como uma faixa na página inicial do painel.
A tabela oficial da Meta para o Brasil, sempre calculada em reais (valores vigentes em 01/10/2026; a Meta pode mudá-los; a aba Consumo e custo usa sempre a tabela que o sistema tem em vigor):
| Categoria | Preço por mensagem entregue |
|---|---|
| Atendimento (resposta dentro da janela) | R$ 0,035 |
| Utility (template de utilidade) | R$ 0,035 |
| Authentication (template de código) | R$ 0,035 |
| Marketing (template de promoção) | R$ 0,3217, cerca de 9× mais caro |
Mensagens que o cliente manda nunca são cobradas, e a mensagem só enviada (não entregue) não entra na conta.
“Confirmado pela Meta” vs “estimativa”. Toda madrugada o sistema confere o valor estimado contra o custo oficial que a própria Meta informa para os últimos dias. Quando a conferência funciona, a frase do topo diz “conferida com a Meta até [dia]”. No fim da aba, o bloco Conferência com a Meta mostra cada conta de negócios: Conferida até [dia], Sem permissão de leitura, Falhou na última leitura ou Ainda não conferida, com uma barra âmbar nas duas que pedem ação. Algumas contas não deixam o token ler esse dado da Meta (falta a permissão whatsapp_business_management); nelas o valor fica sempre como estimativa.
Como reduzir o custo: prefira templates UTILITY a MARKETING sempre que der (aprovam mais rápido e custam ~9× menos). Veja Templates HSM. A própria aba de consumo mostra dicas de economia calculadas em cima do seu uso.
Veja também
- Templates HSM
- Atendimento: onde as conversas acontecem
- Campanhas: disparos proativos com template
- Status e diagnóstico