A BotoZap é uma plataforma sobre a WhatsApp Cloud API oficial da Meta. Cada cliente seu conecta a WABA dele, e você envia e recebe mensagens em nome de todos por um endpoint só. Esta documentação cobre a API REST, os webhooks e o SDK.
Base URL
https://botozap.com.br/api/v1Autenticação
Toda requisição leva a sua chave de API no header, como Bearer ou como X-API-Key. A conta é derivada da chave, então você nunca passa um id de conta (o isolamento multi-tenant é garantido no servidor).
Authorization: Bearer $BOTOZAP_KEYDetalhes em Autenticação.
Formato de resposta
- Sucesso singular:
{ "data": <objeto> }. - Lista:
{ "data": [...], "paging": {...} }. - Erro:
{ "error": { "code": "...", "message": "..." } }.
Por onde começar
- Primeiros passos: envie a primeira mensagem em minutos, no sandbox, sem custo e sem credenciais Meta.
- Enviar mensagens: texto, template e a janela de 24h.
- Webhooks: receba eventos de mensagem e status, com assinatura HMAC.
- Confiabilidade e entrega: o que a API garante: at-least-once, retry, DLQ e replay.
- Transmissões e limites: os quatro limites independentes de uma transmissão e da quota mensal.
- Referência da API /v1: todos os endpoints, escopos e paginação.
- SDK Node: cliente tipado publicado no npm, com a API REST como fallback estável.
- Conceitos: WABA, Embedded Signup, multi-tenant e BSUID.