チャネル メッセージを送信

プロジェクトの対応 OS

Windows | クロスプラットフォーム

概要

説明	API メソッド	API パス
Microsoft Teams のチャネルでメッセージを送信します。オプションで SharePoint のファイルを添付できます。(Send Channel Message)	POST	/normalised-teams/{team_id}/channels/{channel_id}/messages-v2/drive/items

入力

パラメーター	説明	データ型
チーム ID	チームの一意の識別子です。チームの名前を入力して利用可能なドロップダウン リストから取得するか、カスタム チーム ID を入力します。ID は、[ チームを名前で取得 ] アクティビティの出力から取得できます。	string
チャンネル ID	チャネルの一意の識別子です。チャネルの名前を入力して、利用可能なドロップダウン リストから取得するか、チャネル ID を入力します。ID は、[ 名前でチャネルを取得 ] アクティビティの出力から取得できます。	string
メッセージ本文	メッセージのテキスト内容	string
アダプティブ カードの JSON	アダプティブ カードのコンテンツを表す JSON ペイロード。" を ' に置き換え、\n、\r など、'' を含むすべてのエスケープ文字を削除します。たとえば、\r\n"type" を 'type' に置き換えます。詳細については、Microsoft Teams API のドキュメント と アダプティブ カードのドキュメントを参照してください。	string
画像	メッセージに含める画像の添付ファイル	file
ファイル ID (最大 20 個のファイル)	メッセージに添付する 1 つ以上の SharePoint ファイル ID です。この ID は、[ ファイル/フォルダーを取得] または [ ファイルをアップロード ] (Microsoft 365 アクティビティ) の出力から取得できます。このフィールドは String 型の入力をサポートします。	文字列配列
メンション ID	メッセージ内のメンションされたエンティティのインデックスです。メッセージ テキスト内の <at> タグをメンション エントリにリンクする数値識別子です。HTML <at> タグの id 属性と一致する必要があります。設定可能な値: 0、 [ 1]、[ 2] など	int32
言及されたユーザー ID の種類	記載されたユーザーの ID の種類です。一般的な値: member、 aadUser、 onPremiseAadUser、 guest。通常のチーム メンバーの既定値は memberです。	string
メンションのユーザー ID	記載されたユーザーの一意の識別子 (AAD ユーザーの一意の識別子)。たとえば、 74a49af0-e4a2-43d6-9d83-52f5f0です。	string
メンションのユーザーの表示名	Azure AD のメンションされたユーザーの完全な表示名です。例えば John Doe	string
メンションメンションテキスト	メッセージ内でユーザーをメンションするために使用されるテキストです。<at>タグ間のテキストを一致させる必要があります。たとえば、 John Doeです。	string

出力

パラメーター	説明	データ型
メッセージ ID	送信されるメッセージの一意の識別子です	string
Web URL	送信されたメッセージの Web URL です	string
メッセージ	API によって返されるフル チャネル メッセージ オブジェクト	オブジェクト

注:

• API ワークフローでは、単一の応答オブジェクトが出力として返されます。必須フィールドは、このオブジェクトから直接抽出できます。
• RPA ワークフローでは、一部の出力パラメーターが異なる場合がありますが、明示的に公開されていない場合でも、必要な値を応答オブジェクトから取得できます。

ユーザーのメンションを使用する

Teams チャネル メッセージでユーザーをメンションするには、メッセージ テキストとメンションの両方のプロパティを構成する必要があります。

注:

タグのメンションは現在サポートされておらず、ユーザーのみをメンションできます。

1. メッセージ テキストの書式を設定します。

id属性を持つHTML<at>タグを使用してメンションを含めます。

"Hello <at id=\"0\">John Doe</at>, please review this."

2. メンションのプロパティを次の表のように構成します。

   プロパティ	値 (Value)	説明
   メンション ID	0	数値識別子 (複数のメンションの場合は増分)
   メンションメンションテキスト	John Doe	メンションに表示される表示名
   メンションのユーザーの表示名	John Doe	Azure AD からのユーザーのフル ネーム
   メンションのユーザー ID	{AAD オブジェクト ID}	ユーザーの Azure AD オブジェクト ID (以下を参照)
   メンションに記載されているユーザー ID の種類	メンバー	ID の種類 (member/aadUser/guest)

Azure AD オブジェクト ID を取得するには、次の手順を実行します。

• Azure Portal - [Azure Active Directory ] に移動します> ユーザー > {user}> [オブジェクト ID をコピー] に移動します。
• Microsoft Graph API - GET https://graph.microsoft.com/v1.0/users/{userPrincipalName}
• PowerShell - Get-AzureADUser -ObjectId "[e-mail]" | Select ObjectId

ユーザー「Jane Smith」について言及する設定例:

• メッセージ テキスト: "Task completed <at id=\"0\">Jane Smith</at>"
• メンションID: 0
• メンションメンションテキスト: "Jane Smith"
• メンションのユーザーの表示名: "Jane Smith"
• 言及されたユーザーID: "ef1c916a-3135-4417-ba27-8eb7bd084193"
• 言及されたユーザー ID の種類: "member"
  注:

  • アクティビティ インスタンスごとにメンションできるユーザーは 1 人のみです。
  • <at>タグのidは、[メンション ID] プロパティと一致する必要があります。
  • Azure AD のオブジェクト ID が正しくないと、メンションは失敗します。
  • ボット/アプリに、チャネル内のユーザーをメンションするアクセス許可があることを確認します。