プロアクティブトリガーは、会話の外部から手続きを開始できます。顧客がウェブサイトの特定の要素をクリックしたときや、外部システムがIntercom APIを呼び出したときなどです。
顧客体験
プロアクティブトリガーが発動したとき：
Finは設定した最初のメッセージを顧客に送信します。これは会話が始まる前にトリガーの一部として設定したオープニングメッセージです。
顧客が返信した後にのみ手続きが開始されます。
顧客が返信しない場合、会話は保留中の結果で終了します。
プロアクティブな手続きを設定する
ウェブサイトの要素から手続きをトリガーする
ウェブサイトの要素クリックトリガーは、顧客が特定のボタン、リンク、または他の要素をクリックしたときに発動します。例えば、顧客が認識しない請求のボタンをクリックしたときに、取引の異議申し立て手続きを開始できます。
ウェブサイト要素のプロアクティブ手続きの設定方法
Fin AI Agent > トレーニング > 手続きに移動します。
エディターで手続きを開きます。
トリガーのタイミングセクションで、イベントに基づくに進み、追加をクリックします。プロアクティブトリガーパネルが右側に表示されます。
プロアクティブトリガーパネルからウェブサイト要素クリックを選択します。
要素があるページのURLを入力し、参照して選択をクリックします。
追加したURLにリダイレクトされます。必要に応じて、ページ下部のツールバーのナビゲートボタンで別のページに移動できます。
使用したい要素にカーソルを合わせると選択時にハイライトされます。選択をクリックして確定し、保存して閉じるをクリックします。
Finの最初のメッセージを追加します。これは手続きがトリガーされたときにFinが送るオープニングメッセージで、会話が始まる前に送信されます。Finは顧客が返信した後にのみ手続きの指示を実行し始めます。
この手続き終了後にFinを継続させるセクションを展開します。これは会話中および終了後のFinの動作を制御し、メインのFin展開設定とは別で、この手続きがイベントによってトリガーされた場合にのみ適用されます。
この手続きの動作設定を構成します。会話中では、Finが従うトレーニング（コンテンツ、ガイダンス、手続き、属性、エスカレーション）を選択し、エスカレーションや回答タイプの処理方法を設定します。会話終了時には、フォローアップメッセージ、CSAT、自動終了の設定を行います。
Finが会話を解決できない場合は、次に送る先で、特定のチームにルーティングするにはチームを選択（または未割り当てのまま）、自動化をトリガーするにはワークフローを選択します。会話を引き継ぐ前にFinが顧客に送るメッセージも作成可能です。
外部イベントから手続きをトリガーする
APIコールトリガーは外部システムがプログラム的に手続きを開始できます。例えば、アプリでファイルアップロードが失敗した場合、システムがAPIを呼び出してトラブルシューティング手順を案内する手続きをトリガーできます。
注意：このトリガーはウェブ（Messenger）とメールチャネルをサポートします。チャネル指定がない場合はウェブがデフォルトです。
前提条件
アクセストークンを持つDeveloper Hubアプリ
トークンにはwrite_conversationsスコープが必要です。
重要：アクセストークンはサーバー側で保管してください。クライアント側コードに含めて漏洩しないようにしてください。
APIコールの実行
Fin AI Agent > トレーニング > 手続きに移動します。
エディターで手続きを開きます。
トリガーのタイミングセクションで、イベントに基づくに進み、追加をクリックします。プロアクティブトリガーパネルが右側に表示されます。
APIコールを選択します。手続き固有のエンドポイントURLがここに表示されます。
そのURLにPOSTリクエストを、以下のヘッダーとボディで送信します。
Finの最初のメッセージを設定します（必須）。
展開設定を構成します。Finの会話中および終了後の動作を制御し、解決できない場合のルーティング先も設定します。
必須ヘッダー：
Authorization: Bearer {your-access-token}
Intercom-Version: Unstable重要：Intercom-Version: Unstableヘッダーは必須です。このエンドポイントはまだ安定したAPIバージョンではありません。このヘッダーを省略するとリクエストは失敗します。
リクエストボディ：
{
"user": {
"id": "your-user-id"
},
"context": {
"key": "value"
}
}contextフィールドは任意です。取引IDなどのカスタムキー・バリューを渡し、手続きが会話中に変数として参照できます。
成功レスポンス
成功したリクエストはconversation_idとprocedure_idを返します：
{
"conversation_id": "...",
"procedure_id": "..."
}
展開設定
これらの設定は、プロアクティブトリガーで開始された会話に対するFinの動作を制御します。
これらはメインのFin展開設定とは別で、この手続きがイベントによってトリガーされた場合にのみ適用されます。
会話中、Finは以下を行います：
トレーニングに従う — Finが従うトレーニング（コンテンツ、ガイダンス、手続き、属性、エスカレーション）を選択します。各項目は独立して管理可能です。
回答タイプを制御 — FinがAI AnswersまたはCustom Answersを使用するか設定します。
人間のサポートへの期待を設定 — 必要に応じて、チームメンバーに引き継ぐ前の待ち時間を顧客に通知します。
引き継ぎ前に追加情報を求める — 有効にすると、顧客がチームメンバーと話したいときにFinが追加のコンテキストを収集します。
会話終了時、Finは以下を行います：
非アクティブな顧客にフォローアップ — Finが顧客の支援がまだ必要か確認するか、エスカレーションを提案するか、フォローアップを送らないかを選択します。
会話評価（CSAT）を依頼 — 会話終了後にCSAT調査を送信するオプションです。
放置された会話を自動終了 — 顧客が非アクティブになった会話をFinがいつ終了するか設定します。
Finが会話を解決できない場合、チームに送るかワークフローをトリガーするか選択します：
チーム — ドロップダウンから特定のチームを選択、または未割り当てのままにします。
ワークフロー — ドロップダウンからトリガーするワークフローを選択します。
両方のオプションで、会話を引き継ぐ前にFinが顧客に送るメッセージも入力できます。
最初の顧客返信後のルーティング
手続きをトリガーしても必ず実行されるわけではありません。顧客の最初の返信後、Finはメッセージを評価し、進行方法を決定します：
以下の条件に該当しなければ、Finはトリガーされた手続きを実行します。
返信が人間のエージェントを求める場合、Finは手続きを保留します。
返信が別の手続きの意図に合致する場合、Finは手続きを保留します。
返信に対してヘルプコンテンツから自信を持って回答できる場合、Finは手続きを保留します。
注意：プロアクティブフローはこれを考慮して設計してください。顧客の最初の返信がFinを別の方向に導く場合、トリガーされた手続きが必ず実行されるとは限りません。