AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager Guide de référence du manuel d'automatisation

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.

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

Description

AWSSupport-AssociatePhoneNumbersToConnectContactFlowsCela vous permet d'associer des numéros de téléphone aux flux de contacts dans votre instance Amazon Connect. En fournissant les mappages des numéros de téléphone et des flux de contacts dans un fichier de valeurs séparées par des virgules (CSV) en entrée, le runbook associe autant de numéros de téléphone que possible aux flux de contacts en 14,5 minutes. Le runbook produit un fichier CSV contenant toutes les paires de numéros de téléphone et de flux de contacts qu'il n'a pas pu associer dans le délai imparti, afin que vous puissiez les saisir lors de la prochaine exécution.

Comment fonctionne-t-il ?

Le runbook vous AWSSupport-AssociatePhoneNumbersToConnectContactFlows permet d'associer des numéros de téléphone aux flux de contacts de votre instance Amazon Connect à l'aide d'un fichier CSV contenant des données de mappage qui est stocké dans un bucket Amazon Simple Storage Service (Amazon S3). Le fichier CSV d'entrée doit être aligné sur le format suivant, avec des PhoneNumber valeurs au format E.164.

Exemple de fichier CSV d'entrée

PhoneNumber,ContactFlowName
+1800555xxxx,ContactFlowA
+1800555yyyy,ContactFlowB
+1800555zzzz,ContactFlowC

Le runbook d'automatisation crée également les fichiers suivants dans l'emplacement de destination spécifié dans le DestinationFileBucket etDestinationFilePath.

  • automation:EXECUTION_ID/ResourceIdList.csv: fichier temporaire contenant les ContactFlowId paires PhoneNumberId et requises pour l'AssociatePhoneNumberContactFlowAPI.

  • automation:EXECUTION_ID/ErrorResourceList.csv: fichier contenant les paires de numéros de téléphone et de flux de contacts qui n'ont pas pu être traitées en raison d'une erreur, par exemple ResourceNotFoundException au format dePhoneNumber,ContactFlowName,ErrorMessage.

  • automation:EXECUTION_ID/NonProcessedResourceList.csv: fichier contenant les paires de numéros de téléphone et de flux de contacts qui n'ont pas été traitées. Le runbook essaie de traiter autant de numéros de téléphone et de flux de contacts que possible dans un délai de 14,5 minutes (15 minutes d'expiration de la AWS Lambda fonction - 30 secondes de mémoire tampon). Si certains numéros de téléphone ou flux de contacts n'ont pas pu être traités en raison de contraintes de temps, le runbook les inclut dans un fichier CSV à utiliser comme entrée pour la prochaine exécution du runbook.

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

Autorisations IAM requises

Le AutomationAssumeRole paramètre nécessite les actions suivantes pour utiliser correctement le runbook.


        {
            "Statement": [
                {
                    "Action": [
                        "s3:GetBucketPublicAccessBlock",
                        "s3:GetBucketPolicyStatus",
                        "s3:GetBucketAcl",
                        "s3:GetObject",
                        "s3:GetObjectAttributes",
                        "s3:PutObject",
                        "s3:PutObjectAcl"
                    ],
                    "Resource": [
                    "arn:aws:s3:::YOUR-BUCKET/*",
                    "arn:aws:s3:::YOUR-BUCKET"
                    ],
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "cloudformation:CreateStack",
                        "cloudformation:DescribeStacks",
                        "cloudformation:DeleteStack",
                        "iam:CreateRole",
                        "iam:DeleteRole",
                        "iam:DeleteRolePolicy",
                        "iam:GetRole",
                        "iam:PutRolePolicy",
                        "lambda:CreateFunction",
                        "lambda:DeleteFunction",
                        "lambda:GetFunction",
                        "lambda:InvokeFunction",
                        "lambda:TagResource",
                        "connect:AssociatePhoneNumberContactFlow",
                        "logs:CreateLogGroup",
                        "logs:TagResource",
                        "logs:PutRetentionPolicy",
                        "logs:DeleteLogGroup",
                        "s3:GetAccountPublicAccessBlock"
                    ],
                    "Resource": "*",
                    "Effect": "Allow"
                },
                {
                    "Action": [
                        "connect:DescribeInstance",
                        "connect:ListPhoneNumbers",
                        "connect:ListContactFlows",
                        "ds:DescribeDirectories"
                    ],
                    "Resource": "*",
                    "Effect": "Allow"
                },
                {
                    "Condition": {
                        "StringLikeIfExists": {
                            "iam:PassedToService": [
                                "ssm.amazonaws.com",
                                "lambda.amazonaws.com"
                            ]
                        }
                    },
                    "Action": [
                        "iam:PassRole"
                    ],
                    "Resource": "*",
                    "Effect": "Allow"
                }
            ]
        }

