Pošta skupin Office 365

Konektor Pošta skupin Office 365 umožňuje uživatelům pracovat s daty umístěnými v poštovní schránce skupiny Office 365. Funkce v tomto konektoru funguje nezávisle na osobní poštovní schránce jednoho uživatele a umožňuje uživatelům pracovat s libovolnou skupinou, ke které mají přístup v rámci organizace. Konektor funguje s rozhraním Microsoft Graph API a používá terminologii uvedenou v dokumentaci ke skupinám Office 365 v rozhraní Graph API. Další informace najdete v dokumentaci ke konektoru.

Tento konektor je dostupný v následujících produktech a oblastech:

Service	Class	Regions
Copilot Studio	Standard	Všechny oblasti Power Automate
Logic Apps	Standard	Všechny oblasti Logic Apps
Power Apps	Standard	Všechny oblasti Power Apps
Power Automate	Standard	Všechny oblasti Power Automate

Kontakt
Název	Microsoft
URL	Podpora Microsoft LogicApps Podpora microsoft Power Automate Podpora Microsoft Power Apps

Metadata konektoru
Vydavatel	Microsoft
Internetová stránka	https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Kategorie	Produktivita

Požadavky

Abyste mohli tento konektor používat, budete potřebovat uživatelský účet, který má přístup ke skupinám Office 365 v rámci organizace.

Doporučujeme také projít si dokumentaci k rozhraní Microsoft Graph API pro skupiny Microsoft 365 , abyste pochopili, jak jsou data strukturovaná v rámci rozhraní API. Před použitím tohoto konektoru je potřeba zkontrolovat klíčovou terminologii, například "konverzace", "vlákno" a "příspěvek".

Známé problémy a omezení

Při řešení potíží s chybou Zadaný objekt nebyl v úložišti nalezen, můžete provést následující:

Ověřte oprávnění k účtu.
Zkuste odstranit aktuální připojení pošty skupin Office 365 a vytvořit nové.

Přístup k "veřejným" skupinám bez členství

Ověřený uživatel má přístup k datům skupiny ze skupin, které jsou členy a jakékoli "veřejné" skupiny v rámci organizace. V prostředí konektoru nabízí konektor při výběru skupiny dynamický rozevírací seznam Skupin, ze které si můžete vybrat. V případě přehlednějšího prostředí se tento rozevírací seznam automaticky naplní jenom skupinami, ve které je ověřený uživatel členem.

Pokud chcete získat přístup k "veřejným" skupinám ve vaší organizaci, které nejsou vyplněné v rozevíracím seznamu, budete muset zadat ID skupiny v rozevíracím seznamu konektoru tak, že se posunete do dolní části a vyberete Zadat vlastní hodnotu.

Id skupiny ve vaší organizaci najdete takto:

Přejděte do Microsoft Graph Exploreru a ověřte ho u uživatele v levém horním rohu.
V části Ukázkové dotazy vyberte Skupiny a pak získejte všechny skupiny v mé organizaci.
Ve verzi Preview odpovědi najděte skupinu ve vaší organizaci, kterou hledáte. Zadejte hodnotu ve id vlastnosti jako vlastní hodnotu v rozevíracím seznamu konektoru.
Ujistěte se, že je viditelnost skupiny nastavená na veřejnou, nebo jinak uživatel nebude mít přístup k datům v rámci skupiny.
Pokud skupinu nemůžete najít, budete se možná muset podívat na další stránku výsledků, ke které se dostanete tak, že odkaz @odata.nextLink zkopírujete a spustíte ho jako dotaz v horní části stránky.

Aktivační události pošty

Pokud je současně odesláno velké množství e-mailů, trigger může některé e-maily zmeškat. Důvodem je základní systémová omezení zpoždění zpracování e-mailů, která způsobují, že se e-maily zpozdí (jakmile konektor zpracuje dávku obsahující pozdní e-mail).

Informace o vyřazení

