Partager via

Office 365 Groups Mail

Le connecteur de messagerie de groupes Office 365 permet aux utilisateurs d’utiliser des données situées dans une boîte aux lettres de groupe Office 365. La fonctionnalité de ce connecteur fonctionne indépendamment de la boîte aux lettres personnelle d’un seul utilisateur et permet aux utilisateurs de travailler avec n’importe quel groupe auquel ils peuvent accéder au sein de leur organisation. Le connecteur fonctionne hors de l’API Microsoft Graph et utilise la terminologie spécifiée dans une documentation de groupes Office 365 au sein de l’API Graph. En savoir plus dans la documentation du connecteur.

Ce connecteur est disponible dans les produits et régions suivants :

Service classe Régions
Copilot Studio Norme Toutes les régions Power Automate
Applications logiques Norme Toutes les régions Logic Apps
Power Apps Norme Toutes les régions Power Apps
Power Automate Norme Toutes les régions Power Automate
Contact
Nom Microsoft
URL Microsoft LogicApps Support
Prise en charge de Microsoft Power Automate
Prise en charge de Microsoft Power Apps
Métadonnées du connecteur
Éditeur Microsoft
Site internet https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Catégories Productivité

Prerequisites

Pour utiliser ce connecteur, vous aurez besoin d’un compte d’utilisateur qui a accès aux groupes Office 365 au sein d’une organisation.

Nous vous recommandons également de consulter la documentation de l’API Microsoft Graph pour les groupes Microsoft 365 afin de comprendre la façon dont les données sont structurées dans l’API. Il existe une terminologie clé qui doit être examinée avant d’utiliser ce connecteur, comme « conversation », « thread » et « post ».

Problèmes connus et limitations

Pour résoudre les problèmes liés à l’erreur « L’objet spécifié n’a pas été trouvé dans le magasin », vous pouvez effectuer les opérations suivantes :

  • Vérifiez les autorisations pour le compte.
  • Essayez de supprimer la connexion de messagerie des groupes Office 365 actuelle et créez-en une.

Accès aux groupes « publics » sans appartenance

Un utilisateur authentifié est en mesure d’accéder aux données de groupe à partir de groupes dont il est membre et de tout groupe « public » au sein de son organisation. Dans l’expérience du connecteur, lors de la sélection d’un groupe, le connecteur propose une liste déroulante dynamique de groupes à sélectionner. Pour une expérience plus propre, cette liste déroulante est automatiquement renseignée uniquement avec les groupes dont l’utilisateur authentifié est membre.

Pour accéder aux groupes « publics » au sein de votre organisation qui ne sont pas renseignés dans la liste déroulante, vous devez fournir l’ID de groupe dans la liste déroulante du connecteur en faisant défiler vers le bas et en sélectionnant Entrer une valeur personnalisée.

Pour rechercher un ID de groupe au sein de votre organisation, procédez comme suit :

  1. Accédez à l’Explorateur Microsoft Graph et authentifiez-vous auprès de votre utilisateur en haut à gauche.

  2. Dans la section Exemples de requêtes , sélectionnez Groupes, puis GET tous les groupes de mon organisation.

  3. Dans la préversion réponse, recherchez le groupe au sein de votre organisation que vous recherchez. Indiquez la valeur dans la id propriété comme valeur personnalisée dans l’expérience de liste déroulante du connecteur.

  4. Vérifiez que la visibilité du groupe est définie sur Public ou si l’utilisateur ne pourra pas accéder aux données au sein du groupe.

  5. Si vous ne trouvez pas le groupe, vous devrez peut-être rechercher dans la page suivante des résultats, accessible en copiant le lien et en @odata.nextLink l’exécutant en tant que requête en haut de la page.

Déclencheurs de messagerie

