Quase todo resultado de API oficial do WhatsApp te manda o mesmo canteiro: app na Meta for Developers, webhook GET pra challenge, webhook POST pra mensagem, n8n no meio. Dá pra montar. Também dá pra publicar o agente no canal oficial, sem esse webhook, e deixar a conversa cair no CRM.
O que é a API oficial do WhatsApp para agente de IA
A API oficial do WhatsApp (Cloud API da Meta) é o canal que a própria Meta trata como automatizado. Para um agente de IA, isso significa publicar no WhatsApp Official: o número da empresa recebe e envia pelo caminho sancionado, com janela de 24 horas e template quando a janela fecha. Na Zaia esse canal existe ao lado do Waha. A escolha é na hora de publicar, não um projeto de webhook.
O cliente fala com o número que já conhece. O agente responde. Se o caso pede gente, o humano entra pelo CRM. Você não sobe um servidor só pra devolver o hub.challenge da Meta.
Webhook no n8n vs canal Official nativo
O tema não falta conteúdo. Falta o texto que começa do agente pronto, não do app na Meta.
| n8n + Cloud API (webhook) | Agente no WhatsApp Official | |
|---|---|---|
| Quem recebe a mensagem | Seu webhook (GET de verify + POST de evento) | O canal Official do workspace |
| Quem responde | Nó de HTTP pra graph.facebook.com |
O agente publicado no canal |
| Timeout da Meta | Você trata o HTTP 200 em segundos, senão o webhook cai | A plataforma opera o canal |
| Template / janela de 24h | Você monta o envio e a aprovação | Regra da Meta no canal oficial; Follow Up e Message Sending entram quando o fio pede |
| Humano no loop | Slack ou Chatwoot colado, se você montou | CRM nativo: ticket, takeover, histórico |
| Quando quebra | Editar o fluxo é editar a produção | Draft → teste → publicar → rollback |
| Cliente novo | Cópia do app, do token e do fluxo | Workspace, o mesmo agente, outro número Official |
O caminho n8n funciona para um número só, num fim de semana. O teto é o de criar agente de IA para WhatsApp com n8n: cada cliente novo é uma cópia, o token mora solto, e não há versão para voltar atrás. Official no meio dessa stack herda o teto.
Waha continua sendo o atalho de MVP: QR, número que você aceita perder, sem verificação de empresa. Este artigo é o outro lado da mesma escolha. Não redefine o Waha. Responde quem busca a API oficial porque o número já não é descartável.
O que isso não é: tutorial de App Review, nem tabela de preço por conversa da Meta. A Cloud API cobra do lado da Meta. A Zaia não republica essa tabela. Também não é disparo em massa. Template aprovado existe para mensagem proativa dentro da regra da Meta, não para furar spam.
O job concreto: o número que não pode cair
Ninguém acorda pensando “preciso verificar o webhook”. O pedido é este:
O agente já atende no WhatsApp. O número é o da clínica. Um banimento apaga o histórico que o paciente conhece. O tutorial do sábado usou QR. Na segunda a coordenação pergunta se aquilo é oficial.
Três saídas honestas. Nenhuma promete selo verde no dia:
- Ainda é teste. Um cliente, número que você aceita perder. Waha é a escolha certa. Official só atrasa.
- O número já carrega relacionamento. Migra o mesmo agente para WhatsApp Official. Knowledge, Tables e CRM continuam. Muda o canal.
- A janela de 24h fechou. Mensagem proativa pede template aprovado pela Meta. Follow-up automático e Message Sending entram aqui. Fora da janela, o agente não “manda do mesmo jeito que no QR”.
A regra mora na operação, não no nó. Official não apaga a necessidade de handoff. Reclamação, exceção, “fala com a doutora”: ticket, Attendant, o agente para.
O agente não substitui 100% da recepção. Official também não. O canal oficial reduz o risco de sessão de WhatsApp Web. Não reduz a obrigação de ter humano no loop.
Como publicar o agente na API oficial sem montar webhook
- Descreva o caso em português e crie o agente. O Vibe Agent monta a configuração inicial. O canal vem depois.
- Valide o ofício num número que você aceita perder, se ainda estiver em MVP. Waha existe para isso. Não comece o Official para “ver se o agente responde convênio”.
- Quando o número for o da operação, conecte o canal WhatsApp Official no workspace. A credencial fica em Connections, não num token colado no n8n.
- Publique o mesmo agente nesse canal. Teste com o seu número. Confira se a conversa aparece no History.
- Carregue a regra em Knowledge ou Tables. Sem isso, o canal oficial só entrega um agente que improvisa com mais estabilidade.
- Ligue o CRM. Pedido fora da política, paciente irritado, janela fechada sem template: ticket, não um segundo webhook.
- Versionar. Trocar o prompt não vai para produção no escuro. Se o agente errar o tom no número oficial, rollback.
Não trate Workflows como o motor estável deste canal. Workflows na Zaia são beta. O caminho shipped é agente + WhatsApp Official + CRM.
Não prometa aprovação de Business Manager em prazo, selo verificado, custo zero da Meta, nem “Official sem template”. Janela de 24h e template são da Cloud API, não de uma configuração escondida.
O mesmo agente pode estar no Instagram e no widget do site. Official resolve o WhatsApp da empresa. Não unifica inbox de e-mail. O CRM padrão é Tickets + History.
Quando isso vira oferta pra agência
Agência que já faz o site da clínica sente o teto: o agente no QR funciona na demo e assusta na hora de colocar o número que está no Instagram. O cliente final reconhece valor quando o canal é o da empresa, não quando recebe a arquitetura do webhook.
Empacotar “agente no WhatsApp oficial” pede o canal Official + o mesmo ofício + fila humana, não um especialista em Graph API por cliente. Exemplo de precificação pro cliente final: agentes que valem a partir de R$1.500/mês. O piso da plataforma é 7 dias de trial, depois a partir de R$150. O roteiro de como vender isso pra base que a agência já tem está no Programa de Aceleração.
Perguntas frequentes
O que é a API oficial do WhatsApp para um agente de IA?
É o canal Cloud API da Meta no número da empresa. Na Zaia o agente publica em WhatsApp Official, a conversa cai no CRM, e template entra quando a janela de 24h fecha. Sem webhook GET/POST no n8n.
Preciso de n8n para usar a API oficial?
Não. Na Zaia o Official é canal do workspace. n8n com webhook da Cloud API continua válido. Não é requisito.
Qual a diferença para o Waha?
Waha opera WhatsApp Web via QR, sem a Meta reconhecer o canal. Official é a API de empresas. Os dois existem. A escolha é se o número ainda é descartável. O detalhe do risco está em Waha WhatsApp.
A Zaia cobra o preço da conversa da Meta?
Não. A Cloud API tem cobrança do lado da Meta. A Zaia não republica essa tabela. O piso da plataforma é 7 dias de trial, depois a partir de R$150, à parte.
Como começar
API oficial do WhatsApp mora no canal, não no app da Meta for Developers: Vibe Agent pra criar o ofício, teste no número descartável se ainda for MVP, Official quando o número for o da clínica, CRM no mesmo workspace. Descreva a secretária, publique, mande um “vocês atendem no sábado?” de teste.
Começar agora — 7 dias de trial. Depois a partir de R$150.