この記事では、Finが訪問者を認識できるように、PendoとIntercom間のIDマッピングを設定する方法について説明します。Pendoの訪問者IDとIntercomのユーザーIDがすでに一致している場合を除き、タスクナッジやフラストレーションシグナルのサポートなど、Intercomインテグレーションの機能を対象の訪問者に対して利用するには、IDの同期が必要です。
ID同期はPendoアプリの設定で行われています。エージェント自体を接続し、その機能を有効にするには、「Agent Toolkitでエージェントを設定する」の手順を完了していることを確認します。
仕組み
PendoとIntercomのインテグレーションにより、サポートとプロダクトツールが連携するため、チームは各訪問者の全体像を共有して作業できます。Intercomとのインテグレーションには、次のような複数の側面があります。
- IDの同期。Pendo訪問者IDをインターコムユーザーIDに双方向にマッピングします。
- FinがPendoのガイドにアクセスできるようにします。Pendo MCPを使うと、Finは訪問者に関連ガイドを表示することができます。
- フラストレーションシグナルのWebhook。Webhookを使用してIntercomからのフラストレーションシグナルを表示します。
- タスクの促し。アプリ内で重要なタスクを定義し、訪問者が完了前に離脱した場合でも、次のセッションでFinが再度関与して完了を促せるようにしましょう。
- セッションコンテキストツール。Pendo MCPを使用してセッションコンテキストをインテグレーションのツールに公開します。
Pendoの訪問者IDとIntercomのユーザーIDがすでに一致している場合は、これを設定する必要はありません。一致しない場合、Finでは訪問者を特定できないため、フラストレーションシグナル、タスクナッジ、セッションコンテキスト、ガイドを機能させるにはIDの同期が必要です。
ステップ1:IntercomとPendoのIDを比較する
PendoとIntercomで、訪問者(Intercomでは「ユーザー」と呼ばれます)を識別するために同じIDが使用されていることを手動で確認します。
- Intercomで、アプリケーションのユーザーの詳細を開きます。
- ユーザー詳細パネルでユーザーIDを表示します。この値をコピーしてPendoで使用します。
- Pendoで、[ピープル(People)]>[訪問者(Visitors)]に移動します。
- IntercomのユーザーIDの値を検索バーに貼り付けてください。
- Pendoで同じユーザーを検索しても返ってきた場合、IDはすでに同期されています。次の手順に進む必要はありません。インターコムフィンとPendoの使い方については「次の手順」をご覧ください。
- 検索してもPendoにユーザーが返されない場合は、次の手順を実行して、PendoとIntercom間のIDマッピングを完了する必要があります。
ステップ2:Pendo ID同期を有効にする
IntercomとPendoの両方を使用するアプリケーションごとに、このセクションの手順を実行します。
アプリケーション設定へのアクセス
- Pendoで、[設定(Settings)]>[サブスクリプション設定(Subscription settings)]に移動します。
- [アプリケーション(Applications)]タブを選択します。
- アプリケーションのリストで、設定するアプリケーションを選択します。[アプリの詳細(App Details)]タブにアプリケーション設定が表示されます。
訪問者IDとIntercomの同期を有効にする
- [アプリの詳細(App Details)]で、[訪問者IDをIntercomと同期(Sync visitor IDs with Intercom)]設定を見つけます。
- チェックボックスを選択すると、この設定が有効になります。
Intercomとの訪問者ID同期を有効にすると、PendoはページからIntercomユーザーIDを読み取り、それをintercomUserIdとして訪問者メタデータに保存し、Pendo訪問者IDをカスタム属性pendoVisitorIdとしてIntercomにプッシュします。
PendoとIntercomの両方がインストールされているすべてのアプリケーションで、このプロセスを繰り返します。
ステップ3:IntercomでPendoの訪問者IDカスタム属性を作成する
pendoVisitorIdという名前のユーザーカスタム属性を作成し、Pendoがその属性に書き込めるように検証済みの更新が不要であることを確認します。
- Intercomで設定を開きます。
- Intercomのドキュメント「カスタムデータ属性(CDA)の作成と追跡」に記載されている手順に従って、新しい属性を作成します。
- [新しいユーザー属性を作成(Create new people attribute)]モーダルで、次の情報を更新します:
- フォーマット:テキスト。
-
名前:
pendoVisitorId。 - 検証済みの更新が必要:オフ。Intercomには、この属性が未検証の更新を受け付けることを示す注記が表示されますが、これはこの属性では想定された動作です。
- [保存]を選択します。
ステップ4:セットアップを確認する
イベントデータが流れて処理されるまでしばらく待ってから、同期によってPendoにintercomUserIdフィールドが生成されていることを確認します。
- Pendoで、[設定(Settings)]>[メタデータ(Metadata)]に移動します。[訪問者レベルのデータ(Visitor-level data)]タブが開きます。
- [マッピング(Mappings)]テーブルで、
intercomUserIdフィールドが使用可能になっていることを確認します。
intercomUserIdフィールドが表示されない場合は、設定してからまだ時間が経っていない可能性があります。このフィールドは、ID同期が有効になり、イベントデータが処理された後にのみ表示されます。データがシステムを通過する時間によっては、最大1時間かかることがあります。
次のステップ
PendoとIntercom間のIDのマッピングが正常に完了したら、Intercom Finとのインテグレーションの設定に進むことができます。次のいずれか、またはすべてを設定するかを選択します:
- FinとPendoのガイドを共有して、その場で正しい情報を得られるようにしましょう。詳細については、「Intercom Finを使用してPendoガイドを表示する(ベータ版)」を参照してください。
- PendoからIntercom Finにリアルタイムのフラストレーションシグナルを送信して、アプリのユーザーを積極的に支援します。詳細については、「フラストレーションシグナルに基づいてIntercom Finによるプロアクティブな対応を実現する(ベータ版)」を参照してください。
- Finがタスク完了前に離脱したユーザーを再び引きつけることができるよう、タスク通知を設定します。詳細については、「AIエージェントを介してタスク通知を送信する」を参照してください。
- PendoからIntercomにセッションコンテキストを共有することで、Finはこれまでのアプリでのユーザージャーニーに関するコンテキストをできるだけ多く把握できます。詳細については、「セッションコンテキストを使用してFinの解決率を向上させる(ベータ版)」を参照してください。