WhatsApp API: Types, Access, Preços and Limits
// Link an existing WhatsApp account
const account = await cliente.conta.connectWhatsapp();
// account.qrCodeString -> show to the user
// or pass a pairing_phone_number instead
const bate-papos = await cliente.chats.list({
account_type: 'WHATSAPP'
});
O que é a API do WhatsApp?
| Nome | O que é | Who operates it | Access requirements |
|---|---|---|---|
| WhatsApp Business Platform (Cloud API) | Meta's own official API for provisioning new business phone numbers and sending template messages at scale | Meta | Meta developer app, WABA, business phone number, verification for higher tiers |
| Business Solution Provider (BSP) access | A third party (Twilio, 360dialog and similar) reselling the same Cloud API, wrapped in its own dashboard and billing | Meta infrastructure, BSP-managed | Same underlying Meta requirements, provisioned through the BSP |
| Unified session API (Unipile) | Connects a WhatsApp account, business or personal, the way WhatsApp Web does, by QR code or pairing code | Unipile, on behalf of the authenticated user | No Meta Business verification, no new number, no template approval |
What are the different types of WhatsApp API?
| Tipo | Provisioning | Melhor para | Works with an existing account |
|---|---|---|---|
| API de nuvem | New business phone number + Meta Business verification for higher volume | Companies sending high-volume marketing or notifications at scale | No, requires a new number |
| On-Premise API | Deprecated. Meta retired it and pushed migration to the Cloud API | Legacy integrations only | Não |
| Aplicativo WhatsApp Business | Free consumer-facing app, manual setup on one device | Small businesses managing chats by hand | Yes, but manually, one device, not programmatic |
| Unified session API (Unipile) | Links the account the way WhatsApp Web does, no new number | SaaS platforms embedding each user's own WhatsApp account in-product | Yes, this is the primary use case |
Ecossistema da API do WhatsApp
A Meta oferece duas APIs oficiais que permitem às empresas integrar o WhatsApp em seus softwares. Ambas são projetadas para viabilizar mensagens de alto volume, com recursos como mensagens pré-aprovadas, compartilhamento de mídia e ferramentas de suporte ao cliente.
API do WhatsApp Business
A Business API foi a primeira solução lançada pela Meta para ajudar as empresas a interagir com seus clientes no WhatsApp. Normalmente, ela é auto-hospedada ou gerenciada por um provedor aprovado, dando às empresas mais controle sobre a infraestrutura. Ela é compatível com modelos de mensagens de saída, respostas de clientes e formatos de mídia avançada, o que a torna adequada para empresas que precisam integrar o WhatsApp diretamente ao seu CRM, contact center ou sistema de suporte.
WhatsApp Cloud API
Lançada posteriormente, a API em nuvem é totalmente hospedada pela Meta. Ela elimina a necessidade de as empresas gerenciarem servidores ou lidarem com infraestrutura pesada. A API em nuvem oferece funcionalidades básicas semelhantes, como envio e recebimento de mensagens, gerenciamento de modelos e suporte a mídia, além de ser mais fácil de implantar para os desenvolvedores. Ela é posicionada como uma maneira mais rápida de acessar o WhatsApp programaticamente, especialmente para empresas que desejam escalabilidade sem a sobrecarga da hospedagem local.
A complexidade da integração do WhatsApp
Embora as APIs de Negócios e de Nuvem da Meta ofereçam recursos poderosos, sua integração está longe de ser simples. Os desenvolvedores precisam gerenciar a verificação de negócios, aprovações de modelos e cotas de mensagens antes mesmo de entrarem no ar. O hospedagem ou a conexão com a API de Nuvem também exige o manuseio de webhooks, criptografia e conformidade com regras rigorosas de opt-in. Esses obstáculos frequentemente atrasam projetos e limitam o acesso de provedores de SaaS menores que desejam adicionar o WhatsApp rapidamente às suas plataformas.