O que é a API oficial do WhatsApp e como funciona (guia para iniciantes)

Os três "WhatsApps" de uma empresa

Como a API funciona por dentro

São quatro peças, e entender cada uma evita muita confusão na hora de configurar:

1. Portfólio empresarial na Meta (o antigo Gerenciador de Negócios). É a "empresa" dentro da Meta, e é obrigatório para usar a plataforma.
2. Conta do WhatsApp, que guarda o número de telefone da empresa, com nome de exibição e perfil.
3. Conta de mensagens (a sigla WABA que você vai ver por aí), que guarda os modelos de mensagem e a forma de pagamento à Meta.
4. A Cloud API, o "motor" hospedado pela própria Meta que envia e recebe as mensagens. Você não acessa direto: usa uma plataforma (como o Disparo Max) que se conecta a ela e entrega painel, inbox, disparo e automações.

A verificação da empresa na Meta é opcional para começar, mas libera mais coisas: o limite de envio sobe mais rápido e você pode ter mais modelos de mensagem.

As regras principais

• Janela de 24 horas. Quando o cliente manda mensagem, abre uma janela de 24 horas em que você responde livremente, com texto, foto, documento e botões. Cada nova mensagem dele reinicia a contagem.
• Modelos aprovados fora da janela. Para chamar quem não falou com você nas últimas 24 horas, como num disparo, só com modelo aprovado pela Meta. Veja modelos prontos e por que a Meta reprova.
• Autorização do cliente. Só pode receber mensagem quem deu o número à sua empresa e aceitou receber contato.
• Limite diário que cresce. Uma conta nova alcança 250 pessoas diferentes por dia. O limite sobe para 2.000 e depois, sozinho, para 10 mil, 100 mil e ilimitado conforme a qualidade. Mais em como disparar sem ser banido.

Quanto custa

A Meta cobra por mensagem entregue. No Brasil, marketing custa R$ 0,3217 e utilidade, autenticação e serviço custam R$ 0,035, com 1.000 mensagens de serviço grátis por número no mês. Receber mensagens é grátis. A tabela completa e exemplos de conta estão em quanto custa a API oficial do WhatsApp.

Posso usar o número que já tenho?

Pode. Se o número já está no app WhatsApp Business, a Meta permite usá-lo ao mesmo tempo no app e na API. Esse recurso se chama coexistência. Você continua respondendo pelo celular, o histórico de conversas fica sincronizado entre o app e a plataforma, e as mensagens que você manda pelo app continuam grátis.

Algumas coisas mudam quando o número entra em coexistência:

• O app precisa estar atualizado (versão 2.24.17 ou superior).
• As listas de transmissão do app são desativadas, porque o disparo passa a ser feito pela API.
• A velocidade de envio desse número fica em até 20 mensagens por segundo (1.000 mensagens em menos de um minuto). Números só na API chegam a 80 por segundo.
• Grupos, chamadas e catálogo continuam só no app e não passam pela API.
• Aparelhos conectados ao número (como outro celular ou computador) são desconectados e precisam ser ligados de novo.

Como começar

1. Tenha (ou crie) o portfólio empresarial da sua empresa na Meta.
2. Escolha o número: um novo ou o que você já usa no WhatsApp Business.
3. Conecte o número pela plataforma que você vai usar. É ela que cria a conta do WhatsApp e a conta de mensagens ligadas ao seu portfólio.
4. Cadastre a forma de pagamento da Meta para as mensagens.
5. Crie os primeiros modelos de mensagem e espere a aprovação, que leva até 24 horas.
6. Importe a lista de contatos que autorizaram receber e faça o primeiro disparo para os clientes mais engajados.

No Disparo Max essa configuração é feita junto com você, numa chamada, e o passo a passo detalhado está na central de ajuda.

Perguntas frequentes

Regras e preços conferidos na documentação oficial da Meta para a plataforma do WhatsApp Business em 26 de outubro de 2026. A Meta atualiza a tabela de preços em 1º de janeiro, abril, julho e outubro.