Configure un Listener para ejecutar una acción cuando ocurra un evento en una aplicación externa. En este ejemplo, se muestra cómo crear un Task Bot con un activador de Listener para enviar un correo electrónico a un buzón de correo de Microsoft 365 Outlook cuando un usuario crea un ticket en la plataforma Zendesk.

El activador detecta cualquier evento en la plataforma Zendesk. Cuando el usuario crea un ticket en la plataforma, el activador inicia el flujo de trabajo de automatización subsiguiente para enviar un correo electrónico que contiene los detalles del ticket al buzón de correo de Microsoft 365 Outlook configurado.

Antes de empezar

Asegúrese de que cumpla con los siguientes requisitos previos:
  • Una URL de detector para la automatización. Para obtener más información sobre la creación de URL de detector, consulte Creación de la URL de detector para el activador web de Listener.
  • Privilegios de administrador de la plataforma Zendesk para crear, actualizar y eliminar tickets.
  • Los requisitos del activador detector se enumeran en Activador de Listener.
  • Una variable de registro llamada TriggerData.
  • Conexión activa de ‌OAuth para Microsoft 365 Outlook.
  • Una variable de credenciales que contiene el nombre de usuario de Microsoft 365 Outlook.

Procedimiento

  1. Realice los siguientes pasos para crear un webhook en la plataforma Zendesk.
    1. Inicie sesión en su portal Zendesk
    2. Vaya a Centro de administración > Aplicaciones e integraciones > Webhooks y luego, haga clic en Crear webhook.
    3. Ingrese lo siguiente en los campos correspondientes.
      1. Seleccione una forma de conexión: Seleccione eventos de Zendesk y elija Cualquier evento de ticket de la lista desplegable de tipos de eventos.
      2. Nombre: Ingrese un nombre apropiado para el webhook.
      3. URL del punto final: Agregue la URL de detector que cree en la Control Room.
      4. Autenticación: Seleccione Clave de API.
      5. Nombre del encabezado: Ingrese ticket-header.
      6. Valor: Ingrese un valor adecuado para el encabezado.
      Para obtener más información sobre la creación de webhooks, consulte Creating webhooks in Zendesk.
  2. Realice los siguientes pasos para crear un Task Bot en la Control Room.
    1. En el panel izquierdo, haga clic en Automatización.
    2. Haga clic en Crear > Task Bot.
      Aparece el asistente Crear Bot de tareas.
    3. Ingrese un nombre apropiado para el bot en el campo Nombre.
      El sistema almacena todos los bots en la carpeta <\Bots> de manera predeterminada.
    4. Opcional: Agregue una descripción para el bot en el campo Descripción.
    5. Opcional: Haga clic en Elegir y siga las indicaciones para guardar el bot en una carpeta diferente.
    6. Haga clic en Crear y editar.
      El bot se crea y aparece la página Editar bot de tareas.
  3. Realice los siguientes pasos para agregar y configurar el activador web Listener.
    1. Haga clic en Activadores > Activador web universal, luego haga doble clic en Detector o arrastre esta opción para agregar el activador web a la sección Activadores.
    2. Seleccione la URL de receptor generada en la lista desplegable Detector.
      El sistema completa automáticamente la URL generada en el campo URL.
    3. Haga clic en Agregar en los Encabezados de autenticación para abrir el modal Encabezados.
    4. Ingrese el nombre del encabezado de autenticación en Nombre.
    5. Seleccione String insegura e ingrese el valor del encabezado en Valor.
      Alternativamente, puede guardar el valor como una credencial en Credential Vault y usar la opción Credencial para seleccionar el valor.
    6. Haga clic en Agregar para añadir el encabezado de autenticación.
    7. Seleccione Sin validación desde el menú desplegable Esquema de firma.
    8. Seleccione TriggerData en la lista desplegable Respuesta.
      La variable TriggerData almacena la carga útil de respuesta entrante de Zendesk. Para obtener más información sobre la carga útil de respuesta de los eventos de tickets, consulte Zendesk ticket events payloads.
  4. Realice los siguientes pasos para agregar y configurar la acción Conectar de Microsoft 365 Outlook.
    1. Haga clic en Acciones > Microsoft 365 Outlook, luego haga doble clic en Conectar o arrastre esta opción para agregar la acción a la sección Acciones.
    2. Seleccione Azure Global en Azure Cloud.
      Si su Microsoft 365 Outlook forma parte de la versión gubernamental de Microsoft 365, seleccione Azure US GCC High.
    3. Seleccione Gestionado por la Control Room en Modo de autenticación OAuth2.
    4. Haga clic en Elegir y siga las indicaciones en el modal Elegir una conexión OAuth para seleccionar la conexión ‌OAuth del Microsoft 365 Outlook.
    5. Haga clic en Variable > Ingresar un valor y siga las indicaciones para seleccionar la credencial de nombre de usuario de Microsoft 365 Outlook.
    6. Opcional: Ingrese un nombre de sesión apropiado en Crear sesión de Microsoft 365 Outlook.
      El sistema establece Microsoft365OutlookSession como el nombre de la sesión de forma predeterminada.
  5. Realice los siguientes pasos para agregar y configurar la acción Enviar de Microsoft 365 Outlook.
    1. Haga clic en Acciones > Microsoft 365 Outlook, luego haga doble clic en Enviar o arrastre esta opción para agregar la acción a la sección Acciones.
    2. Ingrese el nombre de sesión que ingresó al configurar la acción Conectar.
      Si se mantiene el nombre predeterminado, el sistema completa automáticamente Microsoft365OutlookSession como la sesión de Microsoft 365 Outlook.
    3. Ingrese la dirección de correo de Microsoft 365 Outlook a la que se deben enviar los detalles del archivo en Para.
    4. Ingrese $TriggerData{"detail.subject"}$ en Asunto.
      La clave detail.subject contiene el asunto del ticket de Zendesk como su valor.
    5. Seleccione Código HTML en Tipo de cuerpo de correo electrónico e ingrese $TriggerData{"detail.description"}$.
      La clave detail.description contiene la descripción del ticket de Zendesk como su valor.
  6. Haga clic en Guardar para guardar la configuración.
Cuando haga clic en Ejecutar > Ejecutar con activadores, el sistema acciona el activador y este comienza a detectar los eventos de tickets en la plataforma Zendesk. Cuando un usuario crea un ticket, el activador inicia las acciones subsiguientes de Microsoft 365 Outlook. El buzón de correo de Microsoft 365 Outlook recibe un correo con el asunto del ticket como asunto del correo y la descripción del ticket como cuerpo del correo.