Microsoft Teams Connector

::: (info) () Um die App herunterzuladen, besuchen Sie: Bibliothek:::

Microsoft Teams Anschluss

Tulip Integration mit Microsoft Teams

Einführung

Microsoft Teams API ermöglicht es den Benutzern, Microsoft Teams und Kanäle innerhalb von Teams zu erstellen, zu lesen und zu bearbeiten, wenn sie den richtigen Zugang zu ihren Microsoft-Konten haben. Das Ziel dieses Connectors ist es, Tulip mit Microsofts Graph API (v1.0) unter Verwendung von HTTP Connectors zu integrieren und unseren Kunden einen Out-of-Box-Connector zu bieten, der in ihre Instanz importiert werden kann.

Zweck

Wir werden verschiedene Konnektor-Funktionen hervorheben, die durch HTTP-Aufrufe an Microsofts Graph API (v1.0) erstellt werden können, um mit M365 Teams zu interagieren und verschiedene Lese- und Schreibaktionen auf den Teams zu zeigen, die für verschiedene Anwendungsfälle genutzt werden können.

API-Dokument

Microsoft Graph API-Dokumentation

Vorraussetzungen

1. Erstellen Sie ein Konto bei Microsoft 365 und konfigurieren Sie die OAuth 2.0-Anmeldedaten in Microsoft Entra ID.
2. Registrieren Sie die API mit den erforderlichen Bereichen im Microsoft-Portal. Azure - Entra ID

Video zum Einrichten des Konnektors für Excel:

Sie können die gleichen Schritte befolgen, um auch den Teams-Connector einzurichten.

Details zur Tulip-Verbindung

Die folgenden Informationen müssen bei Tulip konfiguriert werden

Konnektoren.

1. Läuft auf: Cloud Connector Host
2. Rechner: graph.microsoft.com
3. Anschluss:443
4. TLS: Ja

OAuth 2: Die Authentifizierung wird an alle

die Connector-Funktionen

**Wichtig zu beachten:**1. Es handelt sich um eine Tulip zu Microsoft Verbindung über https. 2. Der Zugang wird durch die Authentifizierung auf der Microsoft-Seite kontrolliert. Je nachdem, welches Teams-Konto zur Authentifizierung verwendet wird, hat der Benutzer denselben Zugang. In den Connector-Funktionen können Sie die Berechtigungen und Zugriffsebenen weiter konfigurieren.

Konnektor-Funktionen

1) Alle Teams abrufen

Zweck

Dieser Konnektor ruft alle Teams ab, denen ein Benutzer über sein Microsoft Teams-Konto angehört.

Endpunkt

HTTP GET-Aufruf an den Endpunkt - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

Erforderliche Eingabe

Keine Eingaben erforderlich

Erforderliche Ausgabe Extraktor

1. teamID: Eindeutiger Bezeichner des Teams, das für die Ausführung der anderen Aufgaben verwendet wird.
2. teamName: Der Anzeigename des Teams.
3. teamBeschreibung: Die Beschreibung des Teams.

2) Alle Channels eines Teams abrufen

Zweck

Dieser Konnektor ruft alle Kanäle eines Teams ab, indem er die teamID als Eingabe übergibt.

Endpunkt

HTTP GET-Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Erforderliche Eingabe

Die folgenden URL-Parameter sind zu übergeben

1. Team-ID

Erforderlicher Output-Extraktor

1. channelId: Eindeutiger Bezeichner des Kanals, der für die Ausführung der anderen Aufgaben verwendet wird.
2. channelName: Der Anzeigename des Channels.
3. channelBeschreibung: Die Beschreibung des Channels.

3) Einen neuen Channel erstellen

Zweck

1. Der Benutzer kann eine Team-ID, einen Kanalnamen und eine Kanalbeschreibung als Eingabe übergeben und Tulip erstellt einen neuen Kanal mit dem angegebenen Kanalnamen. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Kanals. Diese können weiter verwendet werden, um Daten aus dem Kanal zu holen und zu aktualisieren.
2. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder in Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die in andere Connector-Funktionen geleitet werden.

Endpunkt

HTTP POST-Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

Erforderliche Eingabe

Die folgenden Parameter werden als Request Body gesendet

1. Team-ID
2. Kanal-Name
3. Channel-Beschreibung

Erforderlicher Output Extraktor

1. channelId: Eindeutiger Bezeichner des Channels, der für die Ausführung der anderen Aufgaben verwendet wird.
2. channelName:Der Anzeigename des Channels.
3. channelDescription:Die Beschreibung des Channels.

4) Channel-Eigenschaften aktualisieren

Zweck

