Pular para o conteúdo principal
A maioria dos endpoints da WaGo retorna JSON. O payload exato varia conforme o endpoint, mas a estrutura comum é:
{
  "code": 200,
  "data": {},
  "success": true
}
Erros geralmente retornam:
{
  "code": 500,
  "error": "human readable error",
  "success": false
}
Alguns endpoints mais recentes retornam objetos JSON diretos com campos como details, call, calls, iceServers, sdp ou turn. Considere o código de status HTTP e o valor de success como o primeiro sinal, e então leia os campos específicos do endpoint.

Códigos de status HTTP

StatusSignificado
200A requisição foi aceita e concluída.
400O corpo JSON é inválido ou um campo obrigatório está faltando.
401 / 403O token ou token admin está ausente ou inválido.
404O recurso de destino não foi encontrado, como um callID ou sessão de player.
500Falha na operação do WhatsApp, mídia, sistema de arquivos, chamada ou operação interna.

Campos obrigatórios

A WaGo valida manualmente muitos corpos de requisição. Campos obrigatórios ausentes geralmente retornam uma mensagem direta como:
{
  "code": 400,
  "error": "missing CallID in payload",
  "success": false
}
Os nomes dos campos diferenciam maiúsculas de minúsculas. Alguns endpoints de chamada usam CallID e AudioFile; endpoints de chamada WebRTC usam nomes JSON em minúsculas, como callID, sdp e type.

Comportamento assíncrono

O WhatsApp pode aceitar uma ação antes que o dispositivo remoto a exiba. Uma resposta de API bem-sucedida significa que a WaGo aceitou e enviou a operação através do seu cliente conectado. A entrega, confirmações de leitura, estado da chamada e atualizações de mensagens chegam posteriormente através de webhooks.