Demande de numéros de téléphone à des groupes de distribution du trafic à l’aide d’Amazon Connect - Amazon Connect
Exemple de flux de travailMotifs de l’échec d’un appel ClaimPhoneNumberStatuts définis pour les numéros de téléphone

Demande de numéros de téléphone à des groupes de distribution du trafic à l’aide d’Amazon Connect

Note

Nouvel utilisateur ? Consultez l’atelier Amazon Connect Global Resiliency. 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 agents à l’aide de nouvelles API, via l’interface de ligne de commande AWS.

Global Resiliency est disponible uniquement pour les instances Amazon Connect créées dans les régions AWS : USA Est (Virginie du Nord), USA Ouest (Oregon), Asie-Pacifique (Osaka), Asie-Pacifique (Tokyo), Europe (Francfort) et Europe (Londres).

  • Vous ne pouvez créer un réplica dans la région USA Est (Virginie du Nord) que si votre source est la région USA Ouest (Oregon), et inversement.

  • Vous ne pouvez créer un réplica dans la région Europe (Francfort) que si votre source est la région Europe (Londres), et inversement.

  • Vous ne pouvez créer un réplica dans la région Asie-Pacifique (Osaka) que si votre source est la région Asie-Pacifique (Tokyo).

Pour accéder à cette fonctionnalité, contactez votre architecte de solutions Amazon Connect ou votre responsable de compte technique.

Une fois votre groupe de répartition du trafic créé avec succès (le paramètre Status a la valeur ACTIVE), vous pouvez utiliser SearchAvailablePhoneNumbers pour rechercher les numéros de téléphone disponibles, puis ClaimPhoneNumber pour les demander.

Avant de demander un numéro de téléphone à votre groupe de répartition du trafic, nous vous recommandons d’utiliser l’API DescribeTrafficDistributionGroup pour vérifier que le statut du groupe de répartition du trafic est ACTIVE. 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 répartition du trafic en fournissant l’ARN du groupe de répartition du trafic dans le paramètre TargetArn lorsque vous appelez l’API ClaimPhoneNumber. Vous pouvez également utiliser l’API UpdatePhoneNumber pour attribuer un numéro de téléphone demandé précédemment à une instance à un groupe de répartition 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. Appelez l’API ReplicateInstance.

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

    1. Appelez l’API CreateTrafficDistributionGroup.

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

    1. Appelez l’API SearchAvailablePhoneNumbers dans la région où le groupe de répartition du trafic a été créé. Indiquez l’ARN du groupe de répartition du trafic pour le paramètre TargetArn.

  4. Dans la région où le groupe de répartition du trafic a été créé, appelez l’API ClaimPhoneNumber :

    1. Indiquez l’ARN de votre groupe de répartition du trafic pour le paramètre TargetArn.

    2. Indiquez la valeur du numéro de téléphone E164 renvoyée par l’appel d’API SearchAvailablePhoneNumbers à 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. Appelez l’API DescribePhoneNumber.

      (DescribePhoneNumber peut également être appelé dans l’autre région associée au groupe de répartition 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. Appelez l’API ListContactFlows. Indiquez l’InstanceId qui correspond à l’instance qui a été répliquée.

      2. Une liste des ARN de flux est renvoyée. Utilisez ces ARN de flux pour associer un flux à un numéro de téléphone ; appelez l’API AssociatePhoneNumberContactFlow.

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

      1. Appelez l’API ListContactFlows. Indiquez l’InstanceId qui correspond à l’instance qui a été répliquée.

      2. Une liste des ARN de flux est renvoyée. Utilisez ces ARN de flux pour associer un flux à un numéro de téléphone ; appelez l’API AssociatePhoneNumberContactFlow.

Motifs de l’échec d’un appel ClaimPhoneNumber

Votre appel d’API ClaimPhoneNumber échoue avec une erreur 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é par SearchAvailablePhoneNumbers a peut-être été demandé par un autre client.

ClaimPhoneNumber échoue avec une erreur InvalidParameterException 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 :

  • CLAIMED signifie que l’opération ClaimPhoneNumber ou UpdatePhoneNumber précédente a réussi.

  • IN_PROGRESS signifie qu’une opération ClaimPhoneNumber ou UpdatePhoneNumber est toujours en cours et n’est pas encore terminée. Vous pouvez appeler DescribePhoneNumber ultérieurement pour vérifier si l’opération précédente est terminée.

  • FAILED indique que l’opération ClaimPhoneNumber ou UpdatePhoneNumber 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 statut FAILED suite à un appel d’API ClaimPhoneNumber, 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.