Slack向けWorkbotトリガー ​

Workbot for Slackを使用すると、Slack上のWorkbotにコマンドを送信できます。 Workbotはこれらのコマンドを処理し、接続済みアプリと連携して、顧客アカウントの詳細表示、商談のクローズ、請求書やチケットの一覧表示、既存チケットの作成/更新などを実行します。

各Workbotコマンドは、Workatoレシピを使用して処理されます。レシピトリガーはWorkbotコマンドをトリガーイベントとして取得し、レシピが実行するアクションを決定します。 Workbotを使用すると、Slackコマンドを通じて実行されるカスタムワークフローを作成し、必要に応じて関連データをSlackに取得できます。

Workbot for Slackコネクタには5つのトリガーがあります。

• New command
• New help message
• New event（リアルタイム）
• New shortcutトリガー
• New URL mention
• New dynamic menu event

New commandトリガー（カスタムコマンドの構築） ​

このトリガーでは、カスタムWorkbotコマンドを設定します。このトリガーを含むレシピが開始されると、Workbotは新しいコマンドを監視します。呼び出されると、Workbotはレシピアクションの実行を続行します。

New commandトリガー入力フィールド ​

次の表に、トリガーで設定可能な入力フィールドと、各フィールドの機能を示します。

Workbotコマンド形式 ​

Workbotコマンドは、app、action、action dataの3つの要素を組み合わせて作成されます。

app action action-data

次の場合、アプリケーションはSalesforce、コマンドアクションはShow、ビジネスデータはAccountです。 Workbotは次のコマンドに応答します。

Salesforce show account

Workbotコマンド入力パラメータ形式 ​

command input fieldsフィールドでは、レシピアクションを正常に実行するためにユーザーから必要なデータを決定できます。

各入力パラメータは、次の形式で指定する必要があります。

param_name optional:true prompt:false type:string hint:hint_to_help_users sample:example_data

この場合、Salesforceアカウントデータを正常に取得するには、Slackユーザーから完全なアカウント名を取得する必要があります。

name optional: false prompt: false type: string hint: Exact account name sample: IBM

設定済みのコマンド入力フィールドは、Workbotコマンドの後にユーザーへのフォローアップ質問として表示されます。

Slackに表示されたコマンド入力フィールド

New commandトリガー出力データピル ​

New commandトリガーは、コマンドを実行したユーザー、コマンドが実行されたチャネルなど、コマンドに関するデータを保持する一連のデータピル変数も提供します。次の表では、これらのデータピル変数について詳しく説明します。

新しいボットコマンド出力データツリー

次の表に、トリガーからの出力データピルと、各フィールドに含まれるデータを示します。

次の表には、Contextオブジェクトと、それに対応して保持されるデータに関する追加情報が含まれています。

次の表には、Modalsオブジェクトと、それに対応して保持されるデータに関する追加情報が含まれています。

トリガーの出力にはMessage IDが含まれる場合があります。 Message IDに値が入るのは、New commandがボタンアクションによってトリガーされた場合のみです。手動で入力したコマンドの結果としてコマンドがトリガーされた場合、このフィールドは空になります。

例：Salesforce show accountコマンド ​

次のGIFでは、DMを通じてWorkbotと直接チャットしています。アプリ名"Salesforce"を入力すると、Workbotは使用可能なコマンドの一覧を生成し、ボタンとして表示します。 DMにSalesforce show accountとしてコマンドを手動で入力することもできます。

Salesforce show accountコマンド

ボタンをクリックするかコマンドを入力してSalesforce show accountコマンドが呼び出されると、Workbot for SlackのNew commandトリガーを含む対応するレシピがジョブを開始します。このレシピには、Salesforce show accountコマンドを具体的にリッスンするWorkbot New commandトリガーがあります。使用方法のインスピレーションとガイダンスとして、この機能を備えたビルド済みWorkbot for Slackレシピを参照してください。

Salesforce show accountコマンドレシピサンプルレシピ

Salesforce show accountコマンドのトリガー設定は次のとおりです。

Salesforce show accountコマンドトリガー設定

