重要事項:Pendoインテグレーションは、Zendeskウェブウィジェット(従来版)を使用しているZendeskヘルプセンターおよびチャットプロダクトでのみ利用可能です。Pendoは、新しいZendeskウェブウィジェットを使用したZendeskメッセージングとのインテグレーションをサポートしていません。Zendeskヘルプセンターとチャットはメッセージングと併用できません。また、Zendeskは現在メッセージングとサードパーティーのインテグレーションをサポートしていません。
Zendeskメッセージングは、2021年11月2日にすべてのZendesk新規顧客向けに提供開始されます。既存のお客様は手動で有効化できます。ウェブウィジェット(従来版)でPendoインテグレーションを使用するには、メッセージングを無効にする必要があります。
メッセージングを無効にする方法については、Zendeskヘルプセンターをご覧ください。
備考:このプロセスは、PendoサブスクリプションにZendeskヘルプセンターインテグレーションの旧バージョンが現在インストールされているお客様にのみ必要です。最新版のZendeskヘルプセンターインテグレーションのみをインストールする場合は、Zendeskナレッジベースインテグレーションの概要を参照してください。
概要
Pendoは、リソースセンターのコンテキストでネイティブのZendeskウェブウィジェットを使用できるように、Zendeskヘルプセンターのインテグレーションエクスペリエンスをアップグレードしました。これまで、Zendeskヘルプセンターモジュールはリソースセンターのiframe内でレンダリングされていました。現在、リソースセンターモジュールは、Zendeskウェブウィジェットで通常生成されるランチャーボタンを抑制しながら、Zendeskヘルプセンターを起動します。新しいエクスペリエンスには、プレゼンテーション、ユーザビリティ、カスタマイズ、Zendeskからのアップデートの利用など、多くのメリットがあります。
新しいインテグレーションでは、旧バージョンでは不要であったインストール手順が追加されています。
- 新しいZendeskヘルプセンターインテグレーションをサブスクリプションに追加する必要があります
- 新しいZendeskヘルプセンターモジュールをリソースセンターに追加する必要があります
- 旧バージョンのZendeskヘルプセンターモジュールを削除する必要があります
- Zendeskウェブウィジェットスニペットをアプリケーションのヘッダーに追加する必要があります
備考:旧バージョンのインテグレーションでは、Zendeskウェブウィジェットスニペットのインストールは不要でした。
要件
- Pendo管理者ユーザー
- Zendesk管理者ユーザー
- Pendoサブスクリプション用の有効なZendeskヘルプセンターインテグレーション
- Zendeskウェブウィジェットスニペットをインストールできる技術者
- 公開されたPendoリソースセンター
- エージェントバージョン2.110.0以降
ZendeskインテグレーションをPendoサブスクリプションに追加するには、Pendoカスタマーサクセスまたは営業担当者にご連絡ください。
重要事項
- Zendeskスニペットは、ページヘッダーのPendoスニペットの下にインストールする必要があります
- リソースセンターでZendeskヘルプセンターを公開せずにZendeskスニペットをインストールすると、Zendeskウェブウィジェット起動バッジがUIにロードされます
- リソースセンターはひとつのヘルプセンターインテグレーションのみをサポートするため、リストにある最初のモジュールのみをロードします
インストール
Zendeskヘルプセンターのアップグレードは、3段階で行います。リソースセンターにヘルプセンターモジュールを追加し、旧バージョンのモジュールを削除して、ヘルプセンターモジュールを使用するページにZendeskウェブウィジェットスニペットをインストールする必要があります。
Zendeskウェブウィジェットスニペットがインストールされていて、モジュールが公開されていない場合、ZendeskスニペットはUI上にZendeskの起動ボタンををロードします。公開されているリソースセンターにヘルプセンターモジュールがある場合、アプリケーションにインストールされているウェブウィジェットスニペットを検出するまで、そのモジュールはリソースセンターには表示されません。このインストール順序がフェールセーフとなり、ヘルプセンターモジュールは機能しているときのみ表示されるようになります。
リソースセンターへのZendeskヘルプセンターモジュールの追加
Zendeskヘルプセンターインテグレーションをサブスクリプションに追加すると、ヘルプセンターモジュールをリソースセンターに追加できるようになります。アプリケーションにZendeskスニペットをインストールする前に、ヘルプセンターモジュールをリソースセンターに追加し、公開する必要があります。これを行わないと、リソースセンターモジュールが追加されるまで、Zendeskは起動バッジを表示します。
インテグレーションの設定
1.[設定]>[インテグレーション]へと移動します。
2. ナレッジベースインテグレーションでZendeskヘルプセンターインテグレーションを探し、[インテグレーションを追加(Add Integration)]をクリックします。
3. 必要に応じて、リソースセンターモジュールの詳細を編集します。
4. [ステージングに保存(Save to staging)]をクリックして、リソースセンターでインテグレーションを利用できるようにします。
リソースセンターの設定
5. [ガイド]>[リソースセンター]に移動します。
6.[モジュールを追加(Add Modules)]をクリックし、Zendeskヘルプセンターモジュールを追加します。[モジュールを追加]をクリックして、新しいモジュールをリソースセンターのドラフトに保存します。
- リソースセンターモジュールの順番の変更や、その他の変更を行う必要がある場合は、[自分のアプリで管理する]をクリックします。
- Zendeskヘルプセンターモジュールのセグメントは、デフォルトで[全員(Everyone)]に設定されています。セグメントを変更して、このモジュールを表示し、Zendeskウェブウィジェットにアクセスできるユーザーを制限します。
7. ドラフトのリソースセンターのモジュールの一覧で、旧バージョンのZendeskヘルプセンターインテグレーションモジュールを探します。
8.[モジュール詳細の表示(View Module Details)]をクリックして、旧バージョンのZendeskヘルプセンターモジュールを削除します。この操作では、現在公開されているリソースセンターからヘルプセンターモジュールが削除されません。このバージョンのリソースセンターが公開されるまで、変更は表示されません。
7.[ステージングへプッシュ(Push to Staging)]をクリックし、リソースセンターをステージングに移行します。新しいリソースセンターを確認し、ステージング環境でヘルプセンターインテグレーションをテストすることをお勧めします。
8.[本番環境へプッシュ(Push to Production)]をクリックし、新しいリソースセンターをステージングから本番環境に移行させます。リソースセンターでZendeskヘルプセンターモジュールが使用できるようになります。
Zendeskウェブウィジェットスニペットのインストール
Zendeskでは、ウェブウィジェットスニペットをインストールするためのインストール手順を提供しています。その手順は、Pendoスニペットのインストールと同様です。スニペットは、ヘルプセンターを使用するすべてのページの<head>
に追加する必要があります。スニペットがページ上に存在しない限り、リソースセンターのヘルプセンターモジュールはロードされません。
Zendeskウェブウィジェットスニペットは、<head>
内のPendoスニペットの下にインストールする必要があります。ZendeskスニペットがPendoスニペットの前にロードされた場合、Zendeskはリソースセンターモジュールを使用せずに自分自身の起動ボタンをロードします。