Operace Přeposlat příspěvek je dočasně zastaralá kvůli nedostatku podpory kontroly exfiltrace e-mailu pro tento konektor. Pracujeme na poskytování podpory a po dokončení aktualizujeme operaci.

Limity omezování

Name	Volání	Období obnovení
Volání rozhraní API na připojení	100	60 sekund
Frekvence dotazování triggerů	1	60 sekund

Akce

Odeslání požadavku HTTP	Vytvořte požadavek rozhraní REST API Microsoft Graphu, který se má vyvolat. Víc se uč: https://docs.microsoft.com/en-us/graph/use-the-api
Odpovědět na příspěvek	Odpovězte na příspěvek a přidejte nový příspěvek do zadaného vlákna ve skupinové konverzaci.
Odpověď na vlákno konverzace	Odpovězte na vlákno ve skupinové konverzaci a přidejte do ní nový příspěvek.
Odstranění vlákna konverzace	Odstraní zadané vlákno konverzace.
Přeposlání příspěvku (Preview)	Přeposlání příspěvku příjemci
Přeposlání příspěvku [ZASTARALÉ]	Tato akce je zastaralá. Místo toho použijte přeposlat příspěvek . ~~Přeposlání příspěvku příjemci~~
Vytvoření nové konverzace ve skupině	Vytvořte novou konverzaci v této skupině.
Vytvoření vlákna konverzace	V zadané konverzaci vytvořte nové vlákno.
Výpis příloh příspěvku	Načte seznam příloh, které patří do příspěvku.
Zahájení nové skupinové konverzace vytvořením vlákna	Začněte novou skupinovou konverzaci tak, že nejprve vytvoříte vlákno.
Zobrazení seznamu konverzací skupiny	Získejte všechny konverzace v této skupině.
Zobrazení seznamu příspěvků vlákna konverzace	Získejte všechny příspěvky zadaného vlákna konverzace.
Zobrazení seznamu vláken konverzace v konverzaci	Získejte všechna vlákna ve skupinové konverzaci.
Zobrazení seznamu vláken skupiny	Získejte všechna vlákna skupiny.
Získání příspěvku vlákna	Načte příspěvek v zadaném vlákně.
Získání skupinové konverzace	Načte vlastnosti konkrétní konverzace.
Získání vlákna konverzace	Získejte konkrétní vlákno, které patří do skupiny.

Odeslání požadavku HTTP

ID operace:: HttpRequest

Vytvořte požadavek rozhraní REST API Microsoft Graphu, který se má vyvolat. Víc se uč: https://docs.microsoft.com/en-us/graph/use-the-api

Parametry

Name	Klíč	Vyžadováno	Typ	Description
identifikátor URI	Uri	True	string	Úplný nebo relativní identifikátor URI. Příklad: `https://graph.microsoft.com/{version}/{resource}`.
Metoda	Method	True	string	Metoda HTTP (výchozí hodnota je GET).
Body	Body		binary	Základní obsah požadavku.
Typ obsahu	ContentType		string	Hlavička typu obsahu pro tělo (výchozí hodnota je application/json).
CustomHeader1	CustomHeader1		string	Vlastní hlavička 1. Zadejte ve formátu: header-name: header-value
CustomHeader2	CustomHeader2		string	Vlastní hlavička 2. Zadejte ve formátu: header-name: header-value
CustomHeader3	CustomHeader3		string	Vlastní hlavička 3. Zadejte ve formátu: header-name: header-value
CustomHeader4	CustomHeader4		string	Vlastní hlavička 4. Zadejte ve formátu: header-name: header-value
CustomHeader5	CustomHeader5		string	Vlastní hlavička 5. Zadejte ve formátu: header-name: header-value

Návraty

response: ObjectWithoutType

Odpovědět na příspěvek

ID operace:: ReplyPost

