SIP 501 Not Implemented: o que significa e como resolver
Resposta curta: SIP 501 Not Implemented significa que o servidor não suporta a funcionalidade necessária para atender o pedido, tipicamente um método SIP que ele não reconhece. Aparece mais em REFER, UPDATE, INFO ou MESSAGE do que no INVITE. Veja no trace qual método recebeu o 501 e ajuste o PABX para não enviá-lo àquele tronco.
| Código | 501 |
|---|---|
| Nome oficial | Not Implemented |
| Classe | 5xx: falha do servidor |
| Definido em | RFC 3261 |
| Causas Q.850 que costumam vir junto | 29 (Facility rejected), 79 (Service or option not implemented, unspecified) |
Como o Monitor trata o SIP 501
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 (SIP 501).
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 501 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 501 na prática?
O SIP 501 Not Implemented diz que o servidor não suporta a funcionalidade necessária para atender o pedido. Pela RFC 3261, é a resposta adequada quando quem recebe não reconhece o método do pedido e não consegue suportá-lo para nenhum usuário. Proxies encaminham pedidos de qualquer método, então o 501 costuma vir do equipamento final, como o SBC da operadora ou o PABX do destino.
Na prática, o erro 501 SIP raramente bloqueia a chamada inteira. Ele costuma atingir uma função: a transferência que usa REFER, a atualização de sessão com UPDATE, o DTMF via INFO ou uma mensagem MESSAGE. O cabeçalho CSeq da resposta mostra o método recusado, como CSeq: 102 REFER. Na interligação com a rede telefônica, a RFC 3398 converte o 501 em Q.850 cause 79 e faz o caminho inverso a partir das causes 29 e 79.
Causas comuns no Brasil
- Transferência de chamada pelo aparelho ou pelo PABX gerando REFER para um tronco de operadora (Vivo, Claro, Algar, Embratel ou outra) que não implementa esse método.
- UPDATE enviado para renovar a sessão ou atualizar dados da chamada a um equipamento que não o suporta.
- INFO para DTMF ou MESSAGE para texto enviados por aparelhos IP ou softphones a um tronco que não trata esses métodos.
- SUBSCRIBE ou PUBLISH de presença e de luzes de ocupação (BLF) indo por engano para o tronco, em vez de ficar entre ramais.
- Gateway SIP para E1 que recebeu da central a Q.850 cause 79 ou 29 e devolveu 501.
Como diagnosticar
- Abra o trace no
sngrepe filtre a resposta 501. O cabeçalho CSeq mostra qual método foi recusado. - Envie ou capture um OPTIONS para o tronco e leia o cabeçalho Allow da resposta: ele lista os métodos que o equipamento aceita.
- No Asterisk, Issabel ou FreePBX, ative
pjsip set logger on(ousip set debug onno chan_sip) e repita a ação que falhou, como a transferência, para ver qual pedido saiu. - Rode
pjsip show endpoint <tronco>e revise as opções que geram métodos extras, como modo de DTMF e temporizadores de sessão. - No 3CX, ative o log detalhado (Verbose) e confira no Activity Log qual pedido recebeu o 501.
- Se o 501 vier em resposta ao INVITE, procure no SDP ou nos cabeçalhos Require e Supported alguma extensão que o destino não implementa.
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 501 Not Implementede o cabeçalho CSeq com o método recusado. - Qual função falhou para o usuário (transferência, DTMF, chamada inteira).
- O arquivo pcap da captura, se você tiver.
Perguntas frequentes
Qual a diferença entre SIP 501 e SIP 405?
O 501 Not Implemented diz que o servidor não reconhece o método e não o suporta para nenhum usuário. O 405 Method Not Allowed diz que o servidor reconhece o método, mas ele não é permitido para aquele recurso. Nos dois casos, o cabeçalho Allow da resposta ou de um OPTIONS mostra quais métodos o equipamento aceita.
Um 501 na resposta ao OPTIONS derruba o tronco?
Em geral, não. O OPTIONS é usado como teste de vida do tronco, e qualquer resposta mostra que o equipamento do outro lado está no ar. O que importa para as chamadas é a resposta ao INVITE. Confira, porém, se o seu PABX ou SBC trata um 501 ao OPTIONS como falha, porque isso varia conforme a configuração.
Uma chamada de teste real pega esse erro?
Sim, quando ele vem em resposta ao INVITE. Uma chamada de teste real recebe a resposta SIP final que a rede devolve. Quando o resultado conta como falha, a chamada é repetida antes de qualquer alerta, e o alerta segue por e-mail e SMS.