Intégration des services de messagerie Microsoft 365 dans ioi

Introduction #

Ce tutoriel détaille comment configurer l’intégration entre les services de messagerie Microsoft 365 (Outlook) et le système de messagerie Frappe.

L’authentification est gérée via le standard OAuth 2.0.

Prérequis #

1. Version de Frappe : Assurez-vous que votre instance Frappe est mise à jour à la version 15 au minimum.
2. Accès à un site HTTPS : Vous devez avoir accès à un site Silicon ioi utilisant le protocole HTTPS.
3. Compte Administrateur Global Microsoft 365 : Un compte Microsoft 365 avec des privilèges d’administrateur global est requis.

Compatibilité #

Cette méthodologie a été testée et validée avec la version 15 de Frappe en date du 30 août 2024.

Guide étape par étape #

Suivez les étapes détaillées sur le forum Frappe via ce lien ou référez-vous aux instructions.

→ Consultez également les points de configuration supplémentaires décrits dans la section Configurations Additionnelles.

Portail d’administration Azure #

Dans Azure AD, créez un enregistrement d’application et configurez les permissions, secrets, etc.

Enregistrement de l’application #

1. Accédez au portail d’administration Azure.

   

2. Enregistrements d’applications.

1. Créez un nouvel enregistrement.

1. Permissions.

Mode SMTP Standard : Ajoutez les permissions à l’application.

Mode MS Graph :

1. Entrez l’ID client de l’application dans Silicon ioi.

1. Créez vos clés d’authentification (secrets).

1. Obtenez l’URL de configuration OpenID, qui sera nécessaire dans les étapes suivantes.

Dans Silicon ioi #

1. Créez une application connectée.
2. Copiez la valeur de configuration OpenID obtenue plus tôt (.7) et utilisez le bouton Fetch OpenID Configuration pour récupérer les URLs des points d’accès. Ensuite, renseignez l’ID client (.5) et la valeur du secret (.6).

1. Scopes de l’application connectée.

Mode SMTP / IMAP : Ajoutez les scopes suivants :

• https://outlook.office365.com/.default
• offline_access

Mode MS Graph : Ajoutez les scopes suivants :

• https://graph.microsoft.com/.default
• offline_access

1. URI de redirection

1. Utilisez la valeur de l’URI de redirection (.4) et retournez à l’enregistrement de l’application M365 pour ajouter cette URL sous authentification.

1. Connexion de l’application dans Silicon ioi :

→ Merci de bien vérifier que vous êtes dans une fenêtre privée avant de continuer.

→ Dans la nouvelle application connectée, cliquez sur Connect to XXXX.

1. Créez un compte email et attribuez le à “l’utilisateur final”.

Créez le compte avec les informations suivantes :

Mode SMTP-IMAP :

Créez un domaine de messagerie, puis configurez le compte email.

Configuration du compte de messagerie

(Mode SMTP – IMAP)

(Mode MS Graph)

Créez le compte uniquement avec ces informations.

Mode MS Graph :

Le mode MS Graph a été intégré dans le module standard de messagerie de Frappe, permettant l’envoi et la réception des emails.

Pour la réception des emails, les modes “ALL” et “UNSEEN” sont pris en charge :

ALL → Importe tous les emails (jusqu’à la limite du nombre d’e-mails initialement synchronisés).

Une nouvelle entrée est créée pour chaque compte dans le doctype ioi Email Pull Request, avec la dernière date de synchronisation (correspondant à la date du dernier email reçu).

UNSEEN → Importe uniquement les emails non lus, en les marquant comme lus une fois importés. Si un email est à nouveau marqué comme non lu, il sera réimporté.

Chaque email reçu génère un document dans le doctype “Communication”.

Configurations Additionnelles #

Ajout d’une API autorisée : SMTP.SendAsApp #

1. Accédez à Azure Active Directory.
2. Ajoutez une nouvelle autorisation.
3. Sélectionnez API utilisées par mon organisation.
4. Recherchez “Office 365 Exchange Online”.
5. Sélectionnez Application Permission.
6. Choisissez la permission SMTP.SendAsApp.

Désactivation du protocole “Turn off AUTH SMTP” #

→ Dans Microsoft 365 : https://admin.exchange.microsoft.com/#/settings

→ Dans Frappe :

Gestion des erreurs #

Si vous rencontrez une erreur 500 lors de la connexion à https://outlook.office365.com, suivez ces étapes :

Ou suivez ces étapes :

1. Accédez à Azure Active Directory.
2. Sélectionnez l’utilisateur administrateur de votre application.
3. Ne conservez que le rôle “Administrateur Global”.
4. Actualisez la page https://outlook.office365.com.

Configuration Multi-Adresses #

Vous pouvez lier plusieurs adresses email à un utilisateur unique. Toutefois, une seule instance de connexion Microsoft 365 est autorisée par session utilisateur.

Pièces jointes #

Les pièces jointes sont prises en charge pour l’envoi et la réception des emails. Il est possible de définir une taille maximale acceptable pour les pièces jointes reçues.