AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager Referenz zum Automatisierungs-Runbook

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

Beschreibung

Das AWSSupport-AssociatePhoneNumbersToConnectContactFlows hilft Ihnen, Telefonnummern mit Kontaktabläufen in Ihrer Amazon Connect Connect-Instance zu verknüpfen. Durch die Bereitstellung der Zuordnungen von Telefonnummern und Kontaktabläufen in einer Eingabedatei mit kommagetrennten Werten (CSV) ordnet das Runbook innerhalb von 14,5 Minuten so viele Telefonnummern wie möglich den Kontaktabläufen zu. Das Runbook erstellt eine CSV Datei mit allen Telefonnummern- und Kontaktflusspaaren, die es innerhalb des Zeitlimits nicht zuordnen konnte, sodass Sie sie beim nächsten Lauf eingeben können.

Wie funktioniert es?

Das Runbook AWSSupport-AssociatePhoneNumbersToConnectContactFlows hilft Ihnen dabei, Telefonnummern mit Kontaktabläufen in Ihrer Amazon Connect Connect-Instance zu verknüpfen, indem Sie eine CSV Datei mit Zuordnungsdaten verwenden, die in einem Amazon Simple Storage Service (Amazon S3) -Bucket gespeichert ist. Die CSV Eingabedatei sollte dem folgenden Format entsprechen, mit PhoneNumber Werten im E.164-Format.

Beispiel für die Eingabedatei CSV

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

Das Automatisierungs-Runbook erstellt außerdem die folgenden Dateien an dem im DestinationFileBucket und DestinationFilePath angegebenen Zielverzeichnis.

  • automation:EXECUTION_ID/ResourceIdList.csv: Eine temporäre Datei, die die PhoneNumberId und ContactFlowId -Paare enthält, die für die AssociatePhoneNumberContactFlow API erforderlich sind.

  • automation:EXECUTION_ID/ErrorResourceList.csv: Eine Datei, die die Telefonnummern- und Kontaktflusspaare enthält, die aufgrund eines Fehlers nicht verarbeitet werden konnten, z. B. ResourceNotFoundException im Format vonPhoneNumber,ContactFlowName,ErrorMessage.

  • automation:EXECUTION_ID/NonProcessedResourceList.csv: Eine Datei, die die Telefonnummer und die Kontaktflusspaare enthält, die nicht verarbeitet wurden. Das Runbook versucht, innerhalb von 14,5 Minuten (15 Minuten AWS Lambda Funktions-Timeout — 30 Sekunden Puffer) so viele Telefonnummern und Kontaktflüsse wie möglich zu verarbeiten. Falls es einige Telefonnummern/Kontaktflüsse gibt, die aufgrund der Zeitbeschränkung nicht verarbeitet werden konnten, nimmt das Runbook sie in eine CSV Datei auf, die als Eingabe für die nächste Runbook-Ausführung verwendet wird.

Typ des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

LinuxmacOS, Windows

Parameter

Erforderliche IAM Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.


        {
            "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"
                }
            ]
        }

Anweisungen

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

  1. Navigieren Sie AWSSupport-AssociatePhoneNumbersToConnectContactFlowsim Systems Manager unter Dokumente zu.

  2. Wählen Sie Execute automation (Automatisierung ausführen).

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ)

      Der Amazon-Ressourcenname (ARN) der Rolle AWS AWS Identity and Access Management (IAM), der es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen durchzuführen. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

    • ConnectInstanceId (Erforderlich)

      Die ID Ihrer Amazon Connect Connect-Instance.

    • SourceFileBucket (Erforderlich)

      Der Amazon S3 S3-Bucket, in dem die CSV Datei gespeichert wird, die die Telefonnummer und die Kontaktflusspaare enthält.

    • SourceFilePath (Erforderlich)

      Der Amazon S3 S3-Objektschlüssel der CSV Datei, die die Telefonnummern- und Kontaktflusspaare enthält. Beispiel, path/to/input.csv.

    • DestinationFileBucket (Erforderlich)

      Der Amazon S3 S3-Bucket, in den die Automatisierung eine Zwischendatei und einen Ergebnisbericht einfügt.

    • DestinationFilePath (Fakultativ)

      Der Amazon S3 S3-Objektpfad, DestinationFileBucket unter dem eine Zwischendatei und ein Ergebnisbericht gespeichert werden sollen. Wenn Sie beispielsweise angebenpath/to/files/, werden Dateien unter gespeicherts3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/.

    • S3 BucketOwnerAccount (optional)

      Die AWS Kontonummer, der der Amazon S3 S3-Bucket gehört, in den Sie das Contact Flow Log hochladen möchten. Wenn Sie diesen Parameter nicht angeben, verwenden die Runbooks die AWS Konto-ID des Benutzers oder der Rolle, in der die Automatisierung ausgeführt wird.

    • S3 BucketOwnerRoleArn (optional)

      Die ARN IAM Rolle mit den Berechtigungen, den Amazon S3 S3-Bucket und das Konto abzurufen, die Einstellungen für den öffentlichen Zugriff zu blockieren, die Bucket-VerschlüsselungskonfigurationACLs, den Bucket, den Bucket-Richtlinienstatus und das Hochladen von Objekten in den Bucket. Wenn dieser Parameter nicht angegeben ist, verwendet das Runbook den AutomationAssumeRole (falls angegeben) oder den Benutzer, der dieses Runbook startet (falls nicht AutomationAssumeRole angegeben). Weitere Informationen finden Sie im Abschnitt „Erforderliche Berechtigungen“ in der Runbook-Beschreibung.

  4. Wählen Sie Ausführen aus.

  5. Die Automatisierung wird eingeleitet.

  6. Das Dokument führt die folgenden Schritte aus:

    • CheckConnectInstanceExistance

      Prüft, ob die in bereitgestellte Amazon Connect Connect-Instanz ConnectInstanceId existiert.

    • Prüft 3 BucketPublicStatus

      Überprüft, ob die in SourceFileBucket und angegebenen Amazon S3 S3-Buckets anonyme oder öffentliche Lese- oder Schreibzugriffsberechtigungen DestinationFileBucket zulassen.

    • CheckSourceFileExistenceAndSize

      Überprüft, ob die in der angegebene CSV Quelldatei SourceFilePath existiert und ob die Dateigröße das Limit von 25 MiB überschreitet.

    • GenerateResourceIdMap

      Lädt die in SourceFilePath und identify PhoneNumberId und ContactFlowId für jede Ressource angegebene CSV Quelldatei herunter. Danach lädt es eine CSV Datei, die,, und ContactFlowId enthält PhoneNumberPhoneNumberId, in den Amazon S3 S3-Ziel-Bucket hochContactFlowName, in DestinationFileBucket dem angegeben ist. Wenn für eine bestimmte Nummer PhoneNumberId nicht identifiziert werden kann, ist das Feld in der CSV Datei leer.

    • AssociatePhoneNumbersToContactFlows

      Erzeugt mithilfe eines AWS CloudFormation Stacks eine AWS Lambda Funktion in Ihrem Konto. Die AWS Lambda Funktion ordnet jede Zahl einem Kontaktfluss zu, der in der in und angegebenen CSV Quelldatei aufgeführt ist, SourceFileBucket SourceFilePath und der AWS CloudFormation Stack ruft die Funktion auf. Die AWS Lambda Funktion ordnet so viele Telefonnummern wie möglich den Kontaktströmen zu, bevor das Zeitlimit überschritten wird (15 Minuten). Die Liste der Telefonnummern und Kontaktabläufe, die aufgrund eines Fehlers nicht verarbeitet werden konnten, wird hochgeladen[automation:EXECUTION_ID]/ErrorResourceList.csv. Diejenigen, die aufgrund einer Überschreitung der maximalen Anzahl von Telefonnummern, die in einer einzigen Ausführung verarbeitet werden können, nicht verarbeitet werden konnten, werden hochgeladen[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Schlägt dieser Schritt fehl, wird mit dem DescribeCloudFormationErrorFromStackEvents Schritt fortgefahren, in dem angegeben wird, warum er aufgrund von AWS CloudFormation Stack-Ereignissen fehlgeschlagen ist.

    • WaitForPhoneNumberContactFlowAssociationCompletion

      Wartet, bis die AWS Lambda Funktion, die Telefonnummern Kontaktabläufen zuordnet, erstellt wurde und der AWS CloudFormation Stack seinen Aufruf abgeschlossen hat.

    • GenerateReport

      Generiert den Bericht, der die Anzahl der Telefonnummern enthält, die Kontaktabläufen zugeordnet sind, diejenigen, die aufgrund eines Fehlers nicht verarbeitet werden konnten, und die, die aufgrund einer Überschreitung der maximalen Anzahl von Telefonnummern, die in einer einzigen Ausführung verarbeitet werden können, nicht verarbeitet werden konnten. Der Bericht zeigt auch den Standort (Amazon S3 URI und Amazon S3 S3-KonsoleURL) für [automation:EXECUTION_ID]/ErrorResourceList.csv oder[automation:EXECUTION_ID]/NonProcessedResourceList.csv, falls zutreffend.

    • DeleteCloudFormationStack

      Löscht den AWS CloudFormation Stack, einschließlich der Lambda-Funktion für das Mapping.

    • DescribeCloudFormationErrorFromStackEvent

      Beschreibt Fehler aus dem AWS CloudFormation Stack des SchrittsAssociatePhoneNumbersToContactFlows.

  7. Wenn Sie den Vorgang abgeschlossen haben, finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung:

    • GenerateReport.OutputPayload

      Ausgabe der Verknüpfungen zwischen Telefonnummer und Kontaktfluss. Dieser Bericht enthält die folgenden Informationen:

      • Die Anzahl der Telefonnummern- und Kontaktflusspaare, die in der CSV Eingabedatei aufgeführt sind

      • Die Anzahl der Telefonnummern, die mit Kontaktströmen verknüpft sind, wie in der CSV Eingabedatei angegeben

      • Die Anzahl der Telefonnummern, die aufgrund eines Fehlers nicht mit Kontaktabläufen verknüpft werden konnten

      • Die Anzahl der Telefonnummern, die aus Zeitgründen nicht mit Kontaktabläufen verknüpft wurden

      • Der Speicherort (Amazon S3 URI und Amazon S3 S3-KonsoleURL) der CSV Datei, die die Telefonnummern- und Kontaktflusspaare enthält, die aufgrund eines Fehlers nicht verknüpft werden konnten

      • Der Speicherort (Amazon S3 URI und Amazon S3 S3-KonsoleURL) der CSV Datei, die die Telefonnummern- und Kontaktflusspaare enthält, die aus Zeitgründen nicht verknüpft wurden

    • DescribeCloudFormationErrorFromStackEvents.Ereignisse

      Ausgabe, die AWS CloudFormation Stack-Ereignisse anzeigt, falls der AssociatePhoneNumbersToContactFlows Schritt fehlschlägt.

Ausgabe der Ausführung mit einer kleinen Anzahl von Telefonnummern und Kontaktabläufen

Ergebnis der Ausführung mit einer großen Anzahl von Telefonnummern und Kontaktabläufen sowie Telefonnummern, die aufgrund eines Fehlers oder einer Zeitbeschränkung nicht verknüpft wurden

Referenzen

Systems Manager Automation