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 aux groupes de distribution du trafic à l'aide de Connect Customer
**Note**
**Nouvel utilisateur ?** Consultez l'atelier [https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US](https://catalog.workshops.aws/amazon-connect-global-resiliency/en-US) Connect Customer 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 Connect Customer 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 des solutions clients Connect ou votre responsable technique des comptes.
Une fois que votre groupe de distribution de trafic a été créé (`Status`est`ACTIVE`) 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) revendiquer.
Avant de réclamer 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 l'état du groupe de distribution de trafic`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 attribuer 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 réclamé à une instance à un groupe de distribution du trafic.
**Note**
Pour mettre à jour le ** champ ** Description, vous devez utiliser la console Connect Customer.
## 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 de la région dans laquelle 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. Fournissez la valeur du numéro de téléphone E164 qui a été renvoyée par l'appel [ SearchAvailablePhoneNumbers ](https://docs.aws.amazon.com/connect/latest/APIReference/API_SearchAvailablePhoneNumbers.html) d'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 relatives au 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 Connect Customer existante dans la région où le groupe de distribution du trafic a été créé, procédez comme suit :
1. Appelez [ ListContactFlows ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) l'API. Indiquez l’`InstanceId` qui correspond à l’instance qui a été répliquée.
1. 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'[AssociatePhoneNumberContactFlow](https://docs.aws.amazon.com/connect/latest/APIReference/API_AssociatePhoneNumberContactFlow.html)API.
1. Dans l'instance Connect Customer répliquée dans l'autre AWS région, procédez comme suit :
1. Appelez [ ListContactFlows ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ListContactFlows.html) l'API. Indiquez l’`InstanceId` qui correspond à l’instance qui a été répliquée.
1. 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'[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 a [ ClaimPhoneNumber](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html), [ UpdatePhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_UpdatePhoneNumber.html) l'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 précédente [ ClaimPhoneNumber ](https://docs.aws.amazon.com/connect/latest/APIReference/API_ClaimPhoneNumber.html) ou 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.