Delen via


E-mail van Office 365-groepen

Met de Office 365 Groups Mail-connector kunnen gebruikers werken met gegevens in een Office 365-groepspostvak. De functionaliteit in deze connector werkt onafhankelijk van het persoonlijke postvak van één gebruiker en stelt gebruikers in staat om te werken met elke groep die ze binnen hun organisatie kunnen openen. De connector werkt uit de Microsoft Graph API en maakt gebruik van terminologie die is opgegeven in een Documentatie voor Office 365 Groepen in de Graph API. Meer informatie vindt u in de connectordocumentatie.

Deze connector is beschikbaar in de volgende producten en regio's:

Dienst Class Regions
Copilot Studio Standaard Alle Power Automate regio's
Logic-apps Standaard Alle Logic Apps-regio's
Power Apps Standaard Alle Power Apps regio's
Power Automate Standaard Alle Power Automate regio's
Contactpersoon
Naam Microsoft
URL Ondersteuning voor Microsoft LogicApps
Ondersteuning voor Microsoft Power Automate
Ondersteuning voor Microsoft Power Apps
Connectormetagegevens
Uitgever Microsoft
Webpagina https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Categorieën Productiviteit

Vereiste voorwaarden

Als u deze connector wilt gebruiken, hebt u een gebruikersaccount nodig dat toegang heeft tot Office 365-groepen binnen een organisatie.

We raden u ook aan de Microsoft Graph API-documentatie voor Microsoft 365-groepen te raadplegen om inzicht te krijgen in de manier waarop de gegevens binnen de API zijn gestructureerd. Er is belangrijke terminologie die moet worden gecontroleerd voordat u deze connector gebruikt, zoals 'gesprek', 'thread' en 'post'.

Bekende problemen en beperkingen

Voor het oplossen van problemen met de fout 'Opgegeven object is niet gevonden in het archief', kunt u het volgende doen:

  • Controleer de machtigingen voor het account.
  • Probeer de huidige Office 365 Groups Mail-verbinding te verwijderen en een nieuwe te maken.

Toegang tot openbare groepen zonder lidmaatschap

Een geverifieerde gebruiker heeft toegang tot groepsgegevens uit groepen waarvan ze lid zijn en een openbare groep binnen hun organisatie. Bij het selecteren van een groep biedt de connector in de connector een dynamische vervolgkeuzelijst groepen waaruit u kunt kiezen. Voor een schonere ervaring wordt deze vervolgkeuzelijst automatisch ingevuld met de groepen waarvan de geverifieerde gebruiker lid is.

Als u toegang wilt krijgen tot 'Openbare' groepen in uw organisatie die niet zijn ingevuld in de vervolgkeuzelijst, moet u de groeps-id opgeven in de vervolgkeuzelijst van de connector door naar de onderkant te schuiven en een aangepaste waarde invoeren te selecteren.

Voer de volgende stappen uit om een groeps-id in uw organisatie te vinden:

  1. Navigeer naar Microsoft Graph Explorer en verifieer met uw gebruiker linksboven.

  2. Selecteer groepen in de sectie Voorbeeldquery's en haal vervolgens alle groepen in mijn organisatie op.

  3. Zoek in de preview van het antwoord de groep in uw organisatie waarnaar u zoekt. Geef de waarde in de id eigenschap op als de aangepaste waarde in de vervolgkeuzelijst van de connector.

  4. Zorg ervoor dat de zichtbaarheid van de groep is ingesteld op Openbaar, anders heeft de gebruiker geen toegang tot de gegevens binnen de groep.

  5. Als u de groep niet kunt vinden, moet u mogelijk zoeken op de volgende pagina met resultaten, die toegankelijk zijn door de koppeling te @odata.nextLink kopiëren en uit te voeren als een query boven aan de pagina.

E-mailtriggers

Als er veel e-mailberichten tegelijk worden verzonden, kunnen sommige e-mailberichten worden gemist door de trigger. Dit komt door onderliggende systeembeperkingen met vertragingen in de e-mailverwerking waardoor e-mailberichten te laat zichtbaar worden (nadat de connector de batch heeft verwerkt die de late e-mail bevat).

Afschaffingsgegevens

De bewerking Een bericht doorsturen is tijdelijk afgeschaft vanwege gebrek aan ondersteuning voor e-mailexfiltratiebeheer voor deze connector. We werken aan het bieden van ondersteuning en werken de bewerking bij wanneer deze is voltooid.

Beperkingslimieten

Name Aanroepen Verlengingsperiode
API-aanroepen per verbinding 100 60 seconden
Frequentie van trigger-polls 1 60 seconden

Acties

De berichten van een gespreksthread weergeven

Haal alle berichten van de opgegeven gespreksthread op.

