はじめに
Zendeskは、チケット発行、セルフサービスオプション、カスタマーサポート機能などの、クラウドベースのカスタマーサービスプログラムを提供しています。既存クエリにもとづいてデータを取り出したり、カスタマイズした検索クエリを作成したりすることができます。Zendesk APIの詳細については、ウェブサイト（ https://developer.zendesk.com/rest_api/docs/core/introduction ）を参照してください。 Zendeskコネクターは「クラウドApp」コネクターであるため、クラウドに保管されたデータの取得が可能です。Data Centerのウィンドウ上部のツールバーにある ［クラウドApp］ をクリックすると、これを含むほかのクラウドAppコネクターのページにアクセスできます。 Zendesk Chatコネクターの詳細については、「 Zendesk Chatコネクター 」を参照してください。 Zendeskアカウントには、Data Centerから接続します。このトピックでは、Zendeskコネクターユーザーインターフェースに固有のフィールドとメニューについて説明します。DataSetの追加や更新スケジュールの設定、DataSet情報の編集に関する一般的な情報は、「 コネクターを使用してDataSetを追加する 」を参照してください。主な使用事例 | DomoでZendeskデータを使用すると、チケットメトリクスを分析してタイムリーで優れた解決策が得られます。カスタムフィールドも利用できるため、ビジネスの最適化を促進できます。 |
主なメトリクス |
|
社内における主なロール |
|
平均導入時間 | Zendeskプラットフォームのスコープの制限、利用可能なデータの種類、コネクターの使いやすさに応じて、基本的な導入に4～8時間。 |
使いやすさ（1～10段階。1が「最も使いやすい」） | 4 |
ベストプラクティス
ZendeskのAPIには、速度制限があることに注意してください。詳細については、トラブルシューティングのセクションを参照してください。 すぐに利用を開始するには、Zendesk定義済みレポート（「Tickets」、「Users」、または「Tickets with Users」）や「General Query」（チケットステータス、日付など）を使用したり、カスタマイズされた「Specific Query」を作成したり、検索を行います（例： tags:vip type:user created<2015-05-01 は、2015年5月1日に作成されたVIPチケットを返します）。必要条件
Zendeskアカウントに接続してDataSetを作成するには、以下が必要です。- Zendeskアカウントのログインに使用するユーザー名
- Zendeskアカウントのログインに使用するAPIトークンまたはパスワード
- 会社のZendesk URL
Zendeskアカウントに接続する
このセクションでは、Zendeskコネクターページの ［認証情報］ および ［詳細］ ペインのオプションについて説明します。このページのほかのペインの項目である ［スケジュール設定］ や ［DataSetに名前を付け、説明を入力］ に関しては、ほとんどのタイプのコネクターで共通しています。詳細については、「 データコネクターを使用してDataSetを追加する 」を参照してください。［認証情報］ ペイン
このペインには、Zendeskアカウントに接続する認証情報の入力フィールドが含まれています。下表では、各フィールドに必要な内容を説明しています。フィールド | 説明 |
|---|---|
［Username］ | Zendeskアカウントのログインに使用するユーザー名を入力します。 |
［Authenticate By］ | Zendesk APIトークンまたは認証パスワードのどちらを使用するかを指定します。 |
［API Token or Password］ | Zendesk APIトークンまたはパスワードを入力します。これは、 ［Authenticate By］ メニューで選択したものと一致する 必要があります 。例えば、 ［API Token］ を ［Authenticate By］ に選択した場合は、APIトークンをこのフィールドに入力します。パスワードではありません。 |
［Zendesk URL］ | 会社のZendeskインスタンスのURLを入力します。 |
［詳細］ペイン
このペインには、メインの ［Report］ メニューのほか、選択したレポートタイプに応じて表示/非表示になる様々なメニューがあります。メニュー | 説明 | ||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
［Report (Core API)］ | 実行したいZendeskコアAPIレポートを選択します。以下のレポートが利用できます。
| ||||||||||||||||||||||
| ［Report (Talk API)］ | 実行したいZendesk Talk APIレポートを選択します。以下のレポートを利用できます。
| ||||||||||||||||||||||
［Country Code］ | ISO国コードを指定します。 | ||||||||||||||||||||||
［Contains］ | 電話番号を検索するための正規表現を指定します。有効な文字は、（”）と [0-9a-zA-Z]です。（”）（二重引用符）文字は任意の1桁と一致します。 | ||||||||||||||||||||||
［Number Should be Toll-Free or Local］ | 番号を無料通話番号にするか市内番号にするかを指定します。 | ||||||||||||||||||||||
［Area Code］ | 指定したエリアコードで電話番号を検索する場合に指定します（米国とカナダのみ）。 | ||||||||||||||||||||||
［From Days］ | レポートの過去日数を入力します。例えば、 | ||||||||||||||||||||||
［To Days］ | レポートで表示させ ない 過去日数を入力します。例えば、 | ||||||||||||||||||||||
［Agent］ | エージェントを選択します。 | ||||||||||||||||||||||
| ［Greeting Category］ | グリーティングカテゴリーを選択します。 | ||||||||||||||||||||||
| ［Greeting］ | グリーティングを選択します。 | ||||||||||||||||||||||
| ［Phone Number］ | 電話番号を選択します。 | ||||||||||||||||||||||
［Search Query］ | 使用したい検索クエリタイプを選択します。 ［Open Tickets］ および ［Closed Tickets］ は、Zendeskインスタンスに対してオープン/クローズドチケット番号を返すのに使うことができる既製のクエリです。［Custom］オプションにより、Zendesk検索クエリを指定できます。例えば、 Zendeskクエリ入力に関する詳細については、 https://support.zendesk.com/hc/en-us/articles/203663226-Zendesk-search-reference を参照してください。 | ||||||||||||||||||||||
| ［Query Field］ | 使用したい検索クエリタイプを選択します。 ［Open Tickets］ および ［Closed Tickets］ は、Zendeskインスタンスに対してオープン/クローズドチケット番号を返すのに使うことができる既製のクエリです。 ［Custom］ オプションにより、Zendesk検索クエリを指定できます。Zendeskクエリ入力に関する詳細については、 https://support.zendesk.com/hc/en-us/articles/203663226-Zendesk-search-reference を参照してください。 | ||||||||||||||||||||||
| ［Include Attachments］ | 結果に添付ファイルを含めるかどうかを指定します。 |
その他のペイン
スケジュール設定、再試行、更新に関するオプションなど、コネクターインターフェースのその他のペインに表示されるオプションについては、 「コネクターを使用してDataSetを追加する」 を参照してください。トラブルシューティング
-
ZendeskのAPIには速度制限があります。Zendeskでは、顧客のプランとエンドポイントに応じて、1分間に定められた数のリクエストのみ利用できます。DomoでZendeskの接続が低速である場合、速度制限がより高いプランにアップグレードすることを考慮してください。
- Essentialプラン = 10リクエスト/分（RPM）
- Teamプラン = 200 RPM
- プロフェッショナル = 400 RPM
- エンタープライズ = 700 RPM
- ハイボリュームアドオン = 2,500 RPM
- 429エラーを受け取った場合、速度制限を超過したことを示しています。
- ご利用のプランの速度制限と過去24時間のAPIアクティビティを、Zendeskの「Tracking API activity against your rate limit（APIアクティビティの使用回数制限をトラッキングする、英語）」（ https://support.zendesk.com/hc/en-us…our_rate_limit ）で比較できます。
- 接続に失敗した場合は、APIトークンがアクティブであることを確認します。APIトークンは、 ［Admin］>［Channels］>［API］ の順に選択して表示する、Zendesk Supportの［Admin］インターフェースで管理できます。このページでは、トークンを表示、追加、または削除できます。同時に2つ以上のトークンをアクティブにすることが可能です。