Microsoft Teams パッケージ の使用例

この例では、P1 インシデント アラートを特定のMicrosoft Teamsチャンネルに送信し、オンコールのサポートエンジニアにチャットで直接通知し、インシデント記録のためにチャンネルの会話を記録する自動化を構築します。

手順

  1. オートメーションを作成します。
    1. 左側のペインで オートメーション をクリックします。

      使用可能な Bot とフォームのリストが表示されます。

    2. Bot を作成 をクリックします。
    3. Bot の名前として次を入力します。 MSTeams_demo.
    4. 作成と編集 をクリックします。
  2. Microsoft Teams に接続してセッションを確立し、認証およびその後のすべての Teams アクションを実行します。
    1. Microsoft Teams > 接続 アクションの順にダブルクリックまたはドラッグします。
    2. OAuth2 コネクションフィールドにMSTeamと入力します。
    3. Username フィールドに office365_dev@automationanywhere.store を入力してください
    4. デフォルト ローカルセッションを選択します。
  3. 特定のチームのチーム ID を取得します。
    1. Microsoft Teams > チームを名前で取得 アクション をダブルクリックまたはドラッグします。
    2. セッション名フィールドで、Microsoft Teams に接続するために使用したものと同じセッション、つまり Default を使用します。
    3. チーム名フィールドにSupport Opsと入力します。
      注: サポート オペレーション チームはMicrosoft Teamsアプリに存在する必要があります。
    4. チームIDを変数に代入フィールドに$TeamID$と入力します。
  4. 特定のSupport Opsチーム内のチャンネルの一意のチャンネルIDを取得します。
    1. Microsoft Teams > 名前でチャンネルを取得 アクション をダブルクリックまたはドラッグします。
    2. セッション名フィールドで、Microsoft Teams に接続するために使用したものと同じセッション、つまり Default を使用します。
    3. チームID フィールドに$TeamID$と入力します。
    4. チャンネル名 フィールドにインシデント管理と入力します。
      注: このチャンネルはMicrosoft Teamsアプリに存在している必要があります。
    5. チャネルIDを変数に代入 フィールドで、$ChannelID$ という新しい変数を作成します。
  5. アラートをインシデント管理チャンネルに投稿してください。
    注: ここでの前提は、外部アプリがこの自動化をトリガーして、アラートメッセージをインシデント管理チャンネルに送信していることです。
    1. Microsoft Teams > チャンネル メッセージを送信 アクション をダブルクリックまたはドラッグします。
    2. チームID フィールドに $TeamID$ を入力します。
    3. チャンネル ID フィールドに $ChannelID$ を入力します
    4. メッセージ フィールドに、次のメッセージを入力します。

      インシデントID: INC-2025-08-13-045

      重大度: P1 – ビジネス クリティカル

      検出日時: 2025年8月13日 午後2時48分 IST

      説明 Order Processing API は 500 エラーを返しています。 すべての新しい注文が処理に失敗しています。

      インパクト: Eコマースの顧客が取引を完了できません。

      次のステップ: API ログと DB の健康状態を即座に調査するエンジニアに連絡してください。

    5. メッセージ ID を変数に割り当てフィールドで、アラートメッセージの ID を格納するために、$MessageId$という名前の新しい変数を作成します。
  6. サポートエンジニアのユーザー詳細を取得します。
    1. Microsoft Teams > ユーザーの詳細を取得 アクション をダブルクリックまたはドラッグします。
    2. セッション名 フィールドで、Microsoft Teams に接続するために使用したのと同じセッション、つまり デフォルト を選択します。
    3. ユーザー名フィールドに、新しい変数を作成してユーザーの詳細を取得するためのメールアドレスを保存します。 変数が作成されました: $email$ (例: tony.dean@office.store)
    4. ユーザーの詳細を変数に代入 フィールドで、ディクショナリ オプションを選択します。 ユーザーの詳細を保存するには、$user_dict$を入力してください。
  7. エンジニアに直接チャットで通知してください。
    1. Microsoft Teams > チャット メッセージを送信 アクション をダブルクリックまたはドラッグします。
    2. セッション名 フィールドで、Microsoft Teams に接続するために使用したのと同じセッション、つまり デフォルト を選択します。
    3. メッセージを送信 > メールフィールドに、$user_dict{email}$を指定してください
    4. メッセージ フィールドに、次のメッセージを入力します。

      こんにちは $user_dict{displayName}$様、

      P1 の重大なインシデントが検出されました: 注文処理APIの障害。 インシデント ID: INC-2025-08-13-045 に検出されました: 2025年8月13日 14:48 IST 影響: すべての新しい注文が失敗しています。

      インシデント ブリッジにすぐに参加してください: Teams ミーティング リンク チケット: ServiceNowリンク

      A360 MS Teams Bot からの自動通知です。

    5. メッセージ ID を変数に割り当て フィールドで、新しい変数 $user_msgid$ を作成します。
  8. エンジニアにメッセージが送信されたことを確認してください。
    1. Microsoft Teams > メッセージ ボックス アクション をダブルクリックまたはドラッグします。
    2. 表示するメッセージを入力フィールドにサポートエンジニアにメッセージが送信されましたと入力します。
  9. チャンネルのチャット履歴を取得して記録します。
    1. ループ アクション をダブルクリックまたはドラッグします。
    2. ループイテレーターのドロップダウンフィールドから、Microsoft Teams > チャンネル内の各メッセージに対して イテレーターを選択します。
    3. セッション名フィールドで、Microsoft Teams に接続するために使用したものと同じセッション、つまり Default を使用します。
    4. チームID フィールドに $TeamID$ を入力します。
    5. チャンネル ID フィールドに $ChannelID$ を入力します
    6. 開始日フィールドに、値2025年8月13日 03:00 PM IST (UTC+5.30) コルカタ アジアを持つ新しい変数$start_dt$を作成します。
    7. 終了日フィールドに、値2025年8月14日 12:00 AM IST (UTC+5.30) コルカタアジアを持つ新しい変数$end_dt$を作成します。
    8. メッセージの詳細を変数に割り当てる フィールドで、チャンネルのメッセージを保存するために $ChannelMessageDetails$ という名前の変数を作成します。
  10. ループ アクション内でメッセージの詳細を抽出します。
    注: グループメッセージのみが取得され、個別のスレッドは取得されません。

    ディクショナリ > 取得 アクション の各キーをダブルクリックまたはドラッグして、$ChannelMessageDetails$ からその値を取得します。
    キー 変数
    $ChannelMessageDetails (msg_id)$ $msg_id$
    $ChannelMessageDetails (msg)$ $msg$
    $ChannelMessageDetails (sentByUserID)$ $sentByUserID$
    $ChannelMessageDetails (sentByUsername)$ $sentByUsername$
    $ChannelMessageDetails (createdDateTime)$ $createdDateTime$
    $ChannelMessageDetails (modifiedDateTime)$ $modifiedDateTime$
  11. ループ内の アクション で、チャンネル メッセージの詳細をインシデント ログ ファイルに記録します。
    • ロギング > 変数をファイルに記録 アクションをダブルクリックまたはドラッグします。
    • 出力ファイル パス フィールドにC:\output\Incident Log File.txtと入力します。
    • ログ記録時 オプションから、既存のログファイルに追加 を選択します。
    • カスタム選択オプションを選択して、ログに記録する変数を特定します。 次の変数を選択します。
      • $createdDateTime$
      • $modifiedDateTime$
      • $msg$
      • $msg_id$
      • $sentByUserID$
      • $sentByUserName$
  12. Microsoft Teams から切断します。
    1. Microsoft Teams > 切断 アクションをダブルクリックまたはドラッグします。
    2. セッション名 フィールドで、Microsoft Teams に接続するために使用したのと同じセッション、つまり デフォルト を選択します。
  13. ファイル > 開く アクションを使用してインシデントログファイルを開く。 以下の情報は .txt ファイルに表示されます。
    キー 価値
    msg_id 例:1692210012345
    メッセージ

    重要なインシデント アラート – 行動が必要です

    インシデント ID: INC-2025-08-13-045

    重大度: P1 – ビジネス クリティカル

    検出日時: 2025年8月13日 午後2時48分 IST

    説明 Order Processing API は 500 エラーを返しています。 すべての新しい注文は

    処理に失敗しました。

    インパクト: Eコマースの顧客が取引を完了できません。

    次のステップ: API ログと DB の健康状態を調査するエンジニアに

    すぐに連絡してください。

    送信者ユーザーID 例:a-user-guid
    createddatetime 2025-08-13T14:50:12Z
    modifieddatetime 2025-08-13T14:50:12Z
    sentbyusername 例:tony.dean@office.store