はじめに

Workbot for Microsoft Teams を使えば、チャット上で人とのインタラクションを実現でき、人が介在する業務全体の自動化を行うことが可能になります。その中で、アカウントプロビジョニング後の初期パスワードの設定や、RPA連携におけるロボットへの認証情報の受け渡しなど、ユーザーからパスワードを受け取りたい場合がございます。

しかし、2024年4月現在、Workbot for Microsoft Teams では、パスワード入力を行うテキスト入力ボックスは提供されておりません。パスワード入力画面を表示させる方法はないのでしょうか？

カスタムの Adaptive Card を使うことで、パスワード入力欄を表示することが可能

「Workbot for Microsoft Teams でリッチな画面を作成する」の記事でご紹介した通り、Workbot for Microsoft Teams では、Adaptive Card によりチャット上の画面を描画しています。Adaptive Card のスキーマバージョン 1.5 より、パスワード入力のスタイルが追加されており、これを使うことでパスワード入力欄を実現することが可能です。

{
  "type": "Input.Text",
  "id": "password_input",
  "style": "password"
}

パスワード入力を受け取る Workbot を作成する手順

レシピの全体構成

今回作成するレシピの全体構成です。パスワード入力画面を表示する「レシピ１」と、[送信]ボタンのクリックをトリガーに動き、入力したパスワードを受け取って結果を表示する「レシピ２」で構成されます。

パスワード入力欄を表示することは、カスタムの Adaptive Card を記述することで簡単に実現できます。しかし、入力した値を次のレシピで受け取る必要があり、今回は、「レシピ１」で表示した画面に入力された値を「レシピ２」に受け渡す方法についても解説していきたいと思います。

パスワード入力画面を表示するレシピを作成（レシピ1）

「Post reply (old version)」アクションを選び、カスタムの Adaptive Card を記述するために、[Post a raw JSON instead] を「Yes」に設定します。

続いて、Adaptive Card を記述します。データピルを埋め込むことで、メッセージに動的な値を埋め込むことも可能です。

具体的には次のような、JSONを記述します。

{
  "type": "message",
  "summary": "パスワードのリセット",
  "attachments": [
    {
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "body": [
          {
            "type": "TextBlock",
            "size": "Medium",
            "weight": "Bolder",
            "text": "パスワードの設定"
          },
          {
            "type": "TextBlock",
            "text": "新しいパスワードを入力してください"
          },
          {
            "type": "Input.Text",
            "id": "password_input",
            "style": "password"
          }
        ],
        "actions": [
          {
            "type": "Action.Submit",
            "title": "送信",
            "data": {
              "bot_command_name": "sample_set_password",
              "bot_command_params": "{\"additional_param\": \"追加で渡したい値\"}"
            }
          }
        ],
        "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
        "version": "1.5"
      }
    }
  ]
}

パスワード入力を受け取るレシピの作成（レシピ2）

複数の Workbot for Microsoft Teams を使ったレシピ間で、データを受け渡す方法は通常と変わりません。トリガーのパラメーターとして、受け取りたい値を定義するだけです。通常と異なるのは、送信側のパラメーターがすべて Adaptive Card の JSON 内に含まれる点のみです。

今回の例では、次のような対応関係となります。

パスワード入力欄の値は、コントロールに指定したID属性により、次のレシピで受け取ることができます。

一方、[送信]ボタンで、実行する次のレシピや、次のレシピに渡す Additional Parameter は、Action.Submit の data属性で指定します。この data属性に指定するオブジェクトは、Workbot 独自のルールがあり、以下の内容を指定します。

data属性で指定するオブジェクトの内容
属性	説明
bot_command_name	ボタンが押された後に実行するレシピの「コマンド名」を指定
bot_command_params	Additional Parameter として次のレシピに引き継ぐオブジェクト(※ JSON文字列内として、JSONオブジェクトを記載するためエスケープが必要です)

ここまでくれば、あとはトリガーの引数をデータピルとして使用し、後続のアクションで利用するだけです。

レシピの実行結果

「レシピ１」からのデータを、上で作成した「レシピ２」で受け取った結果です。カスタムの Adaptive Card から無事にデータが引き渡されていることが確認できます。（パスワードを画面に表示してしまうのでよい例とは言えませんが、データ受け渡しの技術サンプルということでご了承ください。）

まとめ

まとめると、以下のようになります。

カスタムの Adaptive Card を使えばパスワード入力欄を作成可能
カスタムの Adaptive Card のボタンから、次のレシピを呼び出すには決まった書き方 (data属性）が必要

おわりに

いかがでしょうか？カスタムの Adaptive Card を用いることで、標準機能では作成できないパスワード入力欄を作成することができます。おそらく、そのうち Workbot の機能としても取り込まれる可能性が高いと思いますが、いち早く Adaptive Card の新機能を使用したい場合には、非常に力強い方法です。

Workatoの導入・導入後の活用などでお困りの場合、Workatoリセラーにご相談する方法もございます。お困りごとがございましたら、認定リセラーの日立ソリューションズへ是非ご相談ください。

参考リンク

株式会社日立ソリューションズ
- Workato ご紹介サイト
Workato 公式サイト
- Workbot for Microsoft Teams
- Adaptive card blocks for Microsoft Teams
本記事のサンプルレシピ
- JPデータセンター利用者向け
  - [Example] Input password from Teams Workbot
  - [Example] Set password
- USデータセンター利用者向け
  - [Example] Input password from Teams Workbot
  - [Example] Set password
Adaptive Card 関連
- Microsoft Teams 向けアダプティブカードの概要