Documentação
terminal Documentação da API

API oficial do WhatsApp (Meta) — Documentação para desenvolvedores

Envie mensagens WhatsApp (template, texto e mídia), gerencie templates aprovados pela Meta e receba eventos de entrega via webhooks assinados. Base URL api.wablastmessage.com.

bolt Começar em 5 minutos Autenticação

Como funciona a API do WhatsApp?

A API oficial do WhatsApp Business (Meta) expõe endpoints REST autenticados por Bearer token. Você envia uma requisição POST /v1/messages e a mensagem é entregue pelo WhatsApp; mudanças de status chegam via webhook assinado. Veja o passo a passo abaixo.

Comece por aqui

Quickstart Crie sua primeira API key, envie uma mensagem WhatsApp de texto e consulte o status em segundos. Autenticação Autentique na API WaBlast com uma chave Bearer wak_. Validações, erro 401 e gestão de chaves. Formato e catálogo de erros Envelope {error, code}, catálogo completo de status codes / error codes da API WaBlast.

Endpoints da API

POST /v1/messages Messages POST /v1/messages (envia template/texto/mídia) e GET /v1/messages/{id} (consulta status). POST /v1/media Media POST /v1/media — upload de arquivos (imagem/vídeo/documento/áudio) e retorna media_id para uso em mensagens. GET /v1/accounts Accounts GET /v1/accounts — liste as conexões WhatsApp (números conectados) do seu usuário. GET /v1/templates Templates Gerencie templates do WhatsApp Business: listar, criar, editar, remover e sincronizar da Meta. GET /v1/me Utilitários GET /v1/me e POST /v1/echo — sanity checks de auth, quota e idempotência sem disparar nada real. GET /v1/accounts/{id}/profile Perfil comercial GET e PUT /v1/accounts/{id}/profile — consulte e atualize o perfil comercial (Business Profile) exibido no WhatsApp. POST /v1/accounts/{id}/block-users Bloqueio de usuários POST/DELETE/GET /v1/accounts/{id}/block-users — bloqueie, desbloqueie e liste números bloqueados em uma conexão WhatsApp. POST /v1/accounts/{id}/qr-codes QR codes (click-to-chat) CRUD de QR code e link click-to-chat com mensagem pré-preenchida: criar, listar, consultar e remover. POST /v1/accounts/{id}/signups Cadastro no App (In-App Signup) POST /v1/accounts/{id}/signups — gere deep links de opt-in de marketing (wa.me) para contatos optarem em receber suas mensagens sem enviar nada antes. POST /v1/onboarding/sessions Onboarding de parceiros (Embedded Signup) POST /v1/onboarding/sessions e /v1/onboarding/domains — seu cliente conecta o WhatsApp Business de dentro do seu produto, sem passar pela dashboard.

Conceitos

Autenticação Autentique na API WaBlast com uma chave Bearer wak_. Validações, erro 401 e gestão de chaves. Rate limiting Limite de 60 req/min por API key. Cabeçalho Retry-After e erro 429 RATE_LIMITED. Idempotência Header Idempotency-Key em todos os POST. Janela de 5 min, replay e conflitos em voo. Formato e catálogo de erros Envelope {error, code}, catálogo completo de status codes / error codes da API WaBlast. Normalização de telefone Como o campo `to` é normalizado para E.164 (com regra do 9º dígito no Brasil). Limites de tier (cap diário) Cap diário de mensagens por conexão baseado no messagingLimitTier da Meta. Reset à meia-noite UTC.
Pular para o conteúdo