リアクション: 基本
リアクションはボットの主要な構成要素です。いつ動作するか、どの条件で、何をするかを記述するルールです。ボットはリアクションの順序付きリストであり、受信したイベントごとにプラットフォームがリストを上から順に確認し、最初に一致するリアクションを適用します。このセクションは左メニューのリアクションにあります。
リアクションの構成要素
リアクションには 4 つの部分(エディターのタブ)があります。
- トリガー — リアクションが応答するイベント:テキスト、コマンド、メディア、ボタンのクリック、システムイベント、スケジュールなど。詳細はトリガーをご参照ください。
- チャット範囲 — リアクションが動作する場所:プライベートチャット、ボットへのメンション時のグループ、特定のチャット、およびユーザー状態によるフィルター。
- 条件 — 追加フィルター(ラベル、パラメータ、時間、メッセージ数など)。詳細は条件とチャットをご参照ください。
- アクション — トリガー時にボットが行うこと:メッセージの送信、ラベルの設定、コレクションへの書き込み、AIの呼び出しなど。詳細はアクションをご参照ください。
作成と編集
リアクションを作成をクリックします(または既存のリアクションを開きます)。エディターのヘッダーには名前(必須)、番号 #N、説明、有効トグルがあります。左側にはセクションナビゲーション(トリガー / チャット範囲 / 条件 / アクション)、中央にはフォーム、右側にはTelegram プレビュー(ブロック、キーボード、メニュー付きのメッセージ表示)があります。保存ボタンで保存します。
保存済みのリアクションのエディターには統計パネル(実行回数、グラフ、最近のイベント)が表示されます。
順序と優先度
リスト内のリアクションはドラッグ&ドロップで並び替えられます。順序が優先度を決定します。イベントに対して最初に一致するリアクションが実行され、その後の処理は停止します。次に一致するリアクションにも実行を続けたい場合は、次のリアクションアクション(goto_next)を追加してください。
有効化と無効化
リストの行のトグル(またはエディターの有効)でリアクションを削除せずに有効・無効を切り替えられます。無効なリアクションは処理時にスキップされます。
複製と削除
リストの行には複製(コピーを作成)と削除のボタンがあります。複製は、小さな違いがある類似のリアクションを作成する際に便利です。
インポートとエクスポート
リアクションを JSON にエクスポートし(エディターのエクスポートボタン)、再インポートできます(リストのインポート)。これにより、ボット間でリアクションを移動したり、プラットフォーム外でバージョンを管理したりできます。
リアクションの一斉配信
リアクション行の一斉配信ボタン(「送信」アイコン)をクリックすると、ボットのすべてのアクティブな購読者にそのリアクションを配信します。お知らせや通知に便利です。ラベルでオーディエンスを絞り込むことができます。詳細は一斉配信をご参照ください。
チェーンとダイアログ
複数のリアクションを組み合わせてシナリオを作成できます。
- チェーンリアクション(
chain)— 実行中に別のリアクションを起動するアクション。 - 次のリアクション(
goto_next)— リスト内の次に一致するリアクションに制御を渡す。 - ダイアログステップ — メッセージブロックがユーザーの返答を待機し(フォーマット検証付き)、シナリオを一時停止します。詳細はメッセージとボタンをご参照ください。
- 「その他」ブランチ — リアクションの条件が満たされなかった場合、別のリアクションを起動できます(「条件」セクションのフィールド)。