whatslink.top

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.

15 guias · 98 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. 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. 2

    API oficial ou WhatsApp Business: qual você precisa

    Segundo passo, e o mais importante: descobrir se você precisa mesmo da API. Traz os três sinais que, juntos, justificam a conta.

    7 min

  3. 3

    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

  4. 4

    Quanto custa o WhatsApp para empresas: a conta inteira

    A conta somada: tarifa da Meta mais mensalidade do integrador. Leia antes de pedir o primeiro orçamento.

    9 min

  5. 5

    Meta Business: como configurar para o WhatsApp do zero

    A configuração que trava todo projeto antes de começar. Portfólio, conta comercial, número e nome de exibição, na ordem que funciona.

    7 min

  6. 6

    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

  7. 7

    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

  8. 8

    Botões e listas no WhatsApp: mensagens interativas na API

    Botões e listas. Não é firula: um toque reabre a janela de 24 horas e torna o atendimento seguinte gratuito.

    7 min

  9. 9

    Webhooks do WhatsApp: como receber mensagens no seu sistema

    A parte que surpreende: receber mensagem exige servidor sempre no ar. Deixe para depois de decidir que vai integrar de verdade.

    5 min

  10. 10

    Limites de envio da API do WhatsApp: as faixas explicadas

    As faixas de envio e como elas sobem. É o que trava a primeira campanha de todo mundo.

    7 min

  11. 11

    Qualidade do número na API do WhatsApp: como recuperar

    O que derruba a conta e como recuperar. Leia antes do primeiro disparo, não depois.

    7 min

  12. 12

    Erros da Cloud API do WhatsApp: códigos e soluções

    A tradução dos códigos que a API devolve. Deixe salvo: é o que você vai abrir quando algo parar.

    7 min

  13. 13

    Colocar a API do WhatsApp em produção: checklist completo

    As verificações entre o ambiente de teste e o primeiro cliente real. O último passo antes do go-live.

    7 min

  14. 14

    API não oficial do WhatsApp: o risco que ninguém conta

    Antes de fechar com qualquer fornecedor, saiba distinguir a API oficial das soluções que só parecem ser.

    6 min

  15. 15

    Selo de verificação do WhatsApp: como conseguir

    O selo verde é o pedido mais frequente e o mais mal explicado. Leia para saber por que provavelmente você não vai consegui-lo — e por que isso não importa tanto.

    5 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.

Todos os guias deste tema