Zendesk for kintone
概要
Zendesk Inc. の提供するサービス
Zendesk
で管理している問い合わせ（チケット）を kintone のレコードで確認できるプラグインです。
注意事項
- サンプルプラグインに関するお問い合わせは、API サポート窓口へのお問い合わせの対象外です。
- kintone プラグインは、スタンダードコースでのみ利用できます。
- このプラグインでは、API ドキュメントで公開していない API を利用しています。
非公開 API を利用したプラグインの開発および販売はしないでください。
制限事項
- モバイル用のブラウザーおよび kintone モバイルでは、チケットのコメントを確認できません。
- Zendesk 上でリクエスタや担当者の名前を変更した場合、新しい名称で関連するチケットを検索できないことがあります。
終了していないチケットの場合は、チケットの内容を更新してください。 - 検索条件にカスタムフィールドを選択した場合、すべてのカスタムフィールドの値が検索対象です。
- コメントを表示する際、コメント内の添付ファイルを表示できないなど、Zendesk 上での表示と一部違いがあります。
- コメントの番号（「#2」）など、チケット内の相対リンクは Zendesk の相対リンクとして表示されません。
プラグインの機能
kintone のレコード上で、検索キーワードに一致する Zendesk チケットを表示します。
チケットの次の情報から検索できます。
- リクエスタ（顧客）
- 担当者
- タグ
チケット行をクリックすると、 5 件までの最新のコメントを確認できます。
プラグインのパッケージング
Zendesk for kintone プラグインのソースコードは、公開していません。
パッケージングしたサンプル
このプラグインはプラグイン開発のためのサンプルで、サポート対象外です。
ご理解の上、ダウンロードしてください。
プラグインの設定
STEP1：プラグインの読み込み
kintone システム管理画面で、パッケージングしたファイル（zip ファイル）を読み込みます。
ファイルからプラグインを読み込む
STEP2：アプリの追加
-
アプリを追加します。
-
次のフィールドを配置します。
フィールド フィールドの種類 備考 検索キーワードにするフィールド 文字列（1行）またはリンクまたはレコード番号 チケットの検索キーワードとして使用するフィールド
レコード番号を配置する場合、アプリコードを設定するとアプリコードを含めた番号が検索キーワードになります。
テーブル内フィールドは使用できません。チケットを表示するフィールド スペース チケットを表示するスペース
要素 ID を設定してください。
STEP3：プラグインの追加と設定
-
アプリの設定画面を開き、プラグインを追加します。
アプリにプラグインを追加する -
プラグインの設定画面を開き、項目を設定します。
項目名 必須 説明 Zendesk ドメイン名 必須 Zendesk のサブドメイン名 OAuth クライアント 必須 Zendesk で取得した、OAuth の「一意のID」と「シークレット」
Zendesk での OAuth クライアントの設定は、 Zendesk のヘルプ を参照してください。「リダイレクト URL」には次の URL を指定します。
https://oauth.cybozu.com/redirect検索条件 必須 検索キーワードと検索対象の関連付け - kintone フィールド：検索キーワードにするフィールド
- Zendesk チケットプロパティ：Zendesk チケットのプロパティ
フィルター 省略可 絞り込み条件
表示するチケットをさらに絞り込む場合に指定します。kintone スペースフィールド 必須 チケットを表示するフィールド -
【保存】をクリックします。
-
「アプリの設定」画面で、【設定完了】をクリックします。
STEP3：動作確認
-
レコード追加画面を開きます。
Zendesk へのログインを求める画面が表示された場合は、エラーメッセージのリンクをクリックして Zendesk にログインしてください。
-
「検索キーワードにするフィールド」へ、チケットの検索キーワードを入力します。
-
レコードを保存します。
-
検索キーワードに関連するチケットが、保存したレコードに表示されていることを確認します。
更新履歴
- 2015 年 9 月 4 日 v5.0.0 を公開
- 2017 年 9 月 12 日 v6.0.0 を公開
- チケット合計数が表示されるようにしました。
- チケットデータが表示された行をクリックすることで、コメントを表示できるようにしました。
- 検索条件でカスタムフィールドを選択できるようにしました。
- 一部の日本語化に対応しました。
- その他画面の表示など軽微な修正を実施しました。
- 2017 年 9 月 15 日 v6.0.1 を公開
- グループフィールドを配置した場合、設定画面のスペースの ID が取得できない不具合を改修しました。
- その他画面の表示など軽微な修正を実施しました。
このプラグインは、2015 年 9 月のアップデート以前に kintone 製品からインストール可能だった Zendesk プラグインと同じ機能を提供しています。
当時のデザインは一部変更しています。
利用している OSS のライセンス情報
このプラグインで利用している OSS のライセンスは次のとおりです。