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

# Wabox × API oficial do WhatsApp

> O que muda em relação à WhatsApp Business Platform da Meta e quando cada uma faz sentido.

A **API oficial** (WhatsApp Business Platform / Cloud API) é o produto da Meta para empresas. O Wabox conecta um número comum pelo protocolo do WhatsApp Web. São ferramentas diferentes para problemas diferentes.

|                     | Wabox                                                                                | API oficial (Meta)                                                        |
| ------------------- | ------------------------------------------------------------------------------------ | ------------------------------------------------------------------------- |
| Número              | Qualquer chip, pessoal ou Business, ativo hoje                                       | Número novo dedicado ou migração (perde o WhatsApp comum nele)            |
| Cadastro            | Criar conta e ler QR code                                                            | Verificação de empresa na Meta, aprovação, BSP ou Cloud API               |
| Iniciar conversa    | Livre (com risco de ban se for spam)                                                 | Só com **template aprovado** pela Meta                                    |
| Responder o cliente | Livre                                                                                | Livre por 24 h após a última mensagem dele; depois, template              |
| Custo               | Assinatura por instância                                                             | Por conversa (categoria marketing/utilidade/autenticação), varia por país |
| Recursos            | Tudo que o app faz: grupos, comunidades, canais, reações, enquetes, status, catálogo | Mensagens e templates; grupos e status não existem                        |
| Botões e listas     | Best effort; não aparecem no WhatsApp Web ([detalhes](/guides/rendering-support))    | Nativos, em todos os clientes                                             |
| Estabilidade        | Depende de mudanças do WhatsApp Web (podem quebrar recursos sem aviso)               | Contrato de API versionado                                                |
| Risco de banimento  | Existe, proporcional ao comportamento                                                | Baixo, com limites de qualidade e tiers de volume                         |
| Selo verificado     | Não                                                                                  | Possível                                                                  |
| Histórico           | Não há; o Wabox não guarda mensagens                                                 | Não há; você guarda                                                       |

## Quando usar o Wabox

* Atendimento e automação em cima de um número que **já existe** e conversa com clientes.
* Notificações para clientes que **esperam** a mensagem (pedido, agendamento, código de acesso).
* Integrações internas: grupos da equipe, alertas de sistema, bots operacionais.
* Recursos que a API oficial não tem: grupos, comunidades, canais, enquetes, status.
* Quando o custo por conversa da Meta não fecha.

## Quando usar a API oficial

* Campanhas de marketing para bases grandes e frias.
* Exigência de compliance, SLA contratual ou selo verificado.
* Fluxos que dependem de botões/listas funcionando também no WhatsApp Web.

## Dá para usar as duas

Muitos clientes combinam: API oficial para o disparo com template, e o Wabox no número de atendimento (ou em números de vendedores) para a conversa que vem depois. Não há conflito entre elas, desde que sejam números diferentes — um número não pode estar nos dois ao mesmo tempo.

## O que "não oficial" significa na prática

* O WhatsApp não homologa nem dá suporte ao uso por API. A conta é sua e as regras são as de um usuário comum.
* Mudanças no protocolo podem quebrar recursos específicos até o Wabox atualizar. Os mais sensíveis (interativos, catálogo) estão marcados como **best effort** na referência e em [Limitações conhecidas](/resources/limitations).
* Leia [Boas práticas e anti-ban](/guides/best-practices) antes de colocar em produção.