Como o WhatsApp funciona na Twilio hoje
Pelas páginas oficiais da Twilio, o modelo é este:
- API oficial. O envio usa a WhatsApp Business Platform da Meta. É preciso habilitar o WhatsApp num número Twilio, criando uma conta WhatsApp Business (WABA) ligada ao Meta Business Manager, e a documentação informa que só é permitida uma WABA por conta Twilio.
- Mesma API de mensagens. O WhatsApp passa pelo recurso de mensagens da Twilio, autenticado com Account SID e Auth Token, e os números usam o prefixo
whatsapp:seguido do formato E.164. - SDKs. Há bibliotecas para Node.js, Python, C#/.NET, Java, Go, PHP e Ruby, além de CLI.
- Status por callback. A Twilio chama uma URL sua a cada mudança de status da mensagem.
- Cobrança. Taxa por mensagem da Twilio mais a taxa por template da Meta, repassada ao cliente. O total depende da categoria da mensagem (utilidade, autenticação, marketing) e de a conversa estar ou não dentro da janela de 24 horas.
É um desenho sólido para quem já usa outros produtos da Twilio e quer tudo num lugar só. A procura por alternativa vem de necessidades específicas, listadas abaixo.
Três situações em que a Twilio deixa de encaixar
Você também precisa da conexão não oficial
A API oficial exige template aprovado para iniciar conversa e não conecta um WhatsApp já em uso pelo QR Code. Muitos produtos brasileiros precisam das duas coisas: oficial para notificações de clientes maiores, não oficial para quem quer conectar o número que já usa no dia a dia. Sem as duas no mesmo fornecedor, o time mantém duas integrações. As diferenças estão detalhadas em API oficial vs não oficial.
O custo por mensagem não fecha com o seu modelo
Se o seu SaaS cobra do cliente um valor fixo por mês, custo variável por mensagem corrói a margem de quem usa muito. Na conexão não oficial da D-API, a cobrança é por conexão, sem cobrança por mensagem, e o valor por conexão cai conforme a sua base cresce. Na oficial, a cobrança da Meta por template continua existindo, porque é definida por ela; na D-API ela fica com o cliente final, e a D-API cobra uma taxa de plataforma por conexão. Veja como isso se compara em quanto custa a API de WhatsApp.
Você quer atendimento no seu fuso e no seu idioma
A D-API é brasileira: documentação em português, servidores em solo brasileiro e um time que fala a mesma língua do seu. Para quem implementa, isso encurta a distância entre travar numa dúvida e voltar a codar.
Twilio e D-API lado a lado
| Critério | Twilio | D-API |
|---|---|---|
| API oficial (WhatsApp Business Platform) | Sim | Sim, sessão do tipo cloud_api |
| Conexão não oficial por QR Code | Verifique com o fornecedor | Sim, na mesma API |
| Cobrança | Por mensagem da Twilio mais taxa da Meta repassada | Por conexão; na oficial, a taxa da Meta fica com o cliente final |
| Autenticação | Account SID e Auth Token | API Key no header Authorization |
| SDKs | Node.js, Python, C#/.NET, Java, Go, PHP e Ruby | Node.js; REST com Swagger para as demais linguagens |
| Idioma do suporte | Verifique com o fornecedor | Português |
Em SDKs, a Twilio cobre mais linguagens. Se o seu backend não é Node.js, a integração com a D-API é por HTTP direto, o que costuma ser uma camada fina.
Guia de migração da Twilio para a D-API
Os conceitos se mapeiam assim:
| Na Twilio | Na D-API |
|---|---|
| Account SID e Auth Token | API Key no header Authorization |
Número remetente em From com prefixo whatsapp: | sessionId da conexão, criada com type cloud_api ou unofficial |
To com whatsapp: e formato E.164 | to só com dígitos, como 5511999999999 |
| Status Callback URL | Webhook da sessão, com eventos como message.delivered e message.read |
| Mensagem de template | POST /api/v1/messages/send/template com name, language e variáveis |
Com uma conexão oficial criada, o envio de template fica assim. Nome e variáveis do template são ilustrativos; use os que já estão aprovados na sua conta da Meta:
curl -X POST https://api.d-api.cloud/api/v1/messages/send/template \
-H "Authorization: SUA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"sessionId": "conexao-oficial",
"to": "5511999999999",
"template": {
"name": "pedido_confirmado",
"language": "pt_BR",
"bodyVariables": ["Maria", "#48213"]
}
}'Mensagens de texto livres, dentro da janela de atendimento, usam a mesma rota da não oficial: POST /api/v1/messages/send/text. Se amanhã um cliente preferir conectar por QR Code, você cria uma sessão unofficial e chama a mesma rota, sem novo código.
Ordem sugerida
- Crie uma conta de teste e conecte um número não oficial para validar envio e webhook.
- Troque a camada de envio do seu sistema para chamar a D-API, mantendo a Twilio como fallback.
- Adapte o receptor de callbacks para o envelope da D-API, com
eventedata. - Planeje a conexão oficial com a sua conta da Meta e confirme os templates que serão usados.
- Desligue a Twilio no WhatsApp quando o volume estiver todo passando pela D-API.
A D-API é uma API de WhatsApp brasileira que junta os dois mundos. Conheça a API oficial de WhatsApp e a API não oficial, ou compare com a alternativa à Z-API. O teste de 3 dias não pede cartão.