Odpovězte na příspěvek a přidejte nový příspěvek do zadaného vlákna ve skupinové konverzaci.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
ID příspěvku	postId	True	string	Zadejte ID příspěvku.
Content	content	True	html	Obsah nové konverzace
Kategorie	categories		array of string	Kategorie přidružené k příspěvku.
Address	Address		email	E-mailová adresa.
Název přílohy	Name	True	string	Název přílohy
Obsah přílohy	ContentBytes	True	byte	Obsah přílohy

Odpověď na vlákno konverzace

ID operace:: ReplyToAThread

Odpovězte na vlákno ve skupinové konverzaci a přidejte do ní nový příspěvek.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
Content	content	True	html	Obsah nové konverzace
Kategorie	categories		array of string	Kategorie přidružené k příspěvku.
Address	Address		email	E-mailová adresa.
Název přílohy	Name	True	string	Název přílohy
Obsah přílohy	ContentBytes	True	byte	Obsah přílohy

Odstranění vlákna konverzace

ID operace:: DeleteConversationThread

Odstraní zadané vlákno konverzace.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.

Přeposlání příspěvku (Preview)

ID operace:: ForwardPost_V2

Přeposlání příspěvku příjemci

Parametry

Name	Klíč	Vyžadováno	Typ	Description
Skupinová pošta	groupMail	True	string	V rozevíracím seznamu vyberte skupinu nebo zadejte e-mailovou adresu skupiny.
ID konverzace	conversationId	True	string	Zadejte ID konverzace.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
ID příspěvku	postId	True	string	Zadejte ID příspěvku.
Comment	Comment		html	Přidejte komentář k přeposlání příspěvku.
Address	Address		email	E-mailová adresa.

Přeposlání příspěvku [ZASTARALÉ]

ID operace:: ForwardPost

Tato akce je zastaralá. Místo toho použijte přeposlat příspěvek .

~~Přeposlání příspěvku příjemci~~

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
ID příspěvku	postId	True	string	Zadejte ID příspěvku.
Comment	comment		string	Přidejte komentář k přeposlání příspěvku.
Address	Address		email	E-mailová adresa.

Vytvoření nové konverzace ve skupině

ID operace:: CreateConversation

Vytvořte novou konverzaci v této skupině.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
Nové téma	topic	True	string	Téma nové konverzace
Content	content	True	html	Obsah nové konverzace
Kategorie	categories		array of string	Kategorie přidružené k příspěvku.
Address	Address		email	E-mailová adresa.
Název přílohy	Name	True	string	Název přílohy
Obsah přílohy	ContentBytes	True	byte	Obsah přílohy

Návraty

Odpověď s podrobnostmi vytvořené konverzace.

Vytvořený objekt konverzace: CreateConversationResponse

Vytvoření vlákna konverzace

ID operace:: CreateConversationThread

V zadané konverzaci vytvořte nové vlákno.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID konverzace	conversationId	True	string	Zadejte ID konverzace.
Nové téma	topic	True	string	Téma nové konverzace
Content	content	True	html	Obsah nové konverzace
Kategorie	categories		array of string	Kategorie přidružené k příspěvku.
Address	Address		email	E-mailová adresa.
Název přílohy	Name	True	string	Název přílohy
Obsah přílohy	ContentBytes	True	byte	Obsah přílohy

Návraty

Body: NewConversationThreadResponse

Výpis příloh příspěvku

ID operace:: GetAttachments

Načte seznam příloh, které patří do příspěvku.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
ID příspěvku	postId	True	string	Zadejte ID příspěvku.

Návraty

Name	Cesta	Typ	Description
value	value	array of Attachment	Pole obsahující přílohy příspěvku.

Zahájení nové skupinové konverzace vytvořením vlákna

ID operace:: CreateGroupThread

Začněte novou skupinovou konverzaci tak, že nejprve vytvoříte vlákno.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
Nové téma	topic	True	string	Téma nové konverzace
Content	content	True	html	Obsah nové konverzace
Kategorie	categories		array of string	Kategorie přidružené k příspěvku.
Address	Address		email	E-mailová adresa.
Název přílohy	Name	True	string	Název přílohy
Obsah přílohy	ContentBytes	True	byte	Obsah přílohy

