> ## 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.

# Introdução

> O que o Wabox faz, para quem serve e o que ele não faz.

O Wabox conecta um número de WhatsApp ao seu sistema por REST e webhooks. Você cria uma **instância**, lê o QR code com o celular (como no WhatsApp Web) e passa a enviar e receber mensagens por HTTP.

```bash theme={"system"}
curl -X POST https://api.wabox.me/instances/{instance_id}/token/{token}/send-text \
  -H "Content-Type: application/json" \
  -d '{ "phone": "5511988887777", "message": "Seu pedido saiu para entrega." }'
```

<CardGroup cols={2}>
  <Card title="Primeiros passos" icon="rocket" href="/quickstart">
    Da conta à primeira mensagem em cinco minutos.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/introduction">
    Todos os endpoints, com exemplos e playground.
  </Card>

  <Card title="Webhooks" icon="webhook" href="/webhooks/overview">
    Receba mensagens, recibos e eventos de conexão.
  </Card>

  <Card title="Migrando do z-api" icon="arrow-right-left" href="/migration/z-api">
    Mesmo formato de rota; tabela de equivalência completa.
  </Card>
</CardGroup>

## Para quem é

* **Sistemas que precisam falar com clientes no WhatsApp** — notificações, confirmações, atendimento, cobrança.
* **Chatbots e automações** — n8n, Make, Zapier, Typebot ou o seu próprio backend.
* **Quem já usa z-api ou similares** e quer a mesma API com uma base de código aberta e documentação sincronizada com o produto.

## O que dá para fazer

| Área                        | Exemplos                                                                                                                              |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| Mensagens                   | Texto, imagem, áudio (voice note), vídeo, documento, sticker, localização, contato, enquete, reação, resposta, edição, encaminhamento |
| Interativos                 | Botões, listas, carrossel, PIX, eventos de calendário, status (stories) — [veja onde renderizam](/guides/rendering-support)           |
| Recebimento                 | Webhook `received` com o conteúdo por tipo e URL da mídia já decifrada                                                                |
| Recibos                     | Webhook `message_status` com `SENT`, `RECEIVED`, `READ`, `PLAYED`                                                                     |
| Chats, contatos, perfil     | Listar, arquivar, silenciar, bloquear, verificar se um número tem WhatsApp, foto e recado                                             |
| Grupos, comunidades, canais | Criar, administrar participantes, links de convite, publicar em canais                                                                |
| Business                    | Perfil comercial, catálogo, pedidos e etiquetas (contas WhatsApp Business)                                                            |

## O que não dá para fazer

Somos honestos sobre limites, porque eles vêm do próprio WhatsApp Web, não de uma opção nossa:

* **Chamadas de voz e vídeo** (fazer ou atender). Você pode configurar rejeição automática com mensagem.
* **Listas de transmissão** — o WhatsApp Web não cria nem envia para elas. Status (`status@broadcast`) funciona.
* **Instância como aparelho principal** ("mobile"), Meta AI e extensões de navegador.
* **Botões, listas e carrossel no WhatsApp Web/Desktop** — aparecem no celular; no computador o WhatsApp mostra um placeholder. Detalhes em [O que renderiza onde](/guides/rendering-support).

A lista completa está em [Limitações conhecidas](/resources/limitations).

<Warning>
  O Wabox usa o protocolo do WhatsApp Web, não a API oficial da Meta. Isso permite usar um número comum sem aprovação de templates, mas o número está sujeito às regras do WhatsApp contra spam. Leia [Boas práticas e anti-ban](/guides/best-practices) antes de enviar em volume, e compare com a [API oficial](/guides/official-api) para decidir o que faz sentido para o seu caso.
</Warning>

## Como a documentação está organizada

* **Documentação** (esta aba): conceitos, segurança, webhooks, guias e integrações.
* **API Reference**: gerada do mesmo código que roda em produção, com playground para testar cada endpoint com a sua instância.