Skip to main content
Toda a documentação do Wabox é feita para ser lida por agentes tanto quanto por pessoas. Esta página reúne os atalhos.
Um humano ainda precisa criar a conta e a instância no painel e ler o QR code com o celular. Depois disso, instance_id e token bastam para um agente operar tudo pela API.

​
Documentação para agentes

​
MCP das docs

Um servidor MCP de busca na documentação está disponível em https://developer.wabox.me/mcp. Ele só lê docs; não chama a API.
Nas páginas, o menu de contexto tem os botões Abrir no ChatGPT / Claude / Cursor / VS Code que fazem a mesma coisa com um clique.

​
Skills para agentes de código

Skills no formato Agent Skills (SKILL.md + referências + scripts) ensinam o agente a integrar o Wabox no seu código sem ler a documentação inteira:
Funciona com Claude Code, Codex, Cursor e qualquer agente que leia SKILL.md. Você também pode copiar a pasta da skill para .claude/skills/ do seu projeto.

​
Operar o número por MCP

O servidor MCP da sua conta (https://mcp.wabox.me/mcp), autorizado por OAuth, permite que assistentes como Claude e ChatGPT enviem mensagens, consultem instâncias e gerenciem grupos em seu nome, com escopos e instâncias escolhidos por você na tela de consentimento. Veja Claude, ChatGPT e outros apps de IA (MCP).

​
Pontos de partida

Primeiros passos

Conta, QR code, primeira mensagem e primeiro webhook.

Assinatura dos webhooks

Verificação HMAC com exemplos em Node, Python e PHP.

Webhook received

O payload que o seu agente vai ler.

Fila e reenvio

O que acontece entre o queued e o delivery.

Rate limit e erros

Quando repetir uma chamada e quando não.

Limitações conhecidas

O que é best effort, para o agente não prometer o que não existe.

​
Um atendente com IA em 3 passos

  1. Configure received_url apontando para o seu serviço e verifique a assinatura.
  2. Para cada received com text, chame o seu modelo (por exemplo, o Claude Agent SDK) com o histórico que você guarda — o Wabox não armazena conversas.
  3. Responda com POST /send-text usando delay_typing: 2 para a conversa parecer natural, e reply_to_message_id quando fizer sentido.
Regras de ouro para agentes que enviam mensagens: só falar com quem iniciou a conversa ou deu opt-in, nunca disparar em massa, e respeitar as boas práticas anti-ban.