Udostępnij przez


Poczta grupowa Office 365

Łącznik Poczty grup usługi Office 365 umożliwia użytkownikom pracę z danymi znajdującymi się w skrzynce pocztowej grupy usługi Office 365. Funkcjonalność tego łącznika działa niezależnie od osobistej skrzynki pocztowej pojedynczego użytkownika i umożliwia użytkownikom pracę z dowolną grupą, do której mogą uzyskiwać dostęp w organizacji. Łącznik działa poza interfejsem API programu Microsoft Graph i używa terminologii określonej w dokumentacji grup usługi Office 365 w interfejsie API programu Graph. Dowiedz się więcej w dokumentacji łącznika.

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate
Logic Apps Standard Wszystkie regiony usługi Logic Apps
Power Apps Standard Wszystkie regiony usługi Power Apps
Power Automate Standard Wszystkie regiony usługi Power Automate
Kontakt
Name Microsoft
adres URL Obsługa usługi Microsoft LogicApps
Pomoc techniczna usługi Microsoft Power Automate
Obsługa usługi Microsoft Power Apps
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://docs.microsoft.com/en-us/graph/api/resources/groups-overview?view=graph-rest-1.0
Kategorie Produktywność

Wymagania wstępne

Aby korzystać z tego łącznika, musisz mieć konto użytkownika, które ma dostęp do grup usługi Office 365 w organizacji.

Zalecamy również zapoznanie się z dokumentacją interfejsu API programu Microsoft Graph dla grup platformy Microsoft 365 , aby zrozumieć sposób, w jaki dane są ustrukturyzowane w obrębie interfejsu API. Istnieje kluczowa terminologia, którą należy przejrzeć przed użyciem tego łącznika, na przykład "konwersacja", "thread" i "post".

Znane problemy i ograniczenia

W przypadku rozwiązywania problemów z błędem "Określony obiekt nie został znaleziony w magazynie", można wykonać następujące czynności:

  • Sprawdź uprawnienia dla konta.
  • Spróbuj usunąć bieżące połączenie poczty grup usługi Office 365 i utwórz nowe.

Uzyskiwanie dostępu do grup publicznych bez członkostwa

Uwierzytelniony użytkownik może uzyskać dostęp do danych grupy z grup, które są członkami grupy i dowolnej grupy "publicznej" w organizacji. W środowisku łącznika podczas wybierania grupy łącznik oferuje dynamiczną listę rozwijaną grup do wyboru. W przypadku środowiska czystszego ta lista rozwijana jest wypełniana automatycznie tylko przy użyciu grup, do których należy uwierzytelniony użytkownik.

Aby uzyskać dostęp do grup publicznych w organizacji, które nie są wypełnione na liście rozwijanej, musisz podać identyfikator grupy na liście rozwijanej łącznika, przewijając do samego dołu i wybierając pozycję Wprowadź wartość niestandardową.

Aby znaleźć identyfikator grupy w organizacji, wykonaj następujące kroki:

  1. Przejdź do Eksploratora programu Microsoft Graph i uwierzytelnij się przy użyciu użytkownika w lewym górnym rogu.

  2. W sekcji Przykładowe zapytania wybierz pozycję Grupy, a następnie pobierz wszystkie grupy w mojej organizacji.

  3. W wersji zapoznawczej Odpowiedź znajdź grupę w organizacji, której szukasz. Podaj wartość we id właściwości jako wartość niestandardową w środowisku listy rozwijanej łącznika.

  4. Upewnij się, że widoczność grupy jest ustawiona na Publiczna lub użytkownik nie będzie mógł uzyskać dostępu do danych w grupie.

  5. Jeśli nie możesz znaleźć grupy, może być konieczne wyszukanie na następnej stronie wyników, do której można uzyskać dostęp, kopiując link i @odata.nextLink uruchamiając je jako zapytanie w górnej części strony.

Wyzwalacze poczty

