手順は通常、顧客の意図によってトリガーされます。Finは顧客の発言を手順の「使用タイミング」基準と照合します。プロアクティブトリガーは会話の外部から手順を開始できます:顧客がウェブサイトの特定要素をクリックしたとき、または外部システムがIntercom APIを呼び出したときです。
注意:プロアクティブ手順トリガーはベータ版です。アクセスにはアカウントマネージャーにお問い合わせください。
顧客体験
プロアクティブトリガーが発動したとき:
Finは設定した最初のメッセージを顧客に送信します
手順は顧客が返信してから開始されます
顧客が返信しない場合、会話は保留中の結果で終了します
重要:保留中の結果は解決率にカウントされません。プロアクティブトリガーはアウトリーチ用であり、解決指標は顧客が関与し手順が実行された場合にのみ適用されます。
最初の顧客返信後のルーティング
手順がトリガーされても必ず実行されるわけではありません。顧客の最初の返信後、Finはメッセージを評価し進行方法を決定します:
以下の条件に該当しなければ、Finはトリガーされた手順に従います
返信が人間の担当者を求める場合、Finは手順を保留します
返信が別の手順の意図に合致する場合、Finは手順を保留します
返信に対してヘルプコンテンツから自信を持って回答できる場合、Finは手順を保留します
注意:この点を考慮してプロアクティブフローを設計してください。顧客の最初の返信がFinを別方向に導く場合、トリガーされた手順が必ず実行されるとは限りません。
ウェブサイト要素クリックトリガーの設定
ウェブサイト要素クリックトリガーは、顧客がウェブサイトの特定のボタン、リンク、または他の要素をクリックしたときに発動します。
重要:このトリガーはウェブ(Messenger)のみで利用可能です。Messengerは要素が表示されるページにインストールされている必要があります。
エディターで手順を開く
「使用タイミング(トリガー)」>「プロアクティブトリガー」へ移動
「ウェブサイト要素クリック」を選択
ページURLを入力し、「参照して選択」をクリックして要素を選択
Finの最初のメッセージを設定します。これは必須で、トリガー発動時にFinが送信します。
手順終了後の展開設定を構成
APIコールトリガーの設定
APIコールトリガーは外部システムがプログラム的に手順を開始できます。
注意:このトリガーはウェブ(Messenger)とメールチャネルをサポートします。チャネル指定がない場合はウェブがデフォルトです。
前提条件
アクセス トークンを持つDeveloper Hubアプリ
トークンにはwrite_conversationsスコープが必要です
重要:アクセス トークンはサーバー側で保管してください。クライアント側コードに含めてはなりません。
APIコールの実行
エディターで手順を開く
「使用タイミング(トリガー)」>「プロアクティブトリガー」へ移動
「APIコール」を選択します。手順固有のエンドポイントURLが表示されます。
そのURLにPOSTリクエストを、以下のヘッダーとボディで送信します。
Finの最初のメッセージを設定(必須)
手順終了後の展開設定を構成
必須ヘッダー:
Authorization: Bearer {your-access-token}
Intercom-Version: Unstable重要:Intercom-Version: Unstableヘッダーは必須です。このエンドポイントはまだ安定版APIではありません。このヘッダーを省略するとリクエストは失敗します。
リクエストボディ:
{
"user": {
"id": "your-user-id"
}
}成功レスポンス
成功したリクエストはconversation_idとprocedure_idを返します:
{
"conversation_id": "...",
"procedure_id": "..."
}