S’il y a beaucoup d’e-mails envoyés en même temps, certains e-mails peuvent être manqués par le déclencheur. Cela est dû aux limitations système sous-jacentes avec les retards de traitement des e-mails qui entraînent la « visibilité » des e-mails en retard (une fois que le connecteur a traité le lot qui contient le courrier en retard).

Informations de dépréciation

L’opération « Transférer un billet » a été temporairement déconseillée en raison d’un manque de prise en charge du contrôle d’exfiltration de messagerie pour ce connecteur. Nous travaillons à fournir un support et nous allons mettre à jour l’opération une fois terminée.

Limitations

Nom Appels Période de renouvellement
Appels d’API par connexion 100 60 secondes
Fréquence des sondages déclencheurs 1 60 secondes

Actions

Créer un thread de conversation

Créez un thread dans la conversation spécifiée.
Créer une conversation dans un groupe

Créez une conversation dans ce groupe.
Démarrer une conversation de groupe en créant un thread

Démarrez une conversation de groupe en créant d’abord un thread.
Envoyer une requête HTTP

Créez une requête d’API REST Microsoft Graph à appeler. Pour en savoir plus: https://docs.microsoft.com/en-us/graph/use-the-api
Obtenir un billet de thread

Récupère un billet dans un thread spécifié.
Obtenir un thread de conversation

Obtenez un thread spécifique qui appartient à un groupe.
Obtenir une conversation de groupe

Récupère les propriétés d’une conversation particulière.
Répertorier les billets d’un thread de conversation

Obtenez toutes les publications du thread de conversation spécifié.
Répertorier les conversations d’un groupe

Obtenez toutes les conversations de ce groupe.
Répertorier les pièces jointes d’un billet

Récupérez une liste de pièces jointes appartenant à un billet.
Répertorier les threads de conversation d’une conversation

Obtenez tous les threads d’une conversation de groupe.
Répertorier les threads d’un groupe

Obtenez tous les threads d’un groupe.
Répondre à un billet

Répondez à un billet et ajoutez un nouveau billet au thread spécifié dans une conversation de groupe.
Répondre à un thread de conversation

Répondez à un thread dans une conversation de groupe et ajoutez-y un nouveau billet.
Supprimer un thread de conversation

Supprime le thread de conversation spécifié.
Transférer un billet (préversion)

Transférez un billet à un destinataire.
Transférer un billet [DÉCONSEILLÉ]

Cette action a été déconseillée. Utilisez plutôt Transférer un billet .

Transférez un billet à un destinataire.

Créer un thread de conversation

ID d’opération :
CreateConversationThread

Créez un thread dans la conversation spécifiée.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
ID de conversation
 conversationId True string

Entrez l’ID de conversation.
Nouvelle rubrique
 topic True string

Rubrique de la nouvelle conversation.
Content
 content True html

Contenu de la nouvelle conversation.
Catégories
 categories array of string

Catégories associées au billet.
Adresse
 Address email

Adresse e-mail.
Nom de la pièce jointe
 Name True string

Nom de la pièce jointe.
Contenu de pièce jointe
 ContentBytes True byte

Contenu de la pièce jointe.

Retours

Corps
NewConversationThreadResponse

Créer une conversation dans un groupe

ID d’opération :
CreateConversation

Créez une conversation dans ce groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Nouvelle rubrique
 topic True string

Rubrique de la nouvelle conversation.
Content
 content True html

Contenu de la nouvelle conversation.
Catégories
 categories array of string

Catégories associées au billet.
Adresse
 Address email

Adresse e-mail.
Nom de la pièce jointe
 Name True string

Nom de la pièce jointe.
Contenu de pièce jointe
 ContentBytes True byte

Contenu de la pièce jointe.

Retours

Réponse des détails de la conversation créée.

Objet de conversation créé
CreateConversationResponse

Démarrer une conversation de groupe en créant un thread

ID d’opération :
CreateGroupThread

Démarrez une conversation de groupe en créant d’abord un thread.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Nouvelle rubrique
 topic True string

