Skip to main content
Cada instância tem uma aba Testes no painel. Ela envia mensagens reais para um número seu, passando pela API pública exatamente como o seu sistema faria, e acompanha cada uma até o delivery e os recibos. É a forma mais rápida de responder “isso ainda funciona?” sem escrever código.

​
Como usar

1

Abra a instância conectada e vá em Testes

A instância precisa estar connected.
2

Informe o número que vai receber

DDI + DDD + número, só dígitos. Use um número seu (o celular ao lado é o ideal): as mensagens são reais e você vai querer ver como renderizaram.
3

Escolha os passos

Por padrão todos estão marcados. Desmarque grupos que não usa para o teste ser mais rápido.
4

Rode e acompanhe

Os passos aparecem em tempo real: enfileirado → enviado (delivery) → entregue/lido (message_status). Falhas mostram o error_code.

​
O que é testado

Passos que dependem de outro (editar depende do texto enviado antes; reagir depende de uma mensagem existente) são pulados automaticamente se o anterior falhar.

​
Interpretando o resultado

  • Passou = o WhatsApp aceitou e o aparelho enviou (delivery sem erro). Para interativos, isso não garante que renderizou como esperado — olhe o celular. Veja O que renderiza onde.
  • Falhou com media_invalid / media_download_failed em passos de mídia: problema de formato ou de rede no servidor; abra um chamado com o resultado.
  • Falhou com message_not_found em editar/reagir/encaminhar: a mensagem de referência não está mais no cache do engine (normal se o engine reiniciou entre os passos; rode de novo).
  • Tudo falha com instance_not_connected: a instância caiu no meio; confira Dados da instância.

​
Quando rodar

  • Depois de uma atualização do WhatsApp no celular ou de um aviso de mudança no changelog.
  • Antes de colocar um número novo em produção (também ajuda a “aquecer” o número com conversas reais — veja Boas práticas).
  • Quando algo específico parou de funcionar: rode só aquele grupo e mande o resultado para o suporte.

​
Reproduzindo pela API

Cada passo usa o body exato da API pública. Se quiser automatizar o mesmo checklist no seu CI, os payloads estão na seção Mensagens e Interativos da referência; as mídias de exemplo (imagem, áudio, PDF, sticker, vídeo) podem ser as suas.