ユーザーアクションの待機

機能の互換性

ユーザーアクションの待機機能は、特定のWorkbotアクションとモーダルのみサポートされています。以下が該当します：

• コマンドの返信を投稿
• メッセージを投稿
• モーダルビューのオープン/更新またはプッシュ

ボタン付きセクション（新バージョン） メッセージブロックと ボタン（新バージョン） オプションを使用すると、ユーザーアクションの待機機能をサポートできます。これにより、ワークボットとユーザーの対話の複数のステップを1つのレシピで指定できるため、ロジックを簡素化し、レシピの数を減らし、不要なボットコマンドを避けることができます。常に同じレシピでユーザーアクションを処理することをお勧めします。

このガイドでは、コマンドの返信とメッセージの投稿のワークボットアクションでユーザーアクションの待機機能を設定する方法について説明します。

ユーザーアクションの待機の設定方法

1

タイプドロップダウンから**ボタン付きセクション（新バージョン）**を選択します。

2

以下のフィールドを設定します：

• セクションテキスト

• 表示テキスト。マークダウンをサポートしています。

• ボタンクリック時のアクション

• ユーザーがボタンをクリックしたときに実行するアクションを選択します。ここで選択するアクションによって、追加のフィールドを設定する必要があります。詳細についてはステップ3を参照してください。利用可能なアクションは次のとおりです：

  • レシピの継続

  • ユーザーがボタンを押した後に会話のフローが続く場合に使用します。通常、このボタンは1回しか押せません。例えば、ユーザーに承認ボタンと却下ボタンを表示し、ユーザーが応答した後にWorkbotが他のアクションを実行するように設定することができます。

    レシピの継続を選択すると、追加のデータピル（選択されたボタンと選択されたブロックID）がレシピデータで使用できるようになります。

  レシピの継続ボタンの動作

  ユーザーがレシピの継続ボタンをクリックすると、Workbotは同じボタンを複数回クリックすることを防ぐため、現在のメッセージを削除します。ボタンがクリックされた後もユーザーの前に情報を残す場合は、メッセージを2つに分割することを検討してください。例えば、情報が必要なメッセージとレシピの継続ボタンが含まれるメッセージを作成することができます。

  • ボットコマンドの実行

  • ボタンがメインの会話から外れた別のフローを開始する場合に使用します。例えば、ユーザーにデータの更新ボタンを表示し、外部サービスからデータを読み込んでメッセージを更新することができます。通常、このタイプのボタンは複数回押すことができます。

  • URLを開く

  • ユーザーがアクションを実行した後にURLを開きます。

  ボタンアクションの選択

• ボタンのタイトル

• ボタンの表示テキスト。

• ブロックID

• ブロックの内容を更新するために、このIDを後続のボットレシピで参照します。このフィールドを空白のままにすると、Slackがランダムな値を生成します。最大255文字。

• ボタンのスタイル

• ボタンのスタイルを決定します。次のオプションから選択できます：

  • リストから選択

  • 事前定義されたオプションのリストから選択します。これには次のものが含まれます：

    • デフォルト

    • デフォルトのスタイルのボタンです。

    • プライマリ

    • プライマリのアクションやステートのスタイルのボタンです。

    • デンジャー

    • デンジャーステートのスタイルのボタンです。

  • カスタム値を入力

  • Workbot Block Kitのカスタム値を入力します。利用可能な値には、デフォルト、プライマリ、デンジャーがあります。

3

ボタンクリック時のアクションで選択したアクションに応じて、追加のフィールドを設定します。

以下は、ボタンアクションと必要なフィールドのリストです。

• レシピの継続

• ボットコマンドの実行

• • ボットコマンド

  • Slackユーザーがドロップダウンからこのオプションを選択したときにWorkbotが実行するコマンドです。

    • リストから選択
      を選択

    • 事前に指定したコマンドのリストからコマンドを選択します。

    • カスタム値を入力
      を選択

    • コマンドのためのカスタム値を入力します。

  • コマンドの入力値

  • コマンドの入力値を渡します。例えば、 名前： ジョン・スミス 年齢： 42。

• URLを開く

• • URL
  • ユーザーがボタンをクリックしたときに開くURLです。

後続のステップでユーザーアクションの待機を使用する方法

前のセクションのステップ2でレシピの継続ボタンアクションを選択した場合、次に何が起こるかを決定する必要があります。

このセクションでは、後続のステップでユーザーアクションの待機を含むレシピロジックの構築方法について説明します。

1

+（プラス）ボタンをクリックします。

2

IF条件を選択します。

3

アプリ（Workbot for Slack）とアクション（Post messageまたはPost command reply）を選択します。

4

前のレシピステップで決定したボタンアクションをマッピングして、IF条件を設定します。

• データフィールド

• レシピステップ2の出力から選択したボタンデータピルをマッピングします。選択したボタンは、ボタンクリック時のアクションを実行するときに選択したボタンです。

• 条件

• 条件を選択します。例えば、等しいを選択します。

• 値

• 値を決定します。選択したボタンのボタンタイトルに対応する値を決定します。 例えば、私たちの例では、レシピステップ2のボタンタイトルであるレシピを続行を選択しました。

選択したボタンデータピルをマッピングする

5

次に何が起こるかを決定します。

私たちの例では、ステップ2の選択したボタンデータピルにレシピを続行が含まれている場合、WorkatoはGoogle Sheetsのシートに行を追加します。

6

IF条件が満たされない場合、Workatoは他のアクションを実行します。

私たちの例では、別のIF条件があります。ユーザーアクションに設定された有効期限を処理するために、IF条件を設定する必要があります。

有効期限データピルをマッピングする

• データフィールド

• レシピステップ2の出力から有効期限データピルをマッピングします。

• 条件

• 条件を選択します。有効期限データピルは真偽値（true/false）を持つため、trueであるを選択しました。

7

以下のオプションフィールドを設定します。

• レシピを続行しない場合、ボタンをクリックしない場合
• この時間間隔を経過すると、誰もボタンをクリックできなくなり、レシピは待機を停止し、有効期限データピルの値がTRUEに設定され、レシピは自動的に次のステップに進みます。
  • デフォルト値：
  • 43200分（30日）。 カスタムの分数値を入力することもできます。

8

次に何が起こるかを決定します。

私たちの例では、有効期限がtrueの場合、Workbotはアクションの期限切れを示すメッセージを送信するように設定されています。

9

IF条件が満たされない場合、Workbotはメッセージを送信します。

データピル

ボタンクリック時のアクションがレシピを続行に設定されている場合、以下のデータピルを使用してダウンストリームのレシピロジックを構築することができます。

• 選択したボタン：このデータピルはセクションテキストフィールド（選択したボタン名）の値に対応します。

• 選択したブロックID：このデータピルは、選択したボタンを含むブロックのIDに対応します。

• ユーザー：選択を行ったユーザーに関する情報（メッセージがチャンネルに投稿された場合に便利です）：

  • ユーザーID：ユーザーのSlack ID
  • ユーザーハンドル：Slackでのユーザーハンドル（ユーザーを@メンションするために使用）
  • ユーザー名：Slackでのユーザーのフルネーム
  • チームID：ユーザーのチームのSlack ID

以下のデータピルは、ボタンをクリックしない場合のレシピを続行する入力フィールドを設定する場合にのみ使用できます。

• 有効期限：このデータピルは有効期限フィールドに対応します。ボタンをクリックしない場合のレシピを続行するで指定された時間が経過すると、その値はtrueになります。