クイックスタート - チャットを取得してメッセージを送信する

概要

このガイドの目的は、 チャットを取得、 チャット メンバーを取得、 メッセージを送信 、 メッセージを取得 などのさまざまな Microsoft Teams アクティビティを使用した、実用的なサンプルを作成できるようになることです。

この実用的なサンプルを使用すると、 登録済み の Microsoft Teams アプリケーションへの接続をすばやく確認し、アクティビティの入力/出力データ型に習熟することができます。

このページの手順を完了すると、以下のアクションを実行するオートメーション シーケンスが使用できるようになります。

1. 登録済みの Microsoft Teams アプリケーションへの接続を確立します ([Microsoft Teams スコープ])。

2. すべてのチャットを取得します ([チャットを取得])。

3. 各チャットのメンバーを取得します ([繰り返し (コレクション の各要素)] および [チャット メンバーを取得])。

4. 特定のチャット メンバーを含むチャットを見つけてメッセージを送信します ([条件分岐 (if)]、[ 割り当て]、[ メッセージを送信])。

5. メッセージ ID とメッセージの内容を取得して出力することにより、メッセージが正常に送信されたことを確認します ( [メッセージを取得 ] と [1 行を書き込み]) )。

   

前提条件

はじめる前に

1. Microsoft Teams の「セットアップ 」の手順を完了します。
2. 既存のチャットを作成するか使用し、少なくとも1つのチャットメッセージを送信します。

手順

プロジェクトをビルドする

1. プロジェクトに [ Microsoft Teams スコープ ] アクティビティを追加します。
2. 登録済みアプリケーションの [アプリケーション ID ] を入力します。
   • 詳細については、「 セットアップ」 ガイドの「 アプリケーションの登録 」セクションをご覧ください。
3. [ 認証の種類 ] ドロップダウン リストから、該当する認証フロー (例: InteractiveToken) を選択します。
   • 詳しくは、「 Microsoft Teams スコープ アクティビティ」の「 無人オートメーションと有人オートメーション 」をご覧ください。
4. [Microsoft Teams スコープ] アクティビティの後に [ チャットを取得] アクティビティを追加します。
   1. [チャット] の値を表すChat[]変数を作成し、入力します (例: myChats)。
      • 変数を作成するときは、変数の型として Microsoft.Graph.Chat を選択します。
   2. [ チャットを取得] アクティビティの後に [ 繰り返し (コレクション の各要素)] アクティビティを追加します。
   3. [TypeArgument] プロパティで [Microsoft.Graph.Chat] を選択します。
   4. [値] プロパティに、[チャットを取得] アクティビティ用に作成したChat[]変数を入力します (例: myChats)。
5. [繰り返し (コレクションの各要素)] アクティビティに [代入] を追加します。
   1. [宛先] プロパティの String 型変数を作成し、入力します (例: chatId)
   2. [値] プロパティに「item」と入力します。同上。
      • item.id 値を作成してこの変数に割り当てると、異なる引数型を持つ後の [繰り返し (コレクションの各要素)] アクティビティでこの値を使用できるようになります。
   3. [代入] アクティビティの後に [ チャット メンバーを取得] アクティビティを追加します。
   4. [ChatId] プロパティに「Item.Id」と入力して、各チャットのメンバーを取得します。
   5. ChatMembers 値の ConversationMember[] 変数を作成し、入力します (例: myChatMembers)。
      • 変数を作成するときは、変数の型として Microsoft.Graph.ConversationMember を選択します。
   6. [チャット メンバーを取得] アクティビティの後にもう 1 つ [繰り返し (コレクションの各要素)] アクティビティを追加します。
   7. [TypeArgument] プロパティで [Microsoft.Graph.ConversationMember] を選択します。
   8. [値] プロパティに、[チャット メンバーを取得] アクティビティ用に作成したConversationMember[]変数を入力します (例: myChatMembers)。
6. [繰り返し (コレクションの各要素)] アクティビティに [条件分岐 (if)] アクティビティを追加します。
   1. [条件] プロパティに、メンバーごとに特定のチャットを識別する値を入力します (例: item.DisplayName="Sarah Connor")
7. [Then] シーケンス ブロックに、[メッセージを送信] アクティビティを追加します。

   1. [ChatId] プロパティに、[代入] アクティビティ用に作成したString変数を入力します (例: chatId)。

   2. 送信する本文の内容を入力します (例: 「挨拶するだけです」)

   3. [BodyType] プロパティに「BodyType.Text」と入力します。

   4. [メッセージ ID] の値に対して、新しい String 型変数を作成して入力します (例: newMessageId)。

      

プロジェクトをテストする

1. アクティビティがチャットとチャット メンバーを取得してメッセージを送信したことをテストするには、[ メッセージを送信] アクティビティの後に [ 1 行を書き込み] アクティビティを追加します。

   1. [テキスト] プロパティに、[メッセージを送信] アクティビティ用に作成したString変数を入力します (例: newMessageId)

2. [ 1 行を書き込み] アクティビティの後に [ メッセージを取得] アクティビティを追加します。

   1. [ChatId] プロパティに、[代入] アクティビティ用に作成したString変数を入力します (例: chatId)。

   2. [メッセージ ID] プロパティに、[メッセージを送信] アクティビティ用に作成したString変数を入力します (例: newMessageId)。

   3. [メッセージ] の値の ChatMessage 変数を作成し、入力します (例: newMessage)。

      • 変数を作成する場合、変数型として _Microsoft.Graph.ChatMessage_を選択します。

3. [メッセージを取得] アクティビティの後にもう 1 つ [1 行を書き込み] アクティビティを追加します。

4. [テキスト] プロパティに、[メッセージを取得] アクティビティ用に作成した ChatMessage 型変数を入力し、追加します。Body.Content を末尾に追加します (例:newMessage.Body.Content) です。

5. [実行] をクリックし、[出力] ウィンドウに送信されたメッセージ ID と内容が含まれていることを確認します。

   

完了です!

準備ができたら、他の「 クイックスタート 」ページにも挑戦し、「Microsoft Teams」系の各種アクティビティにさらに習熟してください。

Microsoft Teams アクティビティの詳細 (プロパティの入力/出力の例を含む) については、以下のアクティビティのページをご覧ください。すべてのアクティビティが記載されたリストと、アクティビティの詳細な説明ページへのリンクが記載されています。

• Teams