API oficial do WhatsApp

A API oficial do WhatsApp, pronta para o seu sistema.

Você conecta o número pela janela da Meta, gera uma chave e manda a primeira mensagem com uma chamada HTTP. Sem QR code, sem sessão de WhatsApp Web e sem servidor seu para manter. Quem vem da Z-API, da Evolution ou de outra API não oficial muda o jeito de conectar, não o número.

Começar grátis ver o passo a passo

POST/api/v1/messages

curl https://botozap.com.br/api/v1/messages \
  -X POST \
  -H "X-API-Key: $BOTOZAP_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "to": "+5500000000001",
  "type": "text",
  "text": {
    "body": "Oi! 👋 Tudo bem?"
  }
}'

HTTP 201

{
  "id": "5b0a9d0e-6e1a-4f3b-8c2d-1a9f6e0b7c11",
  "wamid": "wamid.HBgNNTU5MTk5OTk5OTk5FQIAERgSM0FCQzFEMkUzRjRBNUI2QzdEAA==",
  "to": "5500000000001",
  "sent_to": "5500000000001",
  "status": "sent",
  "sandbox": true
}

Uma rota para enviar, um webhook para receber.

Para enviar

Texto, template, mídia, botões, listas, localização e reação na mesma chamada de envio.
Transmissões em ondas e réguas de template, no plano BotoZap.
SDK para Node (@botozap/sdk), CLI (@botozap/cli) e servidor MCP (@botozap/mcp) para o seu agente de IA.

Para receber

Webhook assinado para cada mensagem recebida e para cada entrega e leitura.
Retry e replay das entregas quando o seu servidor fica fora do ar.
Uma chave Sandbox para testar sem chamar a Meta e sem gastar cota.

Da conta à primeira mensagem

Comece pelo Sandbox, que não precisa de número nem de Facebook. Quando o teste passar, conecte o número de verdade.

1
Crie sua conta e gere uma chave Sandbox em Configurações › Desenvolvedores › Chaves de API.
2
Mande a primeira mensagem para o número de teste. O BotoZap simula a entrega e a leitura e chama o seu webhook, como em produção.
3
Conecte o seu número pela janela da Meta, gere a chave de produção e troque a chave no seu sistema.

Guia rápido completo na documentação

Vem da Z-API, da Evolution ou de outra API? O que muda

A Z-API conecta o número lendo um QR code e faz o que o WhatsApp Web faz, segundo a própria documentação.
A Evolution API é de código aberto e tem dois modos: um baseado no WhatsApp Web, pela biblioteca Baileys, e outro pela Cloud API da Meta.
Toda API que conecta o número lendo um QR code entra como um aparelho conectado, igual ao WhatsApp Web. Aqui o número entra pela janela oficial da Meta e fica registrado na Cloud API.
O número pode ser o mesmo. Se ele precisa continuar no app WhatsApp Business do celular, conecte em coexistência; se vai funcionar só pela API, ele sai do app.
Fora da janela de 24 horas, a conversa começa com um template aprovado pela Meta. Dentro da janela, a resposta é livre.

Fontes: documentação da Z-API, conferida em 29/10/2026; README da Evolution API, conferido em 30/10/2026

Quanto custa

API e webhooks funcionam em todos os planos. No Free, são 500 respostas e 100 templates por mês, e até 300 mensagens recebidas repassadas ao seu webhook.

O plano BotoZap custa R$ 97 por mês, com respostas e webhooks ilimitados e 10 mil templates por mês. Quem manda mais que isso fala com a gente e contrata uma cota maior.

A tarifa de cada mensagem é da Meta, cobrada direto na sua conta do WhatsApp, sem margem nossa. Para conta em reais e cliente no Brasil, são cerca de R$ 0,32 por template de marketing e R$ 0,035 por template de utilidade ou resposta de atendimento.

Fonte: tabela de preços do WhatsApp (Meta), conferida em 25/09/2026

ver os planos

Perguntas de quem vai integrar

A Z-API é a API oficial do WhatsApp?

Não é a Cloud API da Meta. A própria Z-API descreve o serviço como o que você faz no WhatsApp Web, com o número conectado por QR code. O BotoZap usa a Cloud API, que é a API oficial da Meta.

E a Evolution API?

A Evolution API é um projeto de código aberto com dois modos: um baseado no WhatsApp Web, pela biblioteca Baileys, e outro que usa a Cloud API da Meta. No BotoZap a conexão é sempre pela Cloud API, e a hospedagem, os webhooks e o painel ficam com a gente.

Dá para usar o mesmo número?

Dá. O número continua o mesmo para os seus contatos. Se ele precisa continuar no app WhatsApp Business, conecte em coexistência. Se vai funcionar só pela API, ele sai do app.

Preciso passar pelo App Review da Meta?

Não. A conexão usa o aplicativo do BotoZap, que já é aprovado pela Meta. O cadastro da empresa, o número e os templates continuam passando pelas análises da Meta.

Posso testar sem conectar um número?

Pode. A chave Sandbox manda para números de teste, simula a entrega e a leitura e chama o seu webhook. Ela não chama a Meta e não gasta cota.

Tem SDK?

Tem. O SDK para Node é o @botozap/sdk, a CLI é o @botozap/cli e o servidor MCP é o @botozap/mcp, para o seu agente de IA operar o WhatsApp.

Mande a primeira mensagem hoje

O Free não pede cartão e já tem API e webhooks. Quando você conecta o primeiro número, começam 14 dias com tudo do BotoZap.

Começar grátis