Usar la acción Conectar en el Correo electrónico de paquete

Use la acción Conectar en el paquete de Correo electrónico para establecer una conexión con un servidor de correo electrónico. Esta es la primera acción que utilizará para automatizar una tarea relacionada con el correo electrónico.

Antes de empezar

Puede utilizar OAuth 2.0 a fin de autenticarse con el servidor para la automatización de correo electrónico. En función de su proveedor de servicios de correo electrónico, realice los pasos pertinentes:
  • Outlook/Office 365
    • Si utiliza el modo de autenticación Flujo de credenciales de cliente, realice los pasos siguientes:
      1. Inicie sesión en Microsoft Azure portal.
      2. Registre su aplicación con la plataforma de identidad de Microsoft para obtener la identificación del cliente y el ID de inquilino. Consulte Register an application.
      3. Agregue un secreto del cliente.

        Consulte Add a client secret

      4. En función del servidor de correo al que se conecte, realice los pasos pertinentes:
    • Si utiliza el modo de autenticación Código de autorización con PKCE, realice los siguientes pasos:
      1. Inicie sesión en Microsoft Azure portal.
      2. Registre su aplicación con la plataforma de identidad de Microsoft para obtener la identificación del cliente y el ID de inquilino. Consulte Register an application.
      3. Al registrar la aplicación, configure el URI de redireccionamiento para la aplicación: http://localhost:9999/callback.
      4. Añada permisos con tipo delegado para IMAP, POP3 y SMTP y conceda a la aplicación el permiso requerido para Microsoft Graph.
    • Si utiliza el modo de autenticación administrado por la Control Room, consulte Configure Control Room managed OAuth for Outlook/Office365 (A-people login required).

    Los videos de la siguiente lista de reproducción brindan información sobre cómo configurar y usar la autenticación OAuth 2.0 en la Correo electrónico conectar de acción:

    Nota: Si el buzón de correo se utiliza dentro de una acción Bucle, asegúrese de registrar al usuario al que se le asigna la automatización. Para obtener más información, consulte Manage users and groups assignment to an application.
  • Gmail
    • Si utiliza el modo de autenticación Código de autorización con PKCE, realice los siguientes pasos:
      1. Configure los ajustes de OAuth 2.0 en Plataforma de nube de Google (GCP) y recupere las credenciales necesarias para conectar Automation 360 con sus aplicaciones de Google Workspace.
      2. Asegúrese de crear un proyecto.

        Consulte crear un proyecto.

      3. Genere el ID de cliente y el secreto de cliente.
        Consulte Configurar OAuth 2.0.
        Nota:
        • Seleccione la opción Aplicación web.
        • Agregue esta URI de redireccionamiento autorizada: http://localhost:8888/Callback.
      4. Complete estos pasos para configurar el consentimiento del usuario para el nombre de usuario que utilizará para conectarse a Automation 360.
    • Si utiliza el modo de autenticación administrado por Control Room, realice los siguientes pasos:
      Importante: El Correo electrónico de paquete actualmente admite la opción Oauth administrada por Control Room para las conexiones OAuth basadas únicamente en el flujo de código de autorización.
      1. Configure los ajustes de OAuth 2.0 en Plataforma de nube de Google (GCP) y recupere las credenciales necesarias para conectar Automation 360 con sus aplicaciones de Google Workspace.
      2. Asegúrese de crear un proyecto.

        Consulte crear un proyecto.

      3. Genere el ID de cliente y el secreto de cliente.
        Consulte Configurar OAuth 2.0.
        Nota:
        • Seleccione la opción Aplicación web.
        • Para agregar la URI de redireccionamiento autorizada, realice los siguientes pasos:
          1. Inicie sesión en la Control Room como administrador o cualquier usuario con permisos de Administrar conexiones y Ver conexiones, y navegue hasta Administrar > Conexiones OAuth.
          2. Haga clic en la pestaña Crear conexión y seleccione la opción Personalizado en el campo Tipo de proveedor.
          3. Copie la URL de devolución de llamada y regrese a la página de la aplicación de cliente en la consola de Google Cloud.
          4. Haga clic en el botón + AGREGAR URI en URI de redireccionamiento autorizado y pegue el URI en el campo URI.
          5. Haga clic en Crear.

          Para aprender cómo crear una conexión OAuth en Control Room, consulte Crear conexiones ‌OAuth.

      4. Complete estos pasos para configurar el consentimiento del usuario para el nombre de usuario que utilizará para conectarse a Automation 360.
Nota:
  • El flujo de Credenciales del cliente no es compatible con Gmail.
  • El código de credenciales de cliente y autorización con los modos de autenticación PKCE no son compatibles con los servidores de correo Yahoo y MSN.
Recomendado: Si desea utilizar ambos modos de autenticación (Credenciales de cliente y Código de autorización con PKCE), debe registrarse en dos aplicaciones distintas.
Nota: Cuando se conecta a un servidor de Exchange Web Services, la autenticación multifactor (MFA) debe estar desactivada, incluidas todas las políticas de seguridad de nivel organizativo en las que la autenticación multifactor podría estar habilitada. Si la autenticación multifactor (MFA) no se inhabilita por completo, los usuarios podrían encontrar errores de conexión o autorización. Sin embargo, si aún desea utilizar MFA, revise la información en este artículo, tenga en cuenta que no se garantiza una conexión exitosa:

Multi-factor authentication for Azure EWS (A-people login required)

Esta acción le permite proporcionar las credenciales y los detalles del servidor de correo electrónico, y asociar esta información con un nombre de sesión. Utilice este mismo nombre de sesión para las otras Correo electrónico acciones, de modo que solo tenga que proporcionar la información del servidor una vez.

Procedimiento

Siga estos pasos para establecer una conexión con un servidor de correo electrónico:

  1. En la paleta de Acciones , haga doble clic o arrastre la acción Conectar del paquete de Correo electrónico .
  2. Especifique el nombre de la sesión.
  3. Seleccione Outlook, Servidor de correo electrónico o EWS para especificar si desea establecer una conexión con Microsoft Outlook o con un servidor de correo.
    Nota:
    • Cuando se conecta con el servidor EWS y utiliza la acción Bucle para recuperar todos los correos electrónicos del servidor de correo electrónico, y si el asunto del correo electrónico contiene los siguientes caracteres, el bot no se ejecuta y muestra un mensaje de error.
      • Caracteres de control
        • Rango: 0x00 - 0x08 (excepto 0x09 - Horizontal Tab) y 0x0B - 0x0C (excepto 0x0A - Line Feed y 0x0D - Carriage Return)
        • Valores hexadecimales: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • Pares de sustitutos altos y bajos
        • Rango: 0xD800 - 0xDFFF
        • Valores hexadecimales: 0xD800 - 0xDFFF
      • Puntos de código sin caracteres
        • Rango: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
        • Valores hexadecimales: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
      • Rangos restringidos
        • Rango: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
        • Valores hexadecimales: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

          Solución: Para realizar esta operación, puede utilizar Microsoft Outlook o un servidor de correo electrónico. Sin embargo, recomendamos que utilice el paquete de Microsoft 365 Outlook, ya que Microsoft anunció el fin de las API de EWS que se usan para conectarse a Exchange Online. Consulte Obsolescencia de las API de EWS en Exchange Online.

    • Cuando se establece una conexión con Microsoft Outlook, los mensajes de correo electrónico se procesan desde el buzón compartido. Asegúrese de haber configurado el buzón de correo compartido en su aplicación Outlook.
      • Esta función solo es compatible con Outlook.
      • Solo se puede seleccionar un buzón de la lista de buzones en el buzón compartido.
      • La invitación a la reunión no se lee en Outlook porque el bot no selecciona las invitaciones de calendario como objetos de correo electrónico. Esta función no es compatible actualmente.
    • Si seleccionó la opción Outlook, no es necesario proporcionar ningún detalle adicional.

      Puede usar la opción de variable para especificar la dirección de correo electrónico a la que desea conectarse.

      Nota: No se puede establecer una conexión con el nuevo cliente de Outlook. Sin embargo, puede cambiar al cliente clásico de Outlook para automatizar una tarea relacionada con el correo electrónico.
    • Si seleccionó la opción Servidor de correo electrónico, complete los siguientes campos:
      Nota: Para obtener información sobre el host y el puerto que se utilizan para los distintos servidores de correo, consulte Configuraciones del servidor de correo electrónico.
      • Usar conexión segura (SSL/TLS): Seleccione esta opción si desea utilizar una conexión segura con el servidor de correo.
      • Host: Escribir el nombre del servidor del correo.
        Nota: Este campo no distingue mayúsculas de minúsculas.
      • Puerto: Ingresar el número de puerto para el servidor.
      • Protocolo: Seleccionar el protocolo IMAP o POP3.
        Nota: Las expresiones regulares son compatibles con el protocolo IMAP y leen los correos electrónicos de todas las subcarpetas de la bandeja de entrada.
      • Modo de autenticación: Elija entre los siguientes modos de autenticación:
        • Básico: Utiliza el nombre de usuario y la contraseña.
        • OAuth2 - Código de autorización con PKCE: Consulte Microsoft identity platform and OAuth 2.0 authorization code flow

          Para obtener más información sobre cómo configurar una aplicación en Azure para usar el código de autorización OAuth con el flujo PKCE para el servidor de correo, consulte How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • OAuth2 - Credenciales de cliente: Consulte Microsoft identity platform and the OAuth 2.0 client credentials flow

          Para obtener más información sobre cómo configurar una aplicación en Azure para usar el flujo de credenciales de cliente OAuth 2.0 para el servidor de correo IMAP/POP3, consulte How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • Control Room administrada
          Para usar el modo de autenticación OAuth2 administrado por la Control Room a fin de automatizar Gmail, debe configurar la conexión OAuth en la Control Room. Consulte Crear conexiones ‌OAuth.
          Nota: La Control Room OAuth Managed solo es compatible con Gmail y no con el cliente de Outlook.

          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.

        Dependiendo del modo de autenticación que haya seleccionado, debe especificar los detalles en los siguientes campos según corresponda.
        • Nombre de usuario: Escriba el nombre de usuario que quiere utilizar para acceder al servidor de correo.

          Por ejemplo, john.smith@myCompanyName.com

        • Contraseña: Ingrese la contraseña correspondiente al nombre de usuario que proporcionó.
        • Para las opciones ID de cliente, ID de inquilino, Redirigir URI y Secreto del cliente, utilice la información que se proporciona para su cuenta en su Azure portal.
        • Proveedor de correo electrónico: Seleccione el proveedor de correo electrónico de la lista desplegable.
          • Outlook/Office365

            Si selecciona esta opción, proporcione el ID de arrendatario.

          • Gmail
        Para los campos Nombre de usuario, Contraseña, ID de inquilino, ID de cliente y Secreto del cliente, elija entre Credencial, Variable o String insegura:
        • Credencial: Utiliza un valor disponible en la Credential Vault.
        • Variable: Utilice una variable definida por el usuario que almacene los valores.
        • String insegura: De lo contrario, escriba un valor.
    • Si seleccionó la opción EWS, complete los siguientes campos:
      • Versión de Exchange: Seleccione la versión que utiliza su organización:
        • Servidor de Exchange 2013
        • Exchange2010_SP2
        • Exchange2010_SP1
        • Exchange2010
        • Exchange2007_SP1
      • Nube de Azure: Seleccione el producto que utiliza su organización:
        • Azure Global: Para clientes de la versión comercial de Microsoft 365 (login.microsoftonline.com)
        • Azure US GCC High: Para los clientes de la versión gubernamental de Microsoft 365 (login.microsoftonline.us)
      • Opcional: Domain name (Nombre del dominio):
        • Si usted es cliente de Microsoft 365 y deja este campo en blanco, Automation Workspace utilizará smtp.office365.com para conectarse al servidor.
        • Si usted es cliente de Office 365 y ha ingresado un nombre de dominio en el campo nombre de usuario, debe ingresar smtp.office365.com en este campo.
        • Si usted no es cliente de Office 365, ingrese el nombre de dominio de su organización. De lo contrario, Automation Workspace utiliza el nombre de dominio que proporcionó en el campo Nombre de usuario.
      • Modo de autenticación: Elija entre los siguientes modos de autenticación:
        Nota: A partir de Automation 360 v.27, el tipo de autorización OAuth2-Silent authentication mode pasa a llamarse OAuth2-ROPC, y el OAuth2-Interactive authentication mode pasa a llamarse OAuth2-Implicit.

        Si tiene problemas para conectarse a un buzón compartido mediante EWS, consulte Unable to connect to shared mailbox using EWS error (A-People login required).

        Dependiendo del modo de autenticación que haya seleccionado, debe especificar los detalles en los siguientes campos según corresponda.
        • Nombre de usuario: Escriba el nombre de usuario que quiere utilizar para acceder al servidor de correo.

          Por ejemplo, john.smith@myCompanyName.com

        • Contraseña: Ingrese la contraseña correspondiente al nombre de usuario que proporcionó.
        • Para las opciones ID de cliente, ID de inquilino, Redirigir URI y Secreto del cliente, utilice la información que se proporciona para su cuenta en su Azure portal.
        • Probar conexión: Haga clic en Probar conexión para iniciar sesión en su cuenta, aceptar los permisos solicitados para autenticarse y establecer una conexión con el servidor.
          Nota:
          • Cuando realiza una operación de escritorio y hace clic en Probar conexión, actualmente no se admiten variables como credencial, variable de credencial o variables de cadena.
          • Cuando realice la operación de escritorio y haga clic en Probar conexión para iniciar sesión en su cuenta, añada este URI de redirección: https://outlook.office365.com
        Para los campos Nombre de usuario, Contraseña, ID de inquilino, ID de cliente y Secreto del cliente, elija entre Credencial, Variable o String insegura:
        • Credencial: Utiliza un valor disponible en la Credential Vault.
        • Variable: Utilice una variable definida por el usuario que almacene los valores.
        • String insegura: De lo contrario, escriba un valor.
  4. Haga clic en Guardar.