Códigos SIP

SIP 502 Bad Gateway: o que significa e como resolver

Resposta curta: SIP 502 Bad Gateway significa que um servidor agindo como gateway ou proxy recebeu uma resposta inválida do servidor seguinte na rota. Em troncos, costuma indicar falha na interconexão da operadora com a rede de destino, ou destino fora de serviço. Identifique pelos cabeçalhos quem gerou o 502 e informe a operadora com o Call-ID.

SIP 502 na referência
Código502
Nome oficialBad Gateway
Classe5xx: falha do servidor
Definido emRFC 3261
Causas Q.850 que costumam vir junto27 (Destination out of order), 38 (Network out of order)

Como o Monitor trata o SIP 502

A leitura depende do que deve atender o número, a pergunta que a 2N5 responde ao cadastrar cada circuito. Estas são as regras que o produto aplica hoje, geradas da mesma função que julga cada chamada de teste.

O que deve atender o númeroLeitura
Uma saudação ou mensagem gravada (a URA)Fora do ar
Um tom de teste ou serviço de ecoFora do ar
Outro: pode tocar ou ser atendidoFora do ar

O que o Monitor registra para uma URA: A operadora não conseguiu completar a chamada por uma falha do lado dela: um servidor na rota recebeu uma resposta inválida do seguinte (SIP 502).

Uma chamada lida como Fora do ar não alerta ninguém sozinha: ela é repetida 3 vezes, a cada 2 minutos, e só 4 falhas seguidas abrem um incidente, com o código SIP e a causa Q.850 de cada chamada como evidência para a operadora. No ritmo padrão, cada circuito é testado a cada 15 minutos.

Se a operadora devolve o SIP 502 ao registro da conta de chamadas da 2N5, antes de qualquer chamada, o teste fica sem visibilidade: é um problema do lado da 2N5, não conta contra o circuito e não avisa o cliente.

O que significa o SIP 502 na prática?

O SIP 502 Bad Gateway é uma resposta da classe 5xx. Pela RFC 3261, o servidor que responde estava agindo como gateway ou proxy e recebeu uma resposta inválida do servidor seguinte, aquele que ele consultou para atender o pedido. Ou seja, quem envia o 502 não é o culpado direto: ele está avisando que o próximo salto falhou.

Na interligação com a rede telefônica, a RFC 3398 converte a Q.850 cause 27 (Destination out of order) em 502, e o 502 em cause 38 (Network out of order). Por isso, um erro 502 SIP numa chamada para fixo, celular ou 0800 costuma significar que a central do destino não conseguiu entregar a chamada. Em monitoramento de troncos SIP, o importante é separar um 502 isolado de um 502 que se repete para o mesmo destino.

Causas comuns no Brasil

  • Destino fora de serviço na rede de outra operadora, sinalizado pela central com a Q.850 cause 27 e convertido em 502 pelo gateway.
  • Falha na interconexão entre a operadora do seu tronco (Vivo, Claro, Algar, Embratel ou outra) e a rede onde o número está.
  • PABX do destino com URA própria ou link E1 fora do ar, fazendo o gateway da operadora receber falha.
  • SBC na sua rede, na frente do Asterisk, Issabel, FreePBX ou 3CX, recebendo do PABX uma resposta que ele não aceita.
  • Equipamento atualizado na rota que passou a enviar mensagens fora do padrão para o salto anterior.

Como diagnosticar

  1. Capture a chamada com sngrep e veja quem gerou o 502 pelos cabeçalhos Via, Server e User-Agent.
  2. No Asterisk, Issabel ou FreePBX, ative pjsip set logger on (ou sip set debug on no chan_sip) e procure Reason: Q.850;cause=27 ou outra causa na resposta.
  3. Ligue para o mesmo número por outro tronco ou por um celular. Se também falhar, o problema está no destino.
  4. Teste outros números da mesma operadora de destino. Se todos falharem, a suspeita é a interconexão.
  5. Se o 502 vier de um SBC seu, capture também do lado do PABX e compare a resposta que o PABX mandou com a que o SBC repassou.
  6. No 3CX, ative o log detalhado (Verbose) e confira no Activity Log qual tronco devolveu o 502.

O que mandar para a operadora

  • Data e hora exatas com fuso, por exemplo 2026-10-07 14:32:10 -03:00.
  • Número de origem (A), número de destino (B) e o Call-ID.
  • A linha completa SIP/2.0 502 Bad Gateway e os cabeçalhos Server e Reason.
  • Se outros números da mesma rede de destino também falham, e quantas tentativas foram feitas.
  • O arquivo pcap da captura, se você tiver.

Perguntas frequentes

O SIP 502 é problema do meu PABX?

Raramente. O 502 é gerado por um equipamento que fica no meio da rota, como um proxy, um SBC ou um gateway para a rede telefônica, quando o salto seguinte devolve algo inválido. Se o 502 vem da operadora, a falha costuma estar além dela. Se vem de um SBC seu, confira a resposta que o PABX mandou para ele.

Que causa Q.850 acompanha o SIP 502?

Pela RFC 3398, um gateway converte o SIP 502 em Q.850 cause 38 (Network out of order). No sentido contrário, a Q.850 cause 27 (Destination out of order) vira 502. Um cabeçalho `Reason: Q.850;cause=27` indica que a central do destino considerou o destino fora de serviço.

Uma chamada de teste real pega esse erro?

Sim. Uma chamada de teste real recebe a resposta SIP final que a rede devolve, inclusive o 502. Quando o resultado conta como falha, a chamada é repetida antes de qualquer alerta, e o alerta segue por e-mail e SMS.

Saiba disso antes dos seus clientes

O Monitor liga para cada circuito de voz o dia todo e entrega cada falha com o código SIP e a causa Q.850 como prova.