Résolution des problèmes liés aux codes de réponse de fin d’appel pour le Kit de développement logiciel (SDK) Calling, du Kit de développement logiciel (SDK) Call Automation, du PSTN, du Kit de développement logiciel (SDK) chat et du Kit de développement logiciel (SDK) SMS
Cet article décrit la résolution des problèmes liés aux codes de réponse de fin d’appel pour le Kit de développement logiciel (SDK) Calling, Call Automation et les appels RTC.
Conseils de dépannage
Tenez compte des conseils suivants lors de la résolution :
- Votre application ne reçoit pas d’événement
IncomingCall Event Grid: vérifiez que le point de terminaison de l’application est validé avec Event Grid lors de la création d’un abonnement aux événements. L’état de provisionnement de votre abonnement aux événements est marqué comme réussi si la validation a réussi. - Pour l’erreur
The field CallbackUri is invalid: Call Automation ne prend pas en charge les points de terminaison HTTP. Vérifiez que l’URL de rappel que vous fournissez prend en charge HTTPS. - L’action
PlayAudion’est pas lue : actuellement, seul le format de fichier Wave (.wav) est pris en charge pour les fichiers audio. Le contenu audio dans le fichier d’ondes doit être mono (canal unique), des échantillons 16 bits avec un taux d’échantillonnage de 16 000 (16 KHz). - Les actions sur les points de terminaison RTC ne fonctionnent pas : pour
CreateCall,Transfer,AddParticipantetRedirectsur des numéros de téléphone, vous devez définir laSourceCallerIddans la demande d’action. Sauf si vous utilisez un routage direct, l’ID de l’appelant source doit être un numéro de téléphone appartenant à votre ressource Communication Services pour que l’action réussisse.
Pour plus d’informations sur les problèmes suivis par l’équipe produit, consultez problèmes connus.
Remarque
Les catégories de messages et de résultats répertoriées dans les tableaux suivants sont en préversion publique. Pour plus d’informations, consultez Conditions d’Utilisation Supplémentaires relatives aux Évaluations Microsoft Azure.
Présentation des codes appelants et des erreurs de sous-codes
Les codes d’erreur, les sous-codes et les catégories de résultats correspondants aident les développeurs à identifier et diagnostiquer les erreurs. Ces codes d’erreur sont exposés via la propriété call.callEndReason à l’issue d’un appel.
Les détails du code d’erreur sont les suivants :
Code - sont des entiers à 3 chiffres représentant l’état de réponse du client ou du serveur. Catégories de code :
- Réponses réussies (200-299)
- Erreur du client (400-499)
- Erreur du serveur (500-599)
- Erreur globale (600-699)
Sous-code Sont définis en tant qu’entier, où chaque nombre indique une raison unique, spécifique à un groupe de scénarios ou à un résultat de scénario spécifique.
Message : décrit le résultat et fournit des indications sur la façon d’atténuer le problème si un résultat est un échec.
ResultCategory : indique le type de l’erreur. Selon le contexte, la valeur peut être Success, ExpectedError, UnexpectedClientError ou UnexpectedServerError.
Codes d’erreur et sous-codes du client du Kit de développement logiciel (SDK) Appel d’Azure Communication Services
Pour les erreurs client, si la propriété resultCategories est ExpectedError, l'erreur est attendue du point de vue du SDK. Ces erreurs sont généralement rencontrées dans les échecs de condition préalable, tels que les arguments incorrects passés par l’application, ou lorsque l’état système actuel n’autorise pas l’appel d’API. L’application doit vérifier la raison de l’erreur et la logique d’appel de l’API.
| Sous-code | Code | Message | Catégorie de résultats | Conseils |
|---|---|---|---|---|
| 40101 | 408 | Échec de la création de CallAgent. Réessayez, si le problème persiste, rassemblez les journaux de la console du navigateur, .HAR fichier et contactez le support Azure Communication Services. |
UnexpectedClientError | |
| 40104 | 408 | Échec de la création de CallAgent. Réessayez, si le problème persiste, rassemblez les journaux de la console du navigateur, .HAR fichier et contactez le support Azure Communication Services. |
UnexpectedClientError | |
| 40114 | 408 | Échec de la connexion à l’infrastructure Azure Communication Services. Réessayez et vérifiez les demandes réseau du navigateur. Si les demandes continuent d’échouer, réunissez les journaux de la console du navigateur, le fichier .HAR et contactez le support Azure Communication Services. |
UnexpectedClientError | Pour plus d’informations, consultez Configuration exigée pour le réseau. |
| 40115 | 412 | Échec de la création de CallAgent, impossible d’initialiser la connexion à l’infrastructure Azure Communication Services. Réessayez et vérifiez les demandes réseau du navigateur. Si les demandes continuent d’échouer, réunissez les journaux de la console du navigateur, le fichier .HAR et contactez le support Azure Communication Services. |
UnexpectedClientError | Pour plus d’informations, consultez Configuration exigée pour le réseau. |
| 40216 | 500 | Échec de la création de CallAgent. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | |
| 40228 | 409 | Impossible de créer CallAgent, une instance de CallAgent associée à cette identité existe déjà. Supprimez l’élément CallAgent existant, ou créez-en un avec une identité différente. | ExpectedError | |
| 40230 | 409 | Impossible de créer TeamsCallAgent, une instance de TeamsCallAgent associée à cette identité existe déjà. Supprimez l’objet TeamsCallAgent existant avant d’en créer un nouveau. | ExpectedError | |
| 40606 | 405 | Échec de l’énumération des haut-parleurs, l’énumération et la sélection de haut-parleurs n’est pas prise en charge sur Android Chrome, iOS Safari et macOS Safari. | ExpectedError | L’énumération/sélection d’intervenants n’est pas prise en charge sur Android Chrome, iOS Safari et macOS Safari. Le système d’exploitation sélectionne automatiquement l’orateur (périphérique de sortie). Découvrez-en davantage sur la gestion des appareils et sur la meilleure façon d’atténuer ces problèmes. |
| 40613 | 400 | Échec de l’obtention de l’autorisation pour l’utilisation du microphone et/ou de la caméra. Elle a été refusée ou elle a échoué. Veillez à accorder les autorisations dans les paramètres du navigateur et dans les paramètres du système d’exploitation. | ExpectedError | Découvrez-en davantage sur la gestion optimale des autorisations d’appareil. |
| 40614 | 500 | Échec de la demande d’autorisations d’appareil. Vérifiez que vous avez accordé les autorisations dans les paramètres du navigateur et dans les paramètres du système d’exploitation, puis réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | Découvrez-en davantage sur la gestion optimale des autorisations d’appareil. |
| 41006 | 400 | Échec de l’acceptation de l’appel entrant, il n’est pas dans l’état Sonnerie. Abonnez-vous à l’événement incomingCall callAgent pour accepter l’appel entrant. |
ExpectedError | Consultez les articles suivants pour identifier la cause racine du problème - Recevoir un appel entrant - S’abonner aux événements SDK |
| 41007 | 400 | Échec du rejet de l’appel entrant, il n’est pas dans l’état Sonnerie. Abonnez-vous à l’événement incomingCall callAgent pour rejeter l’appel entrant. |
ExpectedError | Consultez les articles suivants pour identifier la cause racine du problème - Recevoir un appel entrant - S’abonner aux événements SDK |
| 41015 | 500 | Impossible de désactiver le microphone. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | |
| 41016 | 400 | Échec de l’activation du microphone. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | |
| 41025 | 400 | Échec du démarrage de la vidéo, l’instance LocalVideoStream est invalide ou vide. Transmettez une instance LocalVideoStream. | ExpectedError | Vérifiez que l’objet passé pour démarrer la vidéo est une instance de LocalVideoStream. Construisez un LocalVideoStream à l’aide d’un objet VideoDeviceInfo ou d’un objet MediaStream . Consultez les articles suivants pour identifier la cause racine du problème : - Passer un appel avec une caméra vidéo - Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel - Accéder aux vidéos brutes |
| 41027 | 400 | Échec du démarrage de la vidéo, la vidéo est déjà lancée. | ExpectedError | Liens utiles : - Passer un appel avec une caméra vidéo - Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel |
| 41030 | 400 | Échec de l’arrêt de la vidéo, la vidéo est déjà arrêtée. | ExpectedError | Liens utiles : - Passer un appel avec une caméra vidéo - Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel |
| 41032 | 400 | Échec de l’arrêt de la vidéo, argument non valide. Le LocalVideoStream utilisé comme entrée n’est pas en cours d’envoi. | ExpectedError | LocalVideoStream envoyé dans l’appel est stocké dans le tableau Call.localVideoStreams[] et il est de type Video ou RawMedia. Consultez les articles suivants pour identifier la cause racine du problème : - Passer un appel avec une caméra vidéo - Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel - Accéder aux vidéos brutes |
| 41033 | 500 | Échec de la mise en suspens de l’appel. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | |
| 41034 | 500 | Échec de la reprise de l’appel. Réessayez. Si le problème persiste, réunissez les journaux de la console du navigateur et contactez le support Azure Communication Services. | UnexpectedClientError | |
| 41035 | 400 | Échec du démarrage du partage d’écran. Le partage d’écran est déjà lancé. | ExpectedError | En savoir plus sur comment démarrer et arrêter le partage d’écran lors d’un appel |
| 41041 | 400 | Échec de l’arrêt du partage d’écran, le partage d’écran est déjà arrêté. | ExpectedError | En savoir plus sur comment démarrer et arrêter le partage d’écran lors d’un appel |
| 41048 | 410 | Échec du démarrage de la vidéo pendant le processus de configuration des appels. Veillez à accorder les autorisations vidéo dans les paramètres du navigateur et dans les paramètres du système d’exploitation, et vérifiez que la caméra n’est pas utilisée par un autre processus. | UnexpectedClientError | - L’appareil photo peut être désactivé dans le système. - La caméra est utilisée par un autre processus. |
| 41056 | 412 | Échec du démarrage ou de la jonction à l’appel, la stratégie de voix Entreprise Teams n’est pas activée pour cette ressource Azure Communication Services. Suivez le didacticiel en ligne pour l’activer. | ExpectedError | Consultez Comment activer Voix Entreprise en ligne et la messagerie vocale de système téléphonique pour les utilisateurs pour activer la stratégie de voix Entreprise Teams |
| 41071 | 412 | Échec du démarrage du partage d’écran, l’appel n’est pas dans l’état Connecté. Abonnez-vous à l’événement stateChanged de l’appel pour savoir quand l’appel est connecté. |
ExpectedError | Liens utiles : - Vérifier les propriétés de l’appel - S’abonner aux événements SDK |
| 41073 | 412 | Échec de l’obtention ou de la définition de MediaStream personnalisé, cette fonctionnalité est actuellement désactivée par Azure Communication Services. | ExpectedError | |
| 43000 | 412 | Échec du démarrage de la vidéo, l’appareil vidéo est utilisé par un autre processus ou une autre application. Arrêtez l’utilisation de votre caméra dans l’autre processus ou application, puis réessayez. | ExpectedError | Découvrez plus en détail comment mieux gérer une caméra utilisée par un autre processus |
| 43001 | 403 | Impossible de démarrer la vidéo, l’autorisation pour utiliser l’appareil vidéo sélectionné n’a pas été accordée. Vérifiez que les autorisations d’appareil vidéo sont autorisées dans les paramètres du navigateur et dans les paramètres du système. | ExpectedError | Vérifiez que les autorisations de caméra sont autorisées dans les paramètres du navigateur et les paramètres système de l’appareil. Vérifiez que les caméras ne sont pas désactivées dans les paramètres système de l’appareil. Sur macOS, vérifiez que l’enregistrement de l’écran est autorisé à partir des paramètres système. Liens utiles : - Demander des autorisations d’appareil- Autorisations de partage d’écran sur macOS - Accès aux appareils ou énumération de ces appareils pour Safari sur macOS et iOS |
| 43002 | 500 | Échec du démarrage de la vidéo, erreur inconnue. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | |
| 43004 | 400 | Échec du changement d’appareil vidéo, entrée non valide. L’entrée doit être de type VideoDeviceInfo. | ExpectedError | Utilisez le gestionnaire d’appareils pour obtenir la liste des objets VideoDeviceInfo, puis utilisez l’objet VideoDeviceInfo pour changer la source. En savoir plus sur comment démarrer et arrêter l’envoi d’une vidéo locale pendant un appel |
| 43005 | 400 | Échec du basculement d’appareil vidéo, impossible de basculer vers le même appareil vidéo, il est déjà sélectionné. | ExpectedError | |
| 43013 | 412 | Échec du démarrage de la vidéo, aucun appareil vidéo n’a été trouvé. Vérifiez que les appareils vidéo sont branchés et activés dans les paramètres système. | ExpectedError | Vérifiez que vous disposez d’une caméra connectée et installée sur votre appareil. |
| 43014 | 412 | Échec du démarrage de la vidéo, erreur demandant le flux multimédia. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | |
| 43015 | 412 | Échec du démarrage de la vidéo, la demande de flux multimédia a expiré. Accordez l’autorisation sur l’invite du navigateur à accéder à la caméra, puis réessayez. | ExpectedError | Cette erreur peut se produire si l’utilisateur n’agit pas sur l’invite d’autorisation du navigateur pour autoriser l’accès à la caméra. |
| 43016 | 412 | Échec du démarrage de la vidéo, autorisations refusées par le système. Vérifiez que les autorisations d’appareil vidéo sont autorisées dans les paramètres du navigateur et dans les paramètres du système. | ExpectedError | - Vérifiez que les autorisations de caméra sont autorisées dans les paramètres du navigateur et les paramètres système de l’appareil. - Vérifiez que les caméras ne sont pas désactivées dans les paramètres système de l’appareil. - Sur macOS, vérifiez que l’enregistrement de l’écran est autorisé à partir des paramètres système. Liens utiles : - Demander des autorisations d’appareil -Autorisations de partage d’écran sur macOS - Accès aux appareils ou énumération de ces appareils pour Safari sur macOS et iOS |
| 43017 | 412 | Échec du démarrage de la vidéo, flux non pris en charge. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | |
| 43018 | 412 | Échec du démarrage de la vidéo, impossible de définir des contraintes. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | En savoir plus sur comment définir des contraintes vidéo |
| 43019 | 412 | Échec du démarrage de la vidéo, aucun appareil n’est sélectionné. Veillez à transmettre un LocalVideoStream construit avec un VideoDeviceInfo, puis réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | Liens utiles : - Passer un appel avec une caméra vidéo - Démarrer et arrêter l’envoi d’une vidéo locale pendant un appel |
| 43200 | 412 | Échec du rendu du flux vidéo, ce flux n’est pas disponible. Abonnez-vous à la propriété isAvailable du flux pour être averti lorsque le participant distant dispose de sa vidéo et que le flux est disponible pour le rendu. | ExpectedError | Liens utiles : - Afficher les flux de partage de partage d’écran ou de vidéo de participants distants - Ajouter l’appel vidéo 1:1 à votre application - S’abonner aux événements SDK |
| 43202 | 404 | Échec du rendu du flux vidéo, ce flux n’est plus disponible. Le participant distant a désactivé sa vidéo. | ExpectedError | Le participant distant a désactivé sa vidéo lors de sa tentative de création d’un affichage. |
| 43203 | 408 | Échec du rendu du flux vidéo, le rendu a expiré lors de l’attente d’images vidéo. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | |
| 43204 | 500 | Échec du rendu du flux vidéo, échec de l’abonnement à la vidéo dans l’infrastructure Azure Communication Services. Réessayez. Si le problème persiste, contactez le support Azure Communication Services. | UnexpectedClientError | |
| 43209 | 405 | Échec du rendu du flux vidéo, VideoStreamRenderer a été supprimé pendant le processus d’initialisation. | ExpectedError | |
| 43210 | 400 | Échec de la suppression de VideoStreamRenderer, car il est déjà supprimé. | ExpectedError | |
| 43220 | 400 | Impossible de créer une vue, nombre maximal de vues actives RemoteVideoStream déjà atteintes. Vous pouvez en supprimer un ancien pour en créer un. |
ExpectedError | En savoir plus sur comment prendre en charge correctement le meilleur nombre de flux vidéo entrants |
| 480 | Le point de terminaison de client distant n’est pas inscrit. | Vérifiez que le point de terminaison distant est disponible. | ||
| 481 | Échec du traitement de l’appel entrant. | Soumettez une demande de support via le portail Azure. | ||
| 487 | Appel annulé, refusé localement, terminé en raison d’un problème d’incompatibilité avec le point de terminaison, ou ne parvenant pas à générer l’offre multimédia. | Comportement attendu. | ||
| 490, 491, 496, 497, 498 | Problèmes de réseau de point de terminaison local. | Vérifiez votre réseau. | ||
| 503, 504 | Erreur d’infrastructure Communication Services. | Soumettez une demande de support via le portail Azure. | ||
| 600 | Occupé partout. Le participant a contacté avec succès mais a retourné un signal occupé. | Comportement attendu. | ||
| 603 | Appel global refusé par le participant Communication Services distant. | Comportement attendu. | ||
| 604 | N’existe pas n’importe où. L’URI demandé n’existe pas. | Comportement attendu. | ||
| 606 | Pas acceptable. Le participant a correctement contacté mais ne peut pas prendre en charge la session décrite. | Comportement attendu. |
Présentation des codes appelants et des erreurs de sous-codes
Les codes d’erreur, les sous-codes et les catégories de résultats correspondants aident les développeurs à identifier et diagnostiquer les erreurs. Ces codes d’erreur sont exposés via la propriété call.callEndReason à l’issue d’un appel.
Les détails du code d’erreur sont les suivants :
Code - sont des entiers à 3 chiffres représentant l’état de réponse du client ou du serveur. Catégories de code :
- Réponses réussies (200-299)
- Erreur du client (400-499)
- Erreur du serveur (500-599)
- Erreur globale (600-699)
Sous-code Sont définis en tant qu’entier, où chaque nombre indique une raison unique, spécifique à un groupe de scénarios ou à un résultat de scénario spécifique.
Message : décrit le résultat et fournit des indications sur la façon d’atténuer le problème si un résultat est un échec.
ResultCategory : indique le type de l’erreur. Selon le contexte, la valeur peut être Success, ExpectedError, UnexpectedClientError ou UnexpectedServerError.
Appels des codes d’appel et des sous-codes
Il existe plusieurs explications quant à la raison pour laquelle un appel a pris fin. Voici les significations des codes et sous-codes de fin d’appel montrant la façon dont un appel a pris fin.
| Sous-code | Code | Message | Catégories de résultats | Conseils |
|---|---|---|---|---|
| 0 | 0 | L’appel s’est terminé avec succès par le participant local. | Succès | |
| 0 | 487 | L’appel s’est terminé avec succès, car l’appelant a annulé l’appel. | Succès | |
| 0 | 603 | L’appel s’est terminé correctement, car il a été refusé de l’appelé. | Opération réussie | L’appel s’est terminé, car il a été refusé par l’utilisateur cible via le Kit de développement logiciel (SDK) client, Automatisation des appels, Graph, PSTN ou la fonction de rejet de Teams. |
| 7 | 496 | L’appel s’est terminé, car le client a perdu abruptement la connexion réseau, et malgré plusieurs nouvelles tentatives, il n’a pas pu se connecter. | ExpectedError | Le navigateur est hors connexion ou rencontre des problèmes réseau. Vérifiez la connexion réseau de votre navigateur, puis réessayez. |
| 3100 | 410 | La configuration de l’appel a échoué en raison d’un problème réseau inattendu sur le client. Vérifiez le réseau du client, puis réessayez. | UnxpectedClientError | Vérifiez la configuration réseau et assurez-vous qu’elle suit les exigences d’Azure Communication Calling. |
| 3101 | 410 | L’appel a été interrompu en raison d’un problème réseau inattendu sur le client. Vérifiez le réseau du client et réessayez. | UnxpectedClientError | Vérifiez la configuration réseau et assurez-vous qu’elle suit les exigences d’Azure Communication Calling. |
| 3111 | 410 | Échec de la configuration de l’appel. Impossible de traiter l’offre du média lors de la connexion de l’appel. | UnxpectedClientError | Réessayez. Si le problème persiste, rassemblez les informations de l’appel, les journaux du client et les journaux de la console du navigateur, puis contactez le support Azure Communication Services. |
| 3112 | 410 | La configuration de l’appel a échoué en raison d’un problème de configuration réseau côté client. Vérifiez la configuration réseau du client, puis réessayez. | ExpectedError | Découvrez plus de détails sur un appel se terminant par le sous-code 3112 ici. |
| 4097 | 0 | Appel terminé pour tous les utilisateurs par l’organisateur de la réunion. | Opération réussie | |
| 4502 | 490 | L’appel a échoué en raison de problèmes de connectivité réseau. Le navigateur n’a pas pu effectuer la requête HTTP réseau. | UnexpectedClientError | Le client n’a pas pu effectuer la requête et la réponse HTTP. Réessayez. Si le problème persiste, rassemblez les informations de l’appel, les journaux du client et les journaux de la console du navigateur, puis contactez le support Azure Communication Services. |
| 4506 | 408 | L’appel a expiré. Vérifiez si l’appelé a reçu et accepté l’appel. | UnexpectedClientError | Réessayez. Si le problème persiste, rassemblez les informations de l’appel, les journaux du client et les journaux de la console du navigateur, puis contactez le support Azure Communication Services. |
| 4507 | 495 | L’appel s’est terminé car l’application n’a pas fourni de jeton Azure Communication Services valide. | UnexpectedClientError | Vérifiez que votre application implémente correctement le mécanisme d’actualisation des jetons. |
| 4521 | 0 | L’appel s’est terminé car l’utilisateur s’est déconnecté brusquement de celui-ci. Cela peut être dû à la fermeture par un utilisateur de l’application qui a hébergé l’appel, par exemple si un utilisateur a arrêté l’application en fermant l’onglet du navigateur sans raccrocher correctement. | ExpectedError | |
| 5 000 | 0 | Appel terminé pour ce participant. Participant supprimé de la conversation par un autre participant. | Réussite | |
| 5003 | 0 | L’appel s’est terminé avec succès, car tous les points de terminaison appelés ont refusé l’appel. | Réussite | |
| 5300 | 0 | L’appel s’est terminé pour ce participant, car il a été supprimé de la conversation par un autre participant. | Opération réussie | L’appel s’est terminé pour ce participant, car un autre participant l’a supprimé. Il peut s’agir d’un autre client, de l’API Automatisation des appels ou de l’API Graph. |
| 5,317 | 0 | Le participant cible est supprimé en raison de la mise à jour du rôle de participant. | ExpectedError | |
| 5828 | 403 | La participation n’est pas autorisée pour la réunion Salles, car l’utilisateur ne fait pas partie de la liste des invités. | UnexpectedClientError | |
| 5829 | 403 | La participation n’est pas autorisée pour la réunion Salles au-delà de l’heure de fin ou avant l’heure de début de la réunion. | UnexpectedClientError | |
| 5830 | 403 | Seul l’utilisateur Communication Services est autorisé à participer à la réunion Salles. | ExpectedError | |
| 7000 | 0 | L’appel a été terminé par l’API Automatisation des appels d’Azure Communication Services ou par un bot serveur. | Opération réussie | L’appel a été terminé par l’API Automatisation des appels d’ACS ou par un bot Graph. |
| 10003 | 487 | L’appel a été annulé pour ce point de terminaison utilisateur, car il a été accepté ailleurs, par un autre point de terminaison. | Opération réussie | Un appel a été lancé pour un utilisateur cible (appel de démarrage, ajout d’un participant, transfert). L’utilisateur cible avait plusieurs points de terminaison actifs en même temps, sur un des points de terminaison sur lequel l’utilisateur a accepté l’appel. Il s’agit d’un comportement normal : un seul point de terminaison peut accepter et se connecter à un appel. Tous les autres points de terminaison reçoivent le sous-code 10003 pour indiquer que l’appel a déjà été accepté. |
| 10004 | 487 | L’appel a été annulé au terme du délai d’expiration, car l’utilisateur cible ne l’a pas accepté ou rejeté à temps. Assurez-vous que l’utilisateur a vu la notification et/ou que l’application peut la traiter automatiquement, puis réessayez de lancer cet appel. | ExpectedError | L’appel a été annulé après un délai prédéfini (généralement 2 minutes), car l’utilisateur cible ne l’a pas accepté ou l’a rejeté. |
| 10009 | 401 | Identité non authentifiée. Vérifiez que votre jeton Azure Communication Services est valide et qu’il n’a pas expiré. | UnexpectedClientError | |
| 10024 | 487 | L’appel s’est terminé avec succès. Appel refusé par tous les points de terminaison appelés. | Opération réussie | Réessayez de passer l’appel. |
| 10037 | 480 | L’utilisateur cible n’avait pas de points de terminaison inscrits auprès d’ACS. Vérifiez que l’utilisateur cible a au moins un point de terminaison actif et qu’il est en ligne. | ExpectedError | Si l’utilisateur cible utilise le Kit de développement logiciel (SDK) Appel d’Azure Communication Services, vérifiez que le SDK est lancé correctement dans son application cliente. Si l’utilisateur cible est un utilisateur Teams, vérifiez que son client est en ligne. Vérifiez que l’identificateur de l’utilisateur cible (CommunicationUserIdentifier, MicrosoftTeamsUserIdentifier ou MicrosoftTeamsBotIdentifier) est correct. Si l’API Graph user a la propriété department définie sur Microsoft Communication Application Instance, MicrosoftTeamsBotIdentifier doit être spécifié. |
| 10057 | 408 | Échec de l’appel – l’appelé n’a pas pu finaliser la configuration de l’appel ; le plus probable est que l’appelé a perdu le réseau ou a mis fin à l’application brusquement. Vérifiez que les clients sont connectés et disponibles. | ExpectedError | |
| 10076 | 480 | L’utilisateur cible a été inscrit, mais il n’était pas en ligne au moment de l’appel. Vérifiez que l’utilisateur cible a au moins un point de terminaison actif et qu’il est en ligne. | ExpectedError | Si l’utilisateur cible utilise le Kit de développement logiciel (SDK) Appel d’Azure Communication Services, vérifiez que le SDK est initialisé correctement dans son application cliente et que son point de terminaison est en ligne. Si l’utilisateur cible est un utilisateur Teams, vérifiez que son client est en ligne. |
| 10077 | 480 | L’utilisateur cible a été inscrit auprès d’ACS et/ou pour les notifications Push, mais il n’était pas en ligne au moment de l’appel. Vérifiez que l’utilisateur cible a au moins un point de terminaison actif et qu’il est en ligne. | ExpectedError | Si l’utilisateur cible utilise le Kit de développement logiciel (SDK) Appel d’Azure Communication Services, vérifiez que le SDK est initialisé correctement dans son application cliente et que son point de terminaison est en ligne. Si l’application tire parti des notifications Push, vérifiez qu’elles sont configurées correctement. Si l’utilisateur cible est un utilisateur Teams, vérifiez que son client est en ligne. |
| 10078 | 480 | Le point de terminaison de client distant n’est pas inscrit ou n’est pas accessible. Vérifiez que le point de terminaison de client distant envoie correctement les requêtes réseau à Azure Communication Services. | ExpectedError | - Si l’utilisateur cible utilise le Kit de développement logiciel (SDK) Appel d’Azure Communication Services, vérifiez qu’il est lancé correctement dans son application cliente et que son point de terminaison est en ligne. Si l’application tire parti des notifications Push, vérifiez qu’elles sont configurées correctement. - Si l’utilisateur cible est un utilisateur Teams, vérifiez que son client est en ligne. |
| 301004 | 410 | Le participant a été supprimé de l’appel par l’infrastructure Azure Communication Services en raison de l’incapacité à établir la connectivité du média avec l’infrastructure Azure Communication Services lors de la configuration de l’appel. Vérifiez la configuration réseau de l’utilisateur, y compris le réseau local, les pare-feu et la configuration des VPN, puis réessayez. | UnexpectedClientError | Vérifiez que le réseau de l’utilisateur est configuré correctement. Suivez la documentation publique « Recommandations pour le réseau ». |
| 301005 | 410 | Le participant a été supprimé de l’appel par l’infrastructure Azure Communication Services en raison d’une perte de connectivité multimédia avec la même infrastructure. Cela se produit généralement si le participant quitte l’appel brusquement ou perd la connectivité réseau. Si le participant souhaite poursuivre l’appel, il peut se reconnecter. | UnexpectedClientError | Veillez à utiliser le kit SDK le plus récent dans un environnement pris en charge. |
| 540000 | 0 | L’appel a été terminé avec succès par l’appelant PSTN local. | Opération réussie | |
| 510403 | 403 | L’appel s’est terminé, précédemment marqué comme courrier indésirable et maintenant bloqué. | ExpectedError | - Vérifiez que votre jeton Communication Services est valide et n’a pas expiré. - Veillez à transmettre AlternateId dans les options d’appel. |
| 540487 | 487 | L’appel s’est terminé avec succès, car l’appelant a annulé l’appel. | Réussite | |
| 560000 | 0 | L'appel s'est terminé avec succès par le participant PSTN distant. | Réussite | Causes possibles : - L’utilisateur a terminé l’appel. - Appel terminé par l’agent multimédia. |
| 560486 | 486 | L'appel a pris fin car le participant PSTN distant était occupé. Le numéro appelé était déjà dans un appel ou avait des problèmes techniques. | Réussite | - Pour les appels de routage direct, vérifiez les journaux et paramètres du contrôle de bordure de session et la configuration des délais d’expiration. Causes possibles : le numéro appelé était déjà utilisé dans un appel ou avait des problèmes techniques. |
| 404 | Appel introuvable. | Assurez-vous que le numéro que vous appelez (ou l’appel que vous êtes en train de joindre) existe. | ||
| 408 | Le délai d’attente du contrôleur d’appel a expiré. | Le contrôleur d’appel a atteint le délai d’attente des messages de protocole provenant des points de terminaison utilisateur. Vérifiez que les clients sont connectés et disponibles. | ||
| 410 | Erreur locale de pile multimédia ou d’infrastructure multimédia. | Veillez à utiliser le kit SDK le plus récent dans un environnement pris en charge. | ||
| 430 | Impossible de remettre le message à l’application cliente. | Vérifiez que l’application cliente est en cours d’exécution et disponible. | ||
| 480 | Le point de terminaison de client distant n’est pas inscrit. | Vérifiez que le point de terminaison distant est disponible. | ||
| 481 | Échec du traitement de l’appel entrant. | Soumettez une demande de support via le portail Azure. | ||
| 490, 491, 496, 497, 498 | Problèmes de réseau de point de terminaison local. | Vérifiez la configuration réseau et assurez-vous qu’elle suit les exigences d’Azure Communication Calling. | ||
| 500, 503, 504 | Erreur d’infrastructure Communication Services. | Soumettez une demande de support via le portail Azure. |
Présentation des codes et sous-codes d’appel
Quand des codes d’erreur sont-ils émis ?
Les codes d’erreur pour Automatisation des appels peuvent être fournis comme réponses synchrones aux appels d’API ou comme réponses asynchrones via l’URI de rappel fourni. Dans le cas synchrone, si un appel d’API est effectué et qu’il n’est pas accepté, ACS fournit un code d’erreur décrivant pourquoi l’appel d’API a été rejeté. Dans les scénarios asynchrones, si un appel d’API est effectué et accepté mais qu’un problème persiste, un événement de rappel et un code d’erreur sont émis. Un exemple d’événement de rappel courant pour les échecs d’appel pourrait être l’événement callDisconnected qui est exposé chaque fois qu’un appel est déconnecté. Une fois l’événement callDisconnected reçu, il n’y aura plus d’événement de rappel pour cet appel donné. Pour obtenir la liste des événements de rappel signalant des appels, consultez (cette page) et pour obtenir la liste des événements de rappel pour les actions multimédias, consultez (cette page).
Syntaxe des codes d’erreur
Les codes d’erreur, les sous-codes et les catégories de résultats correspondants aident les développeurs à identifier et diagnostiquer les erreurs. Les détails du code d’erreur sont les suivants :
Code - sont des entiers à 3 chiffres représentant l’état de réponse du client ou du serveur. Catégories de code :
- Réponses réussies (200-299)
- Erreur du client (400-499)
- Erreur du serveur (500-599)
- Erreur globale (600-699)
Sous-code Sont définis en tant qu’entier, où chaque nombre indique une raison unique, spécifique à un groupe de scénarios ou à un résultat de scénario spécifique.
Message : décrit le résultat et fournit des indications sur la façon d’atténuer le problème si le résultat est un échec.
En plus du code et du sous-code, des informations de dépannage plus détaillées sont disponibles dans les journaux des appels. Pour en savoir plus sur l’activation et l’accès aux journaux d’appel, consultez cette page pour obtenir des instructions détaillées.
Codes d’erreur du KIT de développement logiciel (SDK) Call Automation
Le tableau suivant contient les codes et sous-codes les plus courants. Si votre erreur ne figure pas dans ce tableau, reportez-vous aux codes et sous-codes génériques pour obtenir plus d’informations sur votre scénario spécifique.
Codes d’erreur les plus courants pour Automatisation des appels
| Code | Sous-code | Description | Limitation des risques |
|---|---|---|---|
| 404 | 8522 | Code d’erreur générique qui indique que la ressource est introuvable. Les ressources peuvent inclure les appels et les participants. | Revérifiez l’état de l’appel : l’appel est peut-être déjà fini ou le participant a quitté l’appel. |
| 400 | 8523 | Code d’erreur générique qui indique qu’un élément dans le corps de la demande n’est pas valide. | Vérifiez que tous les paramètres sont valides. Reportez-vous au message d’erreur pour déterminer quel paramètre lève l’erreur. |
| 400 | 8501 | Action non prise en charge, appel non établi | L’action associée au message d’erreur a été activée alors que l’appel n’était pas actif. Vérifiez que les nouvelles actions d’appel ne sont pas initiées une fois l’appel déconnecté. Cette erreur peut également résulter d’actions appelées pendant que l’appel est actif si elles sont proches de l’heure de déconnexion de l’appel. |
| 400 | 8500 | Mode multimédia non valide | Vérifiez l’état de vos opérations multimédias pour voir si l’une d’elles est déjà active ou si le participant cible est déjà dans une opération multimédia. Si une opération multimédia est active, attendez que l’opération se termine, puis réessayez. |
| 400 | 8559 | Action non prise en charge, application de numérotation unique autorisée seulement | Demande d’enregistrement en double, enregistrement déjà initié ou en cours. Revérifiez l’état de l’enregistrement pour vous assurer qu’il est inactif avant de soumettre un nouvel appel d’enregistrement. |
| 400 | 8528 | Action non prise en charge, appel terminé | L’action associée au message d’erreur a été activée alors que l’appel était terminé. Vérifiez que les nouvelles actions d’appel ne sont pas initiées une fois l’appel terminé. Cette erreur peut également résulter d’actions appelées pendant que l’appel est actif si elles sont proches de l’heure de fin de l’appel. |
| 409 | 8519 | Conflit | Vérifiez que plusieurs actions ne sont pas effectuées sur la même ressource en parallèle. Reportez-vous au message d’erreur pour identifier les deux actions en conflit. |
| 403 | 7507 | Identité non valide de la source d’appel | L’identité de l’application du jeton d’autorisation ne correspond pas à l’identité de l’application dans la source d’appel. Vérifiez que vous utilisez la chaîne de connexion de la ressource ACS dans laquelle le webhook d’appel entrant a été configuré (le numéro de téléphone doit appartenir à la même ressource ACS répondant à l’appel). |
| 403 | 7504 | Autorisations insuffisantes de l’application | Code générique pour les autorisations insuffisantes, consultez le message d’erreur pour savoir quelle ressource n’a pas les autorisations suffisantes. |
| 400 | 8585 | Action non valide dans l’état actuel de l’appel | L’appel n’est pas établi ou est déconnecté : attendez que l’appel soit établi avant de réessayer l’action multimédia. |
| 405 | 8520 | Fonctionnalité non prise en charge à ce stade | Erreur attendue : workflow non pris en charge à ce stade. Consultez notre blog de publication pour voir s’il existe un SDK mis à jour qui active la fonctionnalité en question. Consultez la page Limitations connues d’Automatisation des appels pour obtenir la liste des workflows non pris en charge. |
| 412 | 8583 | Échec de la précondition | Reportez-vous à cette page qui liste les actions multimédias incompatibles pour veiller à ne pas exécuter ni à mettre en file d’attente des actions incompatibles. |
| 400 | 8567 | Principal de service de ressources ACS non activé | La ressource Azure Cognitive Service n’est pas configurée correctement. Consultez cette page qui vous servira de guide pour configurer votre ressource Azure Cognitive Service. |
| 405 | 8522 | Configuration manquante | Consultez le message d’erreur pour savoir quelle configuration doit être établie. Cette configuration doit se produire lors de l’appel de l’API AnswerCall. |
Codes d’erreur génériques
Codes 2xx
Un code 2xx représente une réponse réussie. Le sous-code pour les réponses réussies est 0.
Codes 4xx
Un code 4xx représente une erreur client.
| Code d’état | Description |
|---|---|
| 400 | Demande incorrecte |
| 401 | Non autorisé |
| 403 | Interdit |
| 404 | Introuvable |
| 405 | Méthode non autorisée |
| 406 | Non acceptable |
| 408 | Délai dépassé |
| 409 | Conflit |
| 412 | Échec de la précondition |
| 413 | Entité de requête trop grande |
| 426 | Mise à niveau nécessaire |
| 429 | Trop de demandes |
| 481 | La transaction n’existe pas |
| 487 | Annulée |
Codes 5xx
Un code 5xx représente une erreur de serveur.
| Code d’état | Description |
|---|---|
| 500 | Erreur interne du serveur |
| 501 | Non implémenté |
| 502 | Passerelle incorrecte |
| 503 | Service indisponible |
| 504 | Délai d’expiration de passerelle |
Codes 6xx
Un code 6xx représente une erreur globale.
| Code d’état | Description |
|---|---|
| 603 | Refusé |
Sous-codes génériques
| Sous-code | Description |
|---|---|
| 0 | Opération réussie |
| 7000 | Sans perte de données |
| 7500 | Identité AAD non prise en charge |
| 7501 | Jeton non valide |
| 7502 | Accès non activé |
| 7504 | Autorisations insuffisantes de l’application |
| 7505 | Différence de locataire d’entreprise |
| 7506 | Certificat non autorisé |
| 7507 | Identité non valide de la source d’appel |
| 7508 | Identité ACS non prise en charge |
| 7509 | Erreur de validation Hmac |
| 7510 | Erreur de validation de l’identité managée |
| 7600 | Accès non activé à la ressource |
| 7601 | Identité non valide de la source ACS |
| 7602 | Identité cible non valide d’ACS |
| 7603 | Identité ACS non valide |
| 7604 | Scénario d’interopérabilité Teams non autorisé |
| 7605 | Scénario d’interopérabilité d’enregistrement Teams non autorisé |
| 7606 | Ressource ACS non autorisée pour les actions cognitives |
| 8500 | Mode multimédia non valide |
| 8501 | Appel non établi |
| 8502 | Mon ID de participant n’est pas disponible |
| 8503 | État inactif du flux audio de l’appel |
| 8504 | Flux multimédias non disponibles |
| 8505 | Plusieurs participants avec remplacement |
| 8506 | Appel d’enregistrement de non-conformité |
| 8508 | Opération annulée |
| 8509 | Délai maximal de silence atteint |
| 8510 | Délai initial de silence atteint |
| 8511 | Échec de l’invite de lecture |
| 8512 | Échec du signal de lecture |
| 8513 | Délai d’expiration de la réception multimédia |
| 8514 | Ton d’arrêt détecté |
| 8515 | Durée maximale d’enregistrement atteinte |
| 8516 | Appel limité |
| 8517 | Différence d’ID de locataire d’appel |
| 8518 | Exception d’appel |
| 8519 | Conflit |
| 8520 | Non implémentée |
| 8521 | Trop de tronçons |
| 8522 | Introuvable |
| 8523 | Argument non valide |
| 8524 | Nombre de participants non valide pour l’enregistrement de conformité |
| 8525 | Partie non enregistrée |
| 8526 | Jeton de jointure non valide |
| 8527 | URL de jointure non valide |
| 8528 | Appel terminé |
| 8 529 | Limite mensuelle de l’appel limité atteinte |
| 8530 | Limite d’appels limités pour les appels actifs atteinte |
| 8531 | Nombre maximal de chiffres reçus |
| 8532 | Délai d’expiration inter-chiffres atteint |
| 8,533 | Option DTMF mise en correspondance |
| 8534 | Ton incorrect entré |
| 8535 | Format de fichier non valide |
| 8536 | Échec du téléchargement du fichier |
| 8537 | Délai d’expiration de Keep Alive atteint |
| 8538 | Appelé refusé |
| 8539 | Appelé occupé |
| 8,540 | Appelé occupé partout |
| 8541 | Appelé non disponible |
| 8542 | Appel annulé |
| 8543 | L’appel n’existe pas |
| 8544 | Appelé inaccessible |
| 8545 | Option vocale mise en correspondance |
| 8546 | Demande non valide envoyée par l’appelé |
| 8547 | Option vocale non mise en correspondance |
| 8548 | L’appel n’est pas un appel de groupe |
| 8549 | Échec de reciblage de la création de conversation |
| 8550 | Échec de négociation du reciblage multimédia |
| 8551 | Reciblage non pris en charge |
| 8552 | Impossible de supprimer l’organisateur |
| 8553 | Enregistrement en double |
| 8554 | Mixage audio de participant hors réunion |
| 8555 | Reciblage déjà en cours |
| 8556 | Action non prise en charge pour l’appel CR |
| 8557 | Type de format incorrect |
| 8558 | Participant non présent |
| 8559 | Numérotation unique en double |
| 8560 | Impossible de rejoindre la conversation en raison d’une réunion verrouillée |
| 8561 | ID non valide pour rejoindre la réunion |
| 8562 | Mode d’enregistrement non pris en charge |
| 8563 | Voix non reconnue |
| 8564 | Erreur de connexion au service Speech |
| 8565 | Erreur Cognitive Services |
| 8566 | Opération de réactivation du son non autorisée |
| 8567 | Principal de service de ressources ACS non activé |
| 8568 | Échec de demande d’une identité managée pour un service cognitif |
| 8571 | Conflit d’opérations d’enregistrement |
| 8569 | Voix reconnue |
| 8,570 | Erreur de reconnaissance vocale Cognitive Services |
| 8572 | Arrêt du service de lecture |
| 8573 | Méthode pause/reprise non autorisée |
| 8578 | Échec de transcription |
| 8579 | Transcription annulée |
| 8580 | Arrêt du service de transcription |
| 8581 | URL de flux non valide |
| 8582 | Lecture du texte source ou SSML vide |
| 8583 | Échec de la précondition |
| 8585 | Action non valide dans l’état actuel de l’appel |
| 8586 | Appel entrant non reconnu par le bot |
| 8587 | Appel entrant sans réponse dans les temps |
| 8588 | Enregistrement terminé et expiration du délai de réception multimédia |
| 8589 | Enregistrement limité |
| 8594 | Échec de mise à jour de l’état de la réunion |
| 8603 | Échec de streaming multimédia |
| 8604 | Streaming multimédia annulé |
| 8605 | Modèle vocal personnalisé de transcription non pris en charge |
| 8,606 | Échec de création d’identificateurs de communication |
| 8607 | Conflit d’opérations de transfert |
| 8608 | Erreur d’enregistrement de client participant |
| 8609 | Réponse de jointure non valide du bot |
| 8610 | Aucune réponse du bot lors de la notification |
| 8 613 | Limite des sous-titres en direct des appels limités atteinte |
| 9001 | Erreur inconnue du service sous-jacent |
| 9002 | Erreur de délai d’expiration du service sous-jacent |
| 9003 | Erreur d’opération annulée |
| 9998 | Erreur irrécupérable |
| 9999 | Inconnu |
Codes de réponse d’appel RTC avec ParticipantEndReason
Cette section fournit des informations de résolution des problèmes pour différentes combinaisons de codes de réponse ParticipantEndReason et ParticipantEndSubCode. Pour les tables de cette section, ParticipantEndReason = Code et ParticipantEndSubCode = Sous-code.
ParticipantEndReason 0
La réponse ParticipantEndReason avec la valeur 0 signifie généralement la suppression normale des appels et marque les appels qui se sont terminés sans erreurs.
| SubCode | Code | Message | Catégories de résultats | Conseils |
|---|---|---|---|---|
| 0 | 0 | L’appel s’est terminé avec succès par le participant local. | Réussite | |
| 560000 | 0 | Fin normale de l’appel RTC : - L’utilisateur a terminé l’appel. - Appel terminé par l’agent multimédia. |
Réussite | |
| 540000 | 0 | Fin normale de l’appel RTC : - L’utilisateur a terminé l’appel. - Appel terminé par l’agent multimédia. |
Réussite |
ParticipantEndReason 4xx
La réponse ParticipantEndReason avec la valeur 4xx signifie que l’appel n’a pas été connecté.
| SubCode | Code | Message | Catégories de résultats | Conseils |
|---|---|---|---|---|
| 510403 | 403 | Appel bloqué : - ID de remplacement non fourni pour l’appel. - Numéro de téléphone non autorisé par le contrôleur de bordure de session des utilisateurs (SBC). |
- Pour plus d’informations sur l’ID de remplacement, consultez Gérer les appels. - Vérifiez que vous avez spécifié une alternative ID valide. Il doit s’agir d’un numéro de téléphone qui appartient à la ressource que vous utilisez. - Vérifiez que vous êtes propriétaire de la ressource que vous utilisez pour effectuer un appel. - Pour les appels de routage direct, vérifiez pourquoi votre contrôleur de bordure de session n’a pas autorisé l’appel. |
|
| 560403 | 403 | - Appel interdit. - Appel annulé. - Appel rejeté. |
Assurez-vous que vous avez appelé un numéro de téléphone valide au format correct. Pour plus d’informations sur les formats numériques pris en charge, consultez https://en.wikipedia.org/wiki/E.164. | |
| 511532 | 403 | Configuration de jonction SIP de ressource introuvable. | Vérifiez votre configuration de routage direct dans le portail Azure. Pour plus d’informations, consultez provisionnement de routage direct. | |
| 560404 | 404 | - Numéro de téléphone introuvable. - Numéro de téléphone non affecté à une cible. - Numéro de téléphone non autorisé par le contrôleur de bordure de session. |
- Vérifiez que le numéro de téléphone appartient à la ressource que vous utilisez et que vous êtes propriétaire de la ressource. - Vérifiez que le numéro que vous appelez existe et qu’il est affecté à la cible valide. |
|
| 511404 | 404 | - Numéro de téléphone introuvable. - Ressource utilisée dans l’appel introuvable. |
- Vérifiez que vous avez utilisé un numéro de téléphone qui appartient à la ressource que vous utilisez et que vous possédez la ressource. - Vérifiez que le numéro que vous appelez existe et qu’il est affecté à une cible valide. - Vérifiez que la ressource que vous utilisez pour l’appel n’est pas supprimée ou désactivée. - Vérifiez que vos abonnements Azure ne sont pas supprimés ou désactivés. |
|
| 560408 | 408 | La partie appelée n’a pas répondu à un message d’établissement d’appel dans le délai imparti. | - Vérifiez pourquoi la partie appelée n’a pas répondu. - Pour les appels de routage direct, vérifiez les journaux et paramètres du contrôle de bordure de session (SBC en anglais) et la configuration des délais d’expiration. |
|
| 500001 | 408 | Délai d’expiration de la passerelle utilisateur Azure Communication Services n’a pas reçu de réponse du client dans un délai spécifié et a terminé la demande. |
- Vérifiez pourquoi la partie appelée n’a pas répondu. - Pour les appels de routage direct, vérifiez vos journaux et paramètres SBC et configuration des délais d’expiration. |
|
| 531004 | 410 | Échec des vérifications ICE (Interactive Connectivity Establishment). | - Impossible d’établir le chemin du média. Peut être dû à une configuration réseau incorrecte. Vérifiez la configuration de votre réseau pour vous assurer que les adresses IP et les ports requis ne sont pas bloqués. Lisez les instructions dans https://www.rfc-editor.org/rfc/rfc5245#section-7. - Pour les appels de routage direct, vérifiez les journaux et paramètres SBC pour la configuration et le profil ICE. Contactez votre fournisseur SBC pour obtenir de l’aide sur la configuration. Pour plus d’informations, consultez liste des contrôleurs de frontière de session certifiés pour le routage direct Azure Communication Services. |
|
| 560480 | 480 | - Aucune réponse de l’utilisateur appelé. - Appelé utilisateur temporaire indisponible. |
- Vérifiez pourquoi la partie appelée n’a pas répondu. - Réessayez l’appel plus tard en cas d’indisponibilité temporaire de la partie appelée. - Pour les appels de routage direct, vérifiez vos journaux et paramètres SBC et configuration des délais d’expiration. |
|
| 560484 | 484 | - Adresse d’appel incomplète ou non valide. - Format de numéro d’appelé incomplet ou non valide. |
- Dans certains cas, vous pouvez ignorer ces échecs, car l’utilisateur compose un numéro non valide. - Vérifiez que les numéros de téléphone sont correctement mis en forme. Pour plus d’informations, consultez https://en.wikipedia.org/wiki/E.164. - Pour le routage direct, le SBC peut provoquer ces défaillances en raison d’une configuration manquante dans un scénario de transfert d’appel. |
|
| 60486 | 486 | Le numéro appelé était occupé | - Le numéro appelé peut être connecté à un appel existant ou avoir un problème technique. - Pour les appels de routage direct, vérifiez vos journaux et paramètres SBC et configuration des délais d’expiration. |
|
| 540487 | 487 | L’appelant a terminé la demande d’appel. | Réessayez l’appel. | |
| 560487 | 497 | - L’appelant a arrêté la demande d’appel. - La demande s’est terminée avec l’effacement normal des appels. |
Réessayez l’appel. |
ParticipantEndReason 5xx
La réponse ParticipantEndReason avec la valeur 5xx signifie que l’appel a échoué en raison d’un problème avec un composant logiciel ou matériel requis pour terminer la connexion.
| SubCode | Code | Message | Catégories de résultats | Conseils |
|---|---|---|---|---|
| 560500 | 500 | Une erreur de serveur interne s’est produite dans l’un des services impliqués dans l’appel. | - Réessayez l’appel. Si le problème persiste, contactez votre fournisseur de télécommunications ou le support Microsoft. - Pour les appels de routage directs, vérifiez les journaux et paramètres de SBC et la configuration des délais d’expiration pour voir si votre SBC a provoqué l’échec. |
|
| 560503 | 503 | - Échec de l’appel en raison d’une erreur de serveur interne dans l’un des services impliqués dans l’appel. - Le réseau utilisé pour établir l’appel est hors d’ordre. - Défaillance temporaire dans l’un des services impliqués dans l’appel. |
- Vérifiez la configuration de votre réseau et de votre routage pour connaître les éventuels problèmes. Vérifiez que vos règles de pare-feu réseau sont correctes. - Réessayez l’appel. Si le problème persiste, contactez votre fournisseur de télécommunications ou le support Microsoft. - Pour les appels de routage directs, vérifiez les journaux et paramètres de SBC et la configuration des délais d’expiration pour voir si votre SBC a provoqué l’échec. |
ParticipantEndReason 603
La réponse ParticipantEndReason avec la valeur 603 signifie que l’appel a été rejeté sans connexion.
| SubCode | Code | Message | Catégories de résultats | Conseils |
|---|---|---|---|---|
| 560603 | 603 | - Appel refusé par le destinataire. - Appel refusé en raison de la détection des fraudes. |
- S’il est refusé par le destinataire, réessayez l’appel. - Vérifiez que vous ne dépassez pas le nombre maximal d’appels simultanés autorisés pour votre numéro de téléphone Azure Communication Services. Pour plus d’informations, consultez limitations des appels RTC. |
Codes d’erreur du Kit SDK Conversation
Le Kit de développement logiciel (SDK) Chat utilise les codes d’erreur suivants pour vous aider à résoudre les problèmes de conversation. Les codes d’erreur sont exposés via la propriété error.code dans la réponse d’erreur.
| Code | Message | Conseils |
|---|---|---|
| 401 | Non autorisé | Vérifiez que votre jeton Communication Services est valide et qu’il n’a pas expiré. |
| 403 | Interdit | Assurez-vous que l’initiateur de la demande a accès à la ressource. |
| 429 | Trop de demandes | Assurez-vous que votre application côté client gère ce scénario de manière conviviale. Si l’erreur persiste, déposez une demande de support. |
| 503 | Service indisponible | Soumettez une demande de support via le portail Azure. |
Codes d’erreur SMS
Le Kit de développement logiciel (SDK) SMS utilise les codes d’erreur suivants pour vous aider à résoudre les problèmes SMS. Les codes d’erreur sont exposés via le champ DeliveryStatusDetails dans le rapport de remise SMS.
| Code | Message | Conseils |
|---|---|---|
| 2000 | Message livré avec succès. | |
| 4000 | Le message est rejeté en raison d’une détection de fraude. | Vérifiez que vous ne dépassez pas le nombre maximal de messages autorisés pour votre numéro. |
| 4001 | Le message est rejeté en raison d’un format non valide du numéro de l’expéditeur | Assurez-vous que le numéro du destinataire est au format E.164 et que le numéro de l’expéditeur est au format E.164 ou Numéro court. |
| 4002 | Le message est rejeté en raison d’un format non valide du numéro du destinataire. | Assurez-vous que le numéro du destinataire est au format E.164. |
| 4003 | Échec de la livraison du message en raison d’une destination non prise en charge. | Vérifiez que la destination à laquelle vous tentez d’envoyer le message est prise en charge. |
| 4004 | La livraison du message a échoué parce que le numéro du destinataire n’existe pas. | Vérifiez que le numéro du destinataire auquel vous envoyez le message est valide. |
| 4005 | Message bloqué par l’opérateur de destination. | |
| 4006 | Le numéro du destinataire n’est pas accessible. | Essayez de renvoyer le message ultérieurement. |
| 4007 | Le numéro de destination/de destination a refusé de recevoir des messages de votre part. | Marquez le numéro du destinataire comme étant désabonné afin qu’aucune autre tentative de message ne soit effectuée vers ce numéro. |
| 4008 | Vous avez dépassé le nombre maximal de messages autorisés pour votre profil. | Assurez-vous que vous ne dépassez pas le nombre maximal de messages autorisé pour votre numéro, ou utilisez des files d’attente pour regrouper les messages par lot. |
| 4009 | Message rejeté par le système de droits d’utilisation Microsoft. | Le plus souvent, cela se produit quand une activité frauduleuse est détectée. Pour plus d’informations, contactez le support technique. |
| 4010 | Le message a été bloqué en raison de la non vérification du numéro gratuit. | Examinez les limites d’envoi non vérifiées et envoyez la vérification gratuite dès que possible. |
| 5 000 | Le message n’a pas pu être livré. Contactez l’équipe du support technique Microsoft pour plus de détails. | Soumettez une demande de support via le portail Azure. |
| 5001 | Échec de la livraison du message en raison d’une indisponibilité temporaire de l’application/du système. | |
| 5002 | Le transporteur ne prend pas en charge le rapport de remise | Le plus souvent, cela se produit si un transporteur ne prend pas en charge les rapports de remise. Aucune action n’est nécessaire, car le message a peut-être déjà été remis. |
| 9999 | Échec de la livraison du message en raison d’une erreur inconnue ou d’une défaillance. | Essayez de renvoyer le message. |