ご利用ガイド

thumbnail

Zendesk

Zendeskヘルプセンターの記事をチャネルトークのドキュメントに取り込み、定期的に自動更新します。

Zendeskアプリは、Zendeskヘルプセンターの記事をチャネルトークのドキュメントに自動で取り込めるアプリです。一度連携すると、新しい記事や更新された内容を定期的に確認し、自動で反映します。

Zendeskアプリとは？

Zendeskヘルプセンターとチャネルトークのドキュメントを併用している場合、記事を更新するたびに両方を修正する必要があり、内容に差異が生じやすくなります。

Zendeskアプリを利用すると、Zendeskで公開されている記事をチャネルトークのドキュメントにまとめて取り込み、その後の変更内容も自動で反映できます。これにより、両方の記事を常に同じ状態に保つことができます。

また、Zendeskで記事の公開を停止(Unpublish)すると、チャネルトークのドキュメントでも自動的に非公開になるため、古い情報が引き続きお客様に表示されるのを防ぐことができます。

このようなチャネルにおすすめ

  • Zendeskからチャネルトークへの移行にあたり、既存のヘルプ記事を一括で移行するチャネル

  • Zendeskとチャネルトークのドキュメントの両方で、同じ記事を管理しているチャネル

Zendeskアプリの利用条件

Zendeskアプリを利用するには、以下の条件を満たす必要があります。

  • ZendeskアカウントおよびZendesk API Tokenが必要です。

  • チャネルトークのドキュメント内に、記事を同期するためのスペースが必要です。

新しいスペースの作成方法

  1. [チーム] - [ドキュメント] から新しいスペースを作成します。

    • スペースがない場合：ドキュメント画面中央の [スペースを作成する] ボタンをクリックします。

    • すでにスペースがある場合：ドキュメント左側のサイドバー上部にあるスペースリストをクリックし、[新しいスペースを作成する] ボタンをクリックします。

  2. スペース名と基本URLを入力し、[作成] をクリックします。

同期の仕組み

アプリを連携すると、Zendeskヘルプセンターで公開(Published)されている記事を一括で取り込みます。

連携後は24時間ごとにすべての記事を確認し、変更された内容をチャネルトークのドキュメントに反映します。

Zendeskでの変更

チャネルトークでの反映

❶ 新しい記事を公開

→ 新しい記事を作成・公開

❷ 記事の内容を変更

→ 既存の記事に新しいバージョンを作成・公開

❸ 記事のステータスのみ変更

→ 既存記事のステータスのみ変更

❹ 記事をアーカイブ・削除

→ 既存の記事を非公開に変更

❺ 削除した記事を復元

→ 既存の記事を再利用して再公開

連携方法

1. アプリのインストール

[チャネル設定] - [アプリストア] - [Zendesk] で [インストール] をクリックします。

2. 連携情報の入力

Zendeskアプリの [設定] タブで、Zendesk API認証に必要な情報を入力します。

  • subdomain：管理者がZendeskにアクセスする際に使用するアドレスです。アクセス先が https://test.zendesk.com の場合は、test また https://test.zendesk.com をそのまま入力します。Custom Help Centerドメインは使用できません。

  • email：API Tokenを発行したZendeskユーザーのアカウントメールアドレスです。

  • API Token：Zendesk管理センターの [アプリおよびインテグレーション] - [API] - [APIトークン] から発行できます。API Tokenの発行にはZendeskの管理者権限が必要です。

3. 同期するスペースの選択・保存

[Document space] でZendeskの記事を同期するスペースを選択し、[保存] をクリックします。

保存すると連携が完了します。記事は保存後すぐに取り込まれるのではなく、次回の同期時に取り込まれます。初回の同期が開始されるまで、最大24時間かかる場合があります。

4. 同期結果の確認

初回の同期が完了したら(最大24時間)、スペースにZendeskの記事が取り込まれているか確認します。Zendeskで公開されている記事が一覧に作成・公開され、その後は24時間ごとに変更内容が自動で反映されます。すぐに同期したい場合は、[同期] タブを開き、[今すぐ全体を同期] をクリックします。

注意事項

  • Zendeskのカテゴリ・セクション構造を、チャネルトークのドキュメントのフォルダ構造として取り込む機能には対応していません。

  • 記事本文の画像は、Zendeskの画像URLをそのまま使用します。

  • 通常の添付ファイルは同期されません。

  • Zendesk独自のCSSや一部の埋め込み要素には対応していないため、元の記事と細かな表示が異なる場合があります。

同期状況の確認

Zendeskアプリの [同期] タブでは、同期状況をひと目で確認できます。

最終同期時刻

  • 最終成功：直近の同期が完了した時刻です。

  • 次回の自動同期予定：次回の自動同期が実行される予定時刻です。

  • 画面は60秒ごとに自動で更新されるため、再読み込みをしなくても最新の状態を確認できます。

同期ステータス

ステータス

詳細

同期前

まだ一度も同期が実行されていない状態

全体同期中

現在、同期が進行中

手動同期の待機中

手動同期のリクエストを受け付け、実行を待機中

全体同期完了

直近の同期が正常に完了した状態

一部記事の同期失敗

一部の記事でエラーが発生しています

全体同期失敗

全体の同期に失敗した状態

エラー再試行の待機中

失敗した同期の再試行を待機中

確認が必要な記事あり

確認が必要な記事がある状態

今すぐ全体を同期(手動同期)

自動同期を待たずにすぐに反映したい場合は、[同期] タブ右上の [今すぐ全体を同期] をクリックします。