Os códigos de erro SIP são as respostas 4xx, 5xx e 6xx que um servidor SIP devolve quando uma chamada não pode ser completada: 4xx significa que a requisição falhou na outra ponta ou estava errada, 5xx significa que um servidor ou gateway falhou e 6xx significa uma falha global. A tabela abaixo lista os códigos de resposta definidos na RFC 3261, com o significado e a causa típica em uma rota VoIP.
Quais são as classes de códigos de resposta SIP?
Toda resposta SIP tem um código de três dígitos. O primeiro dígito indica a classe: 1xx provisória (a chamada está em andamento), 2xx sucesso, 3xx redirecionamento, 4xx falha do cliente, 5xx falha do servidor, 6xx falha global. Só os códigos de 3xx a 6xx encerram uma tentativa de chamada, então são esses que você vê nos CDRs das chamadas com falha.
Lista de códigos de resposta SIP
| Código | Nome | Significado | Causa típica |
|---|---|---|---|
| 100 | Trying | Requisição recebida, em processamento | Normal, enviado pelo próximo salto |
| 180 | Ringing | O destino está tocando | Normal |
| 181 | Call Is Being Forwarded | Chamada desviada para outro lugar | Desvio na outra ponta |
| 182 | Queued | Destinatário indisponível, chamada em fila | Fila na outra ponta |
| 183 | Session Progress | Informação de progresso, muitas vezes early media | Tom de chamada ou anúncio |
| 200 | OK | Requisição bem-sucedida | Chamada atendida |
| 300 | Multiple Choices | Vários locais possíveis | Servidor de redirecionamento |
| 301 | Moved Permanently | Usuário mudou para um novo endereço | Número ou URI alterado |
| 302 | Moved Temporarily | Tentar de novo no contato informado | Roteamento por redirecionamento |
| 305 | Use Proxy | Precisa passar por um proxy | Raro na prática |
| 380 | Alternative Service | Chamada falhou, alternativas possíveis | Raro na prática |
| 400 | Bad Request | Requisição malformada | Erro de sintaxe ou de cabeçalho |
| 401 | Unauthorized | Autenticação do usuário exigida | Credenciais ausentes ou erradas |
| 402 | Payment Required | Reservado para uso futuro | Alguns switches o usam para falta de crédito |
| 403 | Forbidden | Entendida, mas recusada | IP não permitido, destino bloqueado, sem saldo |
| 404 | Not Found | O usuário não existe no domínio | Número, prefixo ou formato errado |
| 405 | Method Not Allowed | Método não suportado para este endereço | Configuração incompatível |
| 406 | Not Acceptable | Conteúdo não aceitável | Cabeçalho Accept incompatível |
| 407 | Proxy Authentication Required | O proxy pede credenciais | Desafio normal, ou senha errada |
| 408 | Request Timeout | Nenhuma resposta a tempo | Próximo salto inalcançável ou lento |
| 410 | Gone | Usuário não está mais disponível | Número desativado |
| 413 | Request Entity Too Large | Corpo grande demais | SDP grande demais |
| 414 | Request-URI Too Long | URI longa demais | Saída do plano de discagem com erro |
| 415 | Unsupported Media Type | Formato do corpo não suportado | Content type errado |
| 416 | Unsupported URI Scheme | Esquema de URI não reconhecido | tel ou sips não suportado |
| 420 | Bad Extension | Extensão exigida desconhecida | Cabeçalho Require incompatível |
| 421 | Extension Required | O servidor precisa de uma extensão | Cabeçalho Supported ausente |
| 423 | Interval Too Brief | Validade do registro curta demais | Valor de Expires baixo |
| 480 | Temporarily Unavailable | Destinatário alcançado, mas indisponível | Telefone desligado, sem resposta, sem rota |
| 481 | Call/Transaction Does Not Exist | Diálogo ou transação desconhecidos | Estado perdido, BYE atrasado |
| 482 | Loop Detected | A requisição entrou em loop | Loop de roteamento entre carriers |
| 483 | Too Many Hops | Max-Forwards chegou a zero | Loop de roteamento ou cadeia longa |
| 484 | Address Incomplete | Número curto demais | Dígitos faltando |
| 485 | Ambiguous | Endereço ambíguo | Raro na prática |
| 486 | Busy Here | Destinatário ocupado neste terminal | Linha ocupada |
| 487 | Request Terminated | Requisição cancelada | Quem ligou desligou antes do atendimento |
| 488 | Not Acceptable Here | Descrição da sessão não aceitável | Nenhum codec em comum |
| 491 | Request Pending | Outra requisição em andamento | re-INVITEs simultâneos |
| 493 | Undecipherable | Corpo criptografado ilegível | Problema de chave S/MIME |
| 500 | Server Internal Error | Condição inesperada no servidor | Falha do switch ou causa não mapeada |
| 501 | Not Implemented | Método não suportado | Recurso não suportado |
| 502 | Bad Gateway | Resposta inválida vinda adiante | O próximo carrier falhou |
| 503 | Service Unavailable | Sobrecarregado ou em manutenção | Sem capacidade, limite de CPS ou de canais |
| 504 | Server Time-out | Nenhuma resposta a tempo vinda adiante | O próximo carrier não respondeu |
| 505 | Version Not Supported | Versão do SIP não suportada | Equipamento muito antigo |
| 513 | Message Too Large | Mensagem acima do limite do servidor | Pacote grande demais sobre UDP |
| 600 | Busy Everywhere | Destinatário ocupado em todos os terminais | Usuário ocupado |
| 603 | Decline | O destinatário não quer atender | Chamada rejeitada pelo usuário |
| 604 | Does Not Exist Anywhere | O usuário não existe em lugar nenhum | Número inválido |
| 606 | Not Acceptable | Sessão não aceitável | Mídia não suportada |
RFCs posteriores acrescentaram mais códigos (por exemplo 422 Session Interval Too Small, da RFC 4028). Os carriers também mapeiam causas da rede telefônica para códigos SIP, então o código de causa Q.850 no cabeçalho Reason muitas vezes diz mais do que o código SIP sozinho.
O que significa SIP 503?
503 Service Unavailable significa que o servidor está temporariamente incapaz de tratar a chamada, por sobrecarga ou manutenção. Em rotas wholesale, geralmente significa falta de capacidade: o limite de canais ou de CPS foi atingido, não há fornecedor disponível para o destino ou a conta está bloqueada. Detalhes e soluções: SIP 503 Service Unavailable.
O que significa SIP 487?
487 Request Terminated é a resposta a um INVITE cancelado antes do atendimento, geralmente porque quem ligou desligou ou um dialer parou de chamar. É normal, mas uma parcela alta indica timeouts de toque curtos ou post-dial delay alto. Veja SIP 487 Request Terminated.
O que significam SIP 408, 480 e 486?
408 Request Timeout significa que nenhuma resposta final chegou a tempo. 480 Temporarily Unavailable significa que o destinatário foi alcançado, mas não pode atender agora. 486 Busy Here significa que a linha está ocupada. Os três afetam o ASR. Veja SIP 408, 480 e 486 explicados e leia ASR, ACD e PDD para entender como esses códigos moldam as estatísticas das rotas.
Lendo os códigos SIP nas suas rotas
Agrupe as chamadas com falha por código SIP, por destino e por fornecedor nos seus CDRs. Um salto repentino de 503 ou 403 geralmente é problema do fornecedor ou da conta; um salto de 404 ou 484 geralmente é problema de formato de número do seu lado. Se uma rota continua falhando, o VoIPMatcher pode obter uma rota alternativa de terminação VoIP junto aos seus carriers: solicite uma rota VoIP.
Perguntas frequentes
O que é SIP 403 Forbidden?
403 Forbidden significa que o servidor entendeu a requisição, mas se recusa a processá-la, e tentar de novo com as mesmas credenciais não adianta. Em rotas VoIP, as causas habituais são um IP de origem que não está na whitelist, um destino que a conta não pode chamar, saldo pré-pago esgotado ou um caller ID que o carrier rejeita.
O que é SIP 404 Not Found?
404 Not Found significa que o servidor tem certeza de que o usuário chamado não existe naquele domínio. Em chamadas de saída, quase sempre indica um problema no número: código do país errado, um prefixo técnico faltando ou sobrando, formato fora do padrão E.164 ou um número não atribuído na rede de destino.
Qual a diferença entre SIP 401 e 407?
Os dois pedem autenticação. O 401 Unauthorized vem do servidor de destino, geralmente um registrar, enquanto o 407 Proxy Authentication Required vem de um proxy no caminho. Um único 401 ou 407 seguido de um novo INVITE com credenciais é normal. Desafios repetidos significam que o usuário, a senha ou o realm estão errados.
O que é SIP 488 Not Acceptable Here?
O 488 significa que a outra ponta não aceita a sessão descrita no SDP, na maioria das vezes porque não há codec em comum. Verifique se a sua oferta inclui um codec suportado pela rota, normalmente G.711 ou G.729, e se as configurações de DTMF e fax (RFC 2833 ou T.38) batem com o que o fornecedor espera.
Quais códigos SIP contam como chamadas com falha no ASR?
O ASR conta as chamadas atendidas (200 OK) sobre o total de tentativas, então toda resposta final 3xx, 4xx, 5xx ou 6xx o reduz. Muitos carriers também informam o NER, que trata resultados do lado do usuário, como ocupado, sem resposta e chamada rejeitada, como resultados de rede bem-sucedidos, isolando assim as falhas causadas pela rede e pela própria rota.
Precisa de uma rota?
Envie o destino, o tipo de rota e a tarifa alvo. Respondemos com o que podemos entregar.