De bijlagen van een bericht weergeven

Haal een lijst met bijlagen op die deel uitmaken van een bericht.

De gesprekken van een groep weergeven

Haal alle gesprekken in deze groep op.

De gespreksthreads van een gesprek weergeven

Haal alle threads op in een groepsgesprek.

De threads van een groep weergeven

Haal alle threads van een groep op.

Een bericht beantwoorden

Een bericht beantwoorden en een nieuw bericht toevoegen aan de opgegeven thread in een groepsgesprek.

Een bericht doorsturen (preview)

Een bericht doorsturen naar een geadresseerde.

Een bericht doorsturen [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan Een bericht doorsturen .

Een bericht doorsturen naar een geadresseerde.

Een gespreksthread beantwoorden

Beantwoord een thread in een groepsgesprek en voeg er een nieuw bericht aan toe.

Een gespreksthread maken

Maak een nieuwe thread in het opgegeven gesprek.

Een gespreksthread ophalen

Haal een specifieke thread op die deel uitmaakt van een groep.

Een gespreksthread verwijderen

Hiermee verwijdert u de opgegeven gespreksthread.

Een groepsgesprek ophalen

Haalt de eigenschappen van een bepaald gesprek op.

Een HTTP-aanvraag verzenden

Maak een Microsoft Graph REST API-aanvraag om aan te roepen. Meer informatie: https://docs.microsoft.com/en-us/graph/use-the-api

Een nieuw gesprek maken in een groep

Maak een nieuw gesprek in deze groep.

Een nieuw groepsgesprek starten door een thread te maken

Start een nieuw groepsgesprek door eerst een thread te maken.

Een threadbericht ophalen

Haalt een bericht op in een opgegeven thread.

De berichten van een gespreksthread weergeven

Haal alle berichten van de opgegeven gespreksthread op.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Retouren

Name Pad Type Description
waarde
value array of Post

Matrix met de berichten in de opgegeven thread.

De bijlagen van een bericht weergeven

Haal een lijst met bijlagen op die deel uitmaken van een bericht.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Post-id
postId True string

Voer de post-id in.

Retouren

Name Pad Type Description
waarde
value array of Attachment

Matrix met de bijlagen van het bericht.

De gesprekken van een groep weergeven

Haal alle gesprekken in deze groep op.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Retouren

Name Pad Type Description
waarde
value array of Conversation

De gespreksthreads van een gesprek weergeven

Haal alle threads op in een groepsgesprek.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Gespreks-id
conversationId True string

Voer de gespreks-id in.

Retouren

Name Pad Type Description
waarde
value array of ConversationThread

De threads van een groep weergeven

Haal alle threads van een groep op.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Retouren

Name Pad Type Description
waarde
value array of ConversationThread

Een bericht beantwoorden

Een bericht beantwoorden en een nieuw bericht toevoegen aan de opgegeven thread in een groepsgesprek.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Post-id
postId True string

Voer de post-id in.

Content
content True html

Inhoud van het nieuwe gesprek.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Adres
Address email

E-mailadres.

Bijlagenaam
Name True string

Naam van de bijlage.

Bijlage-inhoud
ContentBytes True byte

Inhoud van de bijlage.

Een bericht doorsturen (preview)

Een bericht doorsturen naar een geadresseerde.

Parameters

Name Sleutel Vereist Type Description
E-mail groeperen
groupMail True string

Kies een groep in de vervolgkeuzelijst of voer het groeps-e-mailadres in.

Gespreks-id
conversationId True string

Voer de gespreks-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Post-id
postId True string

Voer de post-id in.

Comment
Comment html

Opmerking om door te sturen met het bericht.

Adres
Address email

E-mailadres.

Een bericht doorsturen [AFGESCHAFT]

Deze actie is afgeschaft. Gebruik in plaats daarvan Een bericht doorsturen .

Een bericht doorsturen naar een geadresseerde.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Post-id
postId True string

Voer de post-id in.

Comment
comment string

Opmerking om door te sturen met het bericht.

Adres
Address email

E-mailadres.

Een gespreksthread beantwoorden

Beantwoord een thread in een groepsgesprek en voeg er een nieuw bericht aan toe.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Content
content True html

Inhoud van het nieuwe gesprek.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Adres
Address email

E-mailadres.

Bijlagenaam
Name True string

Naam van de bijlage.

Bijlage-inhoud
ContentBytes True byte

Inhoud van de bijlage.

Een gespreksthread maken

Maak een nieuwe thread in het opgegeven gesprek.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Gespreks-id
conversationId True string

Voer de gespreks-id in.

Nieuw onderwerp
topic True string

Onderwerp van het nieuwe gesprek.

Content
content True html

Inhoud van het nieuwe gesprek.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Adres
Address email

E-mailadres.

Bijlagenaam
Name True string

Naam van de bijlage.

Bijlage-inhoud
ContentBytes True byte

Inhoud van de bijlage.

Retouren

Een gespreksthread ophalen

Haal een specifieke thread op die deel uitmaakt van een groep.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Retouren

Gespreksthreadobject.

Een gespreksthread verwijderen

Hiermee verwijdert u de opgegeven gespreksthread.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Een groepsgesprek ophalen

Haalt de eigenschappen van een bepaald gesprek op.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Gespreks-id
conversationId True string

Voer de gespreks-id in.

Retouren

Gespreksobject.

Een HTTP-aanvraag verzenden

Maak een Microsoft Graph REST API-aanvraag om aan te roepen. Meer informatie: https://docs.microsoft.com/en-us/graph/use-the-api

Parameters

Name Sleutel Vereist Type Description
URI
Uri True string

De volledige of relatieve URI. Voorbeeld: https://graph.microsoft.com/{version}/{resource}.

Methode
Method True string

De HTTP-methode (standaard is GET).

Body
Body binary

De inhoud van de hoofdtekst van de aanvraag.

Inhoudstype
ContentType string

De koptekst van het inhoudstype voor de hoofdtekst (standaard is application/json).

CustomHeader1
CustomHeader1 string

Aangepaste koptekst 1. Opgeven in indeling: header-name: header-value

CustomHeader2
CustomHeader2 string

Aangepaste koptekst 2. Opgeven in indeling: header-name: header-value

CustomHeader3
CustomHeader3 string

Aangepaste koptekst 3. Opgeven in indeling: header-name: header-value

CustomHeader4
CustomHeader4 string

Aangepaste koptekst 4. Opgeven in indeling: header-name: header-value

CustomHeader5
CustomHeader5 string

Aangepaste koptekst 5. Opgeven in indeling: header-name: header-value

Retouren

Een nieuw gesprek maken in een groep

Maak een nieuw gesprek in deze groep.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Nieuw onderwerp
topic True string

Onderwerp van het nieuwe gesprek.

Content
content True html

Inhoud van het nieuwe gesprek.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Adres
Address email

E-mailadres.

Bijlagenaam
Name True string

Naam van de bijlage.

Bijlage-inhoud
ContentBytes True byte

Inhoud van de bijlage.

Retouren

Het antwoord van de gemaakte gespreksdetails.

Gespreksobject gemaakt
CreateConversationResponse

Een nieuw groepsgesprek starten door een thread te maken

Start een nieuw groepsgesprek door eerst een thread te maken.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Nieuw onderwerp
topic True string

Onderwerp van het nieuwe gesprek.

Content
content True html

Inhoud van het nieuwe gesprek.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Adres
Address email

E-mailadres.

Bijlagenaam
Name True string

Naam van de bijlage.

Bijlage-inhoud
ContentBytes True byte

Inhoud van de bijlage.

Retouren

Een threadbericht ophalen

Haalt een bericht op in een opgegeven thread.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Thread-id
threadId True string

Voer de gespreksthread-id in.

Post-id
postId True string

Voer de post-id in.

Retouren

Vertegenwoordigt een afzonderlijk post-item in een conversationThread-entiteit.

Body
Post

Triggers

Wanneer er een nieuwe e-mail binnenkomt in een groep

Wanneer er een nieuwe e-mail binnenkomt in een groep.

Wanneer er een nieuwe e-mail binnenkomt in een groep

Wanneer er een nieuwe e-mail binnenkomt in een groep.

Parameters

Name Sleutel Vereist Type Description
Groeps-id
groupId True string

Kies een groep in de vervolgkeuzelijst of voer de groeps-id in.

Retouren

Name Pad Type Description
waarde
value array of ConversationTriggerResponse

Antwoord van de trigger.

Definities

Gesprek

Gespreksobject.

Name Pad Type Description
Gespreks-id
id string

De unieke id van de gesprekken.

Gespreksonderwerp
topic string

Het onderwerp van het gesprek.

Heeft bijlagen?
hasAttachments boolean

Hiermee wordt aangegeven of een van de berichten in dit gesprek ten minste één bijlage heeft.

Laatst geleverde tijdstempel
lastDeliveredDateTime date-time

Het tijdstempeltype vertegenwoordigt datum- en tijdgegevens met iso 8601-indeling en bevindt zich altijd in UTC-tijd.

Unieke afzendermatrix
uniqueSenders array of string

Alle gebruikers die een bericht naar dit gesprek hebben verzonden.

Voorvertoning
preview string

Een korte samenvatting van de hoofdtekst van het laatste bericht in dit gesprek.

Gesprekthread

Gespreksthreadobject.

Name Pad Type Description
Gespreksthread-id
id string

De unieke id van de gespreksthread.

Gespreksonderwerp
topic string

Het onderwerp van het gesprek.

Heeft bijlagen?
hasAttachments boolean

Hiermee wordt aangegeven of een van de berichten in dit gesprek ten minste één bijlage heeft.

Laatst geleverde tijdstempel
lastDeliveredDateTime date-time

Het tijdstempeltype vertegenwoordigt datum- en tijdgegevens met iso 8601-indeling en bevindt zich altijd in UTC-tijd.

Unieke afzendermatrix
uniqueSenders array of string

Alle gebruikers die een bericht naar dit gesprek hebben verzonden.

Voorvertoning
preview string

Een korte samenvatting van de hoofdtekst van het laatste bericht in dit gesprek.

Is vergrendeld?
isLocked boolean

Geeft aan of de thread is vergrendeld.

toRecipients
toRecipients array of EmailAddress

De aan: geadresseerden voor de thread.

ccRecipients
ccRecipients array of EmailAddress

De CC: geadresseerden voor de thread.

Verzenden

Vertegenwoordigt een afzonderlijk post-item in een conversationThread-entiteit.

Name Pad Type Description
Post-id
id string

De unieke id van het bericht.

Tijdstempel van het bericht gemaakt
createdDateTime date-time
Laatst gewijzigd tijdstempel van het bericht
lastModifiedDateTime date-time
Sleutel wijzigen
changeKey string

Identificeert de versie van het bericht.

Gespreks-id
conversationId string

Unieke id van het gesprek waartoe het bericht behoort.

Gespreksthread-id
conversationThreadId string

Unieke id van de gespreksthread waartoe het bericht behoort.

Categorieën
categories array of string

De categorieën die aan het bericht zijn gekoppeld.

Ontvangen tijdstempel
receivedDateTime date-time

Tijdstempel ontvangen.

Heeft bijlagen?
hasAttachments boolean

Geeft aan of het bericht ten minste één bijlage heeft.

Nieuwe deelnemers
newParticipants array of EmailAddress

Gespreksdeelnemers die als onderdeel van dit bericht aan de thread zijn toegevoegd.

body
body ItemBody

Vertegenwoordigt eigenschappen van de hoofdtekst van een item, zoals een bericht, gebeurtenis of groepsbericht.

van
from EmailAddress
afzender
sender EmailAddress
attachments
attachments array of Attachment

Bijlage

Name Pad Type Description
Bijlage-ID
id string

Id van de bijlage.

Bijlagenaam
name string

Naam van bijlage.

Inhoudstype bijlage
contentType string

Inhoudstype van bijlage.

Bijlagegrootte
size integer

Grootte van bijlage.

Bytes voor bijlageinhoud
contentBytes byte

Inhoud van bijlage.

E-mailadres

Name Pad Type Description
Naam van de gebruiker
emailAddress.name string
E-mailadres van de gebruiker
emailAddress.address email

ItemBody

Vertegenwoordigt eigenschappen van de hoofdtekst van een item, zoals een bericht, gebeurtenis of groepsbericht.

Name Pad Type Description
Inhoudstype hoofdtekst
contentType string

Inhoudstype van de hoofdtekst.

Hoofdtekstinhoud
content string

Inhoud van de hoofdtekst.

CreateConversationResponse

Het antwoord van de gemaakte gespreksdetails.

Name Pad Type Description
Gespreks-id
id string

Nieuwe gespreks-id.

Gespreksthreads
threads array of object

Gespreksthread gemaakt.

Thread-id
threads.id string

De nieuwe thread-id.

NewConversationThreadResponse

Name Pad Type Description
Gespreksthread-id
id string

Nieuwe gespreksthread-id.

ConversationTriggerResponse

Wanneer er een nieuw e-mailbericht binnenkomt, wordt het antwoord geactiveerd.

Name Pad Type Description
Gespreks-id
id string

De unieke id van het gesprek.

Laatst geleverde tijdstempel
lastDeliveredDateTime date-time

Het tijdstempeltype vertegenwoordigt datum- en tijdgegevens met iso 8601-indeling en bevindt zich altijd in UTC-tijd.

threads
threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Gespreksthreadobject.

Name Pad Type Description
Gespreksthread-id
id string

De unieke id van de gespreksthread.

Berichten
posts array of PostTriggerResponse

PostTriggerResponse

Vertegenwoordigt een afzonderlijk post-item in een conversationThread-entiteit.

Name Pad Type Description
Post-id
id string

De unieke id van het bericht.

Laatst gewijzigd tijdstempel van het bericht
lastModifiedDateTime date-time
Sleutel wijzigen
changeKey string

Identificeert de versie van het bericht.

ObjectWithoutType