SIP 503 Service Unavailable: o que significa e como resolver
Resposta curta: SIP 503 Service Unavailable significa que o servidor está temporariamente incapaz de processar a chamada, por sobrecarga ou manutenção. Em troncos, o mais comum é falta de canal ou de rota na operadora, ou um SBC fora do ar. Leia o Retry-After e a causa Q.850 no cabeçalho Reason e, se persistir, abra chamado com o Call-ID.
| Código | 503 |
|---|---|
| Nome oficial | Service Unavailable |
| Classe | 5xx: falha do servidor |
| Definido em | RFC 3261 |
| Causas Q.850 que costumam vir junto | 34 (No circuit/channel available), 38 (Network out of order), 41 (Temporary failure), 42 (Switching equipment congestion), 47 (Resource unavailable, unspecified), 58 (Bearer capability not presently available), 88 (Incompatible destination) |
Como o Monitor trata o SIP 503
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úmero | Leitura |
|---|---|
| Uma saudação ou mensagem gravada (a URA) | Fora do ar |
| Um tom de teste ou serviço de eco | Fora do ar |
| Outro: pode tocar ou ser atendido | Fora do ar |
O que o Monitor registra para uma URA: A operadora não conseguiu completar a chamada por uma falha do lado dela: o serviço da operadora está indisponível (SIP 503).
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 503 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 503 na prática?
O SIP 503 Service Unavailable diz que o servidor está temporariamente impossibilitado de processar o pedido, por sobrecarga ou manutenção. Pela RFC 3261, ele pode trazer Retry-After indicando quando tentar de novo, e quem recebe deve procurar um servidor alternativo. Sem Retry-After, o cliente trata a resposta como um 500.
Em troncos, o erro 503 SIP é o jeito mais comum de dizer “não há como completar agora”. A causa Q.850 no cabeçalho Reason ajuda a entender o motivo. Pela RFC 3398, viram 503 a cause 34 (No circuit/channel available), a cause 38 (Network out of order), a cause 41 (Temporary failure), a cause 42 (Switching equipment congestion), a cause 47 (Resource unavailable, unspecified), além das causes 58 e 88. No sentido contrário, o 503 vira cause 41.
Causas comuns no Brasil
- Canais simultâneos esgotados no tronco da operadora (Vivo, Claro, Algar, Embratel ou outra), com
Reason: Q.850;cause=34. - Limite de chamadas por segundo atingido em discadores e campanhas que disparam muitas ligações ao mesmo tempo.
- Manutenção programada ou reinício do SBC da operadora, às vezes com Retry-After.
- Congestionamento ou falha temporária na rota até a rede do destino, com causa 41 ou 42.
- PABX (Asterisk, Issabel, FreePBX, 3CX) sem nenhum tronco de saída disponível, gerando o 503 para o ramal.
- Licença ou capacidade do SBC esgotada na sua própria rede.
Como diagnosticar
- Capture a chamada com
sngrepe identifique quem gerou o 503 pelos cabeçalhos Via, Server e User-Agent. - Ative
pjsip set logger on(ousip set debug onno chan_sip) e leia o Reason, comoReason: Q.850;cause=34, e o Retry-After. - Rode
pjsip show registrationspara confirmar que o tronco está registrado ecore show channelspara contar as chamadas ativas. - Compare o número de chamadas ativas com o limite de canais contratado. Se bater no teto, o 503 é capacidade.
- No 3CX, ative o log detalhado (Verbose) e confira no Activity Log qual tronco respondeu e se havia rota alternativa.
- Repita a chamada depois do tempo do Retry-After e por outro tronco. Se o 503 continuar só num tronco, o problema está nele.
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 503 Service Unavailablee os cabeçalhos Reason e Retry-After. - Quantas tentativas falharam, em que intervalo, e quantas chamadas estavam ativas no tronco.
- Se a falha atinge todos os destinos ou só alguns.
- O arquivo pcap da captura, se você tiver.
Perguntas frequentes
O que fazer com o cabeçalho Retry-After num SIP 503?
Ele diz quantos segundos esperar antes de mandar novos pedidos àquele servidor. Pela RFC 3261, quem recebe o 503 deve tentar um servidor alternativo e não mandar outros pedidos ao mesmo servidor durante esse tempo. Sem Retry-After, o 503 deve ser tratado como um 500. Se o seu PABX tem um segundo tronco, configure-o como rota alternativa.
O 503 sempre vem da operadora?
Não. O próprio PABX ou um SBC na sua rede também gera 503, por exemplo quando nenhum tronco de saída está disponível. Antes de abrir chamado, capture a resposta e confira os cabeçalhos Via, Server e User-Agent. Se o 503 nasceu dentro da sua rede, a operadora não vai encontrar nada.
Uma chamada de teste real pega esse erro?
Sim. Uma chamada de teste real passa pelo tronco como qualquer ligação e recebe a resposta SIP final que a rede devolve, inclusive o 503. Quando o resultado conta como falha, a chamada é repetida antes de qualquer alerta, e o alerta segue por e-mail e SMS.