`AWSSupport-AssociatePhoneNumbersToConnectContactFlows`

Descrizione

Ti AWSSupport-AssociatePhoneNumbersToConnectContactFlows aiuta ad associare i numeri di telefono ai flussi di contatti nella tua istanza Connect Customer. 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 file CSV con tutte le coppie di numeri di telefono e flussi di contatti che non è stato possibile associare entro il limite di tempo, in modo da poterle inserire nella corsa successiva.

Come funziona?

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

Esempio del file CSV di input


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

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

automation:EXECUTION_ID/ResourceIdList.csv: un file temporaneo che contiene le ContactFlowId coppie PhoneNumberId e necessarie per l'AssociatePhoneNumberContactFlowAPI.
automation:EXECUTION_ID/ErrorResourceList.csv: un file che contiene le coppie di numeri di telefono e flussi 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 le coppie di numeri di telefono e flussi di contatti che non sono state elaborate. Il runbook tenta di elaborare il maggior numero di telefono e flussi di contatti possibile entro 14,5 minuti (15 minuti di timeout della AWS Lambda funzione - 30 secondi di buffer). Se ci sono numeri di telefono/flussi di contatti che non possono essere elaborati a causa del vincolo di tempo, il runbook li include in un file CSV da utilizzare come input per la successiva esecuzione del runbook.

Tipo di documento

Automazione

Proprietario

Amazon

Piattaforme

LinuxmacOS, Windows

Parametri

Autorizzazioni IAM 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"
                }
            ]
        }

Se si fornisce un LambdaRoleArn parametro, il ruolo richiede le seguenti azioni per utilizzare correttamente il runbook.

Istruzioni

Segui questi passaggi per configurare l'automazione:

Accedi AWSSupport-AssociatePhoneNumbersToConnectContactFlows a Systems Manager in Documenti.
Seleziona Execute automation (Esegui automazione).
Per i parametri di input, inserisci 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 Connect Customer.
- SourceFileBucket (Obbligatorio)
  
  Il bucket Amazon S3 che memorizza il file CSV che contiene il numero di telefono e le coppie di flussi di contatti.
- SourceFilePath (Obbligatorio)
  
  La chiave oggetto Amazon S3 del file CSV che contiene le coppie di numeri di telefono e 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 report sui risultati.
- DestinationFilePath (Facoltativo)
  
  Il percorso dell'oggetto Amazon S3 DestinationFileBucket in cui devono essere archiviati un file intermedio e un report sui risultati. Ad esempio, se lo specifichipath/to/files/, i file vengono archiviati in. s3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/
- S3BucketOwnerAccount (Facoltativo)
  
  Il numero di AWS account proprietario del bucket Amazon S3 in cui desideri caricare il Contact Flow Log. Se non specifichi questo parametro, i runbook utilizzano l'ID dell' AWS account dell'utente o del ruolo in cui viene eseguita l'automazione.
- S3BucketOwnerRoleArn (Facoltativo)
  
  L'ARN del ruolo IAM con le autorizzazioni per ottenere il bucket Amazon S3 e il blocco dell'account, le impostazioni di accesso pubblico, la configurazione della crittografia del bucket, gli ACL del bucket, lo stato della policy del bucket e il caricamento di oggetti nel bucket. Se questo parametro non è specificato, il runbook utilizza (se specificato) o l'utente che avvia questo runbook AutomationAssumeRole (se non è specificato). AutomationAssumeRole Consulta la sezione delle autorizzazioni richieste nella descrizione del runbook.
- LambdaRoleArn (Facoltativo)
  
  L'ARN del ruolo IAM che consente alla AWS Lambda funzione di accedere ai AWS servizi e alle risorse richiesti. Se non viene specificato alcun ruolo, questa automazione creerà un ruolo IAM per Lambda nel tuo account.
