メインコンテンツにスキップ

プロアクティブ手順トリガー:ウェブサイト要素のクリックとAPI

ウェブサイトのボタンクリックや外部APIコールからFin手順を起動する方法。設定、顧客体験、ルーティング動作を含む。ベータ機能。

対応者:Dawn Perrott

手順は通常、顧客の意図によってトリガーされます。Finは顧客の発言を手順の「使用タイミング」基準と照合します。プロアクティブトリガーは会話の外部から手順を開始できます:顧客がウェブサイトの特定要素をクリックしたとき、または外部システムがIntercom APIを呼び出したときです。

注意:プロアクティブ手順トリガーはベータ版です。アクセスにはアカウントマネージャーにお問い合わせください。

顧客体験

プロアクティブトリガーが発動したとき:

  1. Finは設定した最初のメッセージを顧客に送信します

  2. 手順は顧客が返信してから開始されます

  3. 顧客が返信しない場合、会話は保留中の結果で終了します

重要:保留中の結果は解決率にカウントされません。プロアクティブトリガーはアウトリーチ用であり、解決指標は顧客が関与し手順が実行された場合にのみ適用されます。

最初の顧客返信後のルーティング

手順がトリガーされても必ず実行されるわけではありません。顧客の最初の返信後、Finはメッセージを評価し進行方法を決定します:

  • 以下の条件に該当しなければ、Finはトリガーされた手順に従います

  • 返信が人間の担当者を求める場合、Finは手順を保留します

  • 返信が別の手順の意図に合致する場合、Finは手順を保留します

  • 返信に対してヘルプコンテンツから自信を持って回答できる場合、Finは手順を保留します

注意:この点を考慮してプロアクティブフローを設計してください。顧客の最初の返信がFinを別方向に導く場合、トリガーされた手順が必ず実行されるとは限りません。

ウェブサイト要素クリックトリガーの設定

ウェブサイト要素クリックトリガーは、顧客がウェブサイトの特定のボタン、リンク、または他の要素をクリックしたときに発動します。

重要:このトリガーはウェブ(Messenger)のみで利用可能です。Messengerは要素が表示されるページにインストールされている必要があります。

  1. エディターで手順を開く

  2. 「使用タイミング(トリガー)」>「プロアクティブトリガー」へ移動

  3. 「ウェブサイト要素クリック」を選択

  4. ページURLを入力し、「参照して選択」をクリックして要素を選択

  5. Finの最初のメッセージを設定します。これは必須で、トリガー発動時にFinが送信します。

  6. 手順終了後の展開設定を構成

APIコールトリガーの設定

APIコールトリガーは外部システムがプログラム的に手順を開始できます。

注意:このトリガーはウェブ(Messenger)とメールチャネルをサポートします。チャネル指定がない場合はウェブがデフォルトです。

前提条件

  • アクセス トークンを持つDeveloper Hubアプリ

  • トークンにはwrite_conversationsスコープが必要です

重要:アクセス トークンはサーバー側で保管してください。クライアント側コードに含めてはなりません。

APIコールの実行

  1. エディターで手順を開く

  2. 「使用タイミング(トリガー)」>「プロアクティブトリガー」へ移動

  3. 「APIコール」を選択します。手順固有のエンドポイントURLが表示されます。

  4. そのURLにPOSTリクエストを、以下のヘッダーとボディで送信します。

  5. Finの最初のメッセージを設定(必須)

  6. 手順終了後の展開設定を構成

必須ヘッダー:

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": "..."
}
こちらの回答で解決しましたか?