Sua integração com a Cloud API continua funcionando na WAME? O que aproveitar

Sim: a maior parte de uma integração feita para a WhatsApp Cloud API continua funcionando na WAME (api-wa.me), porque o endpoint POST /{key}/message aceita o mesmo corpo da Meta, devolve o mesmo envelope de resposta, e o webhook no formato meta segue o envelope da Cloud API. O que muda é pouco e previsível: URL base, autenticação, mídia por link e templates. Este guia separa o que você aproveita, o que ajusta e o que fazer quando a ferramenta não deixa trocar nada.

Com a Meta cobrando cada mensagem de serviço a partir de 1º de outubro de 2026 (detalhes em o que muda na cobrança da Meta), muita gente quer sair da cobrança por mensagem sem jogar fora o sistema. É exatamente para isso que o formato compatível existe.

A camada não oficial da WAME não é afiliada, endossada ou suportada pela Meta ou pelo WhatsApp. O uso é de responsabilidade de quem envia.

O que da sua integração funciona sem mudança?

Quase toda a lógica de negócio. O motivo é simples: o sistema conversa com o formato, e o formato é o mesmo.

Os parsers de webhook que você escreveu, as tabelas que guardam wa_id e messages[].id, a máquina de estados do bot e o tratamento de status continuam como estão. O guia completo desse formato está em um código só para a API oficial e a não oficial.

O que precisa de ajuste no código próprio?

Cinco pontos, todos localizados:

1. URL base e autenticação. Na Cloud API você chama https://graph.facebook.com/vXX.X/{phone-number-id}/messages com token Bearer. Na WAME, a instância é identificada pela key na URL:

// Antes (Cloud API)
const URL = `https://graph.facebook.com/v20.0/${PHONE_NUMBER_ID}/messages`;
const headers = { Authorization: `Bearer ${TOKEN}`, 'Content-Type': 'application/json' };

// Depois (WAME)
const URL = `https://us.api-wa.me/${WAME_KEY}/message`;
const headers = { 'Content-Type': 'application/json' };

// O corpo não muda
await fetch(URL, { method: 'POST', headers, body: JSON.stringify(corpoDaCloudApi) });

Se você usa camada de token opcional da WAME, o token entra como cabeçalho. Veja em segurança da API: token e webhook.

2. Mídia enviada por id. Se o seu código sobe a mídia para a Meta e envia pelo id, troque para link (URL pública do arquivo). Mídia por id não é aceita no envio pelo formato compatível.

3. Mídia recebida. Na Cloud API, o webhook traz um id e você busca a URL no Graph. Na WAME, o webhook já traz url apontando para https://us.api-wa.me/{key}/message/{id}/media. Troque a função de download; o resto do fluxo continua. Detalhes em mídia no webhook: receber e baixar.

4. Templates. Na instância não oficial, não existe template nem janela de 24h: você manda texto livre. O código que escolhia template fora da janela vira um envio de texto comum. Se você mantém uma instância oficial para notificação em massa, ali o template continua. Mais sobre isso em API sem template e sem janela de 24h.

5. Assinatura do webhook. A instância não oficial não envia X-Hub-Signature. Proteja o endpoint com token secreto no caminho da URL e idempotência pelo id da mensagem, como em webhook em produção.

E se eu uso uma biblioteca que monta o corpo da Cloud API?

Bibliotecas que só montam o JSON no formato da Meta continuam úteis: o corpo que elas produzem é o que a WAME aceita. O que você troca é a camada de transporte — o fetch, axios ou cliente HTTP que envia para o Graph.

Na prática, isole isso numa função:

async function enviarWhatsApp(corpo) {
  const r = await fetch(`https://us.api-wa.me/${process.env.WAME_KEY}/message`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify(corpo),
  });
  const json = await r.json();
  if (json.error) throw new Error(`${json.error.code}: ${json.error.message}`);
  return json.messages?.[0]?.id; // mesmo campo da Cloud API
}

Bibliotecas que também gerenciam credenciais da Meta, upload de mídia no Graph ou templates precisam de mais cuidado: essas partes não se aplicam à instância não oficial.

Meu CRM ou SaaS tem conector para a Cloud API. Funciona?

A resposta honesta: depende de quanto o conector deixa você configurar.

Não dá para afirmar que um produto específico aceita ou não — cada conector decide o que expõe. Antes de migrar tudo, conecte uma instância de teste e mande uma mensagem de ponta a ponta.

Se a ferramenta não deixa trocar a URL, qual é o atalho?

Use o que a WAME já tem pronto, sem depender do conector da Meta:

• Chatwoot: integração nativa, com criação automática das caixas de entrada. Passo a passo em integrar a WAME com o Chatwoot.
• n8n: template pronto de bot com IA para WhatsApp, Instagram e Messenger em bot de IA com n8n.
• Agentes de IA: servidor MCP para Claude, Cursor e n8n em MCP na prática.
• SDKs: JavaScript/TypeScript e PHP em SDK JavaScript e TypeScript e SDK PHP.

Se você é a software house que mantém o CRM, a página WhatsApp API para CRM e SaaS mostra como plugar a WAME no produto.

Como validar a migração antes de desligar a Cloud API?

Rode em paralelo por alguns dias:

1. Crie uma instância na WAME e ative o webhook com webhookFormat: "meta" (ou "both", para receber também o formato nativo).
2. Aponte o webhook para uma URL de homologação do seu sistema.
3. Troque só a função de envio numa rota de teste.
4. Compare o que chega: mensagens, status, respostas de botão, mídia.
5. Quando estiver igual, mude a rota de produção.

O roteiro completo, com rollback, está em migrar em paralelo sem risco, e o checklist linha a linha em trocar o Graph pela WAME.

Em resumo

• O corpo de envio, a resposta e o envelope do webhook são os da Cloud API.
• Você troca URL base, autenticação, mídia por link e download de mídia.
• Na instância não oficial, template vira texto livre e o webhook se protege por URL secreta.
• Conector de terceiros funciona se deixar configurar URL e webhook; senão, use Chatwoot, n8n, MCP ou SDK.
• Valide em paralelo antes de desligar a Cloud API.

Conclusão

Sair da Cloud API não precisa significar reescrever o sistema. Na WAME, o formato de envio, a resposta e o webhook seguem o padrão da Meta, então a lógica de negócio fica onde está e o trabalho se concentra em poucos pontos: URL, autenticação, mídia e templates. Para quem quer fugir da cobrança por mensagem de serviço de outubro de 2026, é a migração de menor atrito disponível — e como a WAME oferece oficial e não oficial na mesma plataforma, dá para mover o volume aos poucos. Compare os caminhos em alternativa à API oficial depois de outubro e veja os endpoints na documentação.