Rubrique de la nouvelle conversation.
Content
 content True html

Contenu de la nouvelle conversation.
Catégories
 categories array of string

Catégories associées au billet.
Adresse
 Address email

Adresse e-mail.
Nom de la pièce jointe
 Name True string

Nom de la pièce jointe.
Contenu de pièce jointe
 ContentBytes True byte

Contenu de la pièce jointe.

Retours

Corps
NewConversationThreadResponse

Envoyer une requête HTTP

ID d’opération :
HttpRequest

Créez une requête d’API REST Microsoft Graph à appeler. Pour en savoir plus: https://docs.microsoft.com/en-us/graph/use-the-api

Paramètres

Nom Clé Obligatoire Type Description
URI
 Uri True string

URI complet ou relatif. Exemple : https://graph.microsoft.com/{version}/{resource}.
Méthode
 Method True string

Méthode HTTP (la valeur par défaut est GET).
Corps
 Body binary

Contenu du corps de la requête.
Type de contenu
 ContentType string

En-tête de type de contenu pour le corps (la valeur par défaut est application/json).
CustomHeader1
 CustomHeader1 string

En-tête personnalisé 1. Spécifier au format : header-name : header-value
CustomHeader2
 CustomHeader2 string

En-tête personnalisé 2. Spécifier au format : header-name : header-value
CustomHeader3
 CustomHeader3 string

En-tête personnalisé 3. Spécifier au format : header-name : header-value
CustomHeader4
 CustomHeader4 string

En-tête personnalisé 4. Spécifier au format : header-name : header-value
CustomHeader5
 CustomHeader5 string

En-tête personnalisé 5. Spécifier au format : header-name : header-value

Retours

response
ObjectWithoutType

Obtenir un billet de thread

ID d’opération :
GetThreadPost

Récupère un billet dans un thread spécifié.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
ID de publication
 postId True string

Entrez l’ID de publication.

Retours

Représente un élément Post individuel au sein d’une entité conversationThread.

Corps
Post

Obtenir un thread de conversation

ID d’opération :
GetConversationThread

Obtenez un thread spécifique qui appartient à un groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.

Retours

Objet thread de conversation.

Corps
ConversationThread

Obtenir une conversation de groupe

ID d’opération :
GetGroupConversation

Récupère les propriétés d’une conversation particulière.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
ID de conversation
 conversationId True string

Entrez l’ID de conversation.

Retours

Objet conversation.

Corps
Conversation

Répertorier les billets d’un thread de conversation

ID d’opération :
ListThreadPosts

Obtenez toutes les publications du thread de conversation spécifié.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.

Retours

Nom Chemin d’accès Type Description
value
 value array of Post

Tableau contenant les publications dans le thread spécifié.

Répertorier les conversations d’un groupe

ID d’opération :
ListConversations

Obtenez toutes les conversations de ce groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.

Retours

Nom Chemin d’accès Type Description
value
 value array of Conversation

Répertorier les pièces jointes d’un billet

ID d’opération :
GetAttachments

Récupérez une liste de pièces jointes appartenant à un billet.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
ID de publication
 postId True string

Entrez l’ID de publication.

Retours

Nom Chemin d’accès Type Description
value
 value array of Attachment

Tableau contenant les pièces jointes du billet.

Répertorier les threads de conversation d’une conversation

ID d’opération :
ListConversationThreads

Obtenez tous les threads d’une conversation de groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
ID de conversation
 conversationId True string

Entrez l’ID de conversation.

Retours

Nom Chemin d’accès Type Description
value
 value array of ConversationThread

Répertorier les threads d’un groupe

ID d’opération :
ListGroupThreads

Obtenez tous les threads d’un groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.

Retours

Nom Chemin d’accès Type Description
value
 value array of ConversationThread

Répondre à un billet

ID d’opération :
ReplyPost

