リアクションの基本
コマンド、ボタン、その他のイベントにボットがどう応答するか設定します。作成方法、実行順、リアクション間の移動を説明します。
このページの内容
リアクションは、ボットの動作を 1 つ決めるルールです。たとえば「/price と書かれたら料金表を送る」「支払いが済んだら『支払い済み』ラベルを付けてアクセスを許可する」と設定できます。
リアクションでイベント、必要な条件、アクションを設定します。ボットは上から順に調べ、最初に合うルールを実行します。特定の場合のルールは、「どんなメッセージにも返す」ような一般的なルールより上に置いてください。
リアクションの構成
料金表の例なら、/price コマンドを選び、料金を書いたメッセージを追加するだけです。特定の人やチャットに限定したい場合は、ほかの設定を使います。エディターには 4 つのセクションがあります。
| セクション | 決めること | 例 |
|---|---|---|
| トリガー | いつ始めるか。テキスト、コマンド、メディア、ボタン、イベント、日時など | /price が送られた |
| チャット内 | どこで動くか。個別チャット、グループでの呼びかけ、特定のチャット。ユーザーの状態も考慮 | 個別チャットだけ |
| 条件 | 追加で何を確認するか。ラベル、パラメータ、経過時間、メッセージ数など | 「支払い済み」ラベルがある |
| アクション | 何をするか。送信、ラベル変更、記録、AI の呼び出しなど | 料金表を送る |
作成と編集
リアクションを作成を押すか、既存のものを開きます。エディター上部には必須の名前、番号 #N、説明、有効の切り替えがあります。左側のトリガー/チャット内/条件/アクションを選び、中央のフォームを埋めます。右側にはメッセージのブロック、ボタン、メニューが Telegram でどう見えるか表示されます。最後に保存を押します。
保存済みのリアクションには、実行回数、グラフ、直近のイベントを示す統計パネルも表示されます。
変更履歴と復元
保存済みリアクションのChange historyを開くと、直近 20 件の変更日時、変更者、変更元、変更前後の差分を確認できます。選択した変更の直前の状態に戻せます。まず差分を見てから復元を確定してください。
復元すると未保存の編集は上書きされ、復元自体も履歴に記録されます。戻るのはリアクションの設定だけです。送信済みのメッセージや変更済みのデータは元に戻りません。確認中に別のメンバーが変更した場合は、差分を更新してください。
手順と練習問題もご覧ください。
順序と優先度
検索、フィルター、フォルダー選択を解除しているときは、一覧のリアクションをドラッグして手動で並べ替えられます。この順序が優先度です。 イベントに対して最初に合うリアクションが実行され、そこで探索は止まります。後続のリアクションも調べたい場合は次のリアクション(goto_next)アクションを追加します。
検索、フィルター、グループ分け
一覧の上部では名前や番号で検索でき、次のフィルターも使えます。
- 状態: すべて、有効のみ、無効のみ。
- 作成日(開始/終了): 自分のタイムゾーンでの暦日。開始日と終了日も含みます。
- 順序: 手動(ボットが調べる順)、新しい順、古い順。
- グループ分け: 作成日または作成月。日付順のときだけ使えます。手動順でグループ分けをオンにすると「新しい順」に切り替わります。すでに選んだ日付順はそのままです。手動順に戻すとグループ分けはオフになります。
フィルターは表示中のページだけでなく全リアクションに適用され、検索やフォルダーとも併用できます。結果の件数が表示されます。フィルターの状態はページの URL に残るので、再読み込み、リンクの共有、ブラウザーの「戻る」ができます。フィルターをリセットすると検索、フィルター、順序、グループ分けは消えますが、選択中のフォルダーは残ります。
フィルターや表示順を変えても、ボットがリアクションを調べる実際の順序は変わりません。
有効化と無効化
一覧のスイッチかエディターの有効で、削除せずにリアクションをオン/オフできます。無効なものは実行時に飛ばされます。
複製と削除
各行の複製はコピーを作り、削除はリアクションを消します。少しだけ異なるルールを作るときは複製が便利です。
インポートとエクスポート
エディターのエクスポートで JSON として取り出し、一覧のインポートで読み込めます。ボット間でリアクションを移したり、プラットフォーム外で版を保管したりできます。
リアクションの一斉配信
一覧にある送信アイコンを押すと、そのリアクションをボットの有効な登録者全員へ送れます。告知や通知に便利で、ラベルで対象を絞ることもできます。詳しくは一斉配信をご覧ください。
リアクションの連結と会話
たとえば最初のリアクションが商品一覧を見せ、ボタンが商品カードを表示する 2 つ目を起動し、そこで配送先を尋ねます。リアクションをつなぐ方法はいくつかあります。
- 連鎖リアクション(
chain):実行中に別のリアクションを起動します。 - 次のリアクション(
goto_next):一覧で次に当てはまるリアクションへ渡します。 - 会話のステップ: メッセージブロックでユーザーの返答を待ち、形式も確認できます。メッセージとボタンを参照してください。
- 「それ以外」分岐: 条件に合わなかった場合、「条件」で指定した別のリアクションを起動します。
- 次のステップを選択(
branch_result):検索結果が空、1 件、複数、不完全の場合を分けて処理します。 - 値でステップを選択(
branch_value):たとえばupdatedなら申請を確定し、conflictなら状態の再確認を促します。 - アクションの結果: 対応するアクションでは、成功、競合、レコードなし、エラーで別のリアクションに移れます。分岐の選び方。
- ブロックを呼び出す(
call_block):共通の計算に入力を渡し、宣言済みの出力を現在のリアクションで受け取ります。ブロックライブラリとバージョン。
データを使うなら、コレクションを検索 → 次のステップを選択 → ボタン → 関連レコードを検索という流れを作れます。外部サービスからの一覧にはリストを処理 → グループと集計が使えます。各アクションの結果に名前を付け、次のアクションで選んでください。
実践レッスンでは、授業と申請を題材に両方の流れを説明しています。
設定時はパスを暗記せず、前のステップのデータ選択を使ってください。保存前に現在の下書きをサンプルデータで試し、分岐と送信予定のメッセージを確認します。保存後は、実際のアクションが動く接続済みボットとチャンネルでも、利用者の手順を別に試してください。