メッセージを送信

概要

[メッセージを送信] アクティビティは、チャネル API で Microsoft Graph の CreateChatMessage または CreateChatMessage - を呼び出して、指定されたチャット ([チャット ID]) またはチャネル ([チャネル ID]) およびチーム ([チーム ID]) にメッセージ ([本文]、[本文の種類]、[重要度]、[件名]) を送信します。

メッセージの送信後、アクティビティは送信されたメッセージの ID ([メッセージ ID]) を String として出力します。このデータは、後続のアクティビティ (例: [ メッセージの返信を取得]、[ メッセージを取得]) で入力変数として使用できます。

動作のしくみ

以下の手順とメッセージ シーケンス図は、設計時 (つまり、アクティビティの依存関係と入/出力プロパティ) から実行時に至るまでの、アクティビティの動作方法の例を示したものです

1. 「セットアップ」の手順を完了します。

2. プロジェクトに [ Microsoft Teams スコープ ] アクティビティを追加します。

3. 次の 2 つのオプション (A または B) のいずれかを完了します。

   A。 アクティビティを追加するか、 Chat.Id 値を出力する外部プロセスを実行します (例: [チャットを取得])。

   B。Team.Id値を出力するアクティビティまたは外部プロセス (例: [チームを取得]) と、Channel.Id値を出力するアクティビティまたは外部プロセス (例: [チャンネルを取得]) を追加します。

4. [Microsoft Teams スコープ] アクティビティ内に [メッセージを送信] アクティビティを追加します。

5. [チャネル] プロパティと [メッセージ] プロパティに値を入力します。

6. [出力] セクションのプロパティのために String 型変数を作成し、入力します。

7. アクティビティを実行します。

   • 入力プロパティ値は、チャネル API の CreateChatMessage または CreateChatMessage に渡されます 。

   • API は、[出力] セクションのプロパティ変数に String の値を返します。

     

プロパティ

以下のプロパティの値は、このアクティビティを UiPath Studio でプロジェクトに追加するときに指定します。

共通

表示名

アクティビティの表示名です。

属性	詳細
入力	String
Required	はい
既定値	メッセージを送信
許容値	String または String 型変数を入力します。
備考	N/A

Channel

TeamId

メッセージの送信先チャネルを含む Team オブジェクトの ID です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	Team.Id値を取得するには、出力にTeam.Id値を含む外部プロセスまたはアクティビティを使用します (例: [チームを取得] または外部 API 呼び出し)

ChannelId

メッセージの送信先とする Channel オブジェクトの ID です。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	Channel.Id値を取得するには、出力にChannel.Id値を含む外部プロセスまたはアクティビティを使用します (例: [チャネルを取得] または外部 API 呼び出し)

チャット

ChatId

メッセージの送信先 Chat オブジェクトの ID です。

属性	詳細
入力	String
Required	はい ( TeamId と ChannelId が空の場合)
既定値	空
許容値	String または String 型変数を入力します。
備考	Chat.Id値を取得するには、出力にChat.Id値を含む外部プロセスまたはアクティビティを使用します (例: チャットを取得または外部 API 呼び出し) (ChatId) または (TeamId と ChannelId) のいずれかが必要です。

メッセージ

本文

送信するメッセージの内容。

属性	詳細
入力	String
Required	はい
既定値	空
許容値	String または String 型変数を入力します。
備考	BodyType 値 (BodyType.Text または BodyType.Html) に従って値を入力します。

本文の種類

本文で送信するコンテンツの種類です。

属性	詳細
入力	BodyType
Required	いいえ
既定値	空
許容値	BodyType または BodyType 型変数を入力します。
備考	次の 2 つの値のいずれか 1 つを入力します。 BodyType.Text BodyType.Html

重要度

返信メッセージの重要度です。

属性	詳細
入力	ChatMessageImportance
Required	いいえ
既定値	空
許容値	ChatMessageImportance または ChatMessageImportance 型変数を入力します。
備考	次の 3 つの値のいずれか 1 つを入力します。 ChatMessageImportance.Normal ChatMessageImportance.High ChatMessageImportance.Urgent

件名

応答メッセージの件名です。

属性	詳細
入力	String
Required	いいえ
既定値	空
許容値	String または String 型変数を入力します。
備考	N/A

その他

プライベート (Private)

選択すると、変数と引数の値が Verbose レベルでログ記録されなくなります。

属性	詳細
入力	チェックボックス
Required	いいえ
既定値	非選択
許容値	選択または非選択
備考	N/A

出力

メッセージ ID

送信されるメッセージの ID です。

属性	詳細
入力	String
Required	いいえ (後続のアクティビティで出力データを使用する予定がある場合は必須)
既定値	空
許容値	String 型変数を入力します。
備考	このプロパティ用に作成した変数は、後続のアクティビティ (例: [メッセージの返信を取得]、[ メッセージを取得]) で入力変数として使用できます。

例

次の画像は、アクティビティの依存関係と入力/出力プロパティの値の例です。

ステップバイステップの手順と例については、ガイドをご覧ください。