Répondez à un billet et ajoutez un nouveau billet au thread spécifié dans une conversation de groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
ID de publication
 postId True string

Entrez l’ID de publication.
Content
 content True html

Contenu de la nouvelle conversation.
Catégories
 categories array of string

Catégories associées au billet.
Adresse
 Address email

Adresse e-mail.
Nom de la pièce jointe
 Name True string

Nom de la pièce jointe.
Contenu de pièce jointe
 ContentBytes True byte

Contenu de la pièce jointe.

Répondre à un thread de conversation

ID d’opération :
ReplyToAThread

Répondez à un thread dans une conversation de groupe et ajoutez-y un nouveau billet.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
Content
 content True html

Contenu de la nouvelle conversation.
Catégories
 categories array of string

Catégories associées au billet.
Adresse
 Address email

Adresse e-mail.
Nom de la pièce jointe
 Name True string

Nom de la pièce jointe.
Contenu de pièce jointe
 ContentBytes True byte

Contenu de la pièce jointe.

Supprimer un thread de conversation

ID d’opération :
DeleteConversationThread

Supprime le thread de conversation spécifié.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.

Transférer un billet (préversion)

ID d’opération :
ForwardPost_V2

Transférez un billet à un destinataire.

Paramètres

Nom Clé Obligatoire Type Description
Courrier de groupe
 groupMail True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’adresse de messagerie du groupe.
ID de conversation
 conversationId True string

Entrez l’ID de conversation.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
ID de publication
 postId True string

Entrez l’ID de publication.
Commentaire
 Comment html

Commentaire à transférer avec le billet.
Adresse
 Address email

Adresse e-mail.

Transférer un billet [DÉCONSEILLÉ]

ID d’opération :
ForwardPost

Cette action a été déconseillée. Utilisez plutôt Transférer un billet .

Transférez un billet à un destinataire.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.
Thread ID
 threadId True string

Entrez l’ID du thread de conversation.
ID de publication
 postId True string

Entrez l’ID de publication.
Commentaire
 comment string

Commentaire à transférer avec le billet.
Adresse
 Address email

Adresse e-mail.

Déclencheurs

Lorsqu’un nouvel e-mail arrive à un groupe

Lorsqu’un nouvel e-mail arrive à un groupe.

Lorsqu’un nouvel e-mail arrive à un groupe

ID d’opération :
OnNewEmailInGroup

Lorsqu’un nouvel e-mail arrive à un groupe.

Paramètres

Nom Clé Obligatoire Type Description
ID de groupe
 groupId True string

Sélectionnez un groupe dans la liste déroulante ou entrez l’ID de groupe.

Retours

Nom Chemin d’accès Type Description
value
 value array of ConversationTriggerResponse

Réponse du déclencheur.

Définitions

Conversation

Objet conversation.

Nom Chemin d’accès Type Description
ID de conversation
 id string

Identificateur unique des conversations.
Rubrique de conversation
 topic string

Sujet de la conversation.
A-t-il des pièces jointes ?
 hasAttachments boolean

Indique si l’une des publications de cette conversation comporte au moins une pièce jointe.
Horodatage de la dernière livraison
 lastDeliveredDateTime date-time

Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC.
Tableau d’expéditeurs uniques
 uniqueSenders array of string

Tous les utilisateurs qui ont envoyé un message à cette conversation.
Preview
 preview string

Un bref résumé du corps du dernier billet de cette conversation.

ConversationThread

Objet thread de conversation.

Nom Chemin d’accès Type Description
Conversation thread ID
 id string

Identificateur unique du thread de conversation.
Rubrique de conversation
 topic string

Sujet de la conversation.
A-t-il des pièces jointes ?
 hasAttachments boolean

Indique si l’une des publications de cette conversation comporte au moins une pièce jointe.
Horodatage de la dernière livraison
 lastDeliveredDateTime date-time

Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC.
Tableau d’expéditeurs uniques
 uniqueSenders array of string

