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

概要

このガイドの目的は、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」と入力 します。ID。

      • この変数に item.id 値を作成して割り当てると、引数の型が異なる後の [繰 り返し (コレクションの各要素)] アクティビティで使用できます。
   3. [割り当て] アクティビティの後に [チャット メンバーを取得 ] アクティビティを追加します。
   4. [ チャット ID ] プロパティに 、「Item.Id 」と入力して各チャットのメンバーを取得します。
   5. ChatMembers の値に対する ConversationMember[] 変数を作成して入力します (例: myChatMembers)。
      • 変数を作成するときは、変数型として Microsoft.Graph.ConversationMember を選択します。
   6. [ チャット メンバーを取得 ] アクティビティの後に、[繰り返し ( コレクションの各 要素)] アクティビティを追加します。
   7. [ TypeArgument ] プロパティで、[ Microsoft.Graph.ConversationMember] を選択します。
   8. [ 値] プロパティに、[ チャット メンバーを取得 ] アクティビティに対して作成した ConversationMember[] 変数を入力します (例: myChatMembers)。

6. [繰り返し (コレクションの各要素)] アクティビティに [条件分岐 (if)] アクティビティを追加します。

   1. [条件 ] プロパティに、メンバーが特定のチャットを識別する値を入力します (例: item)。表示名="サラコナー")

7. [ Then ] シーケンス ブロックに 、[メッセージを送信] アクティビティを追加します。

   1. [ チャット ID ] プロパティに 、[代入 ] アクティビティに対して作成した String 変数を入力します (例: chatId)。
   2. 送信する 本文 コンテンツを入力します (例: "Just saying hi")。
   3. [ 本文の種類] プロパティに、「 BodyType.Text」と入力します。
   4. [ メッセージ ID] の値に対し、新しい String 変数を作成して入力します (例: newMessageId)。
      
      

      

      
      

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

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

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

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

   1. [ チャット ID ] プロパティに 、[代入 ] アクティビティに対して作成した String 変数を入力します (例: chatId)。
   2. [ メッセージ ID] プロパティに、[メッセージ を 送信 ] アクティビティに対して作成した String 変数を入力します (例: newMessageId)。
      3 . [メッセージ ] の値に対し、 ChatMessage 変数を作成して入力します (例: newMessage)。
      • 変数を作成する場合、変数型として _Microsoft.Graph.ChatMessage_を選択します。
   3. [メッセージを取得] アクティビティの後に もう 1 つの [1 行を書き込み ] アクティビティを追加します。
   4. [ テキスト] プロパティに、[ メッセージを取得 ] アクティビティに対して作成した ChatMessage 変数を入力して追加します 。Body.Content to end (例:newMessage.Body.Content)

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

   
   

   

   
   

完了です!

準備ができたら、他の 「クイックスタート 」ガイドにも挑戦し、さまざまな Microsoft Teams アクティビティにさらに習熟してください。

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

• Channels
• Chats
• Messages
• Teams