Configuración de Amazon AppFlow con Zendesk

¿Qué plan tengo?

Suite

Cualquier plan

Amazon AppFlow es un servicio de AWS que permite la transferencia segura de datos de Zendesk a AWS y otras aplicaciones SaaS.

Su interfaz permite configurar flujos de datos dentro de la cuenta de AWS. AppFlow luego establece la conexión y extrae los datos apropiados de Zendesk al tiempo que acciona las transformaciones y carga los datos en el servicio de destino seleccionado.

Este artículo lo guiará a través de la configuración de un flujo de datos de Zendesk en Amazon AppFlow. Para usar Amazon AppFlow, necesitará:

• Permisos de administrador en Zendesk Support
• Acceso a la consola de su cuenta de AWS
• Un cliente OAuth para su cuenta de Zendesk

En este artículo, se tratan los siguientes temas:

• Registrar su aplicación en Zendesk
• Crear un flujo
• Paso 1: Especificar los detalles del flujo
• Paso 2: Configurar el flujo
• Paso 3: Mapear los campos de datos
• Paso 4: Agregar filtros
• Paso 5: Revisar y crear
• Límites de la integración con AppFlow

Información relacionada:

• Uso de la autenticación OAuth con su aplicación

Registrar su aplicación en Zendesk

Para usar Amazon AppFlow es necesario que registre la aplicación para generar credenciales de OAuth que su aplicación pueda usar para autenticar las llamadas API a Zendesk. Esto se realiza en Zendesk Support.

Para registrar Amazon AppFlow en Zendesk

1. En el Centro de administración, haga clic en Aplicaciones e integraciones en la barra lateral y luego seleccione API > API de Zendesk.
2. Haga clic en la pestaña Clientes OAuth y luego en Agregar cliente OAuth al lado derecho de la lista de clientes.
3. Complete los siguientes campos para crear un cliente OAuth para AppFlow:
   • Nombre de cliente: ingrese un nombre para su aplicación AppFlow. Este es el nombre que verán los usuarios cuando se les solicite que otorguen acceso a la aplicación, y cuando verifiquen la lista de aplicaciones de terceros que tienen acceso a sus cuentas de Zendesk.
   • Descripción: opcional. Una descripción corta de la aplicación que verán los usuarios cuando se les solicite que otorguen acceso a ella.
   • Compañía: opcional. El nombre de la compañía que verán los usuarios cuando se les solicite que otorguen acceso a la aplicación. La información les permitirá saber a quién le están otorgando acceso.
   • Logotipo: opcional. El logotipo que verán los usuarios cuando se les solicite que otorguen acceso a la aplicación.
   • Identificador único: el campo se rellena automáticamente con una versión reformateada del nombre que ingresó para su aplicación. Puede cambiarlo si desea.
   • URL de redireccionamiento: ingrese “ https://{aws_region}.console.aws.amazon.com/appflow/oauth”. Reemplace {aws_region} por la región de AWS en la que está creando el flujo. Ejemplo: "https://ap-southeast-2.console.aws.amazon.com/appflow/oauth".
4. Haga clic en Guardar. En la parte inferior aparecerá un nuevo campo “Secreto” rellenado automáticamente.
5. Copie y guarde la clave secreta en un lugar seguro.
6. Haga clic en Guardar.
   
   

Crear un flujo

Para crear un flujo en la consola de su cuenta de AWS se deben seguir una serie de pasos de configuración.

Para crear un flujo

1. Inicie sesión en la consola de su cuenta de AWS y seleccione AppFlow en el menú de servicios.
2. Haga clic en Create flow.
   
   

   Complete la configuración de un flujo tal como se describe en las secciones que siguen.

Paso 1: Especificar los detalles del flujo

En Step 1: Especificar los detalles del flujo, se configuran el nombre y los detalles del flujo.

Para especificar los detalles del flujo

1. En Step 1: Especificar los detalles del flujo, ingrese los siguientes detalles para el flujo:
   • Flow name: ingrese un nombre para el flujo.
   • Flow Description: agregue una descripción del flujo.
   • Data Encyption: configure la encriptación del flujo. Aquí tiene la opción de usar la clave predeterminada o personalizar la encriptación creando una clave de AWS KMS o usando un Amazon Resource Name.
   • Tags: agregue etiquetas como pares de valores clave para el flujo.
     
     
