Resumo
A API do WhatsApp Business permite que empresas de médio e grande porte se comuniquem com os clientes em escala. As empresas podem integrar a API em seus sistemas para gerenciar interações com clientes automatizadas e humanas.
O WhatsApp Business API está disponível em duas opções de hospedagem:
API Cloud (hospedada pela Meta)
API On-Premises (auto-hospedada por empresas ou Prestadores de Soluções Empresariais (BSPs))
A escolha da opção certa depende das necessidades do seu negócio. Este guia descreve as diferenças entre a API Cloud e a API On-Premises, ajudando você a determinar qual é a melhor para o seu caso de uso.
Importante: Um número de telefone pode estar associado a apenas uma dessas APIs por vez. Você não pode usar o mesmo número em ambas as plataformas simultaneamente.
Instruções
Visão Geral da API Cloud
A API Cloud é hospedada pela Meta e permite que as empresas enviem mensagens por meio da Graph API. Ela usa webhooks para receber eventos, como mensagens recebidas e atualizações de status de entrega.
Principais Características:
Sem manutenção de servidores – A Meta gerencia hospedagem e infraestrutura.
Atualizações automáticas – As empresas sempre têm acesso às últimas funcionalidades e patches de segurança.
Através de mensagens mais alto – Suporte para até 500 mensagens por segundo (envio e recebimento combinados).
Autenticação simplificada – Usa User Access Tokens.
Custos de infraestrutura menores – As empresas pagam apenas pelas mensagens enviadas.
Para saber mais, consulte a documentação de desenvolvimento da Graph API.
Visão Geral da API On-Premises
A API On-Premises exige que as empresas ou BSPs hospedem e mantenham o software da API do WhatsApp em seus próprios servidores.
Principais Características:
Controle maior – As empresas gerenciam sua própria infraestrutura.
Segurança personalizada – As empresas controlam sua própria Autoridade de Certificação (CA) e certificados de webhook.
Suporte à API de Verificação de Contatos e API de Fornecedor de Mídia, que estão obsoletas na API Cloud.
Menos latência para implantações locais, dependendo da infraestrutura da empresa.
Alta disponibilidade requisitada – As empresas devem implementar soluções de recuperação de desastres.
Comparação: API Cloud vs. API On-Premises
Recurso | API Cloud (Hospedada pela Meta) | API On-Premises (Auto-hospedada) |
Hospedagem | Hospedada pela Meta | Empresas/BSPs hospedam em seus próprios servidores |
Manutenção | Meta gerencia atualizações e patches | Empresas/BSPs devem gerenciar atualizações e escalonamento |
Custo | Empresas pagam por mensagem enviada | Custos adicionais de infraestrutura para configuração e manutenção de servidores + taxas por mensagem |
Protocolo de API | Graph API | API REST |
Através de mensagens | Até 500 mensagens por segundo (envio e recebimento combinados) | Até 70 mensagens por segundo (conexão única), 250 mensagens por segundo (conexão múltipla) |
Gestão de Certificados | Gerenciado pela Meta | Empresas gerenciam seus próprios certificados |
Recuperação de Desastres | Meta garante tempo de atividade (objetivo de 99,9%) | Empresas devem implementar soluções de failover |
Single vs. Multi-Tenant | Multi-inquilino (suporte para múltiplos números de telefone) | Single-inquilino (um número de telefone por implantação) |
Monitoramento | Meta monitora a saúde da instância | Empresas devem configurar o monitoramento por si mesmas |
Taxa de Erros Base | ~0,1% | Não publicado; varia conforme a infraestrutura |
Localização do Servidor | América do Norte | Determinada pela infraestrutura da empresa |
SLA (Tempo de Atividade) | Objetivo de 99,9% de tempo de atividade | Varia dependendo da configuração do negócio |
Suporte | Suporte 24/7 para questões críticas | Suporte 24/7 de melhor esforço para questões críticas |
Principais Considerações para Escolher entre API Cloud e API On-Premises
Quando Escolher API Cloud
Você não quer gerenciar servidores e infraestrutura.
Você precisa de escalabilidade com esforço mínimo.
Você quer atualizações automáticas sem tempo de inatividade.
Seus negócios necessitam de através de mensagens alto (até 500 mensagens por segundo).
Quando Escolher API On-Premises
Você exige controle total sobre infraestrutura e segurança.
Seus negócios não podem usar serviços hospedados pela Meta devido a restrições regulatórias.
Você depende da API de Verificação de Contatos e API de Fornecedor de Mídia (obspaces na API Cloud).
Você tem infraestrutura existente e recursos para gerenciar servidores.
Obsolescência na API Cloud
Algumas funcionalidades disponíveis na API On-Premises estão obsoletas na API Cloud:
Recurso | API On-Premises | API Cloud |
API de Verificação de Contatos | Requerido para verificar números de telefone antes de enviar mensagens | Não é mais necessário – basta usar o número de telefone |
API de Fornecedor de Mídia | Suporte | Obspaces – use os passos de upload de mídia da API Cloud |
Conclusão
A escolha entre API Cloud e API On-Premises depende das necessidades do seu negócio:
API Cloud é ideal para empresas que buscam facilidade de uso, manutenção baixa e escalabilidade.
API On-Premises é ideal para empresas que necessitam de controle total, segurança personalizada e hospedagem local.
Se ainda estiver em dúvida, considere suas capacidades de infraestrutura, requisitos de segurança e necessidades de escalabilidade antes de tomar uma decisão.
Perguntas Frequentes (FAQs)
Perguntas gerais
1. O que é a API do WhatsApp Business?
→ A API do WhatsApp Business permite que empresas se comuniquem com o cliente em escala, possibilitando mensagens automatizadas e conduzidas por humanos.
2. Quais são os dois tipos de opções de hospedagem da API do WhatsApp Business?
→ Existem duas opções de hospedagem:
Cloud API – Hospedada pela Meta, não requer manutenção de servidor.
API On-Premises – Hospedada pela própria empresa ou por Provedores de Solução de Negócios (BSPs), exigindo gerenciamento de servidor.
3. Posso usar Cloud API e On-Premises API ao mesmo tempo?
→ Não, um número de telefone só pode ser registrado em uma plataforma por vez.
Cloud API
4. O que é Cloud API?
→ Cloud API é a versão hospedada pela Meta da API do WhatsApp Business, que permite às empresas enviar mensagens via Graph API sem precisar gerenciar sua própria infraestrutura.
5. Quais são os benefícios de usar Cloud API?
Não há necessidade de configurar ou manter servidores.
Atualizações automáticas com novos recursos e correções de segurança.
Maior taxa de envio de mensagens (até 500 mensagens por segundo).
Menores custos de infraestrutura (paga-se apenas pelas mensagens enviadas).
6. Onde os servidores do Cloud API estão localizados?
→ Os servidores do Cloud API estão hospedados na América do Norte.
7. Qual método de autenticação o Cloud API usa?
→ O Cloud API usa Tokens de Acesso do Usuário para autenticação.
8. O Cloud API oferece suporte à API Check Contacts ou Media Provider?
→ Não, essas APIs estão descontinuadas no Cloud API.
API On-Premises
9. O que é a API On-Premises?
→ A API On-Premises é a versão autogerenciada da API do WhatsApp Business, que deve ser mantida pela empresa ou pelos BSPs em seus próprios servidores.
10. Quais são as vantagens de usar a API On-Premises?
Controle total sobre infraestrutura e segurança.
Capacidade de gerenciar certificados e requisitos de conformidade.
Pode ser implantada em modelos de alta disponibilidade para recuperação de desastres.
Suporta as APIs Check Contacts e Media Provider (que estão descontinuadas no Cloud API).
11. Quais são os requisitos de infraestrutura para a API On-Premises?
→ As empresas devem configurar e manter seus próprios servidores, gerenciar autoridades de certificação e monitorar a integridade do sistema.
12. Como a taxa de envio de mensagens se compara à do Cloud API?
On-Premises API suporta até 70 mensagens por segundo (conexão única) e 250 mensagens por segundo (multi-conexão).
Cloud API suporta até 500 mensagens por segundo (envio e recebimento combinados).
13. Onde a API On-Premises pode ser hospedada?
→ Pode ser hospedada em qualquer data center ou provedor de nuvem escolhido pela empresa.
Escolhendo entre Cloud API e On-Premises API
14. Como decidir entre Cloud API e On-Premises API?
Escolha Cloud API se preferir manutenção mínima, atualizações automáticas e maior taxa de envio de mensagens.
Escolha On-Premises API se precisar de controle total sobre segurança, infraestrutura e implantações personalizadas.
15. O Cloud API tem melhor tempo de atividade do que o On-Premises API?
→ O Cloud API tem como meta 99,9% de tempo de atividade, enquanto o tempo de atividade do On-Premises API depende da infraestrutura da empresa.
16. O Cloud API reduz custos em comparação com o On-Premises API?
→ Sim. O Cloud API elimina custos de configuração e manutenção de servidores, então as empresas pagam apenas pelas mensagens enviadas.
17. Posso migrar da API On-Premises para o Cloud API?
→ Sim, mas será necessário cancelar o registro do número de telefone na API On-Premises antes de registrá-lo no Cloud API.
Suporte e manutenção
18. Quem gerencia as atualizações do Cloud API?
→ A Meta gerencia automaticamente as atualizações de software e os patches de segurança do Cloud API.
19. Quem é responsável pela manutenção da API On-Premises?
→ As próprias empresas ou BSPs devem realizar atualizações, correções de segurança e monitoramento dos servidores.
20. Quais opções de suporte estão disponíveis para ambas as APIs?
Cloud API: Suporte 24/7 para problemas críticos.
On-Premises API: Suporte 24/7 em regime de melhor esforço para problemas críticos.