API do WhatsApp: Tipos, Acesso, Preços e Limites
Vincular uma conta do WhatsApp existente
const conta = await cliente.conta.conectarWhatsapp();
// account.qrCodeString -> mostrar para o usuário
// ou passe um pairing_phone_number em vez disso
const bate-papos = await cliente.chats.list({
account_type: 'WHATSAPP'
});
O que é a API do WhatsApp?
| Nome | O que é | Quem o opera | Requisitos de acesso |
|---|---|---|---|
| Plataforma do WhatsApp Business (API de Nuvem) | API oficial da própria Meta para provisionar novos números de telefone comerciais e enviar mensagens de modelo em escala | Meta | Aplicativo de desenvolvedor da Meta, WABA, número de telefone comercial, verificação para níveis superiores |
| Acesso de Provedor de Soluções de Negócios (BSP) | Um terceiro (Twilio, 360dialog e similares) revendendo a mesma API Cloud, integrada ao seu próprio painel e faturamento | Infraestrutura da Meta, gerenciada por BSP | Mesmos requisitos subjacentes da Meta, provisionados por meio do BSP |
| API de sessão unificada (Unipile) | Conecta uma conta do WhatsApp, comercial ou pessoal, da mesma forma que o WhatsApp Web faz, por código QR ou código de pareamento | Unipile, em nome do usuário autenticado | Sem verificação no Meta Business, sem novo número, sem aprovação de modelo |
Quais são os diferentes tipos de API do WhatsApp?
| Tipo | Provisionamento | Melhor para | Funciona com uma conta existente |
|---|---|---|---|
| API de nuvem | Novo número de telefone comercial + Verificação do Meta Business para maior volume | Empresas que enviam marketing ou notificações em alto volume em escala | Não, requer um novo número |
| API On-Premise | Descontinuado. A Meta o desativou e incentivou a migração para a Cloud API | Apenas integrações legadas | Não |
| Aplicativo WhatsApp Business | Aplicativo gratuito para o consumidor, configuração manual em um dispositivo | Pequenas empresas gerenciando conversas manualmente | Sim, mas manualmente, um dispositivo por vez, não programaticamente |
| API de sessão unificada (Unipile) | Vincula a conta do mesmo jeito que o WhatsApp Web, sem número novo | Plataformas SaaS incorporando a conta de WhatsApp de cada próprio usuário no produto | Sim, este é o caso de uso principal |
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.