Códigos SIP

SIP 500 Server Internal Error: o que significa e como resolver

Resposta curta: SIP 500 Server Internal Error significa que um servidor na rota encontrou uma condição inesperada e não conseguiu processar o pedido. As causas comuns são falha de software no PABX, no SBC ou na operadora, ou um 503 de um servidor seguinte convertido em 500 por um proxy. Identifique quem gerou a resposta antes de abrir chamado.

SIP 500 na referência
Código500
Nome oficialServer Internal Error
Classe5xx: falha do servidor
Definido emRFC 3261
Causas Q.850 que costumam vir junto111 (Protocol error, unspecified), 127 (Interworking, unspecified), 41 (Temporary failure)

Como o Monitor trata o SIP 500

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: uma falha interna na operadora (SIP 500).

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 500 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 500 na prática?

O SIP 500 Server Internal Error é a resposta genérica da classe 5xx: o servidor encontrou uma condição inesperada que o impediu de atender o pedido. A RFC 3261 permite que ele traga Retry-After, e o cliente pode tentar de novo depois de alguns segundos. O código não diz qual foi a falha, só que ela aconteceu do lado do servidor que respondeu.

Um detalhe importa no diagnóstico: pela RFC 3261, um proxy que recebe apenas um SIP 503 de um servidor seguinte não deve repassá-lo, e sim gerar um 500. Então um erro 500 SIP pode esconder uma indisponibilidade mais adiante. Na interligação com a rede telefônica, a RFC 3398 converte a Q.850 cause 127 (Interworking, unspecified), a cause 111 e qualquer causa sem mapeamento em 500.

Causas comuns no Brasil

  • Falha de software no PABX (Asterisk, Issabel, FreePBX, 3CX) depois de uma atualização de versão ou de módulo.
  • Dependência interna fora do ar em PABX ou plataforma da operadora, como banco de dados ou serviço de roteamento.
  • Proxy ou SBC que recebeu um 503 do servidor seguinte e o converteu em 500.
  • Gateway SIP para E1 que recebeu da central uma causa Q.850 sem mapeamento, como 111 ou 127, e devolveu 500.
  • SBC da operadora (Vivo, Claro, Algar, Embratel ou outra) com falha intermitente durante manutenção ou reinício.

Como diagnosticar

  1. Capture a chamada com sngrep e identifique quem gerou o 500 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 o cabeçalho Reason, como Reason: Q.850;cause=127, e um eventual Retry-After.
  3. Se o 500 saiu do seu PABX, leia o log completo do Asterisk no mesmo horário em busca de erros de módulo ou de banco de dados.
  4. Rode pjsip show registrations e core show channels para descartar tronco caído ou PABX sobrecarregado.
  5. No 3CX, ative o log detalhado (Verbose) e confira no Activity Log qual etapa falhou.
  6. Repita a chamada algumas vezes. Um 500 em toda chamada aponta para configuração ou software; um 500 intermitente aponta para sobrecarga ou falha mais adiante.

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 500 Server Internal Error e os cabeçalhos Server, Reason e Retry-After, se vieram.
  • Quantas tentativas falharam e se a falha é constante ou intermitente.
  • O arquivo pcap da captura, se você tiver.

Perguntas frequentes

O SIP 500 vem sempre da operadora?

Não. Qualquer servidor na rota pode gerar o 500: o seu PABX, um SBC na sua rede, o SBC da operadora ou um equipamento mais adiante. Antes de abrir chamado, capture a resposta e confira os cabeçalhos Via, Server e User-Agent. Se o 500 nasceu no seu PABX, o problema é local.

Que causa Q.850 acompanha o SIP 500?

Pela RFC 3398, um gateway converte o SIP 500 em Q.850 cause 41 (Temporary failure). No sentido contrário, a cause 111 (Protocol error, unspecified), a cause 127 (Interworking, unspecified) e qualquer causa sem mapeamento próprio viram 500. Um cabeçalho `Reason: Q.850;cause=127` indica falha de conversão entre redes.

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 500. 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.