- 印刷する
::: (info) () アプリをダウンロードするには、こちらをご覧ください:ライブラリ:::
Microsoft Teamsコネクタ
TulipとMicrosoft Teamsの統合
はじめに
Microsoft Teams APIを使用すると、ユーザーはMicrosoftアカウントに設定された適切なアクセス権で、Teams内のMicrosoftチームやチャンネルを作成、閲覧、編集できます。このコネクタの目的は、HTTPコネクタを使用してMicrosoftのグラフAPI(v1.0)を使用してMicrosoftとTulipを統合し、インスタンスにインポートできるアウトオブボックスコネクタをお客様に提供することです。
目的
我々は、様々なユースケースに活用することができるチーム上の様々な読み取りおよび書き込みアクションを紹介するために、M365チームと対話するために、MicrosoftのGraph API(v1.0)へのHTTPコールを行うことによって構築することができるさまざまなコネクタ機能を強調するつもりです。
APIドキュメント
前提条件
- Microsoft 365でアカウントを作成し、Microsoft Entra IDでOAuth 2.0の認証情報を設定する。
- Microsoft ポータルに必要なスコープで API を登録する。Azure - Entra ID
Excel 用コネクタのセットアップ動画です:
同じ手順に従って、チーム コネクタも設定できます。
チューリップ接続の詳細
以下の情報を Tulip の
コネクタ。
- 実行中: クラウド・コネクタ・ホスト
- ホスト:graph.microsoft.com
- ポート:443
- TLS: はい
OAuth 2: 認証はすべての
コネクタ機能
**重要な注意:**1.2.アクセスはマイクロソフト側の認証によって制御されます。アクセスはMicrosoft側の認証によって制御されます。認証に使用されるTeamsアカウントによって、ユーザーは同じアクセス権を持ちます。コネクタ機能では、権限とアクセスレベルをさらに設定できます。
コネクタ機能
1) すべてのTeamsを取得する
目的
このコネクタは、Microsoft teamsアカウントを使用して、ユーザーが所属するすべてのチームを取得します。
エンドポイント
エンドポイントへのHTTP GETコール - https://graph.micrsoft.com:443/v1.0/me/joinedTeams
必要な入力
入力不要
必要な出力エクストラクタ
- teamID: 他のタスクを実行するために使用されるチームの一意識別子。
- teamName: チーム名:チームの表示名。
- teamDescription: チームの説明:チームの説明。
2) チームの全チャンネルの取得
目的
このコネクタは、teamIDを入力として渡すことで、チームのすべてのチャンネルを取得します。
エンドポイント
エンドポイントへのHTTP GETコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels
必要な入力
渡されるURLパラメータは以下のとおりです。
- チームID
必要な出力 抽出
- channelId:他のタスクを実行するために使用されるチャネルの一意の識別子。
- channelName:チャネルの表示名。
- channelDescription: チャネルの説明:チャネルの説明。
3) 新規チャネルの作成
目的
- ユーザーは入力としてチームID、チャンネル名、チャンネルの説明を渡すことができ、Tulipは提供されたチャンネル名で新しいチャンネルを作成します。APIのレスポンスは、チャネルのメタデータとさまざまなプロパティになります。これはさらに、チャネルからデータを取得したり更新したりするために使用できます。
- Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数の中でさらに使用することができます。
エンドポイント
エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels
必要な入力
リクエスト・ボディとして送信されるパラメータは以下のとおりです。
- チームID
- チャンネル名
- チャンネル説明
必須出力 Extractor
- channelId:他のタスクを実行するために使用されるチャンネルの一意の識別子。
- channelName:チャネルの表示名。
- channelDescription:チャネルの説明。
4) チャンネルプロパティの更新
目的
- ユーザーは入力としてチームID、チャンネルID、新しいチャンネル名、新しいチャンネルの説明を渡すことができ、チューリップは提供された新しいチャンネル名と説明で新しいチャンネルを更新します。APIのレスポンスは、チャンネルのメタデータとさまざまなプロパティになります。これはさらに、チャネルからデータを取得したり更新したりするために使用できます。
- Microsoft Graph V1.0 APIから引き出された情報は、Tulipアプリ、Tulipテーブル、または他のコネクター関数にパイプされるTulip変数のいずれかでさらに使用することができます。
エンドポイント
エンドポイントhttps://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}へのHTTP PATCHコール。
必要な入力
以下は、URLやリクエストボディの一部として送信されるパラメータです。
- チームID
- チャンネルID
- チャンネル名
- チャンネル説明
必要な出力抽出器
出力エクストラクタは必要ありません。
5) チャンネルへのメッセージ送信
目的
ユーザーは、チームID、チャンネルID、件名、メッセージ内容を入力として渡すことができます。
エンドポイント
エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages
必要な入力
以下は、URLやリクエストボディの一部として送信されるパラメータです。
- チームID
- チャンネルID
- 件名
- メッセージ内容
必要な出力抽出器
出力抽出器は必要ありません。
6) 特定のチャンネルの全メッセージを取得する
目的
このコネクタは、特定のチャネルからすべてのメッセージを取得します。
エンドポイント
エンドポイントへのHTTP GETコール - https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}/messages
必須入力
渡される URL パラメータは以下のとおりです。
- チームID
- チャンネルID
必須出力エクストラクタ
- messageId:他のタスクを実行するために使用されるメッセージの一意の識別子。
- messageContent: メッセージの内容:Messageの内容。
- messageFrom: 送信者の表示名:送信者の表示名。
7)メッセージへの返信
目的
チームID、チャンネルID、件名、メッセージ内容を入力することで、メッセージに返信することができます。
エンドポイント
エンドポイントへのHTTP POSTコール - https://graph.microsoft.com:443/v1.0/me/teams/{teamID}/channels/{channelID}/messages/{messageID}/replies
必要な入力
以下は、URLやリクエストボディの一部として送信されるパラメータです。
- チームID
- チャンネルID
- メッセージID
- メッセージ内容
必要な出力抽出器
出力エクストラクタは必要ありません。
8) チャンネルの削除
目的
ユーザーは入力としてチームIDとチャンネルIDを渡すことができ、Tulipは提供された入力で特定のチャンネルを削除します。
エンドポイント
エンドポイント-https://graph.microsoft.com:443/v1.0/teams/{teamID}/channels/{channelID}へのHTTP DELETEコール。
必要な入力
渡されるURLパラメータは以下のとおりです。
- チームID
- チャンネルID
必要な出力抽出器
出力エクストラクタは必要ありません。
9) チームメンバー一覧の取得
目的
このコネクタは、特定のチームのすべてのメンバーを取得します。
エンドポイント
エンドポイントhttps://graph.microsoft.com:443/v1.0/teams/{teamID}/membersへのHTTP GETコール。
必須入力
以下は、渡される URL パラメータです。
- チームID
必須出力 抽出
- メンバーID:メンバーの一意の識別子。
- メンバー名:メンバーの表示名。
- Member EmailID:メンバーのEメールID。
- メンバー役割: メンバーの役割:チームチャンネルにおけるメンバーの役割。
その他の情報
Microsoft Connectorに関する詳細情報をご覧ください。