Microsoft Teams コネクター

::: (info) () アプリをダウンロードするには、こちらをご覧ください：ライブラリ::：

Microsoft 365 コネクター

Teams、Outlook、Office SuiteなどのMicrosoftアプリとの統合用。

目的

このドキュメントを使用して、Tulip AppsをTeams、Office Suite、OutlookなどのMicrosoft 365製品と統合します。

前提条件

::: (info) () 注：このコネクタを使用する前に、Entra IDでOauth2認証情報を生成する必要があります。このガイドに従って、必要な認証情報を生成してください。
MS Graph APIをOauth2でTulipに接続する ::：

APIドキュメント

Microsoft Graph API ドキュメント

このコネクタに必要なスコープ

コネクタの機能

1) すべてのチームの取得

目的

このコネクタは、Microsoft teams アカウントを使用して、ユーザーが所属するすべてのチームを取得します。

エンドポイント

エンドポイントへのHTTP GETコール - https://graph.micrsoft.com:443/v1.0/me/joinedTeams

必要な入力

入力不要

必要な出力エクストラクタ

1. teamID: 他のタスクを実行するために使用されるチームの一意識別子。
2. teamName: チーム名：チームの表示名。
3. teamDescription: チームの説明：チームの説明。

2) チームの全チャンネルの取得

目的

このコネクタは、teamIDを入力として渡すことで、チームのすべてのチャンネルを取得します。

エンドポイント

エンドポイントへのHTTP GETコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

必要な入力

渡されるURLパラメータは以下のとおりです。

1. チームID

必要な出力 抽出

1. channelId：他のタスクを実行するために使用されるチャネルの一意の識別子。
2. channelName：チャネルの表示名。
3. channelDescription: チャネルの説明：チャネルの説明。

3) 新規チャネルの作成

目的

1. ユーザーは入力としてチームID、チャンネル名、チャンネルの説明を渡すことができ、Tulipは提供されたチャンネル名で新しいチャンネルを作成します。APIのレスポンスは、チャネルのメタデータとさまざまなプロパティになります。これはさらに、チャネルからデータを取得したり更新したりするために使用できます。
2. Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数の中でさらに使用することができます。

エンドポイント

エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels

必要な入力

リクエスト・ボディとして送信されるパラメータは以下のとおりです。

1. チームID
2. チャンネル名
3. チャンネル説明

必須出力 Extractor

1. channelId：他のタスクを実行するために使用されるチャンネルの一意の識別子。
2. channelName:チャネルの表示名。
3. channelDescription:チャネルの説明。

4) チャンネルプロパティの更新

目的

1. ユーザーは入力としてチームID、チャンネルID、新しいチャンネル名、新しいチャンネルの説明を渡すことができ、チューリップは提供された新しいチャンネル名と説明で新しいチャンネルを更新します。APIのレスポンスは、チャンネルのメタデータとさまざまなプロパティになります。これはさらに、チャネルからデータを取得したり更新したりするために使用できます。
2. Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数のいずれかでさらに使用することができます。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}へのHTTP PATCHコール。

必要な入力

以下は、URLやリクエストボディの一部として送信されるパラメータです。

1. チームID
2. チャンネルID
3. チャンネル名
4. チャンネル説明

必要な出力抽出器

出力エクストラクタは必要ありません。

5) チャンネルへのメッセージ送信

目的

ユーザーは、チームID、チャンネルID、件名、メッセージ内容を入力として渡すことができます。

エンドポイント

エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages

必要な入力

以下は、URLやリクエストボディの一部として送信されるパラメータです。

1. チームID
2. チャンネルID
3. 件名
4. メッセージ内容

必要な出力抽出器

出力抽出器は必要ありません。

6) 特定のチャンネルの全メッセージを取得する

目的

このコネクタは、特定のチャネルからすべてのメッセージを取得します。

エンドポイント

エンドポイントへのHTTP GETコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages

必須入力

渡される URL パラメータは以下のとおりです。

1. チームID
2. チャンネルID

必須出力エクストラクタ

1. messageId：他のタスクを実行するために使用されるメッセージの一意の識別子。
2. messageContent: メッセージの内容：Messageの内容。
3. messageFrom: 送信者の表示名：送信者の表示名。

7)メッセージへの返信

目的

チームID、チャンネルID、件名、メッセージ内容を入力することで、メッセージに返信することができます。

エンドポイント

エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies

必要な入力

以下は、URLやリクエストボディの一部として送信されるパラメータです。

1. チームID
2. チャンネルID
3. メッセージID
4. メッセージ内容

必要な出力抽出器

出力エクストラクタは必要ありません。

8) チャンネルの削除

目的

ユーザーは入力としてチームIDとチャンネルIDを渡すことができ、Tulipは提供された入力で特定のチャンネルを削除します。

エンドポイント

エンドポイント-https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}へのHTTP DELETEコール。

必要な入力

渡されるURLパラメータは以下のとおりです。

1. チームID
2. チャンネルID

必要な出力抽出器

出力エクストラクタは必要ありません。

9) チームメンバー一覧の取得

目的

このコネクタは、特定のチームのすべてのメンバーを取得します。

エンドポイント

エンドポイントhttps://graph.microsoft.com:443/v1.0/teams/{teamID}/membersへのHTTP GETコール。

必須入力

以下は、渡される URL パラメータです。

1. チームID

必須出力 抽出

1. メンバーID：メンバーの一意の識別子。
2. メンバー名：メンバーの表示名。
3. Member EmailID：メンバーのEメールID。
4. メンバー役割: メンバーの役割：チームチャンネルにおけるメンバーの役割。

その他の情報

Microsoft Connectorに関する詳細情報をご覧ください。

• Microsoft Calendarコネクタ
• Microsoft Outlookコネクタ
• Microsoft Excelコネクタ