Workbotコマンドは、app、action、action dataの3つの要素を組み合わせて作成されることがわかっています。この場合、アプリケーションは"Salesforce"、コマンドアクションはShow、ビジネスデータはAccountです。 Workbotは次のコマンドに応答します：Salesforce show account。

command input parametersフィールドでは、レシピアクションを正常に実行するためにユーザーから必要なデータを決定できます。この場合、Salesforceアカウントデータを正常に取得するには、Slackユーザーから完全なアカウント名を取得する必要があるため、パラメータを次のように定義します。

Salesforce show accountコマンド入力フィールド設定

設定済みのコマンド入力パラメータは、Workbotコマンドの後にユーザーへのフォローアップ質問として表示されます。

Slackでの入力パラメータ表示

ユーザーが必要な入力をすべて提供し終えると、レシピアクションが実行されます。この場合、レシピアクションはSalesforceアカウントの詳細をグリッド形式のメッセージ添付ファイルとして表示することでした。

Salesforce show accountコマンド結果

New help messageトリガー ​

New help messageトリガーは、ダイレクトメッセージ（DM）またはチャネル（ユーザーによるメンション時、例：\@workbot help）を通じてhelpメッセージがボットに送信されたときに実行されます。 Workbotのデフォルトヘルプメッセージを使用するのではなく、ボットのhelpメッセージ応答を完全にカスタマイズする場合は、このトリガーを使用します。

ユーザーがhelpコマンドを使用したときに新しいhelpメッセージが表示されるように、このトリガーをPost command replyと一緒に使用することをお勧めします。

各ボットで一度にアクティブにできるNew help messageトリガーレシピは1つだけです。

New help messageトリガーを使用する理由 ​

ボット固有の機能に基づいて、ボットのヘルプメッセージをカスタマイズすることを強くお勧めします。これは、New help messageイベントにPost command replyで応答することで実行できます。トリガーに含まれるコンテキストは、次の用途に使用できます。

• User IDを使用してユーザー向けにメッセージをパーソナライズする
• Is bot admin?を使用して、ユーザーがボット管理者かエンドユーザーかに応じて異なるhelpメッセージを表示する
• ユーザーがhelpコマンドと一緒に送信するテキスト（例：help Salesforce）を使用して、代替のhelpメッセージを提供する
• ボットコマンド、個人用コネクション、ボットレシピとジョブへのリンクを表示する

カスタマイズされたヘルプメッセージをPost command replyアクション内で定義すると、次のことができます。

• ボット固有の機能をより詳しく説明する
• ユーザーにスコープ設定できる他のアプリ（例：Salesforce、ServiceNow、Jira）からの情報を含める
• モーダルを開いたり、ユーザーをボットアプリホームに移動させたりできる複数ステップのhelpフローを構築する

入力 ​

入力は不要です。

出力 ​

ヘルプメッセージの優先順位 ​

ヘルプメッセージは次の優先順位を使用します。

1. レシピ内のカスタムヘルプ
2. コネクションレベルのカスタムヘルプJSON
3. デフォルトヘルプ

新規イベントトリガー ​

New eventトリガーは、Slackワークスペースで指定したイベントが発生したときに実行されます。このトリガーは、SlackのEvents APIおよびインタラクティブコンポーネント（ブロックアクションやモーダル送信など）と連携します。各トリガーは1種類のイベントをサブスクライブします。

Workbot for SlackのNew eventトリガー

デフォルトでは、このトリガーには最も頻繁にサブスクライブされるイベントの一覧が含まれています。探しているイベントが一覧にない場合は、Enter custom valueに切り替えてイベントを手動で設定できます。

Event nameはイベントをレシピに関連付け、コンテキストの提供に役立ちます。それ以外の場合、構文は強制されません

Event schemaの下にあるUse a sample JSONをクリックしてサンプルJSONを指定することで、イベントペイロードを生成することもできます。

サンプルJSONイベント

カスタムJSONイベント

サブスクライブできるイベントの一覧については、SlackのAPI Event Typesドキュメントを参照してください。

