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.
# 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](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US). 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 à l'aide de nouveautés APIs via l'interface de ligne de commande AWS.
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), 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 que votre groupe de distribution du trafic a été créé avec succès, vous pouvez l'utiliser [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)pour rechercher les numéros de téléphone disponibles et les [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)ré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'[DescribeTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribeTrafficDistributionGroup.html)API pour vérifier que le statut du groupe de distribution de 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 distribution de trafic en fournissant l'ARN du groupe de distribution de trafic dans le **TargetArn**paramètre lorsque vous appelez l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API. Vous pouvez également utiliser l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)API 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 :
1. Créez un réplica de votre instance de base de données :
1. Appelez l'API [ReplicateInstance](https://docs.aws.amazon.com/connect/latest/APIReference/API_ReplicateInstance.html).
1. Créez un groupe de répartition du trafic qui relie ces instances entre elles :
1. Appelez l'API [CreateTrafficDistributionGroup](https://docs.aws.amazon.com/connect/latest/APIReference/API_CreateTrafficDistributionGroup.html).
1. Trouvez les numéros de téléphone disponibles qui peuvent être demandés à votre groupe de répartition du trafic :
1. Appelez l'[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API 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`.
1. Dans la région où le groupe de distribution du trafic a été créé, appelez l'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API :
1. Indiquez l’ARN de votre groupe de répartition du trafic pour le paramètre `TargetArn`.
1. Indiquez la valeur du numéro de téléphone E164 renvoyée par l'appel d'[SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)API à l'étape 3.
`PhoneNumberId` et `PhoneNumberArn` sont renvoyés. Vous pouvez utiliser ces valeurs pour les opérations de suivi.
1. Vérifiez que le statut du numéro de téléphone est `CLAIMED` :
1. Appelez l'API [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html).
(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](#claim-phone-number-status).
1. 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.
1. 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. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API d'appel. Indiquez l’`InstanceId` qui correspond à l’instance qui a été répliquée.
1. 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'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
1. Dans l'instance Amazon Connect répliquée dans l'autre AWS région, procédez comme suit :
1. [ListContactFlows](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html)API d'appel. Indiquez l’`InstanceId` qui correspond à l’instance qui a été répliquée.
1. 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'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
## Pourquoi un ClaimPhoneNumber appel échoue
Votre appel d'[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)API é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é [SearchAvailablePhoneNumbers](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html)peut avoir été réclamé par un autre client.
[ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)é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 :
+ `CLAIMED`signifie que l'opération précédente [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)ou [UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)l'opération a réussi.
+ `IN_PROGRESS`signifie que [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)opération est toujours en cours et n'est pas encore terminée. Vous pouvez appeler [DescribePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_DescribePhoneNumber.html)ultérieurement pour vérifier si l'opération précédente est terminée.
+ `FAILED`indique que l'[UpdatePhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html)opération [ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html)ou 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 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.