Automatiser la création, l’envoi et le traitement des messages

  • Article

Les e-mails sont représentées par la ressource message dans Microsoft Graph.

Par défaut, les messages portent un ID d’entrée unique spécifié dans la propriété id. Lorsqu’un message est crée initialement et sauvegardé comme brouillon ou envoyé, le fournisseur store affecte un ID d’entrée. Par défaut, cet ID change lorsque le message est copié ou déplacé vers un autre dossier, store ou fichier PST. Vous faites référence au message par son ID actuel pour un traitement approfondi.

Créer et envoyer du courrier

Dans Outlook, vous pouvez créer et envoyer un e-mail dans la même action sendMail, ou vous pouvez créer un brouillon, puis ajouter du contenu et envoyer le brouillon.

De même, lorsque vous répondez à un e-mail, vous pouvez créer et envoyer la réponse dans la même action (reply, reply-all ou forward). Ou bien, vous pouvez créer un brouillon pour la réponse ((reply, reply-all ou forward), ajouter du contenu, puis envoyer le brouillon ultérieurement.

Pour faire la distinction entre un brouillon et un message envoyé par programme, voir la propriété isDraft.

Par défaut, les messages brouillons sont enregistrés dans le dossier Drafts, les messages envoyés sont enregistrés dans le dossier Sent Items. Pour plus de commodité, vous pouvez identifier le dossier Brouillons et le dossier Éléments envoyés par leur nom de dossier connu correspondant.

Définir les propriétés de et d’expéditeur

Lorsqu’un message est rédigé, dans la plupart des cas, Outlook définit les propriétés de et expéditeur sur le même utilisateur connecté. Vous pouvez mettre à jour ces propriétés dans les scénarios suivants :

  • La propriété from peut être modifiée si l’administrateur Exchange a attribué des droits sendAs de la boîte aux lettres à d’autres utilisateurs. L’administrateur peut le faire en sélectionnant Autorisations de boîte aux lettres du propriétaire de la boîte aux lettres dans le Portail Azure, ou en utilisant le Centre Administration Exchange ou une applet de commande Windows PowerShell Add-ADPermission. Ensuite, vous pouvez définir par programmation la propriété from sur l’un de ces utilisateurs qui disposent des droits sendAs pour cette boîte aux lettres.
  • La propriété sender peut être modifiée si le propriétaire de la boîte aux lettres a autorisé un ou plusieurs utilisateurs à envoyer des messages à partir de cette boîte aux lettres. Le propriétaire de la boîte aux lettres peut octroyer ces droits dans Outlook. Lorsqu’un délégué envoie un message au nom du propriétaire de la boîte aux lettres, Outlook définit la propriété sender sur le compte du délégué, tandis que la propriété from reste le propriétaire de la boîte aux lettres. Vous pouvez définir la propriété sender via un programme pour un utilisateur qui possède des autorisations de délégué pour cette boîte aux lettres.

Utilisez les infos-courrier pour vérifier le statut du destinataire et gagner du temps (préversion)

Utilisez MailTips pour prendre des décisions intelligentes avant d’envoyer un e-mail. MailTips peut fournir des informations telles que: la boîte aux lettres électronique du destinataire est limitée à des expéditeurs spécifiques ou l’approbation est requise pour envoyer un e-mail au destinataire.

Lire les messages avec le contrôle sur le format de corps retourné

Vous pouvezlire un message dans une boîte aux lettres en référençant son ID:

GET /me/messages/AAMkADhMGAAA=

Vous pouvez suivre les modifications apportées aux messages dans un dossier spécifique. Par exemple, lire ses messages dans le dossier Brouillons de l’utilisateur connecté:

GET /me/mailfolders('Drafts')

Le corps du message Outlook peut être au format HTML ou texte, avec HTML comme type de corps du message par défaut renvoyé dans une réponse GET.

Lorsque vous recevez un message, vous pouvez spécifier l’en-tête de requête suivant pour renvoyer les propriétés body et uniqueBody au format texte:

Prefer: outlook.body-content-type="text"

Vous pouvez spécifier l’en-tête suivant, ou simplement ignorer l’en-tête pour obtenir le corps du message au format HTML :

Prefer: outlook.body-content-type="html"

Lorsque vous spécifiez l’un ou l’autre en-tête, une réponse réussie doit inclure l’en-tête Preference-Applied correspondant :

  • Pour les requêtes de format texte : Preference-Applied: outlook.body-content-type="text"
  • Pour les requêtes de format HTML : Preference-Applied: outlook.body-content-type="html"

Si le corps est au format HTML, par défaut, Outlook supprime le contenu HTML potentiellement dangereux (par exemple, un code JavaScript) incorporé dans la propriété body avant que le contenu du corps ne soit renvoyé dans une réponse REST.

Pour obtenir le contenu HTML d’origine dans son intégralité, insérez l’en-tête de demande HTTP suivant :

Prefer: outlook.allow-unsafe-html

Intégration du geste social "@" (aperçu)

Les mentions @ sont des notifications servant à avertir les utilisateurs s’ils sont mentionnés dans des messages. La ressource mention permet aux applications de définir et d’obtenir le lien social en ligne courant, le préfixe « @ », dans les e-mails. Vous pouvez :

Autres fonctionnalités partagées

Tirez parti des fonctionnalités courantes suivantes qui sont partagées entre les entités Microsoft Graph :

Étapes suivantes