Návraty

Body: NewConversationThreadResponse

Zobrazení seznamu konverzací skupiny

ID operace:: ListConversations

Získejte všechny konverzace v této skupině.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.

Návraty

Name	Cesta	Typ	Description
value	value	array of Conversation

Zobrazení seznamu příspěvků vlákna konverzace

ID operace:: ListThreadPosts

Získejte všechny příspěvky zadaného vlákna konverzace.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.

Návraty

Name	Cesta	Typ	Description
value	value	array of Post	Pole obsahující příspěvky v zadaném vlákně.

Zobrazení seznamu vláken konverzace v konverzaci

ID operace:: ListConversationThreads

Získejte všechna vlákna ve skupinové konverzaci.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID konverzace	conversationId	True	string	Zadejte ID konverzace.

Návraty

Name	Cesta	Typ	Description
value	value	array of ConversationThread

Zobrazení seznamu vláken skupiny

ID operace:: ListGroupThreads

Získejte všechna vlákna skupiny.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.

Návraty

Name	Cesta	Typ	Description
value	value	array of ConversationThread

Získání příspěvku vlákna

ID operace:: GetThreadPost

Načte příspěvek v zadaném vlákně.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.
ID příspěvku	postId	True	string	Zadejte ID příspěvku.

Návraty

Představuje jednotlivé položky Post v rámci entity conversationThread.

Body: Post

Získání skupinové konverzace

ID operace:: GetGroupConversation

Načte vlastnosti konkrétní konverzace.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID konverzace	conversationId	True	string	Zadejte ID konverzace.

Návraty

Objekt konverzace

Body: Conversation

Získání vlákna konverzace

ID operace:: GetConversationThread

Získejte konkrétní vlákno, které patří do skupiny.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.
ID vlákna	threadId	True	string	Zadejte ID vlákna konverzace.

Návraty

Objekt vlákna konverzace

Body: ConversationThread

Aktivační události

Když přijde nový e-mail do skupiny

Když přijde nový e-mail do skupiny.

Když přijde nový e-mail do skupiny

ID operace:: OnNewEmailInGroup

Když přijde nový e-mail do skupiny.

Parametry

Name	Klíč	Vyžadováno	Typ	Description
ID skupiny	groupId	True	string	Vyberte skupinu z rozevíracího seznamu nebo zadejte ID skupiny.

Návraty

Name	Cesta	Typ	Description
value	value	array of ConversationTriggerResponse	Odpověď triggeru.

Definice

Konverzace

Objekt konverzace

Name	Cesta	Typ	Description
ID konverzace	id	string	Jedinečný identifikátor konverzací.
Téma konverzace	topic	string	Téma konverzace.
Obsahuje přílohy?	hasAttachments	boolean	Určuje, jestli některé příspěvky v této konverzaci mají aspoň jednu přílohu.
Časové razítko posledního doručení	lastDeliveredDateTime	date-time	Typ časového razítka představuje informace o datu a čase pomocí formátu ISO 8601 a vždy je v čase UTC.
Pole jedinečných odesílatelů	uniqueSenders	array of string	Všichni uživatelé, kteří odeslali zprávu do této konverzace.
Náhled	preview	string	Krátký souhrn z textu posledního příspěvku v této konverzaci.

ConversationThread

Objekt vlákna konverzace

Name	Cesta	Typ	Description
ID vlákna konverzace	id	string	Jedinečný identifikátor vlákna konverzace.
Téma konverzace	topic	string	Téma konverzace.
Obsahuje přílohy?	hasAttachments	boolean	Určuje, jestli některé příspěvky v této konverzaci mají aspoň jednu přílohu.
Časové razítko posledního doručení	lastDeliveredDateTime	date-time	Typ časového razítka představuje informace o datu a čase pomocí formátu ISO 8601 a vždy je v čase UTC.
Pole jedinečných odesílatelů	uniqueSenders	array of string	Všichni uživatelé, kteří odeslali zprávu do této konverzace.
Náhled	preview	string	Krátký souhrn z textu posledního příspěvku v této konverzaci.
Je uzamčeno?	isLocked	boolean	Označuje, zda je vlákno uzamčeno.
toRecipients	toRecipients	array of EmailAddress	To: příjemci pro vlákno.
ccRecipients	ccRecipients	array of EmailAddress	Kopie: příjemci pro vlákno.