Instructions

Pour configurer l'automatisation, procédez comme suit :

  1. Accédez AWSSupport-AssociatePhoneNumbersToConnectContactFlowsà Systems Manager sous Documents.

  2. Sélectionnez Execute automation (Exécuter l'automatisation).

  3. Pour les paramètres d'entrée, entrez ce qui suit :

    • AutomationAssumeRole (Facultatif)

      Amazon Resource Name (ARN) du rôle AWS AWS Identity and Access Management (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.

    • ConnectInstanceId (Obligatoire)

      L'ID de votre instance Amazon Connect.

    • SourceFileBucket (Obligatoire)

      Le compartiment Amazon S3 qui stocke le fichier CSV contenant le numéro de téléphone et les paires de flux de contacts.

    • SourceFilePath (Obligatoire)

      La clé d'objet Amazon S3 du fichier CSV qui contient le numéro de téléphone et les paires de flux de contacts. Par exemple, path/to/input.csv.

    • DestinationFileBucket (Obligatoire)

      Le compartiment Amazon S3 dans lequel l'automatisation placera un fichier intermédiaire et un rapport de résultats.

    • DestinationFilePath (Facultatif)

      Le chemin de l'objet Amazon S3 DestinationFileBucket sous lequel un fichier intermédiaire et un rapport de résultats doivent être stockés. Par exemple, si vous le spécifiezpath/to/files/, les fichiers sont stockés souss3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/.

    • S3 BucketOwnerAccount (facultatif)

      Numéro de AWS compte propriétaire du compartiment Amazon S3 dans lequel vous souhaitez télécharger le journal du flux de contacts. Si vous ne spécifiez pas ce paramètre, les runbooks utilisent l'ID de AWS compte de l'utilisateur ou du rôle dans lequel l'automatisation s'exécute.

    • S3 BucketOwnerRoleArn (facultatif)

      L'ARN du rôle IAM autorisé à obtenir les paramètres d'accès public au compartiment Amazon S3 et au blocage du compte, à la configuration du chiffrement du compartiment, aux ACL du compartiment, à l'état de la politique du compartiment et au téléchargement d'objets dans le compartiment. Si ce paramètre n'est pas spécifié, le runbook utilise le AutomationAssumeRole (si spécifié) ou l'utilisateur qui démarre ce runbook (s'il n'AutomationAssumeRoleest pas spécifié). Consultez la section relative aux autorisations requises dans la description du runbook.

  4. Sélectionnez Exécuter.

  5. L'automatisation démarre.

  6. Le document exécute les étapes suivantes :

    • CheckConnectInstanceExistance

      Vérifie si l'instance Amazon Connect fournie ConnectInstanceId existe.

    • Chèques 3 BucketPublicStatus

      Vérifie si les compartiments Amazon S3 spécifiés dans le SourceFileBucket et DestinationFileBucket autorisent des autorisations d'accès anonymes ou publiques en lecture ou en écriture.

    • CheckSourceFileExistenceAndSize

      Vérifie si le fichier CSV source spécifié dans le SourceFilePath existe et si la taille du fichier dépasse la limite de 25 Mo.

    • GenerateResourceIdMap

      Télécharge le fichier CSV source spécifié dans le SourceFilePath et identify PhoneNumberId et ContactFlowId pour chaque ressource. Une fois cela fait, il télécharge un fichier CSV contenantPhoneNumber, PhoneNumberIdContactFlowName, et ContactFlowId dans le compartiment Amazon S3 de destination spécifié dansDestinationFileBucket. S'il PhoneNumberId n'est pas possible d'identifier un certain nombre, le fichier sera vide dans le fichier CSV.

    • AssociatePhoneNumbersToContactFlows

      Crée une AWS Lambda fonction dans votre compte à l'aide d'une AWS CloudFormation pile. La AWS Lambda fonction associe chaque numéro à un flux de contacts répertorié dans le fichier CSV source spécifié dans SourceFileBucket SourceFilePath et la AWS CloudFormation pile invoque la fonction. La AWS Lambda fonction associe autant de numéros de téléphone aux flux de contacts que possible avant l'expiration du délai (15 minutes). La liste des numéros de téléphone et des flux de contacts qui n'ont pas pu être traités en raison d'une erreur est importée[automation:EXECUTION_ID]/ErrorResourceList.csv. Les numéros qui n'ont pas pu être traités en raison d'un dépassement du nombre maximum de numéros de téléphone pouvant être traités en une seule exécution sont chargés dans[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Si cette étape échoue, elle passe à l'DescribeCloudFormationErrorFromStackEventsétape pour montrer pourquoi elle a échoué à cause d'événements de AWS CloudFormation pile.

    • WaitForPhoneNumberContactFlowAssociationCompletion

      Attend que la AWS Lambda fonction qui associe les numéros de téléphone aux flux de contacts soit créée et que la AWS CloudFormation pile termine son invocation.

    • GenerateReport

      Génère le rapport qui contient le nombre de numéros de téléphone mappés aux flux de contacts, ceux qui n'ont pas pu être traités en raison d'une erreur et ceux qui n'ont pas pu être traités en raison d'un dépassement du nombre maximum de numéros de téléphone pouvant être traités en une seule exécution. Le rapport indique également l'emplacement (URI Amazon S3 et URL de console Amazon S3) pour [automation:EXECUTION_ID]/ErrorResourceList.csv ou[automation:EXECUTION_ID]/NonProcessedResourceList.csv, le cas échéant.

    • DeleteCloudFormationStack

      Supprime la AWS CloudFormation pile, y compris la fonction Lambda pour le mappage.

    • DescribeCloudFormationErrorFromStackEvent

      Décrit les erreurs provenant de la AWS CloudFormation pile de l'AssociatePhoneNumbersToContactFlowsétape.

  7. Une fois terminé, consultez la section Sorties pour obtenir les résultats détaillés de l'exécution :

    • GenerateReport.OutputPayload

      Sortie des associations de numéros de téléphone et de flux de contacts. Ce rapport contient les informations suivantes :

      • Le nombre de paires de numéros de téléphone et de flux de contacts répertoriées dans le fichier CSV d'entrée

      • Le nombre de numéros de téléphone associés aux flux de contacts tel que spécifié dans le fichier CSV d'entrée

      • Le nombre de numéros de téléphone qui n'ont pas pu être associés aux flux de contacts en raison d'une erreur

      • Le nombre de numéros de téléphone qui n'ont pas été associés aux flux de contacts en raison de contraintes de temps

      • L'emplacement (URI Amazon S3 et URL de console Amazon S3) du fichier CSV contenant le numéro de téléphone et les paires de flux de contacts qui n'ont pas pu être associées en raison d'une erreur

      • L'emplacement (URI Amazon S3 et URL de console Amazon S3) du fichier CSV contenant le numéro de téléphone et les paires de flux de contacts qui n'ont pas été associées en raison d'une contrainte de temps

    • DescribeCloudFormationErrorFromStackEvents.Manifestations

      Sortie qui affiche les événements de AWS CloudFormation pile en cas d'échec de l'AssociatePhoneNumbersToContactFlowsétape.

Résultat d'exécution avec un petit nombre de numéros de téléphone et de flux de contacts

Résultat d'exécution avec un grand nombre de numéros de téléphone et de flux de contacts et de numéros de téléphone non associés en raison d'une erreur ou d'une contrainte de temps

Références

Systems Manager Automation