Réclamez des numéros de téléphone à des groupes de distribution de trafic à l'aide d'Amazon Connect - Amazon Connect
Exemple de flux de travailPourquoi un ClaimPhoneNumber appel échoueStatuts définis pour les numéros de téléphone

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. Ce cours en ligne vous guide tout au long du processus d'intégration et de test du basculement des numéros de téléphone et des agents en utilisant le nouveau APIs via le. AWS CLI

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 du trafic, nous vous recommandons d'utiliser le DescribeTrafficDistributionGroupAPIpour vérifier que le statut du groupe de distribution du 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 du trafic en fournissant le groupe de distribution du trafic ARN dans le TargetArnparamètre lorsque vous appelez le ClaimPhoneNumberAPI. Vous pouvez également utiliser le UpdatePhoneNumberAPIpour 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 :

  1. Créez un réplica de votre instance de base de données :

    1. Appelle le ReplicateInstanceAPI.

  2. Créez un groupe de répartition du trafic qui relie ces instances entre elles :

    1. Appelle le CreateTrafficDistributionGroupAPI.

  3. Trouvez les numéros de téléphone disponibles qui peuvent être demandés à votre groupe de répartition du trafic :

    1. Appelez le SearchAvailablePhoneNumbersAPIdans la région où le groupe de distribution du trafic a été créé. Indiquez le groupe de distribution du trafic ARN pour le TargetArn paramètre.

  4. Dans la région où le groupe de distribution du trafic a été créé, appelez le ClaimPhoneNumberAPI:

    1. Indiquez votre groupe de distribution du trafic ARN pour le TargetArn paramètre.

    2. Indiquez la valeur du numéro de téléphone E164 renvoyée par l'SearchAvailablePhoneNumbersAPIappel à l'étape 3.

    PhoneNumberId et PhoneNumberArn sont renvoyés. Vous pouvez utiliser ces valeurs pour les opérations de suivi.

  5. Vérifiez que le statut du numéro de téléphone est CLAIMED :

    1. Appelle le DescribePhoneNumberAPI.

      (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.

  6. 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.

  7. 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.

    1. 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 :

      1. Appelle ListContactFlowsAPI. Indiquez l'InstanceId qui correspond à l'instance qui a été répliquée.

      2. Une liste de flux ARNs est renvoyée. Utilisez ces flux ARNs pour associer un flux à un numéro de téléphone ; appelez le AssociatePhoneNumberContactFlowAPI.

    2. Dans l'instance Amazon Connect répliquée dans l'autre AWS région, procédez comme suit :

      1. Appelle ListContactFlowsAPI. Indiquez l'InstanceId qui correspond à l'instance qui a été répliquée.

      2. Une liste de flux ARNs est renvoyée. Utilisez ces flux ARNs pour associer un flux à un numéro de téléphone ; appelez le AssociatePhoneNumberContactFlowAPI.

Pourquoi un ClaimPhoneNumber appel échoue

Votre ClaimPhoneNumberAPIappel é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 ACTIVE ou 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 TargetArn pour 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 FAILED statut suite à un ClaimPhoneNumber API appel, vous avez un jour pour réessayer de réclamer le numéro de téléphone avant que le numéro ne soit réintégré à l'inventaire pour que les autres clients puissent le réclamer.