I codici di errore SIP sono le risposte 4xx, 5xx e 6xx che un server SIP restituisce quando una chiamata non può essere completata: 4xx significa che la richiesta è fallita sul lato remoto o era sbagliata, 5xx che un server o un gateway ha avuto un guasto, 6xx un errore globale. La tabella qui sotto elenca i codici di risposta definiti nell'RFC 3261 con il loro significato e la causa tipica su una rotta VoIP.
Quali sono le classi dei codici di risposta SIP?
Ogni risposta SIP ha un codice a tre cifre. La prima cifra indica la classe: 1xx provvisoria (la chiamata sta procedendo), 2xx successo, 3xx reindirizzamento, 4xx errore del client, 5xx errore del server, 6xx errore globale. Solo i codici da 3xx a 6xx chiudono un tentativo di chiamata, quindi sono questi i codici che vedi nei CDR per le chiamate fallite.
Elenco dei codici di risposta SIP
| Codice | Nome | Significato | Causa tipica |
|---|---|---|---|
| 100 | Trying | Richiesta ricevuta, in elaborazione | Normale, inviato dall'hop successivo |
| 180 | Ringing | La destinazione sta squillando | Normale |
| 181 | Call Is Being Forwarded | Chiamata inoltrata altrove | Inoltro sul lato remoto |
| 182 | Queued | Chiamato non disponibile, chiamata in coda | Coda sul lato remoto |
| 183 | Session Progress | Informazioni di avanzamento, spesso early media | Tono di richiamata o annuncio |
| 200 | OK | Richiesta riuscita | Chiamata con risposta |
| 300 | Multiple Choices | Più posizioni possibili | Server di reindirizzamento |
| 301 | Moved Permanently | Utente spostato a un nuovo indirizzo | Numero o URI cambiato |
| 302 | Moved Temporarily | Riprovare al contatto indicato | Instradamento basato su redirect |
| 305 | Use Proxy | Bisogna passare da un proxy | Raro nella pratica |
| 380 | Alternative Service | Chiamata fallita, alternative possibili | Raro nella pratica |
| 400 | Bad Request | Richiesta malformata | Errore di sintassi o di header |
| 401 | Unauthorized | Serve l'autenticazione dell'utente | Credenziali mancanti o sbagliate |
| 402 | Payment Required | Riservato per uso futuro | Alcuni switch lo usano per credito esaurito |
| 403 | Forbidden | Capita ma rifiutata | IP non autorizzato, destinazione bloccata, credito esaurito |
| 404 | Not Found | L'utente non esiste nel dominio | Numero, prefisso o formato sbagliato |
| 405 | Method Not Allowed | Metodo non supportato per questo indirizzo | Configurazione non allineata |
| 406 | Not Acceptable | Contenuto non accettabile | Header Accept non compatibile |
| 407 | Proxy Authentication Required | Il proxy chiede le credenziali | Richiesta normale, o password sbagliata |
| 408 | Request Timeout | Nessuna risposta in tempo | Hop successivo irraggiungibile o lento |
| 410 | Gone | Utente non più disponibile | Numero cessato |
| 413 | Request Entity Too Large | Corpo troppo grande | SDP sovradimensionato |
| 414 | Request-URI Too Long | URI troppo lungo | Output del dialplan errato |
| 415 | Unsupported Media Type | Formato del corpo non supportato | Content type sbagliato |
| 416 | Unsupported URI Scheme | Schema URI non riconosciuto | tel o sips non supportati |
| 420 | Bad Extension | Estensione richiesta sconosciuta | Header Require non compatibile |
| 421 | Extension Required | Il server richiede un'estensione | Header Supported mancante |
| 423 | Interval Too Brief | Scadenza della registrazione troppo breve | Valore Expires basso |
| 480 | Temporarily Unavailable | Chiamato raggiunto ma non disponibile | Telefono spento, nessuna risposta, nessuna rotta |
| 481 | Call/Transaction Does Not Exist | Dialogo o transazione sconosciuti | Stato perso, BYE in ritardo |
| 482 | Loop Detected | La richiesta è andata in loop | Loop di instradamento tra carrier |
| 483 | Too Many Hops | Max-Forwards arrivato a zero | Loop di instradamento o catena lunga |
| 484 | Address Incomplete | Numero troppo corto | Cifre mancanti |
| 485 | Ambiguous | Indirizzo ambiguo | Raro nella pratica |
| 486 | Busy Here | Chiamato occupato su questo terminale | Linea occupata |
| 487 | Request Terminated | Richiesta annullata | Il chiamante ha riattaccato prima della risposta |
| 488 | Not Acceptable Here | Descrizione della sessione non accettabile | Nessun codec in comune |
| 491 | Request Pending | Un'altra richiesta è in corso | re-INVITE simultanei |
| 493 | Undecipherable | Il corpo cifrato non si può leggere | Problema di chiave S/MIME |
| 500 | Server Internal Error | Condizione imprevista del server | Guasto dello switch o causa non mappata |
| 501 | Not Implemented | Metodo non supportato | Funzione non supportata |
| 502 | Bad Gateway | Risposta non valida dal nodo a valle | Il carrier successivo ha fallito |
| 503 | Service Unavailable | Sovraccarico o in manutenzione | Nessuna capacità, limite di CPS o di canali |
| 504 | Server Time-out | Nessuna risposta tempestiva dal nodo a valle | Il carrier successivo non ha risposto |
| 505 | Version Not Supported | Versione SIP non supportata | Apparati molto vecchi |
| 513 | Message Too Large | Il messaggio supera il limite del server | Pacchetto troppo grande su UDP |
| 600 | Busy Everywhere | Chiamato occupato su tutti i terminali | Utente occupato |
| 603 | Decline | Il chiamato non vuole prendere la chiamata | Chiamata rifiutata dall'utente |
| 604 | Does Not Exist Anywhere | L'utente non esiste da nessuna parte | Numero non valido |
| 606 | Not Acceptable | Sessione non accettabile | Media non supportati |
RFC successive hanno aggiunto altri codici (per esempio 422 Session Interval Too Small, dall'RFC 4028). I carrier inoltre mappano le cause della rete telefonica sui codici SIP, quindi il cause code Q.850 nell'header Reason spesso dice più del solo codice SIP.
Cosa significa SIP 503?
503 Service Unavailable significa che il server momentaneamente non può gestire la chiamata, per sovraccarico o manutenzione. Sulle rotte wholesale di solito significa mancanza di capacità: limite di canali o di CPS raggiunto, nessun fornitore disponibile per la destinazione o account bloccato. Dettagli e soluzioni: SIP 503 Service Unavailable.
Cosa significa SIP 487?
487 Request Terminated è la risposta a un INVITE annullato prima della risposta, di solito perché il chiamante ha riattaccato o un dialer ha smesso di far squillare. È normale, ma una quota alta indica timeout di squillo brevi o post-dial delay alto. Vedi SIP 487 Request Terminated.
Cosa significano SIP 408, 480 e 486?
408 Request Timeout significa che non è arrivata in tempo una risposta finale. 480 Temporarily Unavailable significa che il chiamato è stato raggiunto ma ora non può prendere la chiamata. 486 Busy Here significa che la linea è occupata. Tutti e tre incidono sull'ASR. Vedi SIP 408, 480 e 486 spiegati, e leggi ASR, ACD e PDD per capire come questi codici influenzano le statistiche delle rotte.
Leggere i codici SIP sulle tue rotte
Raggruppa le chiamate fallite per codice SIP, per destinazione e per fornitore nei tuoi CDR. Un salto improvviso di 503 o 403 di solito è un problema del fornitore o dell'account; un salto di 404 o 484 di solito è un problema di formato dei numeri dalla tua parte. Se una rotta continua a fallire, VoIPMatcher può procurare dai suoi carrier una rotta alternativa di terminazione VoIP: richiedi una rotta VoIP.
Domande frequenti
Cos'è SIP 403 Forbidden?
403 Forbidden significa che il server ha capito la richiesta ma si rifiuta di elaborarla, e riprovare con le stesse credenziali non serve. Sulle rotte VoIP le cause abituali sono un IP sorgente non in whitelist, una destinazione che l'account non è autorizzato a chiamare, un credito prepagato esaurito o un caller ID che il carrier rifiuta.
Cos'è SIP 404 Not Found?
404 Not Found significa che il server è sicuro che l'utente chiamato non esiste in quel dominio. Sulle chiamate in uscita indica quasi sempre un problema di numerazione: prefisso internazionale sbagliato, prefisso tecnico mancante o di troppo, formato non E.164 o numero non assegnato sulla rete di destinazione.
Che differenza c'è tra SIP 401 e 407?
Entrambi chiedono l'autenticazione. 401 Unauthorized arriva dal server di destinazione, di solito un registrar, mentre 407 Proxy Authentication Required arriva da un proxy lungo il percorso. Un singolo 401 o 407 seguito da un nuovo INVITE con le credenziali è normale. Richieste ripetute significano che username, password o realm sono sbagliati.
Cos'è SIP 488 Not Acceptable Here?
488 significa che il lato remoto non può accettare la sessione descritta nell'SDP, il più delle volte perché non c'è un codec in comune. Verifica che la tua offerta includa un codec supportato dalla rotta, di solito G.711 o G.729, e che le impostazioni DTMF e fax (RFC 2833 o T.38) corrispondano a quelle che il fornitore si aspetta.
Quali codici SIP contano come chiamate fallite nell'ASR?
L'ASR conta le chiamate con risposta (200 OK) rispetto a tutti i tentativi, quindi ogni risposta finale 3xx, 4xx, 5xx o 6xx lo abbassa. Molti carrier riportano anche la NER, che considera esiti di rete riusciti i risultati lato utente come occupato, mancata risposta e chiamata rifiutata, e così isola i fallimenti causati dalla rete e dalla rotta stessa.
Ti serve una rotta?
Mandaci destinazione, tipo di rotta e tariffa target. Ti rispondiamo con quello che possiamo offrirti.