Migrar do seu BSP da API oficial para a WAME sem reescrever a integração

Dá para sair do seu BSP da API oficial e ir para a WAME (api-wa.me) sem reescrever a integração, por dois caminhos: continuar na API oficial com a WAME, que é Meta Business Partner e Tech Provider, ou mover o atendimento para a API não oficial, cobrada por plano fixo por instância. Nos dois casos o envio usa o corpo da WhatsApp Cloud API e o webhook chega no envelope da Meta — se o seu sistema já fala esse formato, a troca é de URL e autenticação.

A busca por "trocar de BSP" cresceu com a nova cobrança da Meta: a partir de 1º de outubro de 2026, toda mensagem de serviço pela API oficial passa a ser cobrada, desde a primeira, sem faixa grátis (o que muda em outubro). Antes de migrar, vale entender uma coisa que muita gente confunde: trocar de BSP, por si só, não muda a tarifa da Meta.

O que é um BSP e por que trocar?

BSP (Business Solution Provider) é o parceiro da Meta que dá acesso à Cloud API: cuida da conta, do número e, em muitos casos, repassa a cobrança com uma margem. 360dialog, Gupshup e Twilio são exemplos de empresas nesse papel; não comparamos preços nem recursos deles aqui.

Os motivos para trocar costumam ser três:

• Custo: margem do provedor somada à tarifa da Meta, que ficou maior em outubro.
• Formato: alguns provedores têm API própria, o que prende o seu código a eles.
• Recursos: grupos, status, ligações e texto livre a qualquer hora não existem do mesmo jeito na Cloud API.

Quais são os dois caminhos?

Os dois caminhos não se excluem: é comum levar o número de templates para o caminho A e abrir um número de atendimento no caminho B — o modelo híbrido.

Caminho A: continuar na oficial, com a WAME

A WAME é parceira oficial da Meta e conecta números na Cloud API sem você criar app na Meta nem virar Tech Provider (como funciona). O que você ganha ao vir para cá, mesmo continuando oficial:

• Um formato para tudo: o mesmo POST /{key}/message serve para a instância oficial e para uma não oficial que você venha a abrir.
• Webhook único no padrão Meta, com os campos instance e official para saber de onde veio cada evento.
• Opção de híbrido sem trocar de fornecedor de novo.

O que não muda no caminho A: as tarifas da Meta, incluindo a cobrança de mensagem de serviço. A migração de um número oficial entre provedores segue o processo da própria Meta; o suporte da WAME acompanha esse passo.

Caminho B: mover o atendimento para a não oficial

Este é o caminho que tira a conversa da cobrança por mensagem. O atendimento passa a rodar numa instância não oficial — o número conectado como aparelho, igual ao WhatsApp Web —, cobrada por plano fixo.

O número pode ser o mesmo (removido da Cloud API e ativado no app) ou um novo. Os passos e ressalvas estão em dá para usar o mesmo número ao sair da Cloud API?.

A honestidade necessária: a camada não oficial não é afiliada à Meta. Para atendimento — responder quem fala com você —, o risco de bloqueio é muito baixo para quem usa do jeito certo. A WAME não apoia spam e a API freia envio para muitos números novos por minuto e texto repetido em massa. Mais em riscos de trocar a oficial pela não oficial.

Quanto do código muda?

Depende do formato que o seu BSP usa hoje.

Se o seu provedor usa o formato da Cloud API (corpo com messaging_product, resposta com messages[].id, webhook com entry[].changes[].value), a troca é pequena:

- POST https://SEU-BSP/.../messages
- Authorization: Bearer TOKEN_DO_BSP
+ POST https://us.api-wa.me/SUA_KEY/message
  Content-Type: application/json

  {
    "messaging_product": "whatsapp",
    "to": "5511999999999",
    "type": "text",
    "text": { "body": "Seu pedido foi aprovado." }
  }

A resposta continua no mesmo formato:

{
  "messaging_product": "whatsapp",
  "contacts": [{ "input": "5511999999999", "wa_id": "5511999999999" }],
  "messages": [{ "id": "3EB0..." }]
}

E o webhook, configurado com webhookFormat: "meta", chega no envelope da Cloud API, com metadata.phone_number_id preenchido com a key da instância — útil para quem já roteia por esse campo.

Se o seu provedor usa formato próprio, a camada de mensagens é reescrita uma vez, para o padrão da Meta. Daí em diante, trocar de lado (oficial ou não oficial) não exige mais reescrita. A Twilio é o caso mais comum; o passo a passo está em migrar da Twilio para a WAME.

O que muda além da URL?

Mesmo no formato Meta, alguns detalhes são diferentes na instância não oficial:

A lista completa, item por item, está em trocar graph.facebook.com pela WAME: checklist.

Como migrar sem parar o atendimento?

1. Crie a instância na WAME (oficial, não oficial ou as duas) e configure o webhook com webhookFormat: "meta".
2. Coloque a URL base e a autenticação em variáveis de ambiente, para trocar de provedor sem deploy de código.
3. Teste com um número secundário antes de mexer no principal.
4. Mova o número — pelo processo da Meta (caminho A) ou removendo da Cloud API e conectando no app (caminho B).
5. Acompanhe status e erros nas primeiras horas: statuses com failed trazem errors[], como na Cloud API.

O roteiro de migração com os dois sistemas rodando lado a lado está em migrar o WhatsApp em paralelo, sem risco.

Em resumo

• Trocar de BSP não muda a tarifa da Meta; mover o atendimento para a não oficial muda.
• Caminho A: continuar oficial pela WAME, parceira da Meta, com opção de híbrido.
• Caminho B: atendimento na não oficial, com plano fixo por instância.
• Se o seu provedor já usa o formato da Cloud API, a troca é de URL e autenticação.
• Se usa formato próprio, reescreva uma vez para o padrão Meta e nunca mais.

Conclusão

Migrar de BSP virou pauta por causa da cobrança de outubro, mas a decisão certa começa separando duas perguntas: onde o número fica e quem cobra por mensagem. Na WAME você pode continuar na API oficial, com uma parceira da Meta, ou tirar o atendimento da cobrança por mensagem com a API não oficial — e combinar os dois. Em qualquer caso, o envio e o webhook seguem o padrão da Meta, então a integração que você já tem continua valendo. Para comparar os formatos lado a lado, veja um código só para a API oficial e a não oficial e a documentação.