1. Benutzer können eine Team-ID, eine Kanal-ID, einen neuen Kanalnamen und eine neue Kanalbeschreibung als Eingabe übergeben. Tulip aktualisiert einen neuen Kanal mit dem neuen Kanalnamen und der neuen Beschreibung. Die Antwort der API besteht aus den Metadaten und verschiedenen Eigenschaften des Kanals. Diese können weiter verwendet werden, um Daten aus dem Kanal zu holen und zu aktualisieren.
2. Die Informationen, die aus der Microsoft Graph V1.0 API gezogen werden, können dann entweder innerhalb von Tulip-Anwendungen, Tulip-Tabellen oder Tulip-Variablen weiterverwendet werden, die dann in andere Connector-Funktionen geleitet werden.

Endpunkt

HTTP PATCH-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Erforderliche Eingabe

Im Folgenden sind die Parameter aufgeführt, die als Teil der URL und/oder des Request Body gesendet werden

1. Team-ID
2. Kanal-ID
3. Kanal-Name
4. Channel-Beschreibung

Erforderlicher Output-Extraktor

Wir benötigen keinen Output-Extraktor.

5) Senden einer Nachricht an einen Channel

Zweck

Benutzer können eine Team-ID, eine Kanal-ID, einen Betreff und einen Nachrichteninhalt als Eingabe übergeben und Tulip sendet eine Nachricht mit dem angegebenen Nachrichteninhalt.

Endpunkt

HTTP POST-Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

Erforderliche Eingaben

Im Folgenden sind die Parameter aufgeführt, die als Teil der URL und/oder des Request Body gesendet werden

1. Team-ID
2. Kanal-ID
3. Betreff
4. Inhalt der Nachricht

Erforderlicher Output-Extraktor

Wir benötigen keinen Output-Extraktor.

6) Alle Nachrichten eines bestimmten Channels abrufen

Zweck

Dieser Konnektor holt alle Nachrichten eines bestimmten Channels ab.

Endpunkt

HTTP GET-Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

Erforderliche Eingabe

Im Folgenden sind die URL-Parameter aufgeführt, die übergeben werden müssen.

1. Team-ID
2. Kanal-ID

Erforderlicher Output-Extraktor

1. messageId: Eindeutiger Bezeichner der Nachricht, die für die Ausführung der anderen Aufgaben verwendet wird.
2. messageInhalt: Der Inhalt der Nachricht.
3. messageFrom: Der Anzeigename des Absenders.

7) Antwort auf eine Nachricht

Zweck

Benutzer können eine Team-ID, eine Kanal-ID, einen Betreff und den Inhalt der Nachricht als Eingabe übergeben, um auf eine Nachricht zu antworten & Tulip sendet eine Antwort mit dem Inhalt der Nachricht.

Endpunkt

HTTP POST-Aufruf an den Endpunkt - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

Erforderliche Eingabe

Die folgenden Parameter werden als Teil der URL und/oder des Request Body gesendet

1. Team-ID
2. Kanal-ID
3. Nachrichten-ID
4. Inhalt der Nachricht

Erforderlicher Output-Extraktor

Wir benötigen keinen Output-Extraktor.

8) Einen Channel löschen

Zweck

Benutzer können eine Team-ID und eine Kanal-ID als Eingabe übergeben und Tulip wird den spezifischen Kanal mit den angegebenen Eingaben löschen.

Endpunkt

HTTP DELETE Aufruf an den Endpunkt -https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}

Erforderliche Eingaben

Die folgenden URL-Parameter sind zu übergeben

1. Team-ID
2. Kanal-ID

Erforderlicher Output-Extraktor

Wir benötigen keinen Ausgabe-Extraktor.

9) Abrufen der Liste der Mitglieder eines Teams

Zweck

Dieser Connector ruft alle Mitglieder eines bestimmten Teams ab.

Endpunkt

HTTP GET-Aufruf an den Endpunkt https://graph.microsoft.com:443/v1.0/teams/{teamID}/members

Erforderliche Eingabe

Im Folgenden sind die URL-Parameter aufgeführt, die übergeben werden müssen.

1. Team-ID

Erforderlicher Output-Extraktor

1. Mitglied Id: Eindeutiger Bezeichner des Mitglieds.
2. Name des Mitglieds: Der Anzeigename des Mitglieds.
3. EmailID des Mitglieds: Die E-Mail-ID des Mitglieds.
4. Mitglied-Rolle: Die Rolle des Mitglieds im Team Channel.

Weitere Informationen

Hier finden Sie weitere Informationen zu Microsoft Connectors

• Microsoft Kalender-Connector
• Microsoft Outlook-Verbinder
• Microsoft Excel-Verbinder