ダイナミックメニュー
概要
ダイアログを呼び出すWorkbotコマンドレシピでは、実行時に利用可能になるダイナミックメニューオプションを使用してselectフィールドを定義できます。
動的メニューオプションを含むWorkbotコマンドレシピ
実行時に生成されるメニューオプション
ダイナミックメニューオプションは、セカンダリの'Dynamic menu recipe'によって生成されます。 名前が示すように、このレシピは3つの重要な処理を行います:
- ダイアログ内のダイナミックメニューからのダイナミックメニューイベントを監視する、
- メニューオプションを生成する、および
- メニューオプションをプライマリコマンドレシピに返します。
ダイナミックメニューオプションを使用したWorkbotパラメーターの設定
Workbotコマンドレシピで、
- パラメーターを作成します
- Dialog control typeで、Selectを選択します。
- Menu optionsで、Dynamicを選択します。
- dynamic menu recipeで、メニューオプションの生成を担当するダイナミックメニューレシピのレシピIDを入力します。 この時点で、ダイナミックメニューレシピがすでに作成されている必要があります。 ダイナミックメニューレシピの詳細については、ダイナミックメニューレシピに移動してください。
- (任意)ダイナミックメニューレシピにさらにコンテキストを送信する場合は、Dynamic menu recipe paramsフィールドを使用してパラメーターを渡すことができます。 詳細については、New dynamic menu eventトリガーのドキュメントを参照してください。
動的メニューオプションを含むWorkbotコマンドレシピ
ユーザーがダイアログ内のダイナミックメニューフィールドに入力すると、イベントがダイナミックメニューレシピに送信されます。
実行時に生成されるメニューオプション
Post dialogアクションでのダイナミックメニューオプションを使用したWorkbotパラメーターの設定
Post dialogアクションでダイナミックメニューフィールドを設定することもできます。 Dialog form fieldsで、次のようにJSONを設定します:
[
{
"type": "select",
"name": "your_parameter",
"label": "Your parameter",
"optional": false,
"data_source": "external",
"dynamic_menu_recipe": "28748",
"dynamic_menu_recipe_params": "stagename: Closed Won",
"min_query_length": 3
}
]
JSONを使用したダイナミックメニューフィールドの設定
| フィールド | 説明 |
|---|---|
| type | このパラメーターのフィールドタイプ。 ドロップダウンメニュー(ダイナミックメニューを含む)にはselectを使用します。 |
| name | パラメーターのAPI名。例: stagename。 |
| label | パラメーターの表示名。例: Stage name。 |
| optional | trueの場合、ユーザーはこのフィールドをスキップしてダイアログを送信できます。 |
| data_source | ダイナミックメニューを持つフィールドに対してSlackで必須です。 値はexternalである必要があります。 |
| dynamic_menu_recipe | ダイナミックメニューオプションを生成し、このレシピに返すダイナミックメニューレシピのID。 |
| dynamic_menu_recipe params | カンマ区切りのパラメーターを使用して、ダイナミックメニューレシピにコンテキストを渡します。例: |
| min_query_length | イベントがダイナミックメニューレシピに送信される前に、ユーザーが入力する必要がある文字数。 |
ダイナミックメニューレシピ
ダイナミックメニューレシピは3つの重要な処理を行います:
- ダイアログ内のダイナミックメニューからのダイナミックメニューイベントを監視する、
- メニューオプションを生成する、および
- メニューオプションをプライマリコマンドレシピに返します。
一般的なダイナミックメニューレシピは、次の要素で構成されます:
アプリからレコードを検索して取得するアクション。 例: Salesforce。 New dynamic menu eventトリガー出力のValueStep 1データピルをマッピングして、検索クエリを絞り込みます。 ダイナミックメニューイベントは、ユーザーがダイナミックメニューフィールドに3文字以上入力したときに発生するため、ValueStep 1データピルにはユーザーが入力した文字が含まれます。
typeaheadを使用した検索の絞り込みReturn menu optionsアクション
一般的なダイナミックメニューレシピ
Enterprise Workbotでのダイナミックメニュー機能の設定
Enterprise botを使用している場合は、最初にSlackでボットのOptions Load URLを設定する必要があります。 これは、WorkatoがWorkbotのダイナミックメニューイベントを受信するURLです。
Slackアプリの設定ページで、Features > Interactive Components > Message Menusに移動します。
Options Load URLフィールドに、次の形式のURLを入力します:
https://www.workato.com/slack_webhooks/data_source?coak_id=24820
24820をボットのカスタムOAuth IDに置き換えます。 このIDは、ボットのCustom OAuth profilesのURLで確認できます。

関連トピック
Last updated: