> ## Documentation Index
> Fetch the complete documentation index at: https://developer.wabox.me/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Wabox é uma API não-oficial de WhatsApp (aparelho vinculado). Tudo é snake_case; a base é https://api.wabox.me/instances/{instance_id}/token/{token}.
> Envios respondem { id, message_id, wabox_id, status: "queued" } na hora; o resultado real chega no webhook delivery. Envios não são idempotentes: confira GET /queue antes de repetir.
> Sempre verifique X-Wabox-Signature (HMAC-SHA256 de "<t>.<corpo cru>") nos webhooks e deduplique por event_id.
> Botões, listas, carrossel e catálogo são best effort e não renderizam no WhatsApp Web/Desktop. Não existem: chamadas, listas de transmissão, histórico de mensagens, instância mobile.
> Não invente endpoints ou campos: use o OpenAPI em https://api.wabox.me/openapi.json.

# Changelog

> Mudanças na API pública, nos webhooks e nesta documentação.

Mudanças incompatíveis são anunciadas aqui com antecedência e, quando possível, mantidas por período de convivência. Campos novos em respostas e webhooks **não** são considerados incompatíveis: escreva o seu cliente ignorando campos desconhecidos.

<Update label="Setembro de 2026" description="Documentação pública">
  * Documentação em `developer.wabox.me` com **Documentação** e **API Reference** geradas do código da API.
  * Referência com 120 endpoints canônicos (mais aliases de compatibilidade com a z-api) e 6 webhooks documentados a partir dos contratos.
  * Playground com `instance_id`/`token` persistidos no navegador.
</Update>

<Update label="Agosto de 2026" description="Business e etiquetas">
  * Perfil comercial, catálogo (produtos, coleções), pedidos e `send-product`/`send-catalog`/`send-order`/`order-status-update` — best effort.
  * Etiquetas (`/labels`) em contas Business, com aliases `/tags`.
  * Webhook `received` com blocos `product` e `order`.
</Update>

<Update label="Agosto de 2026" description="Interativos, comunidades, canais e privacidade">
  * Botões, OTP, PIX, lista, carrossel, eventos de calendário e status (stories).
  * Comunidades, canais (newsletters) e configurações de privacidade.
  * Assinatura HMAC `X-Wabox-Signature` em todos os webhooks e `POST /webhooks/secret` para rotação.
</Update>

<Update label="Agosto de 2026" description="Chats, contatos, perfil e grupos">
  * `GET /chats`, ações de chat, mensagens temporárias; contatos, verificação de números em lote e bloqueio; perfil; grupos completos (participantes, links de convite, pedidos de entrada).
</Update>

<Update label="Agosto de 2026" description="Mídia e mensagens ricas">
  * Imagem, áudio (voice note com forma de onda), vídeo, PTV, GIF, documento, sticker — URL ou base64, com conversões por ffmpeg.
  * Localização, contatos, link com prévia, reações, encaminhar, fixar, apagar, enquetes e votos, ler, presença.
  * Endpoints de fila (`GET/DELETE /queue`).
</Update>

<Update label="Agosto de 2026" description="Lançamento da API">
  * Instâncias com QR code e código de pareamento, `send-text`, webhooks `received`, `delivery`, `message_status`, `connected`, `disconnected`, `chat_presence`.
  * Convenção `snake_case`, formato de erro `{ error: { code, message } }`, rate limit por instância.
</Update>