API do WhatsApp para agentes de IA: acesso oficial em minutos, sem se tornar Tech Provider
Um agente de IA obtém acesso oficial ao WhatsApp pela Cloud API da Meta, e um número que continua no app do WhatsApp Business entra nela por meio de um Tech Provider ou Solution Partner. Você pode se tornar um, com verificação da empresa, vídeos para o App Review e uma implementação do Embedded Signup, ou conectar o número por um provedor que já tem esse status: o número entra em minutos e o agente recebe ferramentas MCP ou credenciais de API.
O easyCoexistence é um Tech Provider independente da Meta: conecta um número do WhatsApp Business à Cloud API pela Coexistência em minutos, para que o seu agente tenha acesso oficial enquanto a empresa continua usando o app.
O que a Meta exige de quem conecta um número que continua no app do WhatsApp Business: status de Tech Provider ou Solution Partner.
O App Review pede um vídeo de uma mensagem enviada pelo seu app e outro do seu app criando um template.
O que o App Review concede às permissões whatsapp_business_messaging e whatsapp_business_management, ambas exigidas para se tornar Tech Provider.
Quando a Meta descontinuou as versões v2 e v3 do Embedded Signup, orientando as integrações a migrar para a v4.
Throughput fixo de um número usado ao mesmo tempo no app do WhatsApp Business e na Cloud API.
Por quanto tempo um link de conexão hospedado fica válido quando uma plataforma conecta o número de um cliente pela Partner API.
Do que um agente de IA precisa para usar o WhatsApp oficialmente?
Quatro coisas da Cloud API da Meta. Um phone number ID e um access token com a permissão whatsapp_business_messaging, para que o agente chame o endpoint de mensagens. Um endpoint de webhook onde a Meta entrega as mensagens recebidas e, em um número compartilhado com o app, também os smb_message_echoes, com as respostas que uma pessoa digita no celular. Templates aprovados, porque uma mensagem digitada só chega a quem escreveu nas últimas 24 horas. E uma forma de saber quando a conexão cai, já que o app no celular continua funcionando quando o lado da API para.
O atalho que as pessoas encontram primeiro é automatizar o WhatsApp Web, que entra como dispositivo vinculado. Isso viola os termos do WhatsApp e coloca o número em risco de banimento, seja qual for o agente que roda por cima.
O que envolve a rota para se tornar Tech Provider?
A sequência definida pela própria Meta, nesta ordem. Todas as etapas são gratuitas, e nenhuma pode ser acelerada pagando: as análises seguem o cronograma da Meta, que não divulga prazos, então conte com semanas, e não dias, até conectar o número do primeiro cliente. Depois disso, o backend precisa continuar rodando: a troca de token após cada cadastro, um receptor de webhook, o roteamento por número e o monitoramento de desconexões, como a regra de inatividade de 14 dias da Meta.
Qual é o caminho mais curto?
Conectar o número por um provedor que já passou por esse processo. Com o easyCoexistence, a empresa faz o Embedded Signup da Meta e escaneia um código com o app do WhatsApp Business, o que leva cerca de dois minutos, e o número entra na Cloud API dentro do portfólio da própria empresa, enquanto o app continua funcionando. O agente então recebe acesso no formato que ele entende: ferramentas MCP para um assistente como ChatGPT, Claude, Claude Code ou Codex, ou as credenciais e os webhooks do número para o código que você roda.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Como o agente obtém as credenciais do número?
Pela ferramenta get_api_credentials ou pela página do número no painel. Ela retorna a URL base da Graph API, o WhatsApp Business Account ID, o phone number ID, o endpoint de envio e, quando existir, o access token da própria empresa, restrito aos ativos do WhatsApp dela. Quando nenhum token de cliente foi emitido, o token volta como null, com uma nota explicando que reconectar o número pelo painel emite um, sem substituir um token que já funciona. Não há app secret para buscar, porque a Meta assina os webhooks com o app secret do easyCoexistence, que nunca é compartilhado. A ferramenta exige um plano ativo, já que o token permite enviar mensagens.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'Como as mensagens recebidas chegam ao agente?
Cada número tem dois modos, que você alterna com set_inbound_mode ou na página do número. Direto para o seu servidor: set_webhook_destination aponta a Meta diretamente para o seu endpoint HTTPS, que precisa responder ao handshake GET da Meta, e o easyCoexistence nunca vê as mensagens, por isso as automações ficam desligadas. Como a Meta assina essas entregas com o nosso app secret, coloque um segredo longo e aleatório no caminho da URL e rejeite as requisições que vierem sem ele.
Automações ligadas: a Meta entrega ao easyCoexistence, as automações podem responder e uma Forward URL opcional recebe o payload original da Meta em "value", assinado com X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 de "<t>.<body>"> usando um segredo exibido uma única vez. A etapa Call my webhook de uma automação também entrega ao seu agente a mensagem e as últimas 10 mensagens do chat, e envia a resposta quando o seu servidor retorna {"reply": "..."} em até 20 segundos.
Quais limites o agente precisa respeitar?
Os da Meta, que são os mesmos em qualquer provedor. Um agente que os conhece de antemão evita falhas que parecem bugs:
- 20 mensagens por segundo por número, valor fixado pela Meta para números compartilhados com o app do WhatsApp Business.
- Mensagens digitadas só até 24 horas após a última mensagem do cliente; depois disso, só com um template aprovado.
- Templates saem apenas pela API, porque o app em um número com Coexistência não consegue enviá-los.
- Respostas que uma pessoa digita no app chegam como
smb_message_echoes; pause o agente naquele chat, senão o cliente recebe duas respostas. - Conversas em grupo não são sincronizadas com a API, então o agente atua em conversas individuais.
- Contatos e até 6 meses de conversas individuais são importados uma única vez, e só se um destino de webhook direto for salvo em até 24 horas após a conexão; um número com automações ligadas não recebe a importação.
- Chamadas de voz e vídeo continuam funcionando no app, mas a Cloud API não transporta chamadas em um número com Coexistência, então o agente atua só por texto.
Uma plataforma pode conectar os números dos próprios clientes dessa forma?
Sim, pela Partner API, que é como um SaaS ou uma agência faz o onboarding dos clientes sem ter status próprio de Tech Provider. Crie a chave com create_api_key (ela começa com ec_live_ e é exibida uma única vez) e depois chame POST /api/v1/connect-sessions a partir do seu backend, ou create_connect_link pelo assistente, para obter um link hospedado válido por 1 hora. Nele, o cliente passa pelo popup da Meta e pela leitura do QR code e volta para o seu redirect_url com um connection_id. Em seguida, GET /api/v1/connections/:id?credentials=1 retorna o token do próprio cliente, e eventos de status, como connection.disconnected, chegam assinados com X-EC-Signature. Cada número é cobrado na sua conta, pelas mesmas faixas por número.
Erros comuns
- Validar o X-Hub-Signature-256 em um destino direto. A Meta assina com o app secret do easyCoexistence, que nunca é compartilhado, então entregas legítimas falham na verificação; confie em um segredo longo e aleatório na URL ou use o encaminhamento com X-EC-Signature.
- Receber mensagens com o nó WhatsApp Trigger do n8n. Ele pressupõe um app da Meta seu; use o nó genérico Webhook, com um segredo na URL.
- Ignorar os smb_message_echoes. O agente acaba respondendo por cima de uma pessoa que já respondeu pelo celular, e o cliente recebe duas respostas.
- Salvar o destino de webhook direto dias depois da conexão, ou deixar o número com automações ligadas. A importação única que a Meta faz dos contatos e de até 6 meses de conversas exige um destino direto salvo em até 24 horas após a conexão.
O agente trabalha com mais de 30 ferramentas MCP ou com as credenciais e os webhooks de cada número, e todos os números são monitorados 24/7, com alertas. De R$ 29,90 a R$ 3,90 por número por mês, com o valor caindo conforme você adiciona números, e os primeiros 3 dias grátis.
O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.
Perguntas frequentes
Preciso ter meu próprio app na Meta?
Não. O número é conectado pelo app da Meta do easyCoexistence e permanece no portfólio e na WhatsApp Business Account da própria empresa. Seu código envia mensagens com o token da própria empresa, obtido em get_api_credentials, então nenhum app seu participa, a menos que você crie um depois.
O agente e a equipe podem usar o mesmo número ao mesmo tempo?
Sim. A Meta espelha as mensagens entre a Cloud API e o app do WhatsApp Business, então o que o agente envia aparece na conversa do app no celular, e o que a equipe digita no app chega ao seu sistema como smb_message_echoes.
Quais frameworks de agentes de IA funcionam com o easyCoexistence?
Qualquer cliente que use MCP via HTTP com OAuth, como ChatGPT, Claude, Claude Code, Codex e Cursor, e qualquer código que chame a Graph API da Meta: Node.js, Python, n8n, LangChain, o OpenAI Agents SDK ou o Vercel AI SDK. A API por baixo é a da própria Meta, então nada proprietário fica dentro do agente.
Assistentes de IA de uso geral são permitidos no WhatsApp?
Os Business Solution Terms da Meta, na seção 4.7, em vigor desde 15 de janeiro de 2026, proíbem provedores de assistentes de IA de uso geral de oferecê-los na WhatsApp Business Platform quando a IA é a funcionalidade principal, conforme critério da Meta. Uma empresa que usa IA com os próprios clientes, para atendimento, vendas ou agendamentos, não é o alvo, e reguladores da UE e do Brasil ordenaram que a Meta suspenda ou reverta a regra para assistentes concorrentes.
Continue lendo
Pronto para começar?
Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.
Começar teste grátisVerificado em