GetMyBot ナレッジベース

リアクションの基本

コマンド、ボタン、その他のイベントにボットがどう応答するか設定します。作成方法、実行順、リアクション間の移動を説明します。

このページの内容

リアクションは、ボットの動作を 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):共通の計算に入力を渡し、宣言済みの出力を現在のリアクションで受け取ります。ブロックライブラリとバージョン。

データを使うなら、コレクションを検索 → 次のステップを選択 → ボタン → 関連レコードを検索という流れを作れます。外部サービスからの一覧にはリストを処理 → グループと集計が使えます。各アクションの結果に名前を付け、次のアクションで選んでください。

実践レッスンでは、授業と申請を題材に両方の流れを説明しています。

設定時はパスを暗記せず、前のステップのデータ選択を使ってください。保存前に現在の下書きをサンプルデータで試し、分岐と送信予定のメッセージを確認します。保存後は、実際のアクションが動く接続済みボットとチャンネルでも、利用者の手順を別に試してください。

次のステップ