Skip to main content
Cada instância tem uma aba Testes no painel. Ela envia mensagens reais para um número seu, pela API pública, como o seu sistema faria, e acompanha cada uma até o delivery e os recibos. Serve para 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, de preferência o celular que está ao seu lado: as mensagens são reais e você vai querer ver como renderizaram.
3

Escolha os passos

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

Rode e acompanhe

Os passos aparecem em tempo real: enfileirado, enviado (delivery), entregue ou 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). Em interativos, isso não garante que renderizou como esperado, então olhe o celular. Veja O que renderiza onde.
  • Falhou com media_invalid ou media_download_failed em passos de mídia: há um problema de formato ou de rede no servidor. Abra um chamado com o resultado.
  • Falhou com message_not_found em editar, reagir ou encaminhar: a mensagem de referência não está mais no cache do engine. Isso é normal se o engine reiniciou entre os passos; rode de novo.
  • Tudo falha com instance_not_connected: a instância caiu no meio do teste. 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. O teste 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 da API pública. Para automatizar o mesmo checklist no seu CI, os payloads estão nas seções Mensagens e Interativos da referência. Use as suas próprias mídias (imagem, áudio, PDF, sticker, vídeo).