リアクションリンク
リアクションは単独で機能することはほとんどなく、ボタン、チェーン、「それ以外」ブランチ、ダイアログ返答などで互いを呼び出します。リアクションリンクはこの遷移グラフを表示します。任意のリアクションについて、どこへつながるか(送信リンク)とどこから来るか(受信リンク)を確認できます。大規模なシナリオで迷子にならず、安全にリアクションを削除するのに役立ちます。
リンクとは
リンクとは、1つのリアクションから別のリアクションへの有向遷移であり、その遷移を生み出したメカニズムでラベル付けされています。プラットフォームはリアクション全体を走査してすべての送信遷移を収集し、自己参照と空のターゲットを除外し、同一の遷移をまとめます。リンクのリストはリアクションエディターと API の両方から利用できます: GET /api/bots/{id}/reactions/{id}/links。
受信と送信
- 送信 — 現在のリアクションがどのリアクションを参照しているか(そのボタン、チェーン、「それ以外」ブランチなど)。
- 受信 — どのリアクションが現在のリアクションを参照しているか。削除前に確認すると便利です。誰かが参照していると削除でシナリオが壊れます。
12種類のリンクメカニズム
- ボタン(
button)— 「リアクション呼び出し」タイプのインラインボタンで、タップ時に別のリアクションを開きます。 - ボタン置換(
button_replace)— 「メッセージ置換」動作のボタンで、紐付けられたリアクションの内容を挿入します。 - ダイナミックボタン(
dynamic_button)— 「リストからのダイナミックボタン」ブロックのボタンで、リアクションに誘導します。ダイナミックボタンとパラメータ を参照。 - ブロック「リアクション」(
block)— 送信中に別のリアクションを呼び出すメッセージブロック。 - チェーンリアクション(
chain)— 「チェーンリアクション」アクションで別のリアクションを起動します。 - 「それ以外」ブランチ(
else)— 条件が満たされない場合、指定したリアクションに制御が移ります。 - ウェブリクエスト: 成功(
web_success)— ウェブリクエスト成功時に起動するリアクション。 - ウェブリクエスト: エラー(
web_error)— ウェブリクエストエラー時に起動するリアクション。 - 期待される返答(
expected_answer)— ダイアログステップでユーザーの返答に反応するリアクション。 - 待機タイムアウト(
expected_timeout)— タイムアウトまでに返答がなかった場合に起動するリアクション。 - 次のリアクション(
goto_next)— 「次のリアクション」アクションでリスト内の次の適切なリアクションに制御を移します。 - シナリオ(
flow)— シナリオ(flow)の完了に紐付けられたリアクション。
グラフを確認する理由
- シナリオのナビゲーション — リストを検索せずに関連するリアクションに素早く移動。
- 安全な削除 — 受信リンクを確認して遷移を壊さない。
- 監査 — シナリオのすべてのブランチが正しい場所につながっているか、「浮いた」遷移がないかを確認。
次のステップ
- リアクション: 基本 — 実行順序、チェーン、
goto_next。 - メッセージとボタン — リンクを生み出すボタンとダイアログステップ。
- ダイナミックボタンとパラメータ — ダイナミックキーボード経由のリンク。
- シナリオ — シナリオ完了経由のリンク。