API do WhatsApp

Documentação

Você comprou o acesso à API do WhatsApp. Esta é a parte que diz o que fazer com ele, começando por uma mensagem que chega hoje.

Aqui você fala direto com a Meta

A Zera é provedora de tecnologia da Meta, e não intermediária. A credencial que você recebe foi gerada pela própria Meta, no nome do seu número, e as suas chamadas vão para graph.facebook.com. Nenhuma requisição sua passa por um servidor nosso.

Quem é intermediário fica no meio do caminho: o cliente manda a mensagem para o endereço do fornecedor, e o fornecedor repassa para a Meta. Por isso a documentação desse tipo de empresa ensina um endereço próprio e um cabeçalho próprio. Se você copiar um exemplo assim para cá, ele não funciona, e o erro que volta fala de autenticação, que é o lugar errado para procurar.

Onde pegar o token e o phone_number_id: no painel, em Canais, no seu número, na aba Detalhes. O caminho clique a clique está em O primeiro dia.

O caminho mais curto

Se você chegou aqui para mandar a primeira mensagem e conferir que ela chega, pule o resto e vá para a página seguinte. Ela tem os três valores de que você precisa, o comando pronto para copiar e a regra que explica a mensagem que não chega.

O mapa

Dez páginas. As quatro primeiras cobrem o caminho inteiro de quem está integrando pela primeira vez; as outras seis são consulta.

• 2 O primeiro dia Como fazer uma mensagem chegar hoje, em cinco minutos.
• 3 A sua credencial Onde pegar, o que cada campo é, e por que o botão se comporta do jeito que se comporta.
• 4 A janela de 24 horas Quando você pode escrever o que quiser e quando só modelo aprovado passa.
• 5 Modelos de mensagem Como ver os seus, como criar um novo, e o que fazer quando a Meta recusa.
• 6 Receber mensagens Como o painel aponta o seu endereço na Meta, o que o seu servidor precisa responder no primeiro contato, e o corpo de cada evento.
• 7 Referência O contrato de cada chamada que a sua credencial alcança, no mesmo formato para todas.
• 8 Erros O que cada código que você vai ver quer dizer e qual é o próximo passo.
• 9 O painel O que a Zera faz por você, aba por aba, e onde cada número foi lido.
• 10 O que a Zera não faz A lista, num lugar só, do que este produto não entrega, para você não descobrir com o código meio escrito.

O que esta documentação não faz

Ela não descreve recurso que o produto não tem. Onde falta alguma coisa importante, a página diz que falta, explica por que, e mostra o caminho que existe hoje. É por isso que a última página se chama O que a Zera não faz, e é a que vale a pena ler antes de escrever a primeira linha do seu lado.

Três coisas que atrapalham logo no começo, e que já cabem aqui:

• Não existe ambiente de teste. Não há número de mentira nem caixa de areia. O seu primeiro envio sai do seu número de produção, e o custo dele é da Meta, cobrado direto de você.
• Receber mensagem já é configurado pelo painel, e ninguém ainda passou por esse caminho com um número de verdade. Desde 23 de setembro de 2026 o hub aponta o endereço que você informa direto na Meta, no seu número, depois que a conexão do número está concluída. O código que faz isso existe desde 15 de setembro, e até o dia 22 ficou desligado. O que muda é quem faz a chamada: era você, passou a ser o painel. O que ainda não existe é medição com um número real, e a página Receber mensagens diz isso com todas as letras, junto com o caminho manual para quando o painel falhar.
• Você não consegue validar a assinatura dos eventos. O cabeçalho X-Hub-Signature-256 é calculado com o segredo do aplicativo, que é da Zera e é o mesmo para todos os clientes. Ele não vai na credencial. O que dá para fazer no lugar está em Receber mensagens.