O que é a WhatsApp Cloud API
WhatsApp Cloud API é a API oficial do WhatsApp para empresas, hospedada pela Meta como parte da WhatsApp Business Platform. Exige conta comercial, usa modelos de mensagem aprovados para iniciar conversas e é cobrada pela Meta por mensagem.
Atualizado em
A WhatsApp Cloud API é a API oficial que a Meta oferece para empresas integrarem o WhatsApp aos seus sistemas. Ela faz parte da WhatsApp Business Platform e roda na infraestrutura da própria Meta: a empresa não hospeda nenhum servidor de WhatsApp, só faz chamadas HTTP para a API e recebe eventos por webhook.
É o caminho oficial, com regras definidas pela Meta. Por isso costuma ser comparada às APIs não oficiais, que conectam um número comum pelo protocolo do WhatsApp Web.
Como funciona
Para usar a Cloud API, a empresa precisa de uma conta comercial na Meta e registra um número de telefone na plataforma. A partir daí, o número passa a ser operado pela API, e as mensagens seguem as políticas da Meta.
Três características definem o dia a dia com ela:
- Modelos de mensagem aprovados. Para iniciar uma conversa ou falar com o cliente fora da janela de atendimento, a empresa usa modelos cadastrados e aprovados pela Meta. Dentro da janela aberta pela mensagem do cliente, as respostas são livres.
- Cobrança por mensagem. A Meta cobra conforme a categoria da mensagem e o país do destinatário. Os valores e as regras mudam com frequência, então consulte sempre a tabela oficial de preços da Meta.
- Limites e qualidade definidos pela Meta. A quantidade de conversas que um número pode iniciar e a avaliação de qualidade seguem os critérios publicados pela Meta na documentação da Cloud API.
A conta pode ainda receber o selo de conta oficial, conforme os critérios da Meta.
Cloud API ou API não oficial
As duas resolvem o mesmo problema, enviar e receber mensagens a partir de um sistema, com regras bem diferentes:
| Critério | WhatsApp Cloud API | API não oficial (apiwpp) |
|---|---|---|
| Quem opera | A Meta, com o número registrado na plataforma | O serviço, com o número como aparelho conectado |
| Aprovação | Conta comercial e modelos de mensagem | Nenhuma |
| Cobrança | Pela Meta, por mensagem | Por número, por mês |
| Selo de conta oficial | Possível | Não existe |
| Risco para o número | Baixo, dentro das políticas da Meta | Existe, reduzido pela fila e pelo aquecimento |
O comparativo completo, com os cenários de cada uma, está em apiwpp ou API oficial do WhatsApp.
Quando a Cloud API é a escolha certa
A API oficial é o caminho mais seguro quando o WhatsApp é um canal crítico e de volume alto. Escolha a Cloud API se:
- você precisa de campanhas de marketing em volume para listas grandes;
- o selo de conta oficial ou um vínculo formal com a Meta importa para o negócio;
- nenhum risco de restrição do número é aceitável;
- a equipe consegue manter o processo de aprovação de modelos e acompanhar a cobrança por mensagem.
Se o seu uso é conversar com quem já é cliente, com notificações, lembretes e atendimento, e você prefere custo previsível por número sem aprovação prévia, uma API não oficial como a apiwpp tende a ser mais simples. O guia API oficial ou não oficial do WhatsApp ajuda a decidir.
Perguntas frequentes
A Cloud API é a mesma coisa que o WhatsApp Business?
Não. O WhatsApp Business é o aplicativo de celular para pequenas empresas, usado manualmente. A Cloud API é uma interface para sistemas, sem aplicativo: as mensagens são enviadas e recebidas por código.
Quanto custa a WhatsApp Cloud API?
A Meta cobra por mensagem, conforme a categoria e o país, e os valores mudam ao longo do tempo. A fonte confiável é a tabela de preços publicada pela própria Meta, e não números copiados de terceiros.
A apiwpp usa a Cloud API?
Não. A apiwpp conecta o número pelo protocolo do WhatsApp Web, como aparelho conectado, e não é afiliada ao WhatsApp nem à Meta. Por isso não há aprovação de modelos nem cobrança por mensagem, e o preço é por número conectado.
Posso usar a Cloud API e a apiwpp na mesma empresa?
Sim, com números diferentes. É comum usar a API oficial para campanhas de alto volume e uma API não oficial para conversas e notificações com quem já é cliente.
Outros termos
Todos: Glossário →API não oficial do WhatsApp é um serviço que conecta um número comum pelo protocolo do WhatsApp Web, como um aparelho conectado, e expõe envio e recebimento de mensagens por HTTP. Não passa pela Meta: não exige aprovação, mas o número pode ser restringido.
Webhook é uma chamada HTTP que um serviço faz para um endereço do seu sistema quando um evento acontece, como uma mensagem recebida. Em vez de perguntar de tempos em tempos se há novidades, o seu sistema é avisado na hora.
HMAC é um código calculado a partir de uma mensagem e de um segredo compartilhado, com uma função de hash como SHA-256. Quem tem o segredo recalcula o código e confirma que a mensagem veio de quem diz e não foi alterada no caminho.