Conexión de correo electrónico
Introducción
Una conexión de correo electrónico, creada utilizando el conector de correo electrónico, establece acceso a un servidor de correo electrónico. Una vez que se configura una conexión, se pueden crear instancias de actividades de correo electrónico asociadas con esa conexión para ser utilizadas como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Importante
Usar el conector de correo electrónico con Microsoft 365 requiere que se cumplan requisitos adicionales. Consulta Requisitos de correo electrónico para una conexión OAuth 2.0 de Microsoft 365.
Para información adicional sobre la configuración de puntos finales de correo electrónico de Microsoft 365, consulta la documentación de Microsoft sobre Configuraciones de POP, IMAP y SMTP.
Crear o editar una conexión de correo electrónico
Se crea una nueva conexión de correo electrónico utilizando el conector de correo electrónico desde una de estas ubicaciones:
- La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La página de Puntos finales globales (consulta Crear un punto final global en Puntos finales globales).
Una conexión de correo electrónico existente se puede editar desde estas ubicaciones:
- La pestaña Puntos finales y conectores del proyecto en la paleta de componentes de diseño (consulta Paleta de componentes de diseño).
- La pestaña Componentes del panel del proyecto (consulta Menú de acciones de componentes en Pestaña de componentes del panel del proyecto).
- La página de Puntos finales globales (consulta Editar un punto final global en Puntos finales globales).
Configurar una conexión de correo electrónico
Cada elemento de la interfaz de usuario de la pantalla de configuración de la conexión de correo electrónico se describe a continuación.
Consejo
Los campos con un ícono de variable admiten el uso de variables globales, variables de proyecto y variables de Jitterbit. Comience escribiendo un corchete cuadrado abierto [ en el campo o haciendo clic en el ícono de variable para mostrar un menú con las variables existentes de las que puede elegir.
-
Nombre de la conexión: Ingrese un nombre para identificar la conexión. El nombre debe ser único para cada conexión de correo electrónico y no debe contener barras diagonales
/ni dos puntos:. Este nombre también se utiliza para identificar el punto final de correo electrónico, que se refiere tanto a una conexión específica como a sus actividades. -
Tipo de autenticación: Seleccione el método de autenticación, uno de Autenticación básica o OAuth2:
-
Autenticación básica: Autenticación de servidor SMTP e IMAP con combinaciones de nombre de usuario y contraseña.
-
OAuth2: Esta opción se ha confirmado que funciona con Microsoft 365 (consulte los requisitos previos). Se espera que otros servidores de correo electrónico funcionen, pero no han sido probados por Jitterbit. Cuando se selecciona, estos campos adicionales para configurar la autenticación OAuth 2.0 son visibles:
-
Host: Ingrese el host para la autenticación OAuth.
Consejo
Para la autenticación OAuth de Microsoft Entra ID, ingrese
https://login.microsoftonline.comcomo el host. -
ID de inquilino: Ingrese el ID de inquilino.
-
ID de cliente: Ingrese el ID de cliente.
-
Secreto de cliente: Ingrese el secreto de cliente.
-
Ámbito: Ingrese el ámbito.
-
Tipo de concesión: Seleccione Credenciales de cliente (predeterminado) o ROPC (Credenciales de contraseña de recurso propio) como el tipo de concesión para la autenticación OAuth. Si se selecciona ROPC (Credenciales de contraseña de recurso propio), puede especificar una Contraseña adicional.
Importante
Para enviar correos electrónicos a través de Microsoft 365 (
smtp.office365.com), debes seleccionar ROPC (Credenciales de Contraseña Propiedad del Recurso) para Tipo de Concesión. -
Contraseña: Ingresa una contraseña válida. Visible solo si el Tipo de Concesión está configurado como ROPC (Credenciales de Contraseña Propiedad del Recurso).
-
-
-
Actividad: Selecciona el tipo de actividad para asociar con esta conexión, uno de Ambos, Enviar Correo Electrónico o Leer Correo Electrónico:
-
Ambos: La conexión se asociará con las actividades de Enviar correo y Leer correo. Cuando se selecciona, se muestran todos los campos a continuación.
-
Enviar Correo Electrónico: La conexión se asociará solo con la actividad de Enviar correo. Cuando se selecciona, solo se muestran los campos que comienzan con SMTP.
-
Leer Correo Electrónico: La conexión se asociará solo con la actividad de Leer correo. Cuando se selecciona, solo se muestran los campos que comienzan con IMAP.
-
-
Host SMTP: Ingresa el nombre del host del servidor de correo electrónico SMTP. Este campo se muestra solo si la Actividad seleccionada es Ambos o Enviar Correo Electrónico.
-
Puerto SMTP: Ingresa el número de puerto del servidor de correo electrónico SMTP con el que conectarse. El puerto predeterminado es 25. Un valor en este campo es aplicable solo si el campo Seguridad SMTP a continuación está configurado como Ninguna o TLS. Si el campo Seguridad SMTP está configurado como SSL, entonces el puerto 465 se utiliza siempre, independientemente del valor ingresado en el campo Puerto SMTP. Este campo se muestra solo si el tipo de Actividad seleccionado arriba es Ambos o Enviar Correo Electrónico.
-
Seguridad SMTP: Cuando la Actividad está configurada como Ambos o Enviar Correo Electrónico, utiliza el menú para seleccionar una de estas opciones:
-
Ninguna: El servidor de correo electrónico no requiere autenticación.
-
SSL: El servidor de correo electrónico utiliza cifrado SSL para la autenticación.
-
TLS: El servidor de correo electrónico utiliza cifrado TLS para la autenticación.
-
-
Nombre de Usuario SMTP: Ingresa el nombre de usuario (si es requerido por el servidor de correo electrónico SMTP).
-
SMTP Password: Ingresa la contraseña (si es requerida por el servidor de correo SMTP). Visible solo cuando el Tipo de Autenticación está configurado como Autenticación Básica.
Nota
Al conectarse a Gmail, ingresa una contraseña de aplicación en lugar de la contraseña de la cuenta.
-
IMAP Host: Ingresa el nombre del host del servidor de correo IMAP con el que deseas conectarte. Este campo se muestra solo cuando la Actividad está configurada como Ambas o Leer Correo.
-
IMAP Port: Ingresa el número de puerto del servidor de correo IMAP con el que deseas conectarte. El puerto predeterminado es 993. Este campo se muestra solo cuando la Actividad está configurada como Ambas o Leer Correo.
-
IMAP Security: Cuando la Actividad está configurada como Ambas o Leer Correo, utiliza el menú para seleccionar una de estas opciones:
-
None: El servidor de correo no requiere autenticación.
-
SSL: El servidor de correo utiliza cifrado SSL para la autenticación.
-
TLS: El servidor de correo utiliza cifrado TLS para la autenticación.
-
-
IMAP Username: Ingresa el nombre de usuario (si es requerido por el servidor de correo IMAP).
-
IMAP Password: Ingresa la contraseña (si es requerida por el servidor de correo IMAP). Visible solo cuando el Tipo de Autenticación está configurado como Autenticación Básica.
Nota
Al conectarse a Gmail, ingresa una contraseña de aplicación en lugar de la contraseña de la cuenta.
-
Use Proxy Settings (Private Agent Only): Al utilizar un agente privado, se puede seleccionar esta configuración para usar configuraciones de proxy de agente privado. Esta opción es funcional solo cuando se utiliza OAuth 2.0 como el Tipo de Autenticación.
-
Test: Haz clic para verificar la conexión utilizando la configuración proporcionada. Cuando se prueba la conexión, la última versión del conector es descargada por el(los) agente(s) en el grupo de agentes asociado con el entorno actual. Este conector admite suspender la descarga de la última versión del conector utilizando la política de organización Deshabilitar Actualización Automática del Conector. Los campos de nombre de usuario y contraseña para un protocolo dado se utilizan para la verificación solo si ambos están presentes y el campo de seguridad está configurado como SSL o TLS.
-
Guardar cambios: Haga clic para guardar y cerrar la configuración de la conexión.
-
Descartar cambios: Después de realizar cambios en una configuración nueva o existente, haga clic para cerrar la configuración sin guardar. Un mensaje le pide que confirme que desea descartar los cambios.
-
Eliminar: Después de abrir una configuración de conexión existente, haga clic para eliminar permanentemente la conexión del proyecto y cerrar la configuración (consulte Dependencias de componentes, eliminación y remoción). Un mensaje le pide que confirme que desea eliminar la conexión.
Siguientes pasos
Después de que se ha creado una conexión de correo electrónico, se coloca un tipo de actividad en el lienzo de diseño para crear instancias de actividad que se utilizarán como fuentes (para proporcionar datos en una operación) o como destinos (para consumir datos en una operación).
Las acciones del menú para una conexión y sus tipos de actividad son accesibles desde el panel del proyecto y la paleta de componentes de diseño. Para más detalles, consulte Menús de acciones en Conceptos básicos del conector.
Estos tipos de actividad están disponibles:
-
Enviar correo electrónico: Envía correos electrónicos utilizando el Protocolo Simple de Transferencia de Correo (SMTP) a los destinatarios especificados y está destinado a ser utilizado como un destino en una operación.
-
Leer correo electrónico: Recupera correos electrónicos no leídos utilizando el Protocolo de Acceso a Mensajes de Internet (IMAP) y está destinado a ser utilizado como una fuente para proporcionar datos a una operación.