この記事を使ってPendo Data connectorテンプレートを設定し、Finが顧客が助けを求める前に製品で何をしていたかを確認できるようにします。また、顧客が見る内容、制限事項、一般的な設定問題の解決方法も説明します。この記事はFinのData connectorを設定するチームメンバー向けです。PendoのAgent Toolkitへのアクセスも必要です。
Pendo Data connectorテンプレートとは何ですか？
Pendo Data connectorテンプレートは、FinをPendoのAgent Toolkitに接続する5つの既製Data connectorです。Pendoは顧客が製品をどのように使っているか（訪問したページ、使用した機能、エラーや摩擦が発生した場所など）を記録します。これらのテンプレートを使うことで、Finはそのコンテキストを利用して回答をパーソナライズし、顧客が既に試したステップを省略できます。
なぜPendo Data connectorテンプレートを使うのですか？
Pendo Data connectorテンプレートは、顧客に何をしたか説明させずにFinが製品の質問に答えるのを助けます：
コンテキストから始める：Finは顧客の最近のセッション活動を確認できるため、顧客は自分が何をしていたか説明する必要がありません。
適切なガイドを指し示す：Finはハウツー質問に合ったPendoのアプリ内ガイドを見つけ、その起動リンクを共有します。
製品フィードバックを収集：Finは顧客に代わってPendoにフィードバックを送信できます。
構築を省略：リクエスト、入力、応答フィールドは既に設定されているため、手動で構築する必要はありません。
利用可能なPendo Data connectorテンプレートはどれですか？
この表は「Pendo Agent Toolkit API」テンプレートグループの5つのPendo Data connectorテンプレートと、それぞれからFinが得るものを示しています。
テンプレート | Finが得るもの |
訪問者のPendoセッション活動を取得 | 訪問者が最近行っていたことの概要とタイムライン（ページ、アイテム、設定、エラー、デッドクリックなどの摩擦を含む）。Finは顧客の質問の簡単な説明を渡すため、概要は重要な点に焦点を当てます。 |
Pendoのアプリ内ガイドを探す | ハウツー質問に最も合うPendoガイドと、そのガイドをアプリ内で起動するリンク。Finはそのリンクを顧客と共有します。 |
訪問者のPendo AIエージェント活動を取得 | 過去30日間の訪問者の製品内AIエージェントとの直近3回の会話と、検出された直近3件の問題（エラーや幻覚など）。Pendo Agent Analyticsが必要です。 |
Pendo製品エリアを一覧表示 | Pendoサブスクリプション内のすべての製品エリアとそのIDおよび説明。Finはフィードバック送信前にこれを使用します。 |
訪問者のPendoフィードバックを送信 | 訪問者のためにPendo Feedbackにフィードバック項目を作成します。タイトル、説明、任意の製品エリア、Intercom会話へのリンクを含みます。Pendo Feedbackが必要です。 |
Pendo Data connectorテンプレートがFinの回答を助ける例としての顧客の質問：
設定を保存しようとするとエラーが頻繁に発生します。
新しいダッシュボードはどう作成しますか？
あなたのアプリ内アシスタントが間違った回答をしました。
製品チームに機能リクエストを伝えてもらえますか？
ヒント：Pendo Data connectorテンプレートをProactive Proceduresと組み合わせて、Pendoがフラストレーションの兆候を検出したときにFinの会話を開始しましょう。外部APIからプロアクティブプロシージャをトリガーする方法を学んでください。
Pendo Data connectorテンプレートを設定する前に必要なものは？
Pendo Data connectorテンプレートを設定する前に、以下を確認してください：
Pendo Agent Toolkitアクセス：Pendoでエージェントとサービスアカウントを作成する権限。
顧客認証：Intercomでメールのワンタイムパスコード（OTP）またはJSON Web Tokens（JWT）を使ったMessengerセキュリティを設定。これがないとData connectorは稼働できません。Data connector認証設定について詳しくはこちら。
訪問者IDの一致：各顧客のPendo訪問者IDがIntercomのユーザーIDまたはpendoVisitorId属性として利用可能であること。
2つのテンプレート用Pendoアドオン：Pendo Agent Analytics（AIエージェント活動用）とPendo Feedback（フィードバック送信用）。
注意：Pendo Data connectorテンプレートはウェブアプリのみ対応で、Pendo訪問者IDを持つログイン済み顧客のみ対象です。モバイルアプリやブラウザ拡張機能はまだ対応していません。
Pendo Data connectorテンプレートの設定方法
各Pendo Data connectorテンプレートは独自のData connectorを作成します。Pendoサービスアカウントは一度作成し、Finに使わせたいテンプレートごとにIntercomの手順を繰り返してください。
Fin用のPendoサービスアカウントの作成方法
Pendo Data connectorテンプレートが使用するPendoサービスアカウントを作成するには：
PendoでAgent ToolkitにIntercom Finエージェントを作成します。
エージェント用のサービスアカウントを作成します。
トークンURL、クライアントID、クライアントシークレット、スコープをコピーします。これらはPendo認証トークンをIntercomに追加するときに貼り付けます。
テンプレートからPendo Data connectorを作成する方法
IntercomでテンプレートからPendo Data connectorを作成するには：
設定 > 統合 > Data connectorsに移動し、新規作成をクリックします。
またはテンプレートから開始で、Pendo Agent Toolkit APIを選択します。
テンプレートを選び、内容を確認してから作成をクリックします。
ドラフトのPendo Dataコネクタは、リクエスト、入力、およびレスポンスフィールドがすでに入力された状態で開きます。
Pendo認証トークンの追加方法
Pendo DataコネクタにPendo認証トークンを追加するには：
Authentication tokensの下で、New tokenをクリックし、OAuth（Open Authorization）タイプを選択します。
PendoからコピーしたトークンURL、クライアントID、クライアントシークレット、およびスコープを貼り付けます。
Dataコネクタでトークンを選択します。
ヒント：次にPendo Dataコネクタテンプレートを設定するときは、新しいものを作成する代わりに同じPendo認証トークンを選択してください。
Pendoデータ入力の設定方法
Pendo Dataコネクタのデータ入力を設定するには：
Data inputsの下で、pendo_hostにチェックを入れます。デフォルトは
app.pendo.ioです。PendoのサブスクリプションがEU、AU、日本、またはus1リージョンでホストされている場合は、Custom valueをその地域のPendoホストに変更してください。Visitor ID入力を、顧客のPendoビジターIDを保持するIntercom属性にマッピングします。IntercomのUser IDとPendoのビジターIDが一致する場合はUser IDを使用します。不一致の場合はIDを同期し、pendoVisitorId属性を使用してください。
テンプレートがPendoアプリID、エージェントID、またはガイドリンクのホスト名などのチーム設定を求める場合は、それらをCustom valuesとして入力してください。
注意：FinはPendo Dataコネクタテンプレートのチーム設定（PendoアプリID、エージェントID、ガイドリンクホスト名など）を自動入力しません。これらの値はチームメンバーのみが設定します。
Pendo Dataコネクタをテストしてライブ設定する方法
Pendo DataコネクタをテストしてFinに使用させるには：
Pendoで最近アクティビティのあるテスト顧客のビジターIDでDataコネクタをテストします。
FinタブのHow should Fin use this connector?で、Enabled (direct trigger)を選択します。
Set liveをクリックします。
Pendo Dataコネクタがライブになると、顧客の質問がテンプレートの内容に合致したときにFinが自動的にトリガーします。
注意：Pendo Dataコネクタテンプレートはテストワークスペースではなく、本番ワークスペースでのみ完全にテストできます。
注意：Submit Pendo feedback for a visitorへの各成功した呼び出しはPendoに新しいフィードバック項目を作成するため、テスト時はテスト顧客を使用してください。
FinがPendo Dataコネクタテンプレートを使用すると顧客は何を見るのか？
FinがPendo Dataコネクタテンプレートを使用しても顧客はPendoを直接見ません。Finは裏でPendoのコンテキストを使用しています。唯一の目に見える違いはガイドリンクで、Finが一致するPendoガイドを見つけると、アプリ内でウォークスルーを起動するリンクで返信します。
FinがPendoデータを使用する会話は、他のFin会話と同様にInboxに表示されます。
Pendo Dataコネクタテンプレートのレポート方法
Pendo Dataコネクタテンプレートには専用のレポートはありません。標準のDataコネクタなので、使用状況は既存のDataコネクタおよびFinレポートに表示されます。
Pendo Dataコネクタテンプレートの制限は？
Pendo Dataコネクタテンプレートには以下の制限があり、回避策がある場合は併記します：
ウェブアプリのみ：モバイルアプリやブラウザ拡張機能はまだサポートされておらず、回避策もありません。
ログイン済み顧客のみ：FinはログインしてPendoビジターIDを持つ顧客のみを検索できます。
ビジターIDの一致：IntercomのビジターIDがPendoと一致しない場合、Finは顧客を見つけられません。IDを同期し、Visitor ID入力をpendoVisitorId属性にマッピングしてください。
タグ付けされたアクティビティのみ：セッションの概要にはPendoでタグ付けされたページと機能のみが含まれます。より多くのページと機能をPendoでタグ付けしてください。
顧客認証が必要：メールOTPまたはMessengerセキュリティが設定されるまでテンプレートはライブにできません。
本番環境でのテストのみ：テンプレートはテストワークスペースではなく、本番ワークスペースでのみ完全にテストできます。
Pendoアドオン：AIエージェントのアクティビティにはPendo Agent Analyticsが必要で、フィードバック送信にはPendo Feedbackが必要です。これらがないと、これら2つのテンプレートは有用なデータを返しません。
呼び出しごとに新しいフィードバック項目：Submit Pendo feedback for a visitorへの各成功した呼び出しはPendoに新しいフィードバック項目を作成します。
積極的なアプローチなし：テンプレートは会話を開始しません。FinがPendoでフラストレーションを検出したときに連絡するには、Pendoでフラストレーション信号を設定し、Proactive Proceduresと組み合わせてください。これにはProactive Support PlusまたはFull Suiteが必要です。
Pendo Dataコネクタテンプレートのよくある質問
なぜFinはPendoで私の顧客を見つけられないのですか？
FinがPendoで顧客を見つけられないのは、IntercomのビジターIDがPendoと一致しないか、顧客にタグ付けされたアクティビティがない場合です。Visitor ID入力が正しい属性にマッピングされているか確認してください。IntercomのUser IDとPendoのビジターIDが異なる場合はIDを同期し、pendoVisitorId属性を使用してください。
なぜFinはPendoで一部の顧客だけを見つけるのですか？
FinがPendoで一部の顧客しか見つけられないのは、IntercomのUser IDとPendoのビジターIDが他の顧客と異なるためです。IDを同期し、それらの顧客にpendoVisitorId属性が設定されているか確認してください。
なぜ私のPendo Dataコネクタは認証エラーを表示するのですか？
Pendo Dataコネクタが認証エラーを表示するのは、OAuthの値が間違っているか期限切れ、またはサービスアカウントが異なるPendoリージョン用に作成された場合です。Pendoでサービスアカウントを再作成し、新しい値でIntercomに新しいOAuthトークンを作成してください。
なぜ私のPendo Dataコネクタはデータを返さないのですか？
Pendo Dataコネクタがデータを返さないのは、pendo_hostがPendoリージョンと一致しない場合です。まだapp.pendo.ioに設定されていて、PendoサブスクリプションがEU、AU、または日本でホストされている場合は、その地域のPendoホストに変更してください。
なぜFinは私のPendo Dataコネクタを使用しないのですか？
FinはPendo Dataコネクタがライブで、FinタブのEnabled (direct trigger)に設定されていない限り使用しません。Dataコネクタを開き、両方の設定を確認し、必要に応じてSet liveをクリックしてください。
なぜPendo AIエージェントアクティビティテンプレートは何も返さないのですか？
Get Pendo AI agent activity for a visitorテンプレートは、PendoサブスクリプションにPendo Agent Analyticsが含まれていない場合、有用なデータを返しません。テンプレートを使用するにはPendoでAgent Analyticsを追加してください。
なぜPendoに重複したフィードバック項目があるのですか？
Pendoに重複したフィードバック項目が表示されるのは、訪問者のためにSubmit Pendo feedbackを成功裏に呼び出すたびに新しい項目が作成されるためです。繰り返しの試行について会話を確認してください。
OperatorとCopilotはPendoデータを使用できますか？
OperatorとCopilotは、Pendo DataコネクターテンプレートなしでModel Context Protocol（MCP）を介してPendoデータを使用できます。ConnectionsでPendoをOperatorに接続する方法をご覧ください。ConnectionsはProアドオンのOperatorに含まれています。CopilotでのPendoアクセスはクローズドベータです。