Integracja z Microsoft Teams
Integracja Microsoft Teams z łącznikiem Microsoft Graph API
Integracja z Microsoft Teams
Integracja Microsoft Teams z łącznikiem Microsoft Graph API
Możliwości integracji z Microsoft Teams są zawarte w łączniku Microsoft Graph API (dawniej znanym jako łącznik Entra ID ).
Dzięki łącznikowi Microsoft Graph API Connector możesz odczytywać dane z Microsoft Teams. Od wersji 2025.2 możesz również wykonywać działania w Microsoft Teams i wprowadzać zmiany w środowisku Teams. Łącznie te możliwości zapewniają wymierne korzyści biznesowe w czterech kluczowych obszarach:
Lepsza widoczność i kontrola: dostęp niemal w czasie rzeczywistym do danych powiązanych z usługą Microsoft Teams, takich jak użytkownicy, kanały i członkostwa w zespołach.
Automatyzacja i efektywność: Zautomatyzowane działania redukują wysiłek ręczny, przyspieszają czas reakcji i usprawniają procesy.
Strategiczna integracja i innowacja: Płynna integracja z innymi systemami informatycznymi umożliwia zaawansowaną automatyzację, lepsze zarządzanie i wspiera szersze inicjatywy transformacji cyfrowej.
Integrację z Microsoft Teams można utworzyć za pomocą łącznika Microsoft Graph API .
Instrukcje dla klientów można znaleźć na stronie https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
Dokumentacja Microsoft Graph API dotycząca integracji z Teams: https://learn.microsoft.com/en-us/graph/api/resources/teams-api-overview?view=graph-rest-1.0
Przykłady przypadków użycia Teams to:
- Wysyłanie wiadomości powiadomień do zespołów
- Zespoły czytające i przekazujące informacje do ITSM
- Zarządzanie członkostwem w zespole
- Zarządzanie cyklem życia zespołu
- Walidacja własności zespołu
- Integracja z procesami cyklu życia użytkownika
- Tworzenie zespołu sterowanego zdarzeniami
Przeczytaj o zespołach Microsoft Teams
Uprawnienia aplikacji platformy Azure
W przypadku importu do aplikacji Teams aplikacja na Azure wymaga następujących uprawnień
Instrukcje dla klientów można znaleźć na stronie https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id
| Typ uprawnienia | Uprawnienia |
| Aplikacja |
Grupa.Odczyt.Wszystko, Zespół.Odczyt.Podstawowy.Wszystko I (Channel.ReadBasic.All lub Channel.Read.All) |
Zapytania dotyczące zaplanowanych zadań
Zapytanie: grupy?$filter=resource Pro visioningOptions/Any(x:x eq 'Zespół')
Podzapytania:
zespoły/{id}/kanały
zespoły/{id}/członkowie
Mapowania dla zaplanowanych zadań
Zawsze używaj szablonu ogólnego dla mapowań zespołów. Typ:
| Atrybut zewnętrzny | Atrybut lokalny | Więcej informacji |
|---|---|---|
| id | identyfikator_zespołu | Unikalny identyfikator zespołu |
| nazwa wyświetlana | nazwa_wyświetlana_zespołu | |
| opis | opis_zespołu | |
| widoczność | widoczność_zespołu | Zespół publiczny lub prywatny |
| zespoły/{id}/kanały.id | identyfikator kanału |
Lista identyfikatorów kanałów zespołu Ten atrybut musi być wielowartościowy |
| zespoły/{id}/członkowie.identyfikator użytkownika | członkowie_zespołu |
Lista identyfikatorów członków zespołu Ten atrybut musi być wielowartościowy |
Otwarty temat: Czy lepszym rozwiązaniem byłoby pobranie również szczegółów kanału (nazwy wyświetlanej, opisu itd.) do innego atrybutu wielowartościowego w tym zaplanowanym zadaniu, czy też pobranie ich kanał po kanale z węzła orkiestracji przepływu pracy?
Zadania (akcje) oparte na zdarzeniach dla zespołów i kanałów Microsoft
Uprawnienia aplikacji platformy Azure
W przypadku akcji Teams aplikacja na Azure wymaga uprawnień. Aby ustawić prawidłowe uprawnienia, zobacz: https://docs.efecte.com/customer-instructions/efecte-provisioning-engine-customer-instructions-for-entra-id i https://learn.microsoft.com/en-us/graph/permissions-reference
Zadanie oparte na zdarzeniach
Adres URL zadania opartego na zdarzeniach może być pusty. Ostateczny adres URL do wywołania jest tworzony poprzez połączenie adresu URL łącznika i adresu URL węzła przepływu pracy.
Mapowania dla zadań opartych na zdarzeniach
Nagłówek zadania opartego na zdarzeniach
Nie ma potrzeby ustawiania dodatkowych nagłówków, ponieważ zarządzanie złączami ustawia to automatycznie:
| Typ zawartości | aplikacja/json |
Węzeł przepływu pracy
W węźle Workflow Orchestration wybierz opcje Orchestrate, Data Source i Activity:
Wybierz zadanie oparte na zdarzeniu utworzone dla tej akcji. Możesz również użyć jednego zadania opartego na zdarzeniu dla wielu akcji.
Większość tych akcji korzysta z metody POST protokołu HTTP. Pamiętaj o ustawieniu prawidłowej metody dla węzła Workflow Orchestration dla tych akcji.
Wyślij komentarz tekstowy/powiadomienie do kanału zespołu
Akcja : POST
URL : teams/{team-id}/channels/{channel-id}/messages
Przykład ciała :
Dokumentacja firmy Microsoft dotycząca API
Uzyskaj informacje o kanale
Akcja : GET
URL : teams/{team-id}/channels/{channel-id}
Treść: (brak)
W Workflow przeanalizuj wynik JSON z atrybutu „ REST response attribute”, aby utworzyć referencyjną kartę danych kanału.
Przykład zwróconego zestawu wyników JSON, gdy zespół {team-id} zawiera 2 kanały:
Utwórz zespół
Akcja : POST
URL : teams
Przykład ciała:
Dokumentacja firmy Microsoft dotycząca API
Aktualizuj zespół
Akcja : PATCH
URL : teams/{team-id}
Przykład ciała :
Dokumentacja firmy Microsoft dotycząca API
Archiwizuj zespół
Akcja : POST
URL : teams/{id}/archive
Przykład treści : {"shouldSetSpoSiteReadOnlyForMembers": true}
Dokumentacja firmy Microsoft dotycząca API
Dodaj członka(ów) do zespołu
Akcja : POST
URL : /teams/{team-id}/members
Przykład ciała:
Dokumentacja firmy Microsoft dotycząca API
Usuń członka z zespołu
Akcja : DELETE
URL : /teams/{identyfikator-zespołu}/members/{identyfikator-członkostwa}
Treść : (brak)
https://learn.microsoft.com/en-us/graph/api/team-delete-members?view=graph-rest-1.0&tabs=http
Uprawnienia aplikacji Microsoft dla zespołów i kanałów
Dodaj odpowiednie uprawnienia na podstawie potrzeb danego przypadku użycia.
Typ zakresu użytkownika Aplikacja :
| Działanie | Pozwolenie | Notatki |
|---|---|---|
| Odkryj zespoły | Zespół.ReadBasic.All | Wymień wszystkie zespoły w dzierżawie. |
| Zarządzaj ustawieniami zespołu | Ustawienia zespołu.OdczytZapis.Wszystko | Odczyt/aktualizacja ustawień zespołu. Nieobsługiwane w przypadku osobistych kont Microsoft. |
| Utwórz kanały (dowolny zespół) | Kanał.Utwórz | Utwórz standardowe/prywatne kanały w dowolnym zespole. |
| Odczyt kanałów (metadane) | Kanał.OdczytPodstawowy.Wszystko | Przeczytaj listę kanałów i podstawowe informacje o dzierżawcy. |
| Odczytaj ustawienia kanału | Ustawienia kanału.Odczyt.Wszystkie | Przeczytaj wszystkie właściwości/ustawienia kanału. |
| Edytuj ustawienia kanału | Ustawienia kanału.Odczyt/Zapis.Wszystkie | Zmień nazwę kanału, opis i ustawienia moderacji. |
| Zarządzaj członkostwem w zespole | Członek zespołu.OdczytZapisWszystko | Dodawaj/usuwaj członków i zmieniaj role (dodawanie gości nie jest obsługiwane). |
| Przeczytaj członkostwo w kanale | Członek kanału.Przeczytaj.Wszystko | Przeczytaj członkostwo we wszystkich standardowych/prywatnych/udostępnianych kanałach. |
| Zarządzaj członkostwem w kanale | Członek kanału.OdczytZapisWszystko | Dodawaj/usuwaj/aktualizuj członków w kanałach prywatnych/udostępnianych. |
| Odczyt wiadomości kanałowych | ChannelMessage.Read.All | Odczytaj wszystkie komunikaty kanałowe w obrębie dzierżawy (zgodność/audyt). |
Znane ograniczenia
Ograniczenia w wersji 2025.2 i starszych
Ze względów wydajnościowych nie jest obsługiwany więcej niż jeden poziom podzapytań.
Nie jest obsługiwane więcej niż jedno podzapytanie.
Łącznik nie obsługuje jeszcze oznaczania obiektów zespołów/kanałów jako usuniętych w Matrix42 Core , Pro , IGA po usunięciu obiektu z Microsoft Teams.