Pendoは、リソースセンターのコンテキストでネイティブのZendeskウェブウィジェットを使用できるように、Zendeskチャットのインテグレーション体験をアップグレードしました。
この記事では、PendoサブスクリプションにインストールされているZendeskチャットインテグレーションの旧バージョンからアップグレードする方法について説明します。最新版のZendeskチャットインテグレーションのみをインストールする場合は、ZendeskチャットとPendoのインテグレーションを参照してください。
これはZendeskとの3つのインテグレーションのうちの1つで、PendoリソースセンターからZendeskウェブウィジェットを展開します。
- Zendeskチャットインテグレーションにより、ウェブウィジェットのライブチャット機能が起動します。
- Zendeskヘルプセンターインテグレーションにより、ウェブウィジェットのヘルプセンター機能が起動します。
- Zendeskメッセージングインテグレーションは、ZendeskチャットとZendeskヘルプセンターの両方に対して優先されます。
ZendeskチャットとZendeskヘルプセンターをそれぞれ展開することも、Zendeskメッセージングを展開してヘルプセンターにメッセージング機能を組み込むこともできます。
仕組み
旧バージョンのZendeskチャットモーダルは、Pendoリソースセンターのiframe内でレンダリングされます。今回のアップグレードにより、Zendeskチャットは、リソースセンターモジュールを介してZendeskウェブウィジェットで起動します。これにより、Zendeskウェブウィジェットによりこれまで生成されていた起動ボタンが非表示になります。
新しいインテグレーションでは、旧バージョンでは不要であったインストール手順が追加されています。
- 新しいZendeskチャットインテグレーションをPendoサブスクリプションに追加する必要があります。インテグレーションをPendoサブスクリプションに追加するには、Pendoカスタマーサクセスまたは営業担当者にご連絡ください。
- 新しいZendeskチャットモジュールをリソースセンターに追加する必要があります。
- 旧バージョンのZendeskチャットモジュールを削除する必要があります。
- Zendeskチャットスニペットをアプリケーションのヘッダーに追加する必要があります。
Pendoリソースセンターが一度にサポートできるのは単一のチャットインテグレーションのみであるため、リストにある最初のモジュールのみをロードします。
前提条件
Pendoサブスクリプションに対して有効なZendeskチャットインテグレーションが必要です。また、PendoとZendeskの両方のアカウントに管理者権限があり、Pendoでリソースセンターを公開している必要があります。
さらに、Zendeskスニペットは、ページヘッダーのPendoスニペットの下にインストールする必要があります。リソースセンターでZendeskチャットモジュールを公開せずにZendeskスニペットをインストールすると、Zendesk起動バッジがUIにロードされます。
インストール
Zendeskチャットのアップグレードは、3段階で行います。
- チャットモジュールをリソースセンターに追加します。
- 旧バージョンのチャットモジュールをリソースセンターから削除します。
- チャットモジュールを使用するすべてのページにZendeskスニペットをインストールします。
Zendeskスニペットがインストールされていて、ヘルプセンターモジュールが公開されていない場合、ZendeskスニペットはUI上にZendeskの起動ボタンををロードします。公開されているリソースセンターにチャットモジュールがある場合、アプリケーションにインストールされているZendeskスニペットが検出されるまで、そのモジュールはリソースセンターに表示されません。このインストール順序がフェールセーフとなり、チャットモジュールは機能しているときのみ表示されるようになります。
ステップ1. Zendeskチャットモジュールをリソースセンターにアップグレードする
チャットモジュールをリソースセンターに追加する前に、Zendeskチャットインテグレーションをサブスクリプションに追加する必要があります。アプリケーションにスニペットをインストールする前に、チャットモジュールをリソースセンターに追加し、公開する必要があります。これを行わないと、リソースセンターモジュールが追加されるまで、Zendeskは起動バッジを表示します。
- ［設定（Settings）］>［インテグレーション（Integrations）］に移動します。
- ライブチャットインテグレーションでZendeskチャットインテグレーションを探し、［インテグレーションを編集（Edit Integration）］を選択します。
- リソースセンターモジュールの詳細を編集します。
- ［ステージングに保存（Save to staging）］を選択して、リソースセンターでインテグレーションを利用できるようにします。
- ［ガイド（Guides）］>［リソースセンター（Resource Center）］に移動します。
- ［モジュールを追加（Add Modules）］を選択して、Zendeskチャットモジュールを追加します。
- ［モジュールを追加］を選択して、新しいモジュールをリソースセンターのドラフトに保存します。
ステップ2. 旧バージョンのZendeskチャットモジュールをリソースセンターから削除する
- ドラフトのリソースセンターのモジュールの一覧で、旧バージョンのZendeskチャットインテグレーションモジュールを探します。
- ［モジュール詳細を表示（View Module Details）］を選択して、旧バージョンのZendeskチャットモジュールを削除します。この操作では、現在公開されているリソースセンター上のモジュールは削除されません。このバージョンのリソースセンターが公開されるまで、変更は反映されません。
- ［ステージングへプッシュ（Push to Staging）］を選択して、リソースセンターをステージングに移行させます。新しいリソースセンターを確認し、ステージング環境でインテグレーションをテストすることをお勧めします。
- ［本番環境へプッシュ（Push to Production）］を選択して、新しいリソースセンターをステージングから本番環境に移行させます。これにより、リソースセンターでZendeskチャットモジュールが使用できるようになります。
リソースセンターモジュールの順番変更やその他の変更を行う場合は、［自分のアプリで管理（Manage in My App）］を選択します。セグメントを適用することもできます。チャットモジュールは、セグメント外のユーザーには表示されません。デフォルトは［全員（Everyone）］です。
ステップ3. Zendeskチャットスニペットをインストールする
Zendeskでは、チャットスニペットをインストールするためのインストール手順を提供しています。このプロセスは、インストールスクリプトを使用してPendoをインストールするプロセスと同様です。スニペットは、Zendeskチャットを使用するすべてのページの<head>に追加する必要があります。スニペットがページ上に存在しない限り、リソースセンターのチャットモジュールはロードされません。
Zendeskチャットスニペットは、<head>内のPendoインストールスクリプトの下にインストールする必要があります。ZendeskスニペットがPendoの前にロードされた場合、Zendeskはリソースセンターモジュールを使用せずに起動ボタンをロードします。
よくある質問
Zopimを使用している場合、このチャットインテグレーションを使用できますか？
Zopimは旧バージョンのZendeskチャットウィジェットです。このインテグレーションはZopimをサポートしていません。このチャットインテグレーションを使用する場合、旧バージョンのZendeskチャットのアカウントをアップグレードして、拡張エクスペリエンスを使用する必要があります。Zendeskのアップグレード手順に関する記事は以下のとおりです。