AWSSupport-AssociatePhoneNumbersToConnectContactFlows - AWS Systems Manager Referência do runbook de automação

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

AWSSupport-AssociatePhoneNumbersToConnectContactFlows

Descrição

AWSSupport-AssociatePhoneNumbersToConnectContactFlowsIsso ajuda você a associar números de telefone aos fluxos de contato na sua instância do Amazon Connect. Ao fornecer os mapeamentos de números de telefone e fluxos de contato em um arquivo de entrada de valores separados por vírgula (CSV), o runbook associa o maior número possível de números de telefone aos fluxos de contato em 14,5 minutos. O runbook produz um CSV arquivo de todos os pares de números de telefone e fluxo de contatos que não foi possível associar dentro do limite de tempo para que você possa inseri-los na próxima execução.

Como funciona?

O runbook AWSSupport-AssociatePhoneNumbersToConnectContactFlows ajuda você a associar números de telefone aos fluxos de contato na sua instância do Amazon Connect usando um CSV arquivo de dados de mapeamento que é armazenado em um bucket do Amazon Simple Storage Service (Amazon S3). O CSV arquivo de entrada deve estar alinhado ao seguinte formato, com PhoneNumber valores no formato E.164.

Exemplo do CSV arquivo de entrada

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

O runbook de automação também cria os seguintes arquivos no local de destino especificado no DestinationFileBucket e. DestinationFilePath

  • automation:EXECUTION_ID/ResourceIdList.csv: um arquivo temporário que contém os ContactFlowId pares PhoneNumberId e que são necessários para AssociatePhoneNumberContactFlow API o.

  • automation:EXECUTION_ID/ErrorResourceList.csv: um arquivo que contém o número de telefone e os pares de fluxo de contatos que não puderam ser processados devido a um erro, como ResourceNotFoundException no formato dePhoneNumber,ContactFlowName,ErrorMessage.

  • automation:EXECUTION_ID/NonProcessedResourceList.csv: um arquivo que contém o número de telefone e os pares de fluxo de contatos que não foram processados. O runbook tenta processar o maior número possível de números de telefone e fluxos de contato em 14,5 minutos (15 minutos de tempo limite da AWS Lambda função - 30 segundos de buffer). Se houver alguns números de telefone/fluxos de contato que não puderam ser processados devido à restrição de tempo, o runbook os incluirá em um CSV arquivo para usar como entrada para a próxima execução do runbook.

Tipo de documento

Automação

Proprietário

Amazon

Plataformas

Linux, macOS, Windows

Parâmetros

IAMPermissões necessárias

O parâmetro AutomationAssumeRole requer as seguintes ações para usar o runbook com êxito.


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

Instruções