Tous les utilisateurs qui ont envoyé un message à cette conversation.
Preview
 preview string

Un bref résumé du corps du dernier billet de cette conversation.
Est verrouillé ?
 isLocked boolean

Indique si le thread est verrouillé.
toRecipients
 toRecipients array of EmailAddress

Destinataires du thread.
ccRecipients
 ccRecipients array of EmailAddress

Cc : destinataires du thread.

Publier

Représente un élément Post individuel au sein d’une entité conversationThread.

Nom Chemin d’accès Type Description
ID de publication
 id string

Identificateur unique du billet.
Horodatage créé du billet
 createdDateTime date-time
Horodatage modifié du billet
 lastModifiedDateTime date-time
Modifier la clé
 changeKey string

Identifie la version du billet.
ID de conversation
 conversationId string

ID unique de la conversation à laquelle appartient le billet.
Conversation thread ID
 conversationThreadId string

ID unique du thread de conversation auquel appartient le billet.
Catégories
 categories array of string

Catégories associées au billet.
Horodatage reçu
 receivedDateTime date-time

Horodatage post-reçu.
A-t-il des pièces jointes ?
 hasAttachments boolean

Indique si le billet comporte au moins une pièce jointe.
Nouveaux participants
 newParticipants array of EmailAddress

Participants de conversation ajoutés au thread dans le cadre de ce billet.
body
 body ItemBody

Représente les propriétés du corps d’un élément, telles qu’un message, un événement ou un billet de groupe.
de
 from EmailAddress
expéditeur
 sender EmailAddress
attachments
 attachments array of Attachment

Pièce jointe

Nom Chemin d’accès Type Description
ID de pièce jointe
 id string

ID de la pièce jointe.
Nom de la pièce jointe
 name string

Nom de la pièce jointe.
Type de contenu de pièce jointe
 contentType string

Type de contenu de pièce jointe.
Taille de pièce jointe
 size integer

Taille de la pièce jointe.
Octets de contenu de pièce jointe
 contentBytes byte

Contenu de la pièce jointe.

Adresse e-mail

Nom Chemin d’accès Type Description
Nom de l’utilisateur
 emailAddress.name string
Adresse e-mail de l’utilisateur
 emailAddress.address email

ItemBody

Représente les propriétés du corps d’un élément, telles qu’un message, un événement ou un billet de groupe.

Nom Chemin d’accès Type Description
Type de contenu du corps
 contentType string

Type de contenu du corps.
Contenu du corps
 content string

Contenu du corps.

CreateConversationResponse

Réponse des détails de la conversation créée.

Nom Chemin d’accès Type Description
ID de conversation
 id string

Nouvel ID de conversation.
Threads de conversation
 threads array of object

Thread de conversation créé.
Thread ID
 threads.id string

Nouvel ID de thread.

NewConversationThreadResponse

Nom Chemin d’accès Type Description
Conversation thread ID
 id string

Nouvel ID de thread de conversation.

ConversationTriggerResponse

Lorsqu’un nouvel e-mail arrive à la réponse du déclencheur.

Nom Chemin d’accès Type Description
ID de conversation
 id string

Identificateur unique de conversation.
Horodatage de la dernière livraison
 lastDeliveredDateTime date-time

Le type d’horodatage représente les informations de date et d’heure au moyen du format ISO 8601. Il est toujours au format d’heure UTC.
threads
 threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Objet thread de conversation.

Nom Chemin d’accès Type Description
Conversation thread ID
 id string

Identificateur unique du thread de conversation.
posts
 posts array of PostTriggerResponse

PostTriggerResponse

Représente un élément Post individuel au sein d’une entité conversationThread.

Nom Chemin d’accès Type Description
ID de publication
 id string

Identificateur unique du billet.
Horodatage modifié du billet
 lastModifiedDateTime date-time
Modifier la clé
 changeKey string

Identifie la version du billet.

ObjectWithoutType