Agregar activador de correo electrónico

Inicia un bot cuando se recibe un nuevo mensaje de correo electrónico desde el servicio de correo electrónico predefinido.

Conecte el Control Room a uno de los servicios de correo electrónico en su sistema y active el bot cuando reciba un nuevo correo electrónico.

Para la automatización del correo electrónico, puede utilizar OAuth 2.0 para autenticarse con el servidor de correo electrónico. Para registrar su aplicación en la plataforma de identidades de Microsoft, consulte Usar la acción Conectar en el Correo electrónico de paquete

Procedimiento

  1. En el panel izquierdo, haga clic en Automatización.
    Se muestra la lista de formularios y bots disponibles.
  2. Haga clic en Crear nuevo > Bot.
  3. Ingrese un nombre para el bot.
    Todos los bots se almacenan en la carpeta \Bots. (Opcional) Haga clic en Explorar para cambiar la carpeta.
  4. Haga clic en Crear y editar.
  5. En la página del creador de bot, haga clic en Activadores > Activador de correo electrónico.
  6. Arrastre Correo electrónico a Arrastrar un activador aquí.
  7. Utilice el panel Activador de correo electrónico ubicado a la derecha para elegir uno de los siguientes tipos de servidor como activador para sus correos electrónicos entrantes:
    Tipo de servidorPasos
    Microsoft Outlook Haga clic en Outlook.

    Microsoft Outlook se configura como el servicio de correo electrónico y bot se activa cuando recibe un nuevo correo electrónico.
    Servidor de correo electrónico Haga clic en Servidor de correo electrónico.
    1. Introduzca la información del Host del servicio de correo electrónico.

      Por ejemplo, si está utilizando Office365 como su servicio de correo electrónico, introduzca Outlook.office365.com.

    2. Seleccione IMAP o POP3.
      IMAP y POP3 son protocolos utilizados para conectarse al servidor de correo que le permite leer sus correos electrónicos a través de un cliente de correo electrónico.
      Nota: El protocolo POP3 tiene una limitación conocida en la que cualquier nueva invitación de calendario también puede activar el bot.
    3. Usar conexión segura (SSL/TLS): Seleccione esta opción si desea utilizar una conexión segura con el servidor de correo.
    4. Introduzca el número de puerto configurado para su servidor de correo electrónico.
    5. Seleccione uno de los siguientes métodos de autenticación de usuario para iniciar sesión en el servidor de correo electrónico:
      • Básica
      • Credenciales del cliente
        • Especifique los ID de cliente e inquilino únicos generados cuando registró la aplicación en el portal de Microsoft Azure.
        • Especifique el nombre de usuario que quiere utilizar para acceder al servidor de correo.
        • Especifique el secreto de cliente que generó para su aplicación en el portal de registro de aplicaciones.
          Para los campos ID de cliente, ID de inquilino, Nombre de usuario y Secreto del cliente, elija entre las pestañas Credencial o Cadena insegura:
          • Credencial: Utiliza un valor disponible en la Credential Vault.
          • Cadena insegura: De lo contrario, escriba un valor.
          Nota: El flujo de Credenciales del cliente no es compatible con Gmail.
      • Control Room administrada

        Para usar el modo de autenticación OAuth2 administrado por Control Room a fin de automatizar Gmail, debe configurar la conexión OAuth en Control Room. Consulte Crear conexiones ‌OAuth.

        Actualice la información en los siguientes campos:

        • Conexión: Haga clic en el botón Elegir para seleccionar un tipo de conexión.
        • Seleccione Personalizado en el campo Tipo de proveedor.

        • Seleccione el nombre de la conexión que configuró en la Control Room para aplicaciones de Google Workspace.

        • Utilice el campo Tipo de implementación para seleccionar una de las siguientes opciones:

          Para obtener información sobre los tokens de acceso y actualización de la aplicación Google Workspace, consulte Configurar aplicaciones empresariales

          • Compartido: Seleccione esta opción cuando el token de acceso de OAuth2 se comparta para todos los usuarios que ejecutan la automatización.
            Nota: Esta opción requiere que el administrador de Control Room o cualquier usuario (con las opciones Administrar conexiones y Ver conexiones habilitadas para las CONEXIONES OAUTH) configure una conexión OAuth en Control Room. Guarde las credenciales de inicio de sesión una vez para generar un token de acceso compartido que puedan usar todos los usuarios que ejecutan la automatización.
          • Específico del usuario: Seleccione esta opción cuando el token de acceso de OAuth2 sea específico para cada usuario que ejecuta la automatización.
            Nota: Esta opción requiere que el administrador de Control Room o cualquier usuario (con las opciones Administrar conexiones y Ver conexiones habilitadas para las CONEXIONES OAUTH) configure una conexión OAuth en Control Room. Asegúrese de no guardar las credenciales de inicio de sesión para que cada usuario que ejecute la automatización pueda proporcionar sus credenciales de inicio de sesión y generar un token de acceso que solo pueda usar ese usuario específico.
          • Haga clic en Confirm (Confirmar).
        Nota: Cuando utiliza la opción Específico del usuario, debe iniciar sesión en su cuenta de Google para autenticarse y generar un token específico del usuario. Realice los siguientes pasos para utilizar esta opción:
        1. En la Control Room, navegue hasta su perfil Mi configuración > Conexiones OAuth.
        2. Haga clic en Iniciar sesión para autenticarse.
        3. Inicie sesión en su cuenta de Google y seleccione Continuar.
        4. Verifique los servicios a los que tiene acceso y haga clic en Continuar.

          Si la conexión se realiza de manera correcta, mostrará el estado como Activo.

      Nota: El Correo electrónico en la carpeta no admite subcarpetas cuando configura el protocolo como POP3 para el Servidor de correo electrónico,
    Servidor EWS Haga clic en Servidor EWS.
    1. En el menú desplegable Versión de Microsoft Exchange, seleccione su versión actual.

      Por ejemplo, si está utilizando Microsoft Exchange Service Pack 2, seleccione Exchange2010_SP2 como su servicio de correo electrónico.

    2. Ingrese el nombre del dominio, por ejemplo: smtp.office365.com
    3. Seleccione uno de los siguientes métodos de autenticación de usuario para iniciar sesión en el servidor de correo electrónico:
      • Básica
      • OAuth 2.0: credenciales de cliente
        • Especifique los ID de cliente e inquilino únicos generados cuando registró la aplicación en el portal de Microsoft Azure.
        • Especifique el nombre de usuario que quiere utilizar para acceder al servidor de correo.
        • Especifique el secreto de cliente que generó para su aplicación en el portal de registro de aplicaciones.
          Para los campos ID de cliente, ID de inquilino, Nombre de usuario y Secreto del cliente, elija entre las pestañas Credencial o Cadena insegura:
          • Credencial: Utiliza un valor disponible en la Credential Vault.
          • Cadena insegura: De lo contrario, escriba un valor.
          Nota: No hay soporte de buzón compartido para Microsoft Outlook, pero como solución alternativa, puede usar el flujo de credenciales del servidor EWS con un correo electrónico compartido como cadena de nombre de usuario.
  8. Opcional: Utilice el menú desplegable Verificar cada disponible en todos los tipos de servidor para establecer el intervalo de activación.

    El intervalo de activación para el bot se establece en 120 segundos de manera predeterminada.

    Nota: El intervalo de activación que ha configurado mediante el menú desplegable Comprobar cada no depende de la cantidad de correos electrónicos recibidos durante el intervalo programado.

    Por ejemplo, si ha configurado Comprobar cada en 1 segundo, la tarea se activa solo una vez, incluso si recibe tres correos electrónicos diferentes al mismo tiempo. El filtro de tiempo de ejecución del sondeo se actualiza a la fecha y hora de envío del correo electrónico para el que se ejecutó el último activador.

  9. Opcional: Utilice Seleccionar condiciones para especificar un evento de correo electrónico para el tipo de servidor seleccionado.
    Considere una situación en la que seleccione Outlook y desee activar un bot cuando reciba un correo electrónico de un remitente específico. En Seleccionar condiciones, seleccione la casilla de verificación Correo electrónico de y especifique la dirección de correo electrónico del remitente.
    Cuando se selecciona la casilla de verificación El asunto del correo electrónico contiene, el activador de correo electrónico se ejecuta en función de las siguientes condiciones del asunto:
    • Cuando la línea de asunto se proporciona entre comillas dobles (""), por ejemplo "Hoja de cálculo ABC", el activador se ejecuta solo cuando el asunto del correo electrónico coincide exactamente con la cadena proporcionada entre comillas.
    • Cuando varias líneas de asunto están separadas por punto y coma, por ejemplo Hoja de cálculo ABC; Registros del proyecto ABC, el activador se ejecuta cuando el asunto del correo electrónico coincide con cualquiera de las líneas de asunto mencionadas.
  10. Opcional: Para crear una variable, en la pestaña Asignado a > Registro, haga clic en Seleccionar el ícono variable.

    Puede utilizar esta variable para recuperar varios detalles sobre el correo electrónico que activó el bot, como el remitente, el destinatario, el asunto, el contenido del correo electrónico, la fecha, la información de la acción, el host del servidor de correo electrónico y los datos del puerto.

  11. Haga clic en Aplicar.
  12. Haga clic en Run (Ejecutar) > Run with triggers (Ejecutar con activadores).
Microsoft Outlook, el servidor de correo electrónico o el servidor EWS se configuran como el activador para iniciar el bot para nuevos correos electrónicos.
Nota: Cuando se ejecuta un activador de correo electrónico, la clave emailTo devuelve una lista de direcciones de envío. Para convertir la lista de direcciones de envío en una cadena, utilice la acción Asignar del paquete Lista y, luego, utilice la acción Unir elementos del paquete Lista, con la coma como delimitador para separar las direcciones.