> ## 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 ".") 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. # Limitações conhecidas > Tudo que o Wabox não faz ou faz em modo best effort, por área, com o motivo. Preferimos dizer antes de você descobrir em produção. Esta página consolida o que **não existe**, o que é **best effort** (funciona hoje, pode quebrar com uma atualização do WhatsApp) e o que tem **condições**. ## Legenda * **Não existe** — o protocolo do WhatsApp Web não permite ou não está no roadmap. * **Best effort** — implementado sobre formatos internos do WhatsApp; funciona, mas sem garantia de estabilidade. * **Condicional** — funciona dentro de certas condições descritas. ## Conta e conexão | Item | Status | Detalhe | | -------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------ | | Instância como aparelho principal ("mobile") | Não existe | O Wabox é sempre um aparelho vinculado; o celular precisa existir e abrir o WhatsApp de tempos em tempos | | Chamadas de voz/vídeo (fazer ou atender) | Não existe | Só rejeição automática com mensagem (`call_reject_auto`, `call_reject_message`) e notificação de chamada perdida no `received` | | Extensão de navegador, passkey | Não existe | | | Meta AI | Não existe | | | Histórico de mensagens | Não existe | O Wabox não guarda conteúdo; o que chega vai pelo webhook e pronto. Mensagens anteriores à conexão não são recuperáveis | ## Mensagens | Item | Status | Detalhe | | ---------------------------------------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | | Responder, encaminhar, editar, votar, RSVP | Condicional | Só para mensagens que o engine viu desde o último restart (cache em memória de \~4.000 mensagens por instância). Fora disso, `message_not_found` | | Listas de transmissão | Não existe | O WhatsApp Web não cria nem envia para elas. Status (`status@broadcast`) funciona | | Botões, lista, carrossel, PIX, OTP | Best effort | Renderizam no celular; **não** no WhatsApp Web/Desktop. Formato pode mudar. Veja [O que renderiza onde](/guides/rendering-support) | | Carrossel e lista | Best effort | Formato replicado de outras implementações; validação com número real em andamento | | `send-edit-event`, `send-event-response` | Condicional | Só eventos criados pela API ou recebidos desde o último restart do engine | | Escolher audiência do status | Não existe | Segue a privacidade de status configurada no celular | | Respostas prontas a botões (`reply-button` da z-api) | Não existe | Respostas chegam pelo webhook `received` (`buttons_response`, `list_response`) | | Conversões de mídia (voice note, sticker, GIF) | Condicional | Automáticas com ffmpeg (padrão nos servidores). Sem ele: áudio vai como está, sticker exige WebP, GIF exige mp4 | | Idempotência de envio | Não existe | Repetir um `POST /send-*` envia duas vezes. Veja [Rate limit e erros](/guides/rate-limits-and-errors) | ## Recebimento e webhooks | Item | Status | Detalhe | | ---------------------------------------------------------- | ----------- | -------------------------------------------------------------------------------------------- | | URL de mídia recebida | Condicional | Expira em 24 h. Copie para o seu storage | | Mídia em posts de canal (`GET /newsletters/{id}/messages`) | Não existe | Só tipo e texto | | Imagem em `received.product` | Não existe | Só metadados do produto | | Quem está digitando num grupo | Não existe | `chat_presence` traz só o id do grupo | | Entrega garantida | Condicional | 5 tentativas em \~7 h; depois o evento é descartado (fica no log). Mantenha o endpoint no ar | ## Grupos, comunidades e canais | Item | Status | Detalhe | | ------------------------------------ | ----------- | -------------------------------------------------------------------------------------------------- | | Adicionar participantes | Condicional | Pessoas que não permitem ser adicionadas recebem convite; aparecem como não adicionadas no retorno | | Quantidade de grupos criados por dia | Condicional | O WhatsApp limita contas que criam muitos grupos em sequência | ## Business, catálogo e etiquetas | Item | Status | Detalhe | | ---------------------------------------------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- | | Catálogo (perfil, produtos, coleções, pedidos) | Best effort | O WhatsApp Web não expõe API de catálogo; o Wabox fala o protocolo interno (`w:biz`, `w:biz:catalog`), que pode mudar sem aviso | | `PUT /business/profile`, imagem de produto | Best effort | Formatos reproduzidos de outras implementações; validação com número real em andamento | | `send-order` sem `token` | Condicional | Mostra só o resumo; itens só existem em pedidos feitos pelo cliente a partir do catálogo | | `order-payment-update` | Não existe | | | Etiquetas | Condicional | Só contas WhatsApp Business. O primeiro `GET /labels` após um restart do engine pode responder `action_failed`; repita em alguns segundos | ## Partner e outros | Item | Status | Detalhe | | --------------------------------------- | ---------------- | --------------------------------------------------------------------------------------------------------------------------------------- | | API Partner (criar instâncias por API) | Condicional | Disponível para workspaces do programa Partner — veja [Partner API](/partner/api). Cobrança consolidada por integrador ainda não existe | | Servidor MCP | Não existe ainda | Idem | | Integrações nativas com n8n/Make/Zapier | Não existe | Use o HTTP genérico — [guias por ferramenta](/integrations/n8n) | | Versionamento da API | Condicional | Sem prefixo de versão. Mudanças incompatíveis serão anunciadas no [changelog](/resources/changelog) com antecedência | ## Sobre "best effort" O WhatsApp muda o protocolo do WhatsApp Web sem aviso. Recursos que dependem de formatos não documentados (interativos, catálogo) podem parar de funcionar até o Wabox acompanhar a mudança — geralmente em dias. Para o que é crítico, tenha alternativa em texto e acompanhe o [changelog](/resources/changelog).