ダイナミックメニュー

このページは機械翻訳により提供されています。翻訳内容と英語版に相違がある場合は、英語版が優先されます。

ダイナミックメニューの仕組み概要

ダイアログを呼び出すWorkbotコマンドレシピでは、実行時に利用可能になるダイナミックメニューオプションを使用してselectフィールドを定義できます。

動的メニュー動的メニューオプションを含むWorkbotコマンドレシピ

実行時のメニューオプション実行時に生成されるメニューオプション

ダイナミックメニューオプションは、セカンダリの'Dynamic menu recipe'によって生成されます。 名前が示すように、このレシピは3つの重要な処理を行います:

  1. ダイアログ内のダイナミックメニューからのダイナミックメニューイベントを監視する、
  2. メニューオプションを生成する、および
  3. メニューオプションをプライマリコマンドレシピに返します。

ダイナミックメニューオプションを使用したWorkbotパラメーターの設定

Workbotコマンドレシピで、

  1. パラメーターを作成します
  2. Dialog control typeで、Selectを選択します。
  3. Menu optionsで、Dynamicを選択します。
  4. dynamic menu recipeで、メニューオプションの生成を担当するダイナミックメニューレシピのレシピIDを入力します。 この時点で、ダイナミックメニューレシピがすでに作成されている必要があります。 ダイナミックメニューレシピの詳細については、ダイナミックメニューレシピに移動してください。
  5. (任意)ダイナミックメニューレシピにさらにコンテキストを送信する場合は、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
  }
]

Post dialogアクションでのダイナミックメニューの設定JSONを使用したダイナミックメニューフィールドの設定

フィールド説明
type このパラメーターのフィールドタイプ。 ドロップダウンメニュー(ダイナミックメニューを含む)にはselectを使用します。
name パラメーターのAPI名。例: stagename
labelパラメーターの表示名。例: Stage name
optionaltrueの場合、ユーザーはこのフィールドをスキップしてダイアログを送信できます。
data_source ダイナミックメニューを持つフィールドに対してSlackで必須です。 値はexternalである必要があります。
dynamic_menu_recipe ダイナミックメニューオプションを生成し、このレシピに返すダイナミックメニューレシピのID。
dynamic_menu_recipe params カンマ区切りのパラメーターを使用して、ダイナミックメニューレシピにコンテキストを渡します。例:
stagename: Closed Won, closed: true
min_query_length イベントがダイナミックメニューレシピに送信される前に、ユーザーが入力する必要がある文字数。

ダイナミックメニューレシピ

ダイナミックメニューレシピは3つの重要な処理を行います:

  1. ダイアログ内のダイナミックメニューからのダイナミックメニューイベントを監視する、
  2. メニューオプションを生成する、および
  3. メニューオプションをプライマリコマンドレシピに返します

一般的なダイナミックメニューレシピは、次の要素で構成されます:

  1. New dynamic menu eventトリガー

  2. アプリからレコードを検索して取得するアクション。 例: Salesforce。 New dynamic menu eventトリガー出力のValueStep 1データピルをマッピングして、検索クエリを絞り込みます。 ダイナミックメニューイベントは、ユーザーがダイナミックメニューフィールドに3文字以上入力したときに発生するため、ValueStep 1データピルにはユーザーが入力した文字が含まれます。 typeaheadを使用した検索の絞り込みtypeaheadを使用した検索の絞り込み

  3. 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で確認できます。

カスタムOAuth ID

Last updated: