Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Réclamez des numéros de téléphone à des groupes de distribution de trafic à l'aide d'Amazon Connect
Note
Nouvel utilisateur ? Consultez l'atelier mondial sur la résilience d'Amazon Connect
Global Resiliency est disponible uniquement pour les instances Amazon Connect créées dans les AWS régions suivantes : USA Est (Virginie du Nord), USA Ouest (Oregon), Europe (Francfort) et Europe (Londres).
Vous ne pouvez créer une réplique dans la région USA Est (Virginie du Nord) que si votre source est USA Ouest (Oregon), ou inversement. De même, vous ne pouvez créer une réplique dans la région Europe (Francfort) que si votre source est l'Europe (Londres), ou inversement.
Pour accéder à cette fonctionnalité, contactez votre architecte de solutions Amazon Connect ou votre responsable de compte technique.
Une fois que votre groupe de distribution du trafic a été créé avec succès, vous pouvez l'utiliser SearchAvailablePhoneNumberspour rechercher les numéros de téléphone disponibles et les ClaimPhoneNumberréclamer. Status ACTIVE
Avant de demander un numéro de téléphone à votre groupe de distribution de trafic, nous vous recommandons d'utiliser l'DescribeTrafficDistributionGroupAPI pour vérifier que le statut du groupe de distribution de trafic estACTIVE. L'attribution d'un numéro de téléphone à un groupe de répartition du trafic qui n'a pas le statut ACTIVE entraîne une erreur ResourceNotFoundException.
Vous pouvez demander un numéro de téléphone à un groupe de distribution de trafic en fournissant l'ARN du groupe de distribution de trafic dans le TargetArnparamètre lorsque vous appelez l'ClaimPhoneNumberAPI. Vous pouvez également utiliser l'UpdatePhoneNumberAPI pour attribuer un numéro de téléphone précédemment revendiqué à une instance à un groupe de distribution du trafic.
Note
Pour mettre à jour le champ Description, vous devez utiliser la console Amazon Connect.
Exemple de flux de travail
Voici un exemple de flux de travail qui permet de demander des numéros de téléphone et de les utiliser dans plusieurs Régions AWS :
-
Créez un réplica de votre instance de base de données :
-
Appelez l'API ReplicateInstance.
-
-
Créez un groupe de répartition du trafic qui relie ces instances entre elles :
-
Appelez l'API CreateTrafficDistributionGroup.
-
-
Trouvez les numéros de téléphone disponibles qui peuvent être demandés à votre groupe de répartition du trafic :
-
Appelez l'SearchAvailablePhoneNumbersAPI dans la région où le groupe de distribution du trafic a été créé. Indiquez l'ARN du groupe de répartition du trafic pour le paramètre
TargetArn.
-
-
Dans la région où le groupe de distribution du trafic a été créé, appelez l'ClaimPhoneNumberAPI :
-
Indiquez l'ARN de votre groupe de répartition du trafic pour le paramètre
TargetArn. -
Indiquez la valeur du numéro de téléphone E164 renvoyée par l'appel d'SearchAvailablePhoneNumbersAPI à l'étape 3.
PhoneNumberIdetPhoneNumberArnsont renvoyés. Vous pouvez utiliser ces valeurs pour les opérations de suivi. -
-
Vérifiez que le statut du numéro de téléphone est
CLAIMED:-
Appelez l'API DescribePhoneNumber.
(DescribePhoneNumber peut également être appelé dans l'autre région associée au groupe de distribution du trafic. Il renverra les mêmes informations de numéro de téléphone.)
Le numéro de téléphone ne peut être utilisé par les opérations de suivi qu'une fois que son statut est
CLAIMED.Pour obtenir une description des statuts possibles, consultez Statuts définis pour les numéros de téléphone.
-
-
Répétez les étapes 3 à 5 pour tous les numéros de téléphone que vous devez demander à votre groupe de répartition du trafic.
-
Procédez comme suit pour associer des flux à des numéros de téléphone. Effectuez ces opérations dans les deux régions où le groupe de répartition du trafic fonctionne.
Ces étapes garantissent que votre trafic téléphonique sera correctement acheminé vers vos flux afin de prendre en charge votre configuration de répartition du trafic.
-
Dans votre instance Amazon Connect existante dans la région où le groupe de répartition du trafic a été créé, procédez comme suit :
-
ListContactFlowsAPI d'appel. Indiquez l'
InstanceIdqui correspond à l'instance qui a été répliquée. -
Une liste de flux ARNs est renvoyée. Utilisez ces flux ARNs pour associer un flux à un numéro de téléphone ; appelez l'AssociatePhoneNumberContactFlowAPI.
-
-
Dans l'instance Amazon Connect répliquée dans l'autre AWS région, procédez comme suit :
-
ListContactFlowsAPI d'appel. Indiquez l'
InstanceIdqui correspond à l'instance qui a été répliquée. -
Une liste de flux ARNs est renvoyée. Utilisez ces flux ARNs pour associer un flux à un numéro de téléphone ; appelez l'AssociatePhoneNumberContactFlowAPI.
-
-
Pourquoi un ClaimPhoneNumber appel échoue
Votre appel d'ClaimPhoneNumberAPI échouera avec un ResourceNotFoundException dans les cas suivants :
-
Le groupe de répartition du trafic spécifié n'existe pas, le statut du groupe de répartition du trafic n'est pas
ACTIVEou vous n'êtes pas propriétaire du groupe de répartition du trafic. -
Le numéro de téléphone ne peut pas être demandé. Dans certains cas, un numéro de téléphone trouvé SearchAvailablePhoneNumberspeut avoir été réclamé par un autre client.
ClaimPhoneNumberéchouera avec une InvalidParameterException erreur dans le cas suivant :
-
Le point de terminaison que vous appelez ne se trouve pas dans la région où le groupe de répartition du trafic a été créé.
Statuts définis pour les numéros de téléphone
Voici une description des statuts des numéros de téléphone :
-
CLAIMEDsignifie que l'opération précédente ClaimPhoneNumberou UpdatePhoneNumberl'opération a réussi. -
IN_PROGRESSsignifie que ClaimPhoneNumberl'UpdatePhoneNumberopération est toujours en cours et n'est pas encore terminée. Vous pouvez appeler DescribePhoneNumberultérieurement pour vérifier si l'opération précédente est terminée. -
FAILEDindique que l'UpdatePhoneNumberopération ClaimPhoneNumberou l'opération précédente a échoué. Ce statut comprend un message indiquant le motif de l'échec.Un motif fréquent d'échec est que la valeur
TargetArnpour laquelle vous demandez ou mettez à jour un numéro de téléphone a atteint la limite du nombre total de numéros demandés.Si vous avez reçu un statut
FAILEDsuite à un appel d'APIClaimPhoneNumber, vous avez un jour pour réessayer de demander le numéro de téléphone avant qu'il ne soit réintégré à l'inventaire afin que les autres clients puissent le demander.