Jeśli jednocześnie wysłano wiele wiadomości e-mail, niektóre wiadomości e-mail mogą zostać pominięte przez wyzwalacz. Jest to spowodowane podstawowymi ograniczeniami systemu z opóźnieniami przetwarzania wiadomości e-mail, które powodują, że wiadomości e-mail stają się "widoczne" późno (po przetworzeniu partii zawierającej spóźnioną wiadomość e-mail).

Informacje o wycofaniu

Operacja "Prześlij dalej post" została tymczasowo przestarzała z powodu braku obsługi kontroli eksfiltracji poczty e-mail dla tego łącznika. Pracujemy nad zapewnieniem pomocy technicznej i zaktualizujemy operację po zakończeniu.

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund
Częstotliwość sond wyzwalacza 1 60 sekund

Akcje

Odpowiadanie na wątek konwersacji

Odpowiedz na wątek w konwersacji grupowej i dodaj do niego nowy wpis.

Odpowiedz na wpis

Odpowiedz na wpis i dodaj nowy wpis do określonego wątku w konwersacji grupowej.

Pobieranie konwersacji grupowej

Pobiera właściwości określonej konwersacji.

Pobieranie wpisu wątku

Pobiera wpis w określonym wątku.

Pobieranie wątku konwersacji

Pobierz określony wątek należący do grupy.

Prześlij dalej wpis (wersja zapoznawcza)

Prześlij wpis do adresata.