Post

Představuje jednotlivé položky Post v rámci entity conversationThread.

Name	Cesta	Typ	Description
ID příspěvku	id	string	Jedinečný identifikátor příspěvku.
Vytvoření časového razítka příspěvku	createdDateTime	date-time
Časové razítko poslední změny příspěvku	lastModifiedDateTime	date-time
Změnit klíč	changeKey	string	Identifikuje verzi příspěvku.
ID konverzace	conversationId	string	Jedinečné ID konverzace, do které příspěvek patří.
ID vlákna konverzace	conversationThreadId	string	Jedinečné ID vlákna konverzace, do kterého příspěvek patří.
Kategorie	categories	array of string	Kategorie přidružené k příspěvku.
Přijaté časové razítko	receivedDateTime	date-time	Po přijetí časového razítka
Obsahuje přílohy?	hasAttachments	boolean	Určuje, jestli má příspěvek aspoň jednu přílohu.
Noví účastníci	newParticipants	array of EmailAddress	Účastníci konverzace, kteří byli přidáni do vlákna jako součást tohoto příspěvku.
body	body	ItemBody	Představuje vlastnosti textu položky, například zprávy, události nebo příspěvku skupiny.
od	from	EmailAddress
odesílatel	sender	EmailAddress
attachments	attachments	array of Attachment

Attachment

Name	Cesta	Typ	Description
ID přílohy	id	string	ID přílohy.
Název přílohy	name	string	Název přílohy.
Typ obsahu přílohy	contentType	string	Typ obsahu přílohy
Velikost přílohy	size	integer	Velikost přílohy
Bajty obsahu přílohy	contentBytes	byte	Obsah přílohy

E-mailová adresa

Name	Cesta	Typ	Description
Jméno uživatele	emailAddress.name	string
E-mailová adresa uživatele	emailAddress.address	email

ItemBody

Představuje vlastnosti textu položky, například zprávy, události nebo příspěvku skupiny.

Name	Cesta	Typ	Description
Typ základního obsahu	contentType	string	Typ obsahu textu.
Základní obsah	content	string	Obsah těla.

CreateConversationResponse

Odpověď s podrobnostmi vytvořené konverzace.

Name	Cesta	Typ	Description
ID konverzace	id	string	NOVÉ ID konverzace.
Vlákna konverzací	threads	array of object	Vytvořili jste vlákno konverzace.
ID vlákna	threads.id	string	Nové ID vlákna.

NewConversationThreadResponse

Name	Cesta	Typ	Description
ID vlákna konverzace	id	string	ID nového vlákna konverzace

ConversationTriggerResponse

Když přijde nový e-mail, aktivuje se odpověď.

Name	Cesta	Typ	Description
ID konverzace	id	string	Jedinečný identifikátor konverzace.
Časové razítko posledního doručení	lastDeliveredDateTime	date-time	Typ časového razítka představuje informace o datu a čase pomocí formátu ISO 8601 a vždy je v čase UTC.
threads	threads	array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Objekt vlákna konverzace

Name	Cesta	Typ	Description
ID vlákna konverzace	id	string	Jedinečný identifikátor vlákna konverzace.
odesílá	posts	array of PostTriggerResponse

PostTriggerResponse

Představuje jednotlivé položky Post v rámci entity conversationThread.

Name	Cesta	Typ	Description
ID příspěvku	id	string	Jedinečný identifikátor příspěvku.
Časové razítko poslední změny příspěvku	lastModifiedDateTime	date-time
Změnit klíč	changeKey	string	Identifikuje verzi příspěvku.

ObjectWithoutType