Les codes d'erreur SIP sont les réponses 4xx, 5xx et 6xx qu'un serveur SIP renvoie quand un appel ne peut pas aboutir : 4xx signifie que la requête a échoué à l'extrémité distante ou était incorrecte, 5xx qu'un serveur ou une passerelle a échoué, et 6xx un échec global. Le tableau ci-dessous liste les codes de réponse définis dans la RFC 3261, avec leur sens et leur cause typique sur une route VoIP.
Quelles sont les classes de codes de réponse SIP ?
Chaque réponse SIP porte un code à trois chiffres. Le premier chiffre donne la classe : 1xx provisoire (l'appel progresse), 2xx succès, 3xx redirection, 4xx échec client, 5xx échec serveur, 6xx échec global. Seuls les codes 3xx à 6xx terminent une tentative d'appel : ce sont donc ceux que vous voyez dans les CDR pour les appels échoués.
Liste des codes de réponse SIP
| Code | Nom | Sens | Cause typique |
|---|---|---|---|
| 100 | Trying | Requête reçue, en cours de traitement | Normal, envoyé par le saut suivant |
| 180 | Ringing | La destination sonne | Normal |
| 181 | Call Is Being Forwarded | Appel renvoyé ailleurs | Renvoi à l'extrémité distante |
| 182 | Queued | Appelé indisponible, appel mis en file | File d'attente à l'extrémité distante |
| 183 | Session Progress | Information de progression, souvent early media | Tonalité de retour d'appel ou annonce |
| 200 | OK | Requête réussie | Appel répondu |
| 300 | Multiple Choices | Plusieurs emplacements possibles | Serveur de redirection |
| 301 | Moved Permanently | Utilisateur déplacé vers une nouvelle adresse | Numéro ou URI modifié |
| 302 | Moved Temporarily | Réessayer vers le contact indiqué | Routage par redirection |
| 305 | Use Proxy | Doit passer par un proxy | Rare en pratique |
| 380 | Alternative Service | Appel échoué, alternatives possibles | Rare en pratique |
| 400 | Bad Request | Requête mal formée | Erreur de syntaxe ou d'en-tête |
| 401 | Unauthorized | Authentification utilisateur requise | Identifiants absents ou faux |
| 402 | Payment Required | Réservé pour un usage futur | Certains switches l'utilisent pour le crédit épuisé |
| 403 | Forbidden | Compris mais refusé | IP non autorisée, destination bloquée, solde nul |
| 404 | Not Found | L'utilisateur n'existe pas dans le domaine | Mauvais numéro, préfixe ou format |
| 405 | Method Not Allowed | Méthode non prise en charge pour cette adresse | Configuration incohérente |
| 406 | Not Acceptable | Contenu non acceptable | En-tête Accept incompatible |
| 407 | Proxy Authentication Required | Le proxy demande des identifiants | Demande normale, ou mot de passe faux |
| 408 | Request Timeout | Pas de réponse à temps | Saut suivant injoignable ou lent |
| 410 | Gone | Utilisateur plus disponible | Numéro résilié |
| 413 | Request Entity Too Large | Corps trop volumineux | SDP surdimensionné |
| 414 | Request-URI Too Long | URI trop longue | Mauvaise sortie du plan de numérotation |
| 415 | Unsupported Media Type | Format du corps non pris en charge | Mauvais type de contenu |
| 416 | Unsupported URI Scheme | Schéma d'URI non compris | tel ou sips non pris en charge |
| 420 | Bad Extension | Extension requise inconnue | En-tête Require incompatible |
| 421 | Extension Required | Le serveur exige une extension | En-tête Supported manquant |
| 423 | Interval Too Brief | Expiration de l'enregistrement trop courte | Valeur Expires trop basse |
| 480 | Temporarily Unavailable | Appelé atteint mais indisponible | Téléphone éteint, pas de réponse, pas de route |
| 481 | Call/Transaction Does Not Exist | Dialogue ou transaction inconnu | État perdu, BYE tardif |
| 482 | Loop Detected | La requête a bouclé | Boucle de routage entre carriers |
| 483 | Too Many Hops | Max-Forwards arrivé à zéro | Boucle de routage ou chaîne trop longue |
| 484 | Address Incomplete | Numéro trop court | Chiffres manquants |
| 485 | Ambiguous | Adresse ambiguë | Rare en pratique |
| 486 | Busy Here | Appelé occupé sur ce terminal | Ligne occupée |
| 487 | Request Terminated | Requête annulée | L'appelant a raccroché avant la réponse |
| 488 | Not Acceptable Here | Description de session non acceptable | Aucun codec commun |
| 491 | Request Pending | Une autre requête est en cours | re-INVITE simultanés |
| 493 | Undecipherable | Corps chiffré illisible | Problème de clé S/MIME |
| 500 | Server Internal Error | Condition inattendue du serveur | Défaut du switch ou cause non mappée |
| 501 | Not Implemented | Méthode non prise en charge | Fonction non prise en charge |
| 502 | Bad Gateway | Réponse invalide de l'aval | Le carrier suivant a échoué |
| 503 | Service Unavailable | Surchargé ou en maintenance | Pas de capacité, limite de CPS ou de canaux |
| 504 | Server Time-out | Pas de réponse à temps de l'aval | Le carrier suivant n'a pas répondu |
| 505 | Version Not Supported | Version SIP non prise en charge | Équipement très ancien |
| 513 | Message Too Large | Message au-delà de la limite du serveur | Paquet surdimensionné en UDP |
| 600 | Busy Everywhere | Appelé occupé sur tous ses terminaux | Utilisateur occupé |
| 603 | Decline | L'appelé ne veut pas prendre l'appel | Appel rejeté par l'utilisateur |
| 604 | Does Not Exist Anywhere | L'utilisateur n'existe nulle part | Numéro invalide |
| 606 | Not Acceptable | Session non acceptable | Média non pris en charge |
Des RFC ultérieures ont ajouté d'autres codes (par exemple 422 Session Interval Too Small, de la RFC 4028). Les carriers font aussi correspondre les causes du réseau téléphonique aux codes SIP : le code de cause Q.850 de l'en-tête Reason en dit donc souvent plus que le code SIP seul.
Que signifie SIP 503 ?
503 Service Unavailable signifie que le serveur est temporairement incapable de traiter l'appel, pour cause de surcharge ou de maintenance. Sur les routes wholesale, cela veut en général dire qu'il n'y a pas de capacité : limite de canaux ou de CPS atteinte, aucun fournisseur disponible pour la destination, ou compte bloqué. Détails et solutions : SIP 503 Service Unavailable.
Que signifie SIP 487 ?
487 Request Terminated est la réponse à un INVITE annulé avant la réponse, en général parce que l'appelant a raccroché ou qu'un dialer a arrêté la sonnerie. C'est normal, mais une forte proportion révèle des délais de sonnerie trop courts ou un post-dial delay élevé. Voir SIP 487 Request Terminated.
Que signifient SIP 408, 480 et 486 ?
408 Request Timeout signifie qu'aucune réponse finale n'est arrivée à temps. 480 Temporarily Unavailable signifie que l'appelé a été atteint mais ne peut pas prendre l'appel maintenant. 486 Busy Here signifie que la ligne est occupée. Les trois pèsent sur l'ASR. Voir SIP 408, 480 et 486 expliqués, et lisez ASR, ACD et PDD pour voir comment ces codes façonnent les statistiques de route.
Lire les codes SIP sur vos routes
Regroupez les appels échoués par code SIP, par destination et par fournisseur dans vos CDR. Un saut soudain des 503 ou des 403 est en général un problème de fournisseur ou de compte ; un saut des 404 ou des 484 est en général un problème de format de numéro de votre côté. Si une route continue d'échouer, VoIPMatcher peut sourcer une route de terminaison VoIP alternative auprès de ses carriers : demandez une route VoIP.
Questions fréquentes
Qu'est-ce que SIP 403 Forbidden ?
403 Forbidden signifie que le serveur a compris la requête mais refuse de la traiter, et réessayer avec les mêmes identifiants n'y changera rien. Sur les routes VoIP, les causes habituelles sont une IP source non autorisée, une destination que le compte n'a pas le droit d'appeler, un solde prépayé épuisé ou un numéro d'appelant refusé par le carrier.
Qu'est-ce que SIP 404 Not Found ?
404 Not Found signifie que le serveur est certain que l'appelé n'existe pas dans ce domaine. Sur les appels sortants, cela désigne presque toujours un problème de numéro : mauvais indicatif pays, préfixe technique manquant ou en trop, format non E.164, ou numéro non attribué sur le réseau de destination.
Quelle est la différence entre SIP 401 et 407 ?
Les deux demandent une authentification. 401 Unauthorized vient du serveur de destination, en général un registrar, alors que 407 Proxy Authentication Required vient d'un proxy sur le chemin. Un seul 401 ou 407 suivi d'un nouvel INVITE avec identifiants est normal. Des demandes répétées signifient que le nom d'utilisateur, le mot de passe ou le realm est faux.
Qu'est-ce que SIP 488 Not Acceptable Here ?
488 signifie que l'extrémité distante ne peut pas accepter la session décrite dans le SDP, le plus souvent parce qu'il n'y a aucun codec en commun. Vérifiez que votre offre inclut un codec pris en charge par la route, typiquement G.711 ou G.729, et que les réglages DTMF et fax (RFC 2833 ou T.38) correspondent à ce qu'attend le fournisseur.
Quels codes SIP comptent comme appels échoués dans l'ASR ?
L'ASR rapporte les appels répondus (200 OK) à l'ensemble des tentatives : toute réponse finale 3xx, 4xx, 5xx ou 6xx le fait donc baisser. Beaucoup de carriers publient aussi le NER, qui compte les issues côté utilisateur comme occupé, pas de réponse et appel rejeté comme des succès réseau, afin d'isoler les échecs dus au réseau et à la route.
Besoin d'une route ?
Indiquez la destination, le type de route et le tarif cible. Nous vous répondons avec ce que nous pouvons fournir.