Intégration à Exchange

Remarque : vous serez facturé 1 AI Unit ou 0,2 Platform Units par commentaire créé ou par commentaire mis à jour, en fonction de l'ID de message de l'e-mail, si son texte a été modifié.

Vue d'ensemble (Overview)

L’intégration Exchange constitue un moyen pratique et facile à configurer de synchroniser en temps réel vos données d’e-mails de développement et de production dans Communications Mining™.

L'intégration Exchange interroge en continu votre serveur Exchange pour détecter les nouveaux e-mails dans les boîtes aux lettres configurées. Les e-mails sont nettoyés, enrichis et convertis en objets de commentaires Communications Mining. Ils sont accessibles aux utilisateurs sur la plate-forme Web Communications Mining, ainsi qu'aux applications ou bots via l'API Communications Mining. L'intégration Exchange s'exécute dans le cloud Communications Mining.

Les boîtes aux lettres à interroger peuvent être facilement configurées dans l'interface utilisateur de Communications Mining, qui offre également la possibilité de démarrer ou d'arrêter l'intégration, et de mettre à jour les paramètres de configuration utilisés pour se connecter à votre serveur Exchange.

Remarque :

• L'intégration Exchange est compatible avec Exchange Online et avec le serveur Microsoft Exchange 2010-2019 utilisant les services Web Exchange (EDS).
• L'intégration Exchange interroge le serveur Exchange en effectuant des requêtes GET authentifiées sur HTTPS. L'intégration Exchange reçoit des données via les requêtes GET qu'elle initie, et n'accepte aucune connexion entrante initiée ailleurs. L'intégration Exchange peut être configurée avec des chiffrements spécifiques.
• Il suffit de donner à l’intégration Exchange un accès en lecture seule à vos boîtes aux lettres.

Comment les e-mails sont synchronisés

L'intégration synchronisera en continu les e-mails de chaque boîte aux lettres configurée. Si aucune heure de début n'est fournie, tous les e-mails seront synchronisés.

L'intégration définira le message_id du commentaire sur le comment ID encodé hexadécimal de l'e-mail synchronisé. Si plusieurs boîtes aux lettres contenant le même e-mail, par exemple, en raison de leur ajout au champ Cc du même e-mail, sont synchronisées dans le même compartiment, le commentaire résultant contiendra les métadonnées du dernier e-mail synchronisé des e-mails en double.

L'intégration mettra à jour la propriété utilisateur du Dossier d'un commentaire lorsque l'e-mail correspondant est déplacé vers un autre dossier. L'intégration ne mettra pas à jour l'objet ou le corps du commentaire s'il est mis à jour dans l'e-mail après son envoi ou sa réception.

Vous pouvez également activer la synchronisation des pièces jointes au niveau de la boîte aux lettres sur une intégration Exchange. L'API des flux rend ensuite les pièces jointes récupérables via une référence de pièce jointe. Pour en savoir plus sur la synchronisation des pièces jointes, consultez les pages Pièces jointes ( Attachments ) et Utilisation des intégrations d'Exchange (Using Exchange Integrations) .

L'image suivante contient un exemple de configuration de boîte aux lettres avec les valeurs suivantes :

• Compartiment: Boîte aux lettres (org2/example-2b2f8982)
• Règles de filtrage de contenu:
  • Dossiers explicitement autorisés : racine/Haut du Magasin d’informations/Boîte de réception
  • Dossiers explicitement refusés : aucun
  • À partir du 1er février 2023 12 h 00 UTC

Erreurs d'intégration

Les intégrations renvoyant à des problèmes persistants seront automatiquement désactivées au niveau de l'intégration si l'intégration est mal configurée, ou au niveau de la boîte aux lettres, si la boîte aux lettres est mal configurée.

Vous serez informé afin de résoudre un ou plusieurs problèmes. Une fois résolu, vous pourrez réactiver l'intégration.

Cela se produit lorsque la boîte aux lettres est introuvable, dans le cas où elle a été supprimée, que le compte de service n'a pas accès à la Boîte de réception ou que les informations d'identification ont expiré et doivent être mises à jour.

Voici quelques exemples d'erreurs qui désactivent l'intégration :

• Identifiants incorrects
• Identifiants expirés
• Atteindre une limite de quota pour le téléchargement de données
• Erreur de configuration des détails du serveur Exchange

Voici quelques exemples d'erreurs qui désactivent une boîte aux lettres :

• Autorisations non valides pour l'authentification du compte de service ou de l'application
• Adresse de la boîte aux lettres mal orthographiée
• Boîte aux lettres supprimée

Remarque : vous serez automatiquement abonné aux notifications si vous disposez de l'autorisation Afficher les intégrations , mais vous pouvez également vous abonner ou vous désabonner via le service de notification. Pour mettre à jour les configurations d'intégration, l'autorisation Modifier les intégrations est requise.

Configuration

Échanger en ligne

Veuillez suivre l'un des guides étape par étape :

• Intégration avec l'authentification d'application Azure
• Intégration avec l'utilisateur du service Azure

Serveur Exchange auto-hébergé

Veuillez configurer un compte de service NTLM et accorder à l’utilisateur du service un accès en lecture aux boîtes aux lettres que vous souhaitez synchroniser.

Collectez les détails suivants :

• URL du serveur Exchange
• Nom d'utilisateur et mot de passe de l'utilisateur du service
• Type d'accès (délégué ou emprunt d'identité)
• La liste des boîtes aux lettres à synchroniser.

Configurez l'intégration Exchange comme décrit dans la partie « Créer une nouvelle intégration dans Communications Mining™ » du tutoriel, en choisissant l'option NTLM et en saisissant les informations collectées : URL du serveur Exchange, nom d'utilisateur et mot de passe de l'utilisateur du service, type d'accès, liste de boîtes aux lettres à synchroniser.

Attention : Si vous sélectionnez Tout le temps (All time) dans la section Filtres de temps (Time filters) , cela peut entraîner la synchronisation de plus de données que prévu, et les messages sont facturés lors du téléchargement.