Microsoft Teams Connector

Microsoft 365 Connector

Für die Integration mit Microsoft-Anwendungen wie Teams, Outlook und Office Suite.

Zweck

Verwenden Sie dieses Dokument, um Ihre Tulip Apps mit Microsoft 365 Produkten wie Teams, Office Suite und Outlook zu integrieren.

Vorraussetzungen

API-Dokument

Microsoft Graph API-Dokumentation

Erforderliche Bereiche für diesen Connector

Funktionen des Connectors

1) Alle Teams abrufen

Zweck

Dieser Connector 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 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. 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, der 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