`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:

Accedere AWSSupport-AssociatePhoneNumbersToConnectContactFlowsa Systems Manager nella sezione Documenti.
Seleziona Execute automation (Esegui automazione).
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.
Seleziona Esegui.
L'automazione si avvia.
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
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

Report showing 7 phone numbers processed successfully with no errors or time constraints.

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

Amazon Connect phone number mapping results showing processed and unprocessed contacts.

Riferimenti

Systems Manager Automation

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

Amazon Connect

AWSSupport-CollectAmazonConnectContactFlowLog