Siga estas etapas para configurar a automação:

  1. Navegue até AWSSupport-AssociatePhoneNumbersToConnectContactFlowsem Systems Manager em Documentos.

  2. Selecione Execute automation (Executar automação).

  3. Para os parâmetros de entrada, insira o seguinte:

    • AutomationAssumeRole (Opcional)

      O Amazon Resource Name (ARN) da função AWS AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation execute as ações em seu nome. Se nenhuma função for especificada, o Systems Manager Automation usa as permissões do usuário que inicia esse runbook.

    • ConnectInstanceId (Obrigatório)

      O ID da sua instância do Amazon Connect.

    • SourceFileBucket (Obrigatório)

      O bucket do Amazon S3 que armazena o CSV arquivo que contém o número de telefone e os pares de fluxo de contato.

    • SourceFilePath (Obrigatório)

      A chave de objeto do Amazon S3 do CSV arquivo que contém o número de telefone e os pares de fluxo de contato. Por exemplo, path/to/input.csv.

    • DestinationFileBucket (Obrigatório)

      O bucket do Amazon S3 no qual a automação colocará um arquivo intermediário e um relatório de resultados.

    • DestinationFilePath (Opcional)

      O caminho do objeto Amazon S3 no DestinationFileBucket qual um arquivo intermediário e um relatório de resultados devem ser armazenados. Por exemplo, se você especificarpath/to/files/, os arquivos serão armazenados ems3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/.

    • S3 BucketOwnerAccount (opcional)

      O número da AWS conta que possui o bucket do Amazon S3 em que você deseja fazer o upload do registro de fluxo de contatos. Se você não especificar esse parâmetro, os runbooks usarão o ID da AWS conta do usuário ou da função na qual a automação é executada.

    • S3 BucketOwnerRoleArn (opcional)

      A ARN IAM função com permissões para obter o bucket e a conta do Amazon S3 bloqueia as configurações de acesso público, a configuração da criptografia do bucket, o bucketACLs, o status da política do bucket e o upload de objetos para o bucket. Se esse parâmetro não for especificado, o runbook usa o AutomationAssumeRole (se especificado) ou o usuário que inicia esse runbook (se não AutomationAssumeRole for especificado). Consulte a seção de permissões necessárias na descrição do runbook.

  4. Selecione Executar.

  5. A automação é iniciada.

  6. O bucket realiza as seguintes etapas:

    • CheckConnectInstanceExistance

      Verifica se a instância do Amazon Connect fornecida em ConnectInstanceId existe.

    • Verificações 3 BucketPublicStatus

      Verifica se os buckets do Amazon S3 especificados no SourceFileBucket e DestinationFileBucket permitem permissões de acesso anônimas ou públicas de leitura ou gravação.

    • CheckSourceFileExistenceAndSize

      Verifica se o CSV arquivo de origem especificado no SourceFilePath existe e se o tamanho do arquivo excede o limite de 25 MiB.

    • GenerateResourceIdMap

      Faz o download CSV do arquivo de origem especificado na identificação SourceFilePath PhoneNumberId e ContactFlowId para cada recurso. Depois de concluído, ele carrega um CSV arquivo que contémPhoneNumber,, PhoneNumberIdContactFlowName, e ContactFlowId para o bucket de destino do Amazon S3 especificado em. DestinationFileBucket Se PhoneNumberId não puder ser identificado por um determinado número, o campo ficará vazio no CSV arquivo.

    • AssociatePhoneNumbersToContactFlows

      Cria uma AWS Lambda função na sua conta usando uma AWS CloudFormation pilha. A AWS Lambda função associa cada número a um fluxo de contato listado no CSV arquivo de origem especificado em SourceFileBucket e SourceFilePath e a AWS CloudFormation pilha invoca a função. A AWS Lambda função mapeia o maior número possível de números de telefone para fluxos de contato antes que o tempo limite atinja o tempo limite (15 minutos). A lista de números de telefone e fluxos de contato que não puderam ser processados devido a um erro é carregada em[automation:EXECUTION_ID]/ErrorResourceList.csv. Aqueles que não puderam ser processados devido ao excesso do número máximo de números de telefone que podem ser processados em uma única execução são enviados[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Se essa etapa falhar, ela vai para a DescribeCloudFormationErrorFromStackEvents etapa para mostrar por que ela falhou nos eventos da AWS CloudFormation pilha.

    • WaitForPhoneNumberContactFlowAssociationCompletion

      Espera até que a AWS Lambda função que mapeia números de telefone para fluxos de contato seja criada e a AWS CloudFormation pilha conclua sua invocação.

    • GenerateReport

      Gera o relatório que contém o número de números de telefone mapeados para fluxos de contato, aqueles que não puderam ser processados devido a um erro e aqueles que não puderam ser processados devido ao excesso do número máximo de números de telefone que podem ser processados em uma única execução. O relatório também mostra a localização (Amazon S3 URI e URL console Amazon S3) [automation:EXECUTION_ID]/ErrorResourceList.csv para [automation:EXECUTION_ID]/NonProcessedResourceList.csv ou, se aplicável.

    • DeleteCloudFormationStack

      Exclui a AWS CloudFormation pilha, incluindo a função Lambda para mapeamento.

    • DescribeCloudFormationErrorFromStackEvent

      Descreve os erros da AWS CloudFormation pilha da AssociatePhoneNumbersToContactFlows etapa.

  7. Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução:

    • GenerateReport.OutputPayload

      Saída de associações de número de telefone e fluxo de contatos. Esse relatório contém as seguintes informações:

      • O número de pares de números de telefone e fluxo de contatos listados no CSV arquivo de entrada

      • O número de números de telefone associados aos fluxos de contato, conforme especificado no CSV arquivo de entrada

      • O número de números de telefone que não puderam ser associados aos fluxos de contato devido a um erro

      • O número de números de telefone que não estavam associados aos fluxos de contato devido à restrição de tempo

      • A localização (Amazon S3 URI e URL console Amazon S3) do arquivo que contém CSV o número de telefone e os pares de fluxo de contatos que não puderam ser associados devido a um erro

      • A localização (Amazon S3 URI e Amazon S3 URL Console) do arquivo que contém CSV o número de telefone e os pares de fluxo de contato que não foram associados devido à restrição de tempo

    • DescribeCloudFormationErrorFromStackEvents.Eventos

      Saída que mostra os eventos da AWS CloudFormation pilha se a AssociatePhoneNumbersToContactFlows etapa falhar.

Saída de execução com um pequeno número de números de telefone e fluxos de contato

Saída de execução com um grande número de números de telefone e fluxos de contato e números de telefone que não foram associados devido a erro ou restrição de tempo

Referências

Automação do Systems Manager