Limitações conhecidas

Preferimos avisar antes de você descobrir em produção. Esta página lista o que não existe, o que é best effort (funciona hoje, mas pode quebrar com uma atualização do WhatsApp) e o que depende de condições.

Legenda

Não existe: o protocolo do WhatsApp Web não permite, ou o item não está no roadmap.
Best effort: o Wabox implementa sobre formatos internos do WhatsApp. Funciona, mas sem garantia de estabilidade.
Condicional: funciona dentro das 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 completo de mensagens	Parcial	Ao parear, o celular envia as conversas recentes e o Wabox guarda até 50 mensagens por conversa (`GET /chats/{phone}/messages`, desligável em `settings.history_enabled`). Mensagens mais antigas que isso, ou de conversas sem atividade recente, não são recuperáveis; o tráfego novo chega só pelo webhook

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, mas não no WhatsApp Web/Desktop. O formato pode mudar. Veja O que renderiza onde
Carrossel e lista	Best effort	O Wabox replica o formato de outras implementações; a validação com número real está 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

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
Online e visto por último do contato	Condicional	`GET /contacts/{phone}/presence` exige o número online (`settings.always_online`). Vem `null` quando o contato oculta a presença ou não tem conversa com o número. Com o número online, o celular costuma deixar de receber notificações
Entrega garantida	Condicional	5 reenvios 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, então o Wabox usa o protocolo interno (`w:biz`, `w:biz:catalog`), que pode mudar sem aviso
`PUT /business/profile`, imagem de produto	Best effort	O Wabox reproduz formatos de outras implementações; a validação com número real está 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

Account API e outros

Item	Status	Detalhe
Criar instâncias por API	Condicional	Account API: disponível para contas com plano (não no trial), até o número de slots do plano
Integrações nativas com n8n/Make/Zapier	Não existe	Use o HTTP genérico. Veja os guias por ferramenta
Versionamento da API	Condicional	Sem prefixo de versão. Mudanças incompatíveis serão anunciadas no 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 uma alternativa em texto e acompanhe o changelog.

Começar

Autenticação e segurança

Webhooks

Guias

Migrando do z-api

Integrações

Conta

Referências

Limitações conhecidas

Legenda

Conta e conexão

Mensagens

Recebimento e webhooks

Grupos, comunidades e canais

Business, catálogo e etiquetas

Account API e outros

Sobre “best effort”

​Legenda

​Conta e conexão

​Mensagens

​Recebimento e webhooks

​Grupos, comunidades e canais

​Business, catálogo e etiquetas

​Account API e outros

​Sobre “best effort”

Legenda

Conta e conexão

Mensagens

Recebimento e webhooks

Grupos, comunidades e canais

Business, catálogo e etiquetas

Account API e outros

Sobre “best effort”