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á. # Amazon Connect AWS Systems Manager A automação fornece runbooks predefinidos para o Amazon Connect. Para obter informações sobre como usar runbooks, consulte [Trabalhado com runbooks](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-documents.html). Para obter informações sobre como visualizar o conteúdo do runbook, consulte [Exibir conteúdo do runbook](automation-runbook-reference.md#view-automation-json). **Topics** + [`AWSSupport-AssociatePhoneNumbersToConnectContactFlows`](automation-associate-phone-numbers-to-connect-contact-flows.md) + [`AWSSupport-CollectAmazonConnectContactFlowLog`](automation-collect-amazon-connect-contact-flow-log.md) # `AWSSupport-AssociatePhoneNumbersToConnectContactFlows` **Descrição** `AWSSupport-AssociatePhoneNumbersToConnectContactFlows`Isso 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 arquivo CSV de todos os pares de números de telefone e fluxo de contatos que ele não pôde 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 em sua instância do Amazon Connect usando um arquivo CSV de dados de mapeamento que é armazenado em um bucket do Amazon Simple Storage Service (Amazon S3). O arquivo CSV de entrada deve estar alinhado ao seguinte formato, com `PhoneNumber` valores no formato [E.164](https://www.itu.int/rec/T-REC-E.164/en). **Exemplo do arquivo CSV 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 a `AssociatePhoneNumberContactFlow` API. + **`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 de`PhoneNumber,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 arquivo CSV 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** **Permissões obrigatórias do IAM** 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" } ] } ``` Se fornecer um `LambdaRoleArn` parâmetro, a função exigirá as seguintes ações para usar o runbook com êxito. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Action": [ "logs:CreateLogGroup" ], "Resource": "arn:aws:logs:us-east-1:111122223333:*", "Effect": "Allow" }, { "Action": [ "logs:CreateLogStream", "logs:PutLogEvents" ], "Resource": "arn:aws:logs:us-east-1:111122223333:*", "Effect": "Allow" }, { "Action": [ "connect:AssociatePhoneNumberContactFlow" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "s3:PutObject", "s3:GetObject" ], "Resource": "arn:aws:s3:::amzn-s3-demo-bucket/DESTINATION_FILE_PATH*", "Effect": "Allow" } ] } ``` ------ **Instruções** Siga estas etapas para configurar a automação: 1. Navegue até [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description)em Systems Manager em Documentos. 1. Selecione Execute automation (Executar automação). 1. 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 arquivo CSV 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 arquivo CSV 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ê especificar`path/to/files/`, os arquivos serão armazenados em`s3://[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)** O ARN da função do IAM 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 bucket, o ACLs 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. + **LambdaRoleArn (Opcional)** O ARN da função do IAM que permite que a AWS Lambda função acesse os AWS serviços e recursos necessários. Se nenhuma função for especificada, essa automação criará uma função do IAM para o Lambda em sua conta. 1. Selecione Executar. 1. A automação é iniciada. 1. 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 arquivo CSV de origem especificado no `SourceFilePath` existe e se o tamanho do arquivo excede o limite de 25 MiB. + **GenerateResourceIdMap** Faz o download do arquivo CSV de origem especificado na identificação `SourceFilePath` `PhoneNumberId` e `ContactFlowId` para cada recurso. Depois de concluído, ele carrega um arquivo CSV que contém`PhoneNumber`,, `PhoneNumberId``ContactFlowName`, 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 arquivo CSV. + **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 arquivo CSV 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 (URI do Amazon S3 e URL do console do 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. 1. 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 arquivo CSV de entrada + O número de números de telefone associados aos fluxos de contato, conforme especificado no arquivo CSV 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 (URI do Amazon S3 e URL do console do Amazon S3) do arquivo CSV que contém o número de telefone e os pares de fluxo de contato que não puderam ser associados devido a um erro + A localização (URI do Amazon S3 e URL do console do Amazon S3) do arquivo CSV que contém 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 ![\[Report showing 7 phone numbers processed successfully with no errors or time constraints.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_small.png) 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 ![\[Amazon Connect phone number mapping results showing processed and unprocessed contacts.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/automation-associate-phone-numbers-to-connect-contact-flows_outputs_many.png) **Referências** Automação do Systems Manager + [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-AssociatePhoneNumbersToConnectContactFlows/description) + [Executar uma automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Configurar a automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Página inicial dos fluxos de trabalho de automação](https://aws.amazon.com/premiumsupport/technology/saw/) # `AWSSupport-CollectAmazonConnectContactFlowLog` **Descrição** O runbook de `AWSSupport-CollectAmazonConnectContactFlowLog` automação é usado para coletar os registros de fluxo de contatos do Amazon Connect para uma ID de contato específica. Ao fornecer seu ID de instância e ID de contato do Amazon Connect, o runbook pesquisa os registros de fluxo de contatos do grupo de CloudWatch registros da Amazon e os carrega no bucket do Amazon Simple Storage Service (Amazon S3) especificado no parâmetro de solicitação. O runbook gera uma saída que fornece o URL do console Amazon S3 e o comando AWS CLI para você baixar os registros. **Como funciona?** O runbook de `AWSSupport-CollectAmazonConnectContactFlowLog` automação ajuda a coletar os registros de fluxo de contatos do Amazon Connect para um ID de contato específico armazenado no grupo de CloudWatch registros configurado e os carrega em um bucket específico do Amazon S3. Para ajudar na segurança dos registros coletados do seu fluxo de contatos do Amazon Connect, a automação avalia a configuração do bucket do Amazon S3 para determinar se o bucket concede permissões `read` públicas `write` ou de acesso e é de propriedade AWS da conta especificada no `S3BucketOwnerAccountId` parâmetro. Se seu bucket do Amazon S3 usa criptografia do lado do servidor com AWS Key Management Service chaves (SSE-KMS), certifique-se de que o usuário ou a função AWS Identity and Access Management (IAM) que está executando essa automação tenha as permissões na chave. `kms:GenerateDataKey` AWS KMS Para obter mais informações sobre os registros gerados pela sua instância do Amazon Connect, consulte Registros de [fluxo armazenados em um grupo de CloudWatch registros da Amazon](https://docs.aws.amazon.com/connect/latest/adminguide/contact-flow-logs-stored-in-cloudwatch.html). **Importante** As consultas do CloudWatch Logs Insights incorrem em cobranças com base na quantidade de dados consultados. Os clientes do nível gratuito são cobrados apenas pelo uso que ultrapassar as cotas de serviço. Para obter mais informações, consulte [Definição de preço do Amazon CloudWatch](https://aws.amazon.com/cloudwatch/pricing/). [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-CollectAmazonConnectContactFlowLog) **Tipo de documento** Automação **Proprietário** Amazon **Plataformas** Linux, macOS, Windows **Parâmetros** **Permissões obrigatórias do IAM** 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:::amzn-s3-demo-bucket/*", "arn:aws:s3:::amzn-s3-demo-bucket" ], "Effect": "Allow" }, { "Action": [ "connect:DescribeInstance", "connect:DescribeContact", "ds:DescribeDirectories" ], "Resource": "*", "Effect": "Allow" }, { "Action": [ "logs:StartQuery", "logs:GetQueryResults" "Resource": "*", "Effect": "Allow" } ] } ``` **Instruções** Siga estas etapas para configurar a automação: 1. Navegue até [https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description)em Systems Manager em Documentos. 1. Selecione Execute automation (Executar automação). 1. Para os parâmetros de entrada, insira o seguinte: + **AutomationAssumeRole (Opcional):** O Amazon Resource Name (ARN) da função 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. + **ContactId (Obrigatório):** A ID do contato para o qual você deseja coletar o registro do fluxo de contatos. + **S3 BucketName (obrigatório):** O nome do bucket do Amazon S3 na sua conta em que você deseja fazer o upload do log de fluxo de contatos. Certifique-se de que a política de bucket não conceda permissões desnecessárias de leitura/gravação a partes que não precisam acessar os registros coletados. + **S3 ObjectPrefix (opcional):** O caminho do objeto do Amazon S3 no bucket do Amazon S3 para um log de fluxo de contatos carregado. Por exemplo, se você especificar`CollectedLogs`, o registro será carregado como`s3://your-s3-bucket/CollectedLogs/ContactFlowLog_[ContactId][AWSAccountId].gz`. Se você não especificar esse parâmetro, o ID de execução do Systems Manager Automation será usado, por exemplo:`s3://your-s3-bucket/[automation:EXECUTION_ID]/ContactFlowLog[ContactId]_[AWSAccountId].gz`. Observação: se você especificar um valor `S3ObjectPrefix` e executar essa automação usando o mesmo [ContactId], o registro do fluxo de contatos será sobrescrito. + **S3 BucketOwnerAccount (opcional):** O número da AWS conta que possui o bucket do Amazon S3 em que você deseja fazer o upload do log de fluxo de contatos. Se você não especificar esse parâmetro, o runbook usará o ID da AWS conta do usuário ou da função na qual a automação é executada. + **S3 BucketOwnerRoleArn (opcional):** O ARN da função do IAM 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 ACLs bucket, o status da política do bucket e carrega objetos no 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). Veja a seção de permissões necessárias na descrição do runbook. ![\[Input parameters form for AWS Systems Manager Automation with fields for roles, IDs, and S3 settings.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/automation-collect-amazon-connect-contact-flow-log_input_parameters.png) 1. Selecione Executar. 1. A automação é iniciada. 1. O bucket realiza as seguintes etapas: + **CheckConnectInstanceExistance** Verifica se a instância do Amazon Connect fornecida no `ConnectInstanceId` é`ACTIVE`. + **Verificações 3 BucketPublicStatus** Verifica se o bucket do Amazon S3 especificado em `S3BucketName` permite permissões de acesso anônimas ou públicas de leitura ou gravação. + **GenerateLogSearchTimeRange** Gera `StartTime` e `EndTime` para a `StartQuery` etapa com base na `InitiationTimestamp` e `LastUpdateTimestamp` retornada pela `DescribeContact` API. `StartTime`será uma hora antes `InitiationTimestamp` e `EndTime` será uma hora depois`LastUpdateTimestamp`. + **StartQuery** Inicia um registro de consulta para o fornecido `ContactId` no grupo de CloudWatch registros de registros associado à instância do Amazon Connect fornecida em`ConnectInstanceId`. As consultas atingem o tempo limite após 60 minutos de tempo de execução. Se sua consulta atingir o tempo limite, reduza o intervalo de tempo pesquisado. Você pode ver as consultas atualmente em andamento, bem como seu histórico de consultas recentes no CloudWatch console. Para obter mais informações, consulte [Exibir consultas em execução ou histórico de consultas](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs-Insights-Query-History.html). + **WaitForQueryCompletion** Aguarda a conclusão do registro de consultas de CloudWatch registros fornecido`ContactId`. Observe que a consulta expira após 60 minutos de tempo de execução. Se sua consulta atingir o tempo limite, reduza o intervalo de tempo pesquisado. Você pode visualizar as consultas atualmente em andamento, bem como seu histórico de consultas recentes no console do Amazon Connect. Para obter mais informações, consulte [Exibir consultas em execução ou histórico de consultas](https://docs.aws.amazon.com//AmazonCloudWatch/latest/logs/CloudWatchLogs-Insights-Query-History.html). + **UploadContactFlowLog** Obtém o resultado da consulta e carrega o log do fluxo de contatos para o bucket do Amazon S3 especificado em. `S3BucketName` + **GenerateReport** Retorna a URL do console Amazon S3 em que o log do fluxo de contatos foi carregado e um exemplo de comando AWS CLI que você pode usar para baixar o arquivo de log. 1. Depois de concluído, revise a seção Saídas para obter os resultados detalhados da execução: + **GenerateReport.OutputPayload** Saída que informa que o runbook recuperou com sucesso os registros de fluxo de contato do contato especificado. Esse relatório também contém a URL do console Amazon S3 e um exemplo de comando da AWS CLI para que você possa baixar o arquivo de log. ![\[Output showing successful retrieval of Contact Flow log with S3 Console URL and AWS CLI command.\]](http://docs.aws.amazon.com/pt_br/systems-manager-automation-runbooks/latest/userguide/images/automation-collect-amazon-connect-contact-flow-log_outputs.png) **Referências** Automação do Systems Manager + [Execute esta automação (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-CollectAmazonConnectContactFlowLog/description) + [Executar uma automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-working-executing.html) + [Configurar a automação](https://docs.aws.amazon.com//systems-manager/latest/userguide/automation-setup.html) + [Página inicial dos fluxos de trabalho de automação](https://aws.amazon.com/premiumsupport/technology/saw/)