Migrar da Twilio para a WAME API: o que muda na prática

Migrar o WhatsApp da Twilio para outra API significa transferir a titularidade do número entre provedores (BSPs) dentro da própria plataforma da Meta — o número e a conta verificada continuam os mesmos, o que muda é quem processa o tráfego e cobra por ele. O motivo mais comum para essa troca é custo: a Twilio soma sua própria tarifa por mensagem em cima da cobrança da Meta, que numa API dedicada ao WhatsApp costuma ser mais enxuta.

O que de fato migra — e o que não migra

Migra: o número de telefone, a conta comercial verificada (WABA) e, na maioria dos casos, os templates já aprovados — porque tudo isso pertence à Meta, não à Twilio. A Twilio é a intermediária técnica, não a dona da conta.

Não migra automaticamente: o histórico de conversas armazenado dentro da Twilio (Conversations API, logs), qualquer automação ou Function/Studio Flow construída na plataforma deles, e integrações que dependem especificamente do formato de webhook da Twilio.

Isso significa que a migração é, na prática, duas coisas separadas: um processo formal na Meta (transferência de provedor) e um trabalho de engenharia seu (reescrever a integração para o formato do novo provedor).

Por que sair da Twilio

Três motivos aparecem com mais frequência em quem migra:

Custo em camada dupla. A Twilio cobra sua própria tarifa por mensagem, além da cobrança da Meta por template. Numa operação de volume, essa camada extra soma rápido. Uma API dedicada ao WhatsApp, com plano fixo ou tarifa mais direta, tende a reduzir esse custo — veja como funciona a cobrança oficial da Meta em quanto custa a API oficial do WhatsApp.

API genérica versus API dedicada. A Twilio nasceu para SMS e voz, e o WhatsApp entrou como mais um canal dentro de uma API multicanal. Isso trouxe abstrações (Conversations, Messaging Service) que não existem quando você usa uma API pensada só para WhatsApp — o que simplifica a integração para quem só precisa de WhatsApp.

Suporte e documentação em português. Para operação no Brasil, ter suporte no fuso e no idioma certos reduz o tempo de resolução de problema em produção — um fator que pesa mais do que parece quando um webhook para de chegar às 2h da manhã.

Os passos da migração

1. Confirme o status atual da WABA no Gerenciador do WhatsApp Business — número, Tier de qualidade e templates aprovados.
2. Crie a instância no novo provedor apontando para o mesmo número. No caso da WAME, isso é feito por Embedded Signup, sem criar app na Meta nem virar Tech Provider.
3. Migre a titularidade da WABA pelo fluxo de transferência de BSP da própria Meta — é um processo formal, e o número fica indisponível por uma janela curta durante a troca.
4. Reaponte o webhook para o endpoint do novo provedor e reescreva os handlers no formato dele. É aqui que entra a maior parte do trabalho de engenharia.
5. Confirme os templates no novo painel antes do primeiro disparo em produção.
6. Desative a integração antiga só depois de confirmar que o tráfego novo está estável.

O que muda no código

A Twilio usa seu próprio formato de payload (MessagingResponse, TwiML, ou o formato de mensagem da Conversations API, dependendo de qual produto você usava). Uma API dedicada ao WhatsApp costuma expor REST direto, sem essa camada intermediária:

// Antes: Twilio (formato de mensagem da API de Programmable Messaging)
await client.messages.create({
  from: "whatsapp:+14155238886",
  to: "whatsapp:+5566996852025",
  body: "Olá!",
});

// Depois: API dedicada ao WhatsApp (REST direto)
await fetch(`https://us.api-wa.me/${key}/message/text`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ to: "5566996852025", text: "Olá!" }),
});

O webhook de entrada também muda de formato. Vale reescrever o parser do zero em vez de tentar adaptar o payload da Twilio para o formato novo — são estruturas diferentes o suficiente para que a tradução gere mais bug do que economiza tempo. O formato de entrada de uma API baseada no padrão oficial da Meta está detalhado em webhook para WhatsApp, Instagram e Messenger: o padrão Meta na prática.

Conclusão

A parte que trava a decisão costuma ser o medo de perder o número — e essa parte é a mais simples: o número, a verificação e o histórico de qualidade pertencem à Meta, não à Twilio, e seguem com você. O trabalho real está em reescrever a integração para o formato do novo provedor, o que é um projeto de dias, não de meses. Se você está avaliando o próximo passo, o comparativo entre API oficial e não oficial ajuda a decidir se vale manter a Cloud API oficial ou considerar as duas opções na mesma plataforma.