プロアクティブトリガーは、会話の外部から手順を開始できます：顧客がウェブサイト上の特定の要素をクリックしたとき、または外部システムが Intercom API を呼び出したときです。
顧客体験
プロアクティブトリガーが作動したとき：
Fin は、会話が始まる前にトリガーの一部として設定した最初のメッセージ（開始メッセージ）を顧客に送信します。
手順は顧客が返信した後にのみ開始されます。
顧客がまったく返信しない場合、会話は Pending の結果でクローズされます。
プロアクティブ手順の設定
ウェブサイト要素から手順をトリガーする
ウェブサイト要素のクリックトリガーは、顧客がウェブサイト上の特定のボタン、リンク、または他の要素をクリックしたときに発火します。例えば、顧客が認識しない請求に対して異議を申し立てる手順を、該当する請求のボタンをクリックしたときに開始するよう設定できます。
ウェブサイト要素用のプロアクティブ手順を設定する方法
エディタで Procedure を開きます。
When to trigger セクションで、Based on events に移動して Add をクリックします。プロアクティブトリガーパネルが右側に表示されます。
プロアクティブトリガーパネルから Website element click を選択します。
要素が存在するページの URL を入力し、Browse and select をクリックします。
追加した URL にリダイレクトされます。必要に応じてページ下部のツールバーにある Navigate ボタンを使用して別のページに移動してください。
使用したい要素にカーソルを合わせると、選択時にハイライト表示されます。Select をクリックして確認し、次に Save and close をクリックします。
Fin の最初のメッセージを追加します—これは手順がトリガーされたとき、会話が始まる前に Fin が送信する開始メッセージです。Fin は顧客が返信した後にのみ手順の指示を実行し始めます。
Let Fin continue after this procedure ends セクションを展開します。これは会話中および会話後の Fin の動作を制御します。メインの Fin 展開設定とは別で、イベントによってこの手順がトリガーされた場合にのみ適用されます。
この手順の動作設定を構成します。During the conversation では、Fin が従うトレーニング（コンテンツ、ガイダンス、手順、属性、エスカレーション）を選択し、エスカレーションや応答タイプの扱いを設定します。At the end of the conversation では、フォローアップメッセージ、CSAT、オートクローズの設定を行います。
If Fin can't resolve the conversation, send it to の下で、特定のチームにルーティングするには Team を選択する（または Unassigned のままにする）、または自動化をトリガーするには Workflow を選択します。会話を引き継ぐ前に Fin が顧客に送るメッセージも作成できます。
外部イベントから手順をトリガーする
API 呼び出しトリガーは、外部システムがプログラム的に手順を開始できるようにします。例えば、アプリ内でファイルアップロードが失敗した場合、システムが API を呼び出してトラブルシューティング手順を開始し、顧客に解決方法を案内できます。
Note: このトリガーは web（Messenger）と email チャネルをサポートします。チャネルが指定されていない場合は既定で web になります。
前提条件
アクセス トークンを持つ Developer Hub アプリ
トークンには write_conversations スコープが必要です
Important: アクセストークンはサーバー側で保管してください。クライアント側コードに含めて公開されないようにしてください。
API 呼び出しを行う
エディタで Procedure を開きます。
When to trigger セクションで、Based on events に移動して Add をクリックします。プロアクティブトリガーパネルが右側に表示されます。
API call を選択します — 手順固有のエンドポイント URL がここに表示されます。
その URL にヘッダーとボディを付けて POST リクエストを送信します。
Fin の最初のメッセージを設定します（必須）。
デプロイ設定を構成します — 会話中および会話後の Fin の動作、Fin が解決できない場合のルーティング先などを制御します。
必須ヘッダー：
Authorization: Bearer {your-access-token}
Intercom-Version: UnstableImportant: Intercom-Version: Unstable ヘッダーは必須です。このエンドポイントはまだ安定した API バージョンにありません — このヘッダーを省略するとリクエストは失敗します。
リクエストボディ：
{
"user": {
"id": "your-user-id"
},
"context": {
"your_key": "your-value"
}
}
context フィールドはオプションです。トランザクション ID のようなカスタムのキーと値のペアを渡して、Fin が会話中に読み取って使用できるようにします。トリガーコンテキスト全体は Read attributes ステップから参照できますが、内部の個々のキーと値のペアは参照できません — Fin はそれらに直接アクセスします。
成功レスポンス
成功したリクエストは conversation_id と procedure_id を返します：
{
"conversation_id": "...",
"procedure_id": "..."
}
デプロイ設定
これらの Settings は、プロアクティブトリガーで開始された会話に対する Fin の動作を制御します。
これらはメインの Fin 展開設定とは別で、この手順がイベントによってトリガーされた場合にのみ適用されます。
会話中、Fin は次のことを行います：
トレーニングに従う — Fin が従うトレーニングを選択します：コンテンツ、ガイダンス、手順、属性、エスカレーション。それぞれは個別に管理できます。
応答タイプを制御する — Fin が AI Answers か Custom Answers を使用するかを設定します。
人間のサポートの期待を設定する — 必要に応じて、チームメンバーに引き継ぐ前の待ち時間について顧客に通知できます。
引き継ぎ前に追加情報を要求する — 有効にすると、顧客がチームメンバーとの会話を希望したときに Fin が追加コンテキストを収集します。
会話終了時、Fin は次のことを行います：
非アクティブな顧客にフォローアップする — Fin が顧客がまだ支援を必要としているか確認するか、エスカレーションを提案するか、フォローアップを行わないかを選択します。
会話終了後に会話評価（CSAT）を求める — 任意で会話終了後に CSAT 調査を送信します。
放置された会話を自動でクローズする — 顧客が非アクティブになった会話を Fin がいつクローズするかを設定します。
Fin が会話を解決できない場合、チームに送るかワークフローをトリガーするかを選択します：
Team — ドロップダウンから特定のチームを選択するか、Unassigned のままにします。
Workflow — ドロップダウンからトリガーするワークフローを選択します。
両方のオプションで、会話を引き継ぐ前に Fin が顧客に送るメッセージを入力できます。
最初の顧客返信後のルーティング
手順をトリガーしても必ず実行されるとは限りません。顧客の最初の返信の後、Fin はメッセージを評価して進め方を決定します：
以下の条件が該当しない場合、Fin はトリガーされた手順に従います
返信が人間のエージェントを求めている場合、Fin は手順を脇に置きます。
返信が別の手順のインテントに一致する場合、Fin は手順を脇に置きます。
返信に対してヘルプコンテンツから自信を持って回答できる場合、Fin は手順を脇に置きます。
Note: プロアクティブフローを設計する際はこれを考慮してください — 顧客の最初の返信が Fin を別の方向に引き込む場合、トリガーされた手順が実行される保証はありません。