AWSSupport-AssociatePhoneNumbersToConnectContactFlows

Descripción

AWSSupport-AssociatePhoneNumbersToConnectContactFlowsEsto le ayuda a asociar números de teléfono a los flujos de contactos de su instancia de Amazon Connect. Al proporcionar las asignaciones de números de teléfono y flujos de contactos en un archivo de entrada de valores separados por comas (CSV), el manual asocia tantos números de teléfono a los flujos de contactos como sea posible en 14,5 minutos. El manual genera un archivo CSV con todos los pares de números de teléfono y flujos de contactos que no ha podido asociar dentro del límite de tiempo para que puedas introducirlos en la siguiente ejecución.

¿Cómo funciona?

El manual le AWSSupport-AssociatePhoneNumbersToConnectContactFlows ayuda a asociar números de teléfono a los flujos de contactos de su instancia de Amazon Connect mediante un archivo CSV de datos de mapeo que se almacena en un depósito de Amazon Simple Storage Service (Amazon S3). El archivo CSV de entrada debe alinearse con el siguiente formato, con PhoneNumber los valores en formato E.164.

Ejemplo del archivo CSV de entrada

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

El manual de automatización también crea los siguientes archivos en la ubicación de destino especificada en DestinationFileBucket yDestinationFilePath.

• automation:EXECUTION_ID/ResourceIdList.csv: un archivo temporal que contiene los ContactFlowId pares PhoneNumberId y necesarios para la AssociatePhoneNumberContactFlow API.

• automation:EXECUTION_ID/ErrorResourceList.csv: un archivo que contiene los pares de números de teléfono y flujo de contactos que no se pudieron procesar debido a un error, por ejemplo, ResourceNotFoundException en el formato dePhoneNumber,ContactFlowName,ErrorMessage.

• automation:EXECUTION_ID/NonProcessedResourceList.csv: un archivo que contiene los pares de número de teléfono y flujo de contactos que no se procesaron. El manual intenta procesar tantos números de teléfono y flujos de contactos como sea posible en 14,5 minutos (15 minutos después del tiempo de espera de la AWS Lambda función, 30 segundos de búfer). Si hay algunos números de teléfono o flujos de contactos que no se han podido procesar por falta de tiempo, el runbook los incluye en un archivo CSV para usarlos como entrada en la siguiente ejecución del runbook.

Tipo de documento

Automation

Propietario

Amazon

Plataformas

Linux, macOS, Windows

Parámetros

Permisos de IAM necesarios

El parámetro AutomationAssumeRole requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.

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

Instrucciones

Siga estos pasos para configurar la automatización:

1. Navegue hasta AWSSupport-AssociatePhoneNumbersToConnectContactFlowsSystems Manager, en Documentos.

2. Elija Execute automation (Ejecutar automatización).

3. Para los parámetros de entrada, introduzca lo siguiente:

   • AutomationAssumeRole (Opcional)

     El nombre del recurso de Amazon (ARN) del rol AWS AWS Identity and Access Management (IAM) que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que inicia este runbook.

   • ConnectInstanceId (Obligatorio)

     El ID de tu instancia de Amazon Connect.

   • SourceFileBucket (Obligatorio)

     El depósito de Amazon S3 que almacena el archivo CSV que contiene los pares de número de teléfono y flujo de contacto.

   • SourceFilePath (Obligatorio)

     La clave de objeto de Amazon S3 del archivo CSV que contiene los pares de número de teléfono y flujo de contacto. Por ejemplo, path/to/input.csv.

   • DestinationFileBucket (Obligatorio)

     El depósito de Amazon S3 en el que la automatización colocará un archivo intermedio y un informe de resultados.

   • DestinationFilePath (Opcional)

     La ruta del objeto de Amazon S3 en DestinationFileBucket la que se deben almacenar un archivo intermedio y un informe de resultados. Por ejemplo, si lo especificapath/to/files/, los archivos se almacenan ens3://[DestinationFileBucket]/path/to/files/[automation:EXECUTION_ID]/.

   • S3 BucketOwnerAccount (opcional)

     El número de AWS cuenta propietario del bucket de Amazon S3 en el que desea cargar el registro de flujo de contactos. Si no especificas este parámetro, los manuales utilizan el ID de AWS cuenta del usuario o rol en el que se ejecuta la automatización.

   • S3 BucketOwnerRoleArn (opcional)

     El ARN de la función de IAM con permisos para obtener la configuración de acceso público del bucket y el bloqueo de cuentas de Amazon S3, la configuración de cifrado del bucket, las ACL del bucket, el estado de la política del bucket y cargar objetos al bucket. Si no se especifica este parámetro, el runbook utiliza el runbook AutomationAssumeRole (si se ha especificado) o el usuario que inicia este runbook (si AutomationAssumeRole no se ha especificado). Por favor consulte la sección de permisos necesarios en la descripción del manual de procedimientos.

   

4. Seleccione Ejecutar.

5. Se inicia la automatización.

6. Este documento realiza los siguientes pasos:

   • CheckConnectInstanceExistance

     Comprueba si la instancia de Amazon Connect proporcionada ConnectInstanceId existe.

   • Comprueba [S3] BucketPublicStatus

     Comprueba si los buckets de Amazon S3 especificados en SourceFileBucket y DestinationFileBucket permiten permisos de acceso de lectura o escritura públicos o anónimos.

   • CheckSourceFileExistenceAndSize

     Comprueba si el archivo CSV de origen especificado en el SourceFilePath existe y si el tamaño del archivo supera el límite de 25 MiB.

   • GenerateResourceIdMap

     Descarga el archivo CSV de origen especificado en el SourceFilePath identificador PhoneNumberId y ContactFlowId para cada recurso. Una vez hecho esto, carga un archivo CSV que contienePhoneNumber, PhoneNumberIdContactFlowName, y ContactFlowId al bucket Amazon S3 de destino especificado enDestinationFileBucket. Si PhoneNumberId no se puede identificar con un número determinado, el archivo estará vacío en el archivo CSV.

   • AssociatePhoneNumbersToContactFlows

     Crea una AWS Lambda función en tu cuenta mediante una AWS CloudFormation pila. La AWS Lambda función asocia cada número a un flujo de contactos que aparece en el archivo CSV de origen especificado en SourceFileBucket SourceFilePath y, a continuación, la AWS CloudFormation pila invoca la función. La AWS Lambda función asigna tantos números de teléfono a los flujos de contactos como sea posible antes de que se agote el tiempo de espera (15 minutos). Se carga la lista de números de teléfono y flujos de contactos que no se pudieron procesar debido a un error[automation:EXECUTION_ID]/ErrorResourceList.csv. Se cargan los que no se han podido procesar debido a que se ha superado el número máximo de números de teléfono que se pueden procesar en una sola ejecución[automation:EXECUTION_ID]/NonProcessedResourceList.csv. Si se produce un error en este paso, se pasa al DescribeCloudFormationErrorFromStackEvents paso siguiente para mostrar el motivo del error debido a los eventos de la AWS CloudFormation pila.

   • WaitForPhoneNumberContactFlowAssociationCompletion

     Espera hasta que se cree la AWS Lambda función que asigna los números de teléfono a los flujos de contactos y la AWS CloudFormation pila complete su invocación.

   • GenerateReport

     Genera el informe que contiene el número de números de teléfono asignados a los flujos de contactos, los que no se pudieron procesar debido a un error y los que no se pudieron procesar debido a un exceso del número máximo de números de teléfono que se pueden procesar en una sola ejecución. El informe también muestra la ubicación (URI de Amazon S3 y URL de la consola de Amazon S3) de [automation:EXECUTION_ID]/ErrorResourceList.csv o[automation:EXECUTION_ID]/NonProcessedResourceList.csv, si corresponde.

   • DeleteCloudFormationStack

     Elimina la AWS CloudFormation pila, incluida la función Lambda para el mapeo.

   • DescribeCloudFormationErrorFromStackEvent

     Describe los errores de la AWS CloudFormation pila del AssociatePhoneNumbersToContactFlows paso.

7. Una vez finalizado, revise la sección de resultados para ver los resultados detallados de la ejecución:

   • GenerateReport.OutputPayload

     Resultado de las asociaciones de números de teléfono y flujo de contactos. Este informe contiene la siguiente información:

     • El número de pares de números de teléfono y flujo de contactos que aparecen en el archivo CSV de entrada

     • El número de números de teléfono asociados a los flujos de contactos, tal como se especifica en el archivo CSV de entrada

     • El número de números de teléfono que no se pudieron asociar a los flujos de contactos debido a un error

     • El número de números de teléfono que no estaban asociados a los flujos de contactos por falta de tiempo

     • La ubicación (URI de Amazon S3 y URL de la consola de Amazon S3) del archivo CSV que contiene los pares de número de teléfono y flujo de contactos que no se pudieron asociar debido a un error

     • La ubicación (URI de Amazon S3 y URL de la consola de Amazon S3) del archivo CSV que contiene los pares de números de teléfono y flujo de contactos que no estaban asociados por falta de tiempo

   • DescribeCloudFormationErrorFromStackEvents.Eventos

     Resultado que muestra los eventos de la AWS CloudFormation pila si el AssociatePhoneNumbersToContactFlows paso falla.

Resultado de la ejecución con un número reducido de números de teléfono y flujos de contactos

Resultado de la ejecución con una gran cantidad de números de teléfono y flujos de contactos y números de teléfono que no estaban asociados debido a un error o a una limitación de tiempo

Referencias

Automatización de Systems Manager

• Ejecuta esta automatización (consola)

• Ejecución de una automatización

• Configuración de Automation

• Página de inicio de Support Automation Workflows