Pular para o conteúdo principal
Use esta página quando um endpoint falhar, mas o servidor estiver em execução.

​
Primeiras verificações

Execute estes comandos na ordem: 
curl http://localhost:1337/server/ok
curl -H "token: YOUR_TOKEN" http://localhost:1337/session/status
curl -H "token: YOUR_TOKEN" http://localhost:1337/webhook
Se /server/ok falhar, depure primeiro o processo, a porta, o firewall ou o proxy reverso. Se /session/status falhar, depure o token e o estado da sessão antes de testar as mensagens.

​
Unauthorized

O WaGo não encontrou o token de sessão no banco de dados ou no cache. Correção:
  • Envie o token como um header.
  • Verifique se há espaços em branco no token.
  • Confirme se o token existe com GET /session/all usando o admintoken.
  • Se necessário, crie-o com POST /session/init.

​
No session

O token existe, mas nenhum cliente WhatsApp ativo está carregado para ele. Correção: 
curl -X POST http://localhost:1337/session/connect \
  -H "Content-Type: application/json" \
  -H "token: YOUR_TOKEN" \
  -d '{"Subscribe":["All"],"Immediate":true,"Phone":""}'
Em seguida, verifique /session/status.

​
Already Logged in ao solicitar QR

O token já está vinculado ao WhatsApp. Você não precisa escanear novamente. Use /session/status para confirmar a sessão, ou /session/logout se você deseja intencionalmente desvincular e escanear novamente.

​
Mensagens não são enviadas

Verifique:
  • A sessão está conectada e autenticada.
  • Phone é um número de telefone ou JID válido.
  • Os campos obrigatórios correspondem exatamente às maiúsculas/minúsculas.
  • O payload de mídia é uma data URL válida quando necessário.
  • A conta do WhatsApp conectada não está com limite de taxa (rate limited).
  • O usuário de destino existe no WhatsApp.
Use /user/check antes de enviar para novos números de telefone.

​
Upload de mídia falha

Causas comuns:
  • Prefixo de data URL incorreto.
  • String Base64 truncada.
  • Limite de tamanho de requisição do proxy reverso muito pequeno.
  • O WaGo não consegue baixar uma URL usada por /send/mediaurl.
  • O tipo de mídia não é suportado pelo WhatsApp para aquele tipo de mensagem.
Para documentos, o endpoint de documentos atual espera: 
data:application/octet-stream;base64,

​
Webhooks não chegam

Verifique:
  • /webhook retorna a URL esperada.
  • /session/connect está inscrito no tipo de evento.
  • Sua URL de webhook é acessível a partir do servidor WaGo.
  • Seu receptor retorna 2xx rapidamente.
  • Seu proxy reverso permite o tamanho do corpo da requisição.
Use ["All"] durante a depuração e, em seguida, reduza as inscrições em produção.

​
Chamada funciona, mas o áudio do navegador não

Verifique:
  • A página do navegador está em HTTPS.
  • O usuário concedeu permissão de microfone.
  • A chamada está ativa e rastreada em /call/status.
  • A oferta WebRTC usa sendrecv.
  • O navegador definiu a resposta SDP do WaGo como descrição remota.
  • A rede não requer relay TURN.
O TURN está atualmente como coming_soon, portanto, algumas redes de produção falharão até que o TURN seja adicionado.

​
Logs de pacotes Opus

Se você vir logs sobre pacotes Opus curtos ou vazios, mas a chamada funcionar, eles podem ser preenchimento (padding), keepalive ou pacotes RTP que não são de áudio vindos do navegador. Nem sempre são uma falha. Se o áudio falhar ao mesmo tempo, verifique a negociação de codec e certifique-se de que o navegador está enviando áudio Opus.