このトリガーはEnterprise botsと一緒に使用するのが最適です。これにより、ボットがサブスクライブするボットまたはワークスペースイベントを指定できます。イベントをサブスクライブするには、Slackのボットに移動し、Event Subscriptionsに移動します。必要なイベントをサブスクライブし、Save Changesをクリックします。

SlackのEvent Subscriptions

New shortcutトリガー ​

New shortcutトリガーは、ワークフローを開始する強力な方法です。グローバルショートカットからワークフローを起動するか、メッセージショートカットを使用してSlackメッセージをタスクやチケットに変換します。このトリガーはGlobalショートカットとMessageショートカットの両方で機能し、Enterpriseボットでショートカットを作成する必要があります。

Workbotショートカットの例

トリガーされると、ショートカットはダイアログを起動してユーザーからコマンド入力フィールドを収集します。メッセージの元の内容（ダイアログから取得した入力とともに）を使用して、タスク、チケットなどを作成できます。ショートカットの使用を開始するには、ショートカットドキュメントを確認してください。

必要に応じて、ユーザーから追加情報を収集するダイアログボックスを起動します。

New shortcutトリガー

ショートカットの使用を開始するには、Shortcutsドキュメントを確認してください。

New URL mention ​

このトリガーはSlack内の特定の種類のURLを監視し、そのようなURLがメンションされると、事前定義済みのフォーマット済みデータをチャネルに取り込みます。現在、SalesforceおよびGitHubのURLがサポートされています。

SlackでURLを送信すると、Workbotがチャネル内の全員に表示される特定の情報を提供できます。たとえば、SalesforceリードURLを営業チャネルに送信すると、Workbotはその特定のリードに関する詳細情報を示すメッセージを自動的に送信します。

Workbot URL mention

トリガーでアプリケーション（現在はSalesforceとGitHubのみ）を選択し、Documentを選択して、必要に応じてアクションを設定します。デフォルトでは、Workbotが参加しているチャネルにSalesforceまたはGitHubのURLを提供すると、Workbotからのプロンプトがトリガーされます。このプロンプトでは、送信したURLのコンテンツの詳細を表示するかどうかを確認します。 yesを選択してレシピをトリガーします。メッセージに含めるフィールドを増減する場合は、Workatoでレシピを編集することもできます。

Workbot URL詳細

New dynamic menu event ​

ダイアログを呼び出すWorkbotコマンドレシピでは、動的メニューオプションを使用してselectフィールドを定義できます。

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

このトリガーは、ユーザーがそのようなフィールドに入力したときに実行され、ユーザーが入力した内容（例：typeahead値）を返します。イベントをトリガーするには、少なくとも5文字を入力する必要があります。

このtypeahead値を使用して、レコードの一覧（Salesforceなどの別のアプリから）を取得し、メインレシピ（例：selectフィールドがあるダイアログを投稿するレシピ）に返します。

Typeheadの例

Return menu optionsアクションを使用して、レコードの一覧を動的メニューに返すことができます。したがって、このトリガーは常にReturn menu optionsアクションと組み合わせる必要があります。

入力 ​

動的メニュー名 ​

このメニューの識別子。

コマンド入力フィールド ​

動的メニューオプションを含むWorkbotコマンドレシピは、Dynamic menu recipe paramsフィールドを通じてDynamic menuレシピにパラメータを渡すことができます。動的メニューレシピは、メニューオプションの生成時にこれらの追加パラメータを使用できます。

値'Closed Won'を持つ'stagename'パラメータを渡す、動的メニューオプションフィールドを含むWorkbotコマンドレシピ

これに対応して、トリガーにも同じパラメータを定義する必要があります。

同じ'stagename'パラメータが定義された対応する動的メニューレシピ

その後、動的メニューレシピはメニューオプションの生成時に追加パラメータを利用できます。以下の例では、パラメータstagenameが動的メニューレシピに渡され、SOQL検索をさらに絞り込むことができます。

SOQL検索を絞り込むために'stagename'パラメータが渡される

出力 ​

FAQ ​