AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager Riferimento al runbook di automazione

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

Descrizione

Ti AWSSupport-AssociatePhoneNumbersToConnectContactFlows aiuta ad associare i numeri di telefono ai flussi di contatti nella tua istanza Amazon Connect. Fornendo le mappature dei numeri di telefono e dei flussi di contatti in un file di input con valori separati da virgole (CSV), il runbook associa il maggior numero possibile di numeri di telefono ai flussi di contatti entro 14,5 minuti. Il runbook produce un CSV file con tutte le coppie di numeri di telefono e flussi di contatti che non è riuscito ad associare entro il limite di tempo, in modo da poterle inserire nella prossima esecuzione.

Come funziona?

Il runbook ti AWSSupport-AssociatePhoneNumbersToConnectContactFlows aiuta ad associare i numeri di telefono ai flussi di contatti nella tua istanza Amazon Connect utilizzando un CSV file di dati di mappatura archiviato in un bucket Amazon Simple Storage Service (Amazon S3). Il CSV file di input deve essere allineato al seguente formato, con PhoneNumber valori in formato E.164.

Esempio di file di input CSV

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

Il runbook di automazione crea anche i seguenti file nella posizione di destinazione specificata in DestinationFileBucket andDestinationFilePath.

  • automation:EXECUTION_ID/ResourceIdList.csv: Un file temporaneo che contiene le ContactFlowId coppie PhoneNumberId and necessarie per. AssociatePhoneNumberContactFlow API

  • automation:EXECUTION_ID/ErrorResourceList.csv: Un file che contiene il numero di telefono e le coppie del flusso di contatti che non è stato possibile elaborare a causa di un errore, ad esempio ResourceNotFoundException nel formato diPhoneNumber,ContactFlowName,ErrorMessage.

  • automation:EXECUTION_ID/NonProcessedResourceList.csv: Un file che contiene il numero di telefono e le coppie di flussi di contatti che non sono state elaborate. Il runbook tenta di elaborare il maggior numero possibile di numeri di telefono e flussi di contatti entro 14,5 minuti (15 minuti di timeout della AWS Lambda funzione - 30 secondi di buffer). Se alcuni numeri di telefono o flussi di contatti non possono essere elaborati a causa del vincolo di tempo, il runbook li include in un CSV file da utilizzare come input per la successiva esecuzione del runbook.

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

IAMAutorizzazioni richieste

Il AutomationAssumeRole parametro richiede le seguenti azioni per utilizzare correttamente il 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"
                }
            ]
        }

Istruzioni

Segui questi passaggi per configurare l'automazione:

  1. Accedere AWSSupport-AssociatePhoneNumbersToConnectContactFlowsa Systems Manager nella sezione Documenti.

  2. Seleziona Execute automation (Esegui automazione).

  3. Per i parametri di input, immettete quanto segue:

    • AutomationAssumeRole (Facoltativo)

      L'Amazon Resource Name (ARN) del ruolo AWS AWS Identity and Access Management (IAM) che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook.

    • ConnectInstanceId (Obbligatorio)

      L'ID della tua istanza Amazon Connect.

    • SourceFileBucket (Obbligatorio)

      Il bucket Amazon S3 che archivia il CSV file che contiene il numero di telefono e le coppie di flussi di contatti.

    • SourceFilePath (Obbligatorio)

      La chiave oggetto Amazon S3 del CSV file che contiene il numero di telefono e le coppie di flussi di contatti. Ad esempio path/to/input.csv.

    • DestinationFileBucket (Obbligatorio)

      Il bucket Amazon S3 in cui l'automazione inserirà un file intermedio e un rapporto sui risultati.

    • DestinationFilePath (Facoltativo)

      Il percorso dell'oggetto Amazon S3 DestinationFileBucket in cui archiviare un file intermedio e un report sui risultati. Ad esempio, se si specificapath/to/files/, i file vengono archiviati in. s3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/

    • S3 BucketOwnerAccount (opzionale)

      Il numero di AWS account proprietario del bucket Amazon S3 in cui desideri caricare il registro del flusso di contatti. Se non specifichi questo parametro, i runbook utilizzano l'ID AWS account dell'utente o del ruolo in cui viene eseguita l'automazione.

    • S3 BucketOwnerRoleArn (opzionale)

      Il IAM ruolo con le autorizzazioni per ottenere le impostazioni ARN di accesso pubblico del bucket Amazon S3 e dell'account, la configurazione della crittografia dei bucket, il bucket, lo stato della policy del ACLs bucket e il caricamento di oggetti nel bucket. Se questo parametro non è specificato, il runbook utilizza l'utente AutomationAssumeRole (se specificato) o che avvia questo runbook (se non è specificato). AutomationAssumeRole Consulta la sezione sulle autorizzazioni richieste nella descrizione del runbook.

  4. Seleziona Esegui.

  5. L'automazione si avvia.

  6. Il documento esegue le seguenti operazioni:

    • CheckConnectInstanceExistance

      Verifica se l'istanza Amazon Connect fornita ConnectInstanceId esiste.

    • Controlla S3 BucketPublicStatus

      Verifica se i bucket Amazon S3 specificati in SourceFileBucket e DestinationFileBucket consentono autorizzazioni di accesso anonime o pubbliche in lettura o scrittura.

    • CheckSourceFileExistenceAndSize

      Verifica se il CSV file sorgente specificato in SourceFilePath esiste e se la dimensione del file supera il limite di 25 MiB.

    • GenerateResourceIdMap

      Scarica il CSV file sorgente specificato in SourceFilePath and identify PhoneNumberId e ContactFlowId per ogni risorsa. Al termine, carica un CSV file che contienePhoneNumber, PhoneNumberIdContactFlowName, e ContactFlowId nel bucket Amazon S3 di destinazione specificato in. DestinationFileBucket Se PhoneNumberId non può essere identificato per un determinato numero, il file sarà vuoto nel file. CSV

    • AssociatePhoneNumbersToContactFlows

      Crea una AWS Lambda funzione nel tuo account utilizzando uno AWS CloudFormation stack. La AWS Lambda funzione associa ogni numero a un flusso di contatti elencato nel CSV file sorgente specificato in SourceFileBucket e SourceFilePath e lo AWS CloudFormation stack richiama la funzione. La AWS Lambda funzione associa il maggior numero possibile di numeri di telefono ai flussi di contatto prima del timeout (15 minuti). L'elenco dei numeri di telefono e dei flussi di contatti che non è stato possibile elaborare a causa di un errore viene caricato in[automation:EXECUTION_ID]/ErrorResourceList.csv. Vengono caricati quelli che non è stato possibile elaborare a causa di un eccesso del numero massimo di numeri di telefono che possono essere elaborati in un'unica esecuzione[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Se questo passaggio fallisce, passa alla DescribeCloudFormationErrorFromStackEvents fase che mostra il motivo dell'errore in base agli eventi AWS CloudFormation dello stack.

    • WaitForPhoneNumberContactFlowAssociationCompletion

      Attende che venga creata la AWS Lambda funzione che mappa i numeri di telefono ai flussi di contatti e che lo AWS CloudFormation stack completi la sua chiamata.

    • GenerateReport

      Genera il rapporto che contiene il numero di numeri di telefono mappati ai flussi di contatti, quelli che non è stato possibile elaborare a causa di un errore e quelli che non hanno potuto essere elaborati a causa di un eccesso del numero massimo di numeri di telefono che possono essere elaborati in un'unica esecuzione. Il rapporto mostra anche la posizione (Amazon S3 URI e URL console Amazon S3) di [automation:EXECUTION_ID]/NonProcessedResourceList.csv o, se [automation:EXECUTION_ID]/ErrorResourceList.csv applicabile.

    • DeleteCloudFormationStack

      Elimina lo AWS CloudFormation stack, inclusa la funzione Lambda per la mappatura.

    • DescribeCloudFormationErrorFromStackEvent

      Descrive gli errori della pila del AWS CloudFormation passo. AssociatePhoneNumbersToContactFlows

  7. Al termine, consulta la sezione Output per i risultati dettagliati dell'esecuzione:

    • GenerateReport.OutputPayload

      Emissione delle associazioni tra numeri di telefono e flussi di contatti. Questo rapporto contiene le seguenti informazioni:

      • Il numero di coppie di numeri di telefono e flussi di contatti elencate nel CSV file di input

      • Il numero di numeri di telefono associati ai flussi di contatti come specificato nel CSV file di input

      • Il numero di numeri di telefono che non è stato possibile associare ai flussi di contatti a causa di un errore

      • Il numero di numeri di telefono che non sono stati associati ai flussi di contatti a causa di vincoli di tempo

      • La posizione (Amazon S3 URI e URL console Amazon S3) del file che contiene CSV il numero di telefono e le coppie di flussi di contatti che non è stato possibile associare a causa di un errore

      • La posizione (Amazon S3 URI e Amazon S3 URL Console) del file che contiene CSV il numero di telefono e le coppie di flussi di contatti che non erano associate a causa di vincoli di tempo

    • DescribeCloudFormationErrorFromStackEvents.Eventi

      Output che mostra gli eventi AWS CloudFormation dello stack se il AssociatePhoneNumbersToContactFlows passaggio fallisce.

Output di esecuzione con un numero limitato di numeri di telefono e flussi di contatti

Output di esecuzione con un gran numero di numeri di telefono e flussi di contatti e numeri di telefono che non sono stati associati a causa di errori o vincoli di tempo

Riferimenti

Systems Manager Automation