Seleziona Esegui.
L'automazione viene avviata.
Il documento esegue i seguenti passaggi:
- CheckConnectInstanceExistance
  
  Verifica se l'istanza Connect Customer fornita in ConnectInstanceId esiste.
- CheckS3BucketPublicStatus
  
  Verifica se i bucket Amazon S3 specificati in SourceFileBucket e DestinationFileBucket consentono autorizzazioni di accesso in lettura o scrittura anonime o pubbliche.
- CheckSourceFileExistenceAndSize
  
  Verifica se il file CSV di origine specificato in SourceFilePath esiste e se la dimensione del file supera il limite di 25 MiB.
- GenerateResourceIdMap
  
  Scarica il file CSV di origine specificato in SourceFilePath and identify PhoneNumberId and ContactFlowId per ciascuna risorsa. Al termine, carica un file CSV che contienePhoneNumber, PhoneNumberIdContactFlowName, e nel bucket Amazon S3 ContactFlowId 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 file CSV di origine specificato in SourceFileBucket e SourceFilePath e AWS CloudFormation lo stack richiama la funzione. La AWS Lambda funzione mappa il maggior numero possibile di numeri di telefono ai flussi di contatto prima che scada il 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[automation:EXECUTION_ID]/ErrorResourceList.csv. 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 vengono caricati in[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Se questo passaggio ha esito negativo, passa alla DescribeCloudFormationErrorFromStackEvents fase in cui viene illustrato il motivo per cui non è riuscito in base agli eventi AWS CloudFormation dello stack.
- WaitForPhoneNumberContactFlowAssociationCompletion
  
  Attende che venga creata la AWS Lambda funzione che associa i numeri di telefono ai flussi di contatti e che AWS CloudFormation lo stack ne completi l'invocazione.
- GenerateReport
  
  Genera il report 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 possono 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 (URI Amazon S3 e URL della console Amazon S3) di [automation:EXECUTION_ID]/ErrorResourceList.csv o[automation:EXECUTION_ID]/NonProcessedResourceList.csv, se applicabile.
- DeleteCloudFormationStack
  
  Elimina lo AWS CloudFormation stack, inclusa la funzione Lambda per la mappatura.
- DescribeCloudFormationErrorFromStackEvent
  
  Descrive gli errori dello AWS CloudFormation stack del passaggio. AssociatePhoneNumbersToContactFlows
Al termine, consulta la sezione Output per i risultati dettagliati dell'esecuzione:
- GenerateReport.OutputPayload
  
  Uscita del numero di telefono e delle associazioni del flusso di contatti. Questo rapporto contiene le seguenti informazioni:
  - Il numero di coppie di numeri di telefono e flusso di contatti elencate nel file CSV di input
  - Il numero di numeri di telefono associati ai flussi di contatti come specificato nel file CSV 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 (URI Amazon S3 e URL della console Amazon S3) del file CSV che contiene il numero di telefono e le coppie di flussi di contatti che non è stato possibile associare a causa di un errore
  - La posizione (URI Amazon S3 e URL della console Amazon S3) del file CSV che contiene il numero di telefono e le coppie di flussi di contatti che non erano associate a causa di limiti di tempo
- DescribeCloudFormationErrorFromStackEvents.Events
  
  Output che mostra gli eventi AWS CloudFormation dello stack se il passaggio ha esito negativo. AssociatePhoneNumbersToContactFlows

Risultato dell'esecuzione con un numero limitato di numeri di telefono e flussi di contatti

L'output mostra 7 numeri di telefono elaborati con Contact Flow, 0 errori, 0 problemi con vincoli temporali.

Risultato dell'esecuzione con un numero elevato di numeri di telefono e flussi di contatti e numeri di telefono non associati a causa di errori o limiti di tempo

Output che mostra i risultati della mappatura dei numeri di telefono con errori e posizioni dei file di risorse non elaborate.

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

Connetti il cliente

AWSSupport-CollectAmazonConnectContactFlowLog