Códigos SIP

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.

SIP 501 na referência
Código501
Nome oficialNot Implemented
Classe5xx: falha do servidor
Definido emRFC 3261
Causas Q.850 que costumam vir junto29 (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ú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 (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

  1. Abra o trace no sngrep e filtre a resposta 501. O cabeçalho CSeq mostra qual método foi recusado.
  2. 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.
  3. No Asterisk, Issabel ou FreePBX, ative pjsip set logger on (ou sip set debug on no chan_sip) e repita a ação que falhou, como a transferência, para ver qual pedido saiu.
  4. Rode pjsip show endpoint <tronco> e revise as opções que geram métodos extras, como modo de DTMF e temporizadores de sessão.
  5. No 3CX, ative o log detalhado (Verbose) e confira no Activity Log qual pedido recebeu o 501.
  6. 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 Implemented e 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.

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.