Prześlij dalej wpis [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Prześlij dalej wpis .

Prześlij wpis do adresata.

Rozpocznij nową konwersację grupową, tworząc wątek

Rozpocznij nową konwersację grupową, tworząc najpierw wątek.

Tworzenie nowej konwersacji w grupie

Utwórz nową konwersację w tej grupie.

Tworzenie wątku konwersacji

Utwórz nowy wątek w określonej konwersacji.

Usuwanie wątku konwersacji

Usuwa określony wątek konwersacji.

Wysyłanie żądania HTTP

Skonstruuj żądanie interfejsu API REST programu Microsoft Graph do wywołania. Dowiedz się więcej: https://docs.microsoft.com/en-us/graph/use-the-api

Wyświetlanie listy konwersacji grupy

Pobierz wszystkie konwersacje w tej grupie.

Wyświetlanie listy wpisów wątku konwersacji

Pobierz wszystkie wpisy określonego wątku konwersacji.

Wyświetlanie listy wątków grupy

Pobierz wszystkie wątki grupy.

Wyświetlanie listy wątków konwersacji konwersacji

Pobierz wszystkie wątki w konwersacji grupowej.

Wyświetlanie listy załączników wpisu

Pobierz listę załączników należących do wpisu.

Odpowiadanie na wątek konwersacji

Odpowiedz na wątek w konwersacji grupowej i dodaj do niego nowy wpis.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Content
content True html

Zawartość nowej konwersacji.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Address
Address email

Adres e-mail.

Nazwa załącznika
Name True string

Nazwa załącznika.

Zawartość załącznika
ContentBytes True byte

Zawartość załącznika.

Odpowiedz na wpis

Odpowiedz na wpis i dodaj nowy wpis do określonego wątku w konwersacji grupowej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Identyfikator wpisu
postId True string

Wprowadź identyfikator wpisu.

Content
content True html

Zawartość nowej konwersacji.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Address
Address email

Adres e-mail.

Nazwa załącznika
Name True string

Nazwa załącznika.

Zawartość załącznika
ContentBytes True byte

Zawartość załącznika.

Pobieranie konwersacji grupowej

Pobiera właściwości określonej konwersacji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator konwersacji
conversationId True string

Wprowadź identyfikator konwersacji.

Zwraca

Obiekt konwersacji.

Pobieranie wpisu wątku

Pobiera wpis w określonym wątku.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Identyfikator wpisu
postId True string

Wprowadź identyfikator wpisu.

Zwraca

Reprezentuje pojedynczy element Post w jednostce conversationThread.

Body
Post

Pobieranie wątku konwersacji

Pobierz określony wątek należący do grupy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Zwraca

Obiekt wątku konwersacji.

Prześlij dalej wpis (wersja zapoznawcza)

Prześlij wpis do adresata.

Parametry

Nazwa Klucz Wymagane Typ Opis
Poczta grupowa
groupMail True string

Wybierz grupę z listy rozwijanej lub wprowadź adres e-mail grupy.

Identyfikator konwersacji
conversationId True string

Wprowadź identyfikator konwersacji.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Identyfikator wpisu
postId True string

Wprowadź identyfikator wpisu.

Comment
Comment html

Komentarz do przodu z wpisem.

Address
Address email

Adres e-mail.

Prześlij dalej wpis [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Prześlij dalej wpis .

Prześlij wpis do adresata.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Identyfikator wpisu
postId True string

Wprowadź identyfikator wpisu.

Comment
comment string

Komentarz do przodu z wpisem.

Address
Address email

Adres e-mail.

Rozpocznij nową konwersację grupową, tworząc wątek

Rozpocznij nową konwersację grupową, tworząc najpierw wątek.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Nowy temat
topic True string

Temat nowej konwersacji.

Content
content True html

Zawartość nowej konwersacji.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Address
Address email

Adres e-mail.

Nazwa załącznika
Name True string

Nazwa załącznika.

Zawartość załącznika
ContentBytes True byte

Zawartość załącznika.

Zwraca

Tworzenie nowej konwersacji w grupie

Utwórz nową konwersację w tej grupie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Nowy temat
topic True string

Temat nowej konwersacji.

Content
content True html

Zawartość nowej konwersacji.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Address
Address email

Adres e-mail.

Nazwa załącznika
Name True string

Nazwa załącznika.

Zawartość załącznika
ContentBytes True byte

Zawartość załącznika.

Zwraca

Odpowiedź z utworzonymi szczegółami konwersacji.

Utworzony obiekt konwersacji
CreateConversationResponse

Tworzenie wątku konwersacji

Utwórz nowy wątek w określonej konwersacji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator konwersacji
conversationId True string

Wprowadź identyfikator konwersacji.

Nowy temat
topic True string

Temat nowej konwersacji.

Content
content True html

Zawartość nowej konwersacji.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Address
Address email

Adres e-mail.

Nazwa załącznika
Name True string

Nazwa załącznika.

Zawartość załącznika
ContentBytes True byte

Zawartość załącznika.

Zwraca

Usuwanie wątku konwersacji

Usuwa określony wątek konwersacji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Wysyłanie żądania HTTP

Skonstruuj żądanie interfejsu API REST programu Microsoft Graph do wywołania. Dowiedz się więcej: https://docs.microsoft.com/en-us/graph/use-the-api

Parametry

Nazwa Klucz Wymagane Typ Opis
URI
Uri True string

Pełny lub względny identyfikator URI. Przykład: https://graph.microsoft.com/{version}/{resource}.

Metoda
Method True string

Metoda HTTP (wartość domyślna to GET).

Body
Body binary

Zawartość treści żądania.

Typ zawartości
ContentType string

Nagłówek content-type treści (wartość domyślna to application/json).

CustomHeader1
CustomHeader1 string

Nagłówek niestandardowy 1. Określ w formacie: nazwa-nagłówka: nagłówek-wartość

CustomHeader2
CustomHeader2 string

Nagłówek niestandardowy 2. Określ w formacie: nazwa-nagłówka: nagłówek-wartość

CustomHeader3
CustomHeader3 string

Nagłówek niestandardowy 3. Określ w formacie: nazwa-nagłówka: nagłówek-wartość

CustomHeader4
CustomHeader4 string

Nagłówek niestandardowy 4. Określ w formacie: nazwa-nagłówka: nagłówek-wartość

CustomHeader5
CustomHeader5 string

Nagłówek niestandardowy 5. Określ w formacie: nazwa-nagłówka: nagłówek-wartość

Zwraca

Wyświetlanie listy konwersacji grupy

Pobierz wszystkie konwersacje w tej grupie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of Conversation

Wyświetlanie listy wpisów wątku konwersacji

Pobierz wszystkie wpisy określonego wątku konwersacji.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of Post

Tablica zawierająca wpisy w określonym wątku.

Wyświetlanie listy wątków grupy

Pobierz wszystkie wątki grupy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of ConversationThread

Wyświetlanie listy wątków konwersacji konwersacji

Pobierz wszystkie wątki w konwersacji grupowej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator konwersacji
conversationId True string

Wprowadź identyfikator konwersacji.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of ConversationThread

Wyświetlanie listy załączników wpisu

Pobierz listę załączników należących do wpisu.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Identyfikator wątku
threadId True string

Wprowadź identyfikator wątku konwersacji.

Identyfikator wpisu
postId True string

Wprowadź identyfikator wpisu.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of Attachment

Tablica zawierająca załączniki wpisu.

Wyzwalacze

Po nadejściu nowej wiadomości e-mail do grupy

Po nadejściu nowej wiadomości e-mail do grupy.

Po nadejściu nowej wiadomości e-mail do grupy

Po nadejściu nowej wiadomości e-mail do grupy.

Parametry

Nazwa Klucz Wymagane Typ Opis
Identyfikator grupy
groupId True string

Wybierz grupę z listy rozwijanej lub wprowadź identyfikator grupy.

Zwraca

Nazwa Ścieżka Typ Opis
value
value array of ConversationTriggerResponse

Odpowiedź wyzwalacza.

Definicje

Konwersacja

Obiekt konwersacji.

Nazwa Ścieżka Typ Opis
Identyfikator konwersacji
id string

Unikatowy identyfikator konwersacji.

Temat konwersacji
topic string

Temat konwersacji.

Czy załączniki?
hasAttachments boolean

Wskazuje, czy którykolwiek z wpisów w tej konwersacji ma co najmniej jeden załącznik.

Sygnatura czasowa ostatniego dostarczenia
lastDeliveredDateTime date-time

Typ znacznika czasu reprezentuje informacje o dacie i godzinie przy użyciu formatu ISO 8601 i są zawsze w czasie UTC.

Tablica unikatowych nadawców
uniqueSenders array of string

Wszyscy użytkownicy, którzy wysłali wiadomość do tej konwersacji.

Preview
preview string

Krótkie podsumowanie treści najnowszego wpisu w tej konwersacji.

Wątek konwersacji

Obiekt wątku konwersacji.

Nazwa Ścieżka Typ Opis
Identyfikator wątku konwersacji
id string

Unikatowy identyfikator wątku konwersacji.

Temat konwersacji
topic string

Temat konwersacji.

Czy załączniki?
hasAttachments boolean

Wskazuje, czy którykolwiek z wpisów w tej konwersacji ma co najmniej jeden załącznik.

Sygnatura czasowa ostatniego dostarczenia
lastDeliveredDateTime date-time

Typ znacznika czasu reprezentuje informacje o dacie i godzinie przy użyciu formatu ISO 8601 i są zawsze w czasie UTC.

Tablica unikatowych nadawców
uniqueSenders array of string

Wszyscy użytkownicy, którzy wysłali wiadomość do tej konwersacji.

Preview
preview string

Krótkie podsumowanie treści najnowszego wpisu w tej konwersacji.

Czy jest zablokowany?
isLocked boolean

Wskazuje, czy wątek jest zablokowany.

toRecipients
toRecipients array of EmailAddress

Adresaci do: dla wątku.

ccRecipients
ccRecipients array of EmailAddress

Adresaci DW: dla wątku.

Post

Reprezentuje pojedynczy element Post w jednostce conversationThread.

Nazwa Ścieżka Typ Opis
Identyfikator wpisu
id string

Unikatowy identyfikator wpisu.

Utworzony znacznik czasu wpisu
createdDateTime date-time
Znacznik czasu ostatniej modyfikacji wpisu
lastModifiedDateTime date-time
Zmień klucz
changeKey string

Identyfikuje wersję wpisu.

Identyfikator konwersacji
conversationId string

Unikatowy identyfikator konwersacji, do którego należy wpis.

Identyfikator wątku konwersacji
conversationThreadId string

Unikatowy identyfikator wątku konwersacji, do którego należy wpis.

Kategorie
categories array of string

Kategorie skojarzone z wpisem.

Odebrano znacznik czasu
receivedDateTime date-time

Znacznik czasu otrzymany po otrzymaniu.

Czy załączniki?
hasAttachments boolean

Wskazuje, czy wpis ma co najmniej jeden załącznik.

Nowi uczestnicy
newParticipants array of EmailAddress

Uczestnicy konwersacji, którzy zostali dodani do wątku w ramach tego wpisu.

body
body ItemBody

Reprezentuje właściwości treści elementu, takie jak komunikat, zdarzenie lub wpis grupy.

z
from EmailAddress
nadawca
sender EmailAddress
attachments
attachments array of Attachment

Attachment

Nazwa Ścieżka Typ Opis
Identyfikator załącznika
id string

Identyfikator załącznika.

Nazwa załącznika
name string

Nazwa załącznika.

Typ zawartości załącznika
contentType string

Typ zawartości załącznika.

Rozmiar załącznika
size integer

Rozmiar załącznika.

Bajty zawartości załącznika
contentBytes byte

Zawartość załącznika.

Adres e-mail

Nazwa Ścieżka Typ Opis
Nazwa użytkownika
emailAddress.name string
Adres e-mail użytkownika
emailAddress.address email

ItemBody

Reprezentuje właściwości treści elementu, takie jak komunikat, zdarzenie lub wpis grupy.

Nazwa Ścieżka Typ Opis
Typ zawartości treści
contentType string

Typ zawartości treści.

Zawartość treści
content string

Zawartość treści.

CreateConversationResponse

Odpowiedź z utworzonymi szczegółami konwersacji.

Nazwa Ścieżka Typ Opis
Identyfikator konwersacji
id string

Nowy identyfikator konwersacji.

Wątki konwersacji
threads array of object

Utworzono wątek konwersacji.

Identyfikator wątku
threads.id string

Nowy identyfikator wątku.

NewConversationThreadResponse

Nazwa Ścieżka Typ Opis
Identyfikator wątku konwersacji
id string

Nowy identyfikator wątku konwersacji.

ConversationTriggerResponse

Po nadejściu nowej wiadomości e-mail zostanie wyzwolna odpowiedź.

Nazwa Ścieżka Typ Opis
Identyfikator konwersacji
id string

Unikatowy identyfikator konwersacji.

Sygnatura czasowa ostatniego dostarczenia
lastDeliveredDateTime date-time

Typ znacznika czasu reprezentuje informacje o dacie i godzinie przy użyciu formatu ISO 8601 i są zawsze w czasie UTC.

threads
threads array of ConversationThreadTriggerResponse

ConversationThreadTriggerResponse

Obiekt wątku konwersacji.

Nazwa Ścieżka Typ Opis
Identyfikator wątku konwersacji
id string

Unikatowy identyfikator wątku konwersacji.

Posty
posts array of PostTriggerResponse

PostTriggerResponse

Reprezentuje pojedynczy element Post w jednostce conversationThread.

Nazwa Ścieżka Typ Opis
Identyfikator wpisu
id string

Unikatowy identyfikator wpisu.

Znacznik czasu ostatniej modyfikacji wpisu
lastModifiedDateTime date-time
Zmień klucz
changeKey string

Identyfikuje wersję wpisu.

ObjectWithoutType