2. Haga clic en Siguiente.

Paso 2: Configurar el flujo

En Paso 2: Configurar el flujo, se nombran los datos que tienen origen en Zendesk y a dónde deben dirigirse, por ejemplo: S3, Redshift, o aplicaciones SaaS seleccionadas.

Para configurar el flujo

1. En Paso 2: Configurar el flujo, seleccione “Zendesk” en las opciones de la lista desplegable Source name bajo Source details.
2. Haga clic en Connect.
3. En la ventana modal, ingrese la ID del cliente y el secreto de cliente OAuth que creó anteriormente en Support, su subdominio de Zendesk y el nombre de la conexión.
   
   
   Nota: Si recibe un mensaje de error, primero verifique el URL de redireccionamiento en el cliente OAuth de AppFlow en Support. Si sigue teniendo errores, contacte al administrador de AWS para comprobar los roles y permisos de AWS.
4. En la ventana emergente, haga clic en Allow para que AppFlow pueda acceder a los datos de Zendesk. Es necesario ser administrador de Zendesk para permitir el acceso.
   
   
5. En la lista desplegable Choose Zendesk object seleccione el tipo de datos de Zendesk que desea sincronizar.
6. En la lista desplegable Destination name, bajo Destination details, seleccione el destino para los datos de Zendesk.
   • Si selecciona S3 como destino, seleccione el bucket S3 para enviar datos
   • Si selecciona otro destino, haga clic en Connect y siga las indicaciones de la ventana modal para completar la conexión
     
     
7. En la sección Flow trigger, bajo Choose how to trigger the flow, seleccione “Run on demand” para activar el flujo manualmente o “Run on schedule” para activar el flujo de acuerdo a un programa. Si elige “Run on schedule”, seleccione la frecuencia del programa.
   
   
8. Seleccione Transfer only new data si desea transferir únicamente los datos que son nuevos cuando se activa el flujo, o bien Transfer all data si desea que el flujo transfiera todos los datos.
9. Haga clic en Siguiente.

Paso 3: Mapear los campos de datos

En Paso 3: Mapear los campos de datos, se especifica cómo se mapean los campos de datos de Zendesk con los campos en el destino.

Para mapear los campos de datos

1. Elija el método para mapear los campos.
   • Manually map fields. Para mapear manualmente todos los campos, elija Source field name, Bulk actions y Map all fields directly. O bien, seleccione uno o más campos de Source field name, Source fields y luego elija Map fields directly.
   • Upload csv file with mapped fields. Use un archivo CSV para definir el mapeo. El archivo CSV contiene valores separados por coma del nombre del campo de origen y el nombre del campo de destino.
   
   
   
2. Para concatenar los campos entre sí, seleccione los campos mapeados y luego seleccione Add formula.
   
   
3. Para enmascarar los campos o truncar los nombres de campos, seleccione los campos mapeados y luego seleccione Modify values.
4. Para Validations, haga clic en Add validation para configurar cómo se deben manejar los campos de datos según la condición.
   
   
5. Haga clic en Siguiente.

Paso 4: Agregar filtros

En Paso 4: Agregar filtros, se establecen las reglas que determinan qué datos se extraen de su cuenta de Zendesk cada vez que se activa el flujo.

Para agregar filtros

1. En Filters, haga clic en Add filter, luego seleccione el campo, elija una condición y especifique los criterios.
   
   
2. Haga clic en Siguiente.

Paso 5: Revisar y crear

En Paso 5: Revisar y crear, se puede examinar la configuración del flujo antes de crearla.

Para finalizar la creación de un flujo

1. Verifique que la configuración esté correcta. Haga clic en Edit en la parte superior derecha si necesita hacer modificaciones.
2. Haga clic en Create flow.

Así quedará creado el flujo.

Límites de la integración con AppFlow

Amazon impone los siguientes límites en AppFlow:

• Un millón de flujos por cuenta
• 10 millones de ejecuciones de flujos al mes
• Ningún flujo puede tener más de un origen y un destino
• Ningún flujo puede incluir más de 10 tareas

También se aplican los límites de la API de Zendesk de modo que cada vez que se ejecuta un flujo, se consume una llamada de API desde la API de exportación incremental de Zendesk.