Agility Solution / Agility Studio / Funcionalidades Agility Studio / 23. Email / 23.01 Connect Mail
Actualizado: 01. October 2024

23.01 Connect Mail

Función que permite realizar la conexión a un servidor de correo por el protocolo POP , IMAP o MicrosoftOAuth2.

ConnectMail1.png

ConnectSettings4.2.png

Parámetros de configuración.

Imagen Descripción Obligatorio
Time Wait.png Tiempo de espera para ejecutar la función. Opcional
pop.png Especifica que tipo de protocolo se va usar , true si es Pop, false si es Imap y MicrosoftOAuth2 si no una cuenta Office365 y GmailOAuth2 para Gmail con este protocolo. Si
ServerName.png Nombre o IP del servidor de correo Pop. Si
Port.png Puerto usado por el servidor POP Si
SmtpServerNAme.png Nombre usuario del servidor de correo SMTP. Si
PortSmtp.png Puerto usado por el servidor SMTP. si
userName.png Nombre de cuenta a buzon a monitorear. Si
Password.png Contraseña del servidor de correo. Cuentas Gmail por IMAP requieren password de aplicacion. Si, solo para IMAP Y POP
ClientId.png Solo aplica para protocolo MicrosoftOAuth2, Id de la aplicación creada en el servicio en portal.Azure.com. Si
tenantId.png Solo aplica para protocolo MicrosoftOAuth2, Id del directorio al crear el servicio en portal.Azure.com. Si
GmailClientId4.2.png Solo aplica para protocolo GmailOAuth2, Dato obtenido en la credenciales creadas en Google Cloud Platfom. Si
GmailClientSecret4.2.png Solo aplica para protocolo GmailOAuth2, Dato obtenido en la credenciales creadas en Google Cloud Platfom. Si
Security.png Tipo de seguridad usado por el protocolo.Opciones SSL y STARTSSL Si

NOTAS

  • Para utilizar esta funcionalidad se debe configurar el correo, habilitar descarga de correo POP y el acceso IMAP
    Ejemplo
    Configuracion1.png
    Configuracion.png

Protocolos POP e IMAP más usados

  • Gmail protocolo POP
    Pop: true
    Server: pop.gmail.com
    Port: 995
    SMTP Server Smtp: smtp.gmail.com
    Smtp port: 465
    Security: SSL
    Se debe usar una contraseña de aplicacion, se crea en la configuración del Gmail.

  • Gmail protocolo IMAP
    Pop: false
    server: imap.gmail.com
    port: 993
    Server Smtp: smtp.gmail.com
    smtp port: 465
    Security: SSL
    Se debe usar una contraseña de aplicacion, se crea en la configuración del Gmail.

  • Hotmail protocolo POP
    Pop: true
    Server: outlook.office365.com
    Port: 995
    Server Smtp: smtp.office365.com
    smtp port: 587
    Security: {EMPTY}

  • Hotmail protocolo IMAP
    Pop: false
    server: outlook.office365.com
    port: 993
    server Smtp: smtp.office365.com
    smtp port: 587
    Security: {EMPTY}

  • Yahoo protocolo POP
    server: pop.mail.yahoo.com
    port: 995
    server smtp.mail.yahoo.com
    smtp port: 465
    POP: true

  • Yahoo protocolo IMAP
    Pop: false
    server: imap.mail.yahoo.com
    port: 993
    server Smtp: smtp.mail.yahoo.com
    smtp port: 465
    POP: vacío

  • Outlook protocolo POP
    server: outlook.office365.com
    port: 993
    server smtp: smtp.office365.com
    smtp port: 587
    POP: true

  • Outlook protocolo IMAP
    Pop: false
    server: outlook.office365.com
    port: 993
    server Smtp: smtp-mail.outlook.com
    smtp port: 587
    POP: vacío

Conexión por MicrosoftOAuth2. Cuentas Office365

Pop: Se debe diligenciar con: MicrosoftOAuth2 .
Server name: Se llenara de manera automatica con outlook.office365.com
Port : Se llenara de manera automatica con 993
SMTP: Se llenara de manera automatica con smtp.office365.com
Port SMTP: Se llenara de manera automatica con 587
User name: Ingresar cuenta de correo electronico de office365 a monitorear que use este protocolo.
Client Id: Id de la aplicacion creada en el servicio en portal.Azure.com.
Tenanr Id: Id del directorio al crear el servicio en portal.Azure.com.
Security: Seleccionar SSL

La primera vez que se realice la conexión se deberá hacer una confirmacion con una logeo manual, se mostrará la siguiente pantalla donde se debe ingresar el correo y la respectiva contraseña.
Agility Studio almacenará un token y ya no será necesario volver a repetir este proceso.

2023-05-09_10h38_45.png

Conexión cuentas Gmail usando autenticación OAuth2.

  • Server: imap.gmail.com, Port: 993, Server smtp: smtp.gmail.com, Smtp Port: 587, Security: SSL.

  • Activar Gmail Api en Google Cloud Platform.

GmailAPI.png

  • Crear credenciales tipo OAuth2 para obtemer Client Id y Client Secret en Google Cloud Platform.

CredencialesOAuth2.png

Propiedades de salida o retorno.

PropieSSHClose.png

Esta función retorna True o False si la conexión fue exitosa.

En el siguiente link encontraran un ejemplo de cómo se aplica este process Step Aquí.