Guia completo da API oficial do WhatsApp
Tudo sobre a API oficial do WhatsApp em um só lugar: o que é, quanto custa de verdade, como integrar, o que a Meta exige e quando ela não vale a pena.
4 guias · 24 min de leitura no total
Resposta rápida
A API oficial do WhatsApp (WhatsApp Business Platform) é a forma de um sistema enviar e receber mensagens sem celular no meio. A hospedagem da Cloud API é gratuita e cobra-se por mensagem, conforme a categoria do template e o país. Este guia reúne, em ordem de leitura, tudo que decide se ela faz sentido para o seu caso.
A API oficial é o assunto mais mal explicado do WhatsApp em português — e não por acaso. Quase todo material disponível é escrito por quem vende a plataforma que revende a API, o que muda o que se diz e, principalmente, o que se omite.
Este guia é escrito por quem não vende plataforma de atendimento. O WhatsLink é um gerador de link gratuito; não há nada aqui para empurrar. Isso permite escrever a frase que a maioria dos guias evita: na maior parte dos casos, a API não é o que você precisa.
Por onde começar
Na ordem. Cada guia pressupõe o anterior, e o motivo de cada posição está escrito ao lado.
- 1
API oficial do WhatsApp (Cloud API): guia para começar
Comece aqui. Explica o que a API é de fato, o que a Meta exige antes de liberar e — o mais importante — os casos em que ela não compensa.
8 min
- 2
Janela de 24 horas do WhatsApp: o que é e como usar
A regra que organiza a plataforma inteira. Quem não entende a janela acha que a API está com defeito, porque a mensagem simplesmente não sai.
5 min
- 3
Quanto custa a API do WhatsApp: a conta explicada
A estrutura de cobrança, e onde o dinheiro vaza. Leia antes de pedir orçamento a qualquer fornecedor.
5 min
- 4
Templates de mensagem do WhatsApp: criar e ser aprovado
Fora da janela, template é a única forma de falar. É também o que decide o custo do mês, porque a categoria define o preço.
6 min
Antes de contratar: as quatro perguntas
A conta comercial fica no meu Meta Business? Se ficar no do fornecedor, trocar de plataforma vira negociação e o número é refém.
A tarifa da Meta é repassada ou tem margem? É a diferença mais comum entre duas propostas que parecem iguais.
Existe janela de 24 horas e template? Se o fornecedor responde que não precisa, não é a plataforma oficial.
Qual o prazo de fidelidade e a multa? Fornecedor confiante aceita um período de teste curto.
O caminho mais barato costuma ser não usar a API
Para quem atende de dezenas a poucas centenas de conversas por dia, com até quatro pessoas, o WhatsApp Business gratuito entrega o mesmo resultado: etiquetas como funil, respostas rápidas para o repetitivo, catálogo e mensagem de ausência cobrindo a noite e o fim de semana.
A API passa a fazer sentido quando a mensagem precisa sair de um sistema, quando o atendimento não cabe em quatro aparelhos, ou quando o WhatsApp precisa conversar com o ERP. Três sinais ao mesmo tempo, não um.
Perguntas frequentes
A API oficial do WhatsApp é gratuita?
A hospedagem da Cloud API não é cobrada pela Meta e existe um ambiente de teste gratuito. O que se paga é por mensagem enviada, conforme a categoria do template e o país do destinatário. Conversas iniciadas pelo cliente e respondidas dentro da janela de 24 horas não são cobradas.
Preciso de programador para usar a API?
Para falar direto com a Cloud API, sim — não há interface. A alternativa é contratar uma plataforma de atendimento que já fez essa parte e entrega uma tela pronta, cobrando mensalidade por isso.
Quanto tempo leva para colocar a API no ar?
O ambiente de teste é imediato. O nome de exibição costuma sair em horas. A verificação da empresa, que depende de documentos, é a etapa mais demorada e varia de dias a semanas.
Posso usar meu número atual do WhatsApp Business na API?
Só depois de removê-lo do aplicativo — um número não fica nos dois lugares, e o histórico de conversas não é transferido. Por isso a maioria migra com um número novo e mantém o antigo por um período.
Não achou o termo? O glossário do WhatsApp define os 40 termos que aparecem nestes guias.