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

# Postman, Insomnia e clientes gerados

> Importe a especificação OpenAPI e gere uma coleção ou um SDK na sua linguagem.

A referência desta documentação é gerada de um arquivo OpenAPI 3.1 produzido pelo próprio código da API. O mesmo arquivo serve para importar em ferramentas:

```text theme={"system"}
https://developer.wabox.me/openapi.json
```

## Postman

<Steps>
  <Step title="Importe">
    **Import › Link** e cole a URL acima (ou baixe o arquivo e arraste). Escolha gerar uma **Postman Collection**.
  </Step>

  <Step title="Configure as variáveis">
    A coleção usa `baseUrl` (`https://api.wabox.me`) e os path params `instance_id` e `token`. Crie um **Environment** com os três e, se usar, `Client-Token` como header na coleção.
  </Step>

  <Step title="Teste">
    Comece por `GET /status`, depois `POST /send-text` para um número seu.
  </Step>
</Steps>

## Insomnia, Bruno, Hoppscotch

Todos importam OpenAPI 3 diretamente pela URL. O processo é o mesmo: importar, definir `instance_id`/`token` como variáveis de ambiente, testar com `GET /status`.

## SDK gerado

Não mantemos SDKs oficiais; a API é simples o bastante para `fetch`/`requests`/`curl`. Se preferir tipos e autocompletar, gere um cliente a partir do spec:

<CodeGroup>
  ```bash TypeScript (openapi-typescript) theme={"system"}
  npx openapi-typescript https://developer.wabox.me/openapi.json -o wabox.d.ts
  # tipos para usar com openapi-fetch
  ```

  ```bash Qualquer linguagem (OpenAPI Generator) theme={"system"}
  npx @openapitools/openapi-generator-cli generate \
    -i https://developer.wabox.me/openapi.json \
    -g python \
    -o ./wabox-python
  ```

  ```bash Go (oapi-codegen) theme={"system"}
  go run github.com/oapi-codegen/oapi-codegen/v2/cmd/oapi-codegen@latest \
    -generate types,client -package wabox https://developer.wabox.me/openapi.json > wabox.gen.go
  ```
</CodeGroup>

Os `operationId` são estáveis (`send.sendText`, `groups.create`, `instance.status`…), então o código gerado não muda de nome entre versões.

## Copiar como cURL

Cada página de endpoint tem exemplos em cURL, JavaScript, Python, PHP e Go gerados do spec, e o playground **Try it** mostra o request exato que foi enviado. Para colar em um script, use o botão de copiar do bloco de código.

## Para agentes e LLMs

A documentação inteira está disponível em texto simples para ferramentas de IA: `https://developer.wabox.me/llms.txt` (índice) e `llms-full.txt` (conteúdo completo). No topo de cada página, o menu de contexto permite copiar a página como Markdown ou abri-la no ChatGPT, Claude ou Cursor.