Para configurar la conexión de tu cuenta de correo de Microsoft con Athento, será necesaria información y configuración por parte de los administradores de la cuenta. En este artículo detallamos todo lo necesario.

IMPORTANTE: Athento no da soporte de Azure, si tiene algún problema con la configuración en Azure, consulte con su proveedor.

Configuración necesaria para la integración

1. Acceso a la configuración del registro de la aplicación que servirá de Integración Office365 para la conexión y descarga de correo electrónico.

Para ello, accedemos a la zona del Directorio Activo de Azure (Azure Active Directory - AAD) y dentro a la zona de Registro de Aplicaciones donde incluiremos la nueva aplicación.

2. Registrar la nueva aplicación.

En esta parte, tenemos que incluir el nombre de la aplicación por ejemplo "Athento - Office365", y dejamos la opción por defecto seleccionada en el tipo de cuenta:

• Accounts in this organizational directory only (Directorio predeterminado only - Single tenant)
   

3. Configurar la aplicación

Cuando la aplicación se encuentra registrada hay que añadir la siguiente información:

3.1. Añadir credenciales

Para añadir credenciales a la aplicación, accedemos a ella en el listado de nuestro "Registro de aplicaciones" (donde ya debe aparecer la recién creada en el paso 2.). Cuando estemos en el panel de la aplicación accedemos al menú "Certificados y secretos" y creamos un nuevo secreto.

De esta zona demos quedarnos con el valor del secreto y para ello copiamos el "Value" del secreto generado.

3.2. Configuración de permisos "delegados"

Se deben añadir los siguientes permisos a  la app de Athento  en "API Permissions" en el registro de aplicaciones. Cualquier otro permiso debe eliminarse.

4. Configuración de sincronización IMAP de la cuenta en Outlook.

En la configuración de Outlook (rueda dentada de arriba a la derecha), selecciona abajo "Ver toda la configuración de Outlook" y en el menú Correo haz click en "Sincronizar correo electrónico". Aquí debes activar las opciones que se muestran en la captura de pantalla y que permiten la comunicación.

5. Configurar en Athento información de la aplicación para integración

Para que desde Athento se pueda establecer la conexión con Office365, es necesario contar con siguientes campos:

De la aplicación registrada:

• Application (cliente) ID.
• Directory (tenant) ID.
• Secret (tal y como se indicaba en el punto 3.1.)

De la cuenta de Office365:

• Email user
• Email password

Desde la configuración avanzada en Athento añadir un nuevo Ews mailbox connections en servers/ewsmailboxconnection/

Athento te pedirá la información



Nota: para la Serie y Mailbox es el name del espacio donde fue configurado el buzón Información necesaria para configurar la obtención de documentos desde un buzón de correo – Athento

Por último se debe programar el comando load_mails_ews --serie=NOMBRE_ESPACIO para finalizar la configuración 
¿Cómo programar tareas automáticas? – Athento

Problemas conocidos

InvalidGrantError. The user account {invalid_grant}. The user account does not exist in the XXX directory.

Posible solución: Revise que la cuenta exite o añádala al directorio.

InvalidGrantError. Access has been blocked by Conditional Access policies. The access policy does not allow token issuance.

Posible solución: Revise si tiene restricción de acceso por IP y si la IP de Athento ha sido añadida a su whitelist.

IMPORTANTE: Athento no da soporte de Azure, si tiene algún problema con la configuración en Azure, consulte con su proveedor.