Zendesk for kintone

目次

概要

Zendesk Inc. の提供するサービス Zendesk (External link) で管理している問い合わせ(チケット)を kintone のレコードで確認できるプラグインです。

注意事項

  • サンプルプラグインに関するお問い合わせは、API サポート窓口へのお問い合わせの対象外です。
  • kintone プラグインは、スタンダードコースでのみ利用できます。
  • このプラグインでは、API ドキュメントで公開していない API を利用しています。
    非公開 API を利用したプラグインの開発および販売はしないでください。

制限事項

  • モバイル用のブラウザーおよび kintone モバイルでは、チケットのコメントを確認できません。
  • Zendesk 上でリクエスタや担当者の名前を変更した場合、新しい名称で関連するチケットを検索できないことがあります。
    終了していないチケットの場合は、チケットの内容を更新してください。
  • 検索条件にカスタムフィールドを選択した場合、すべてのカスタムフィールドの値が検索対象です。
  • コメントを表示する際、コメント内の添付ファイルを表示できないなど、Zendesk 上での表示と一部違いがあります。
  • コメントの番号(「#2」)など、チケット内の相対リンクは Zendesk の相対リンクとして表示されません。

プラグインの機能

kintone のレコード上で、検索キーワードに一致する Zendesk チケットを表示します。
チケットの次の情報から検索できます。

  • リクエスタ(顧客)
  • 担当者
  • タグ

チケット行をクリックすると、 5 件までの最新のコメントを確認できます。

プラグインのパッケージング

Zendesk for kintone プラグインのソースコードは、公開していません。

パッケージングしたサンプル

このプラグインはプラグイン開発のためのサンプルで、サポート対象外です。
ご理解の上、ダウンロードしてください。

SAMPLE_zendesk_plugin_v6.0.2.zip

プラグインの設定

STEP1:プラグインの読み込み

kintone システム管理画面で、パッケージングしたファイル(zip ファイル)を読み込みます。
ファイルからプラグインを読み込む (External link)

STEP2:アプリの追加

  1. アプリを追加します。

  2. 次のフィールドを配置します。

    フィールド フィールドの種類 備考
    検索キーワードにするフィールド 文字列(1行)またはリンクまたはレコード番号 チケットの検索キーワードとして使用するフィールド
    レコード番号を配置する場合、アプリコードを設定するとアプリコードを含めた番号が検索キーワードになります。
    テーブル内フィールドは使用できません。
    チケットを表示するフィールド スペース チケットを表示するスペース
    要素 ID を設定してください。

STEP3:プラグインの追加と設定

  1. アプリの設定画面を開き、プラグインを追加します。
    アプリにプラグインを追加する (External link)

  2. プラグインの設定画面を開き、項目を設定します。

    項目名 必須 説明
    Zendesk ドメイン名 必須 Zendesk のサブドメイン名
    OAuth クライアント 必須 Zendesk で取得した、OAuth の「一意のID」と「シークレット」
    Zendesk での OAuth クライアントの設定は、 Zendesk のヘルプ (External link) を参照してください。「リダイレクト URL」には次の URL を指定します。
    https://oauth.cybozu.com/redirect
    検索条件 必須 検索キーワードと検索対象の関連付け
    • kintone フィールド:検索キーワードにするフィールド
    • Zendesk チケットプロパティ:Zendesk チケットのプロパティ
    フィルター 省略可 絞り込み条件
    表示するチケットをさらに絞り込む場合に指定します。
    kintone スペースフィールド 必須 チケットを表示するフィールド
  3. 【保存】をクリックします。

  4. 「アプリの設定」画面で、【設定完了】をクリックします。

STEP3:動作確認

  1. レコード追加画面を開きます。
    Zendesk へのログインを求める画面が表示された場合は、エラーメッセージのリンクをクリックして Zendesk にログインしてください。

  2. 「検索キーワードにするフィールド」へ、チケットの検索キーワードを入力します。

  3. レコードを保存します。

  4. 検索キーワードに関連するチケットが、保存したレコードに表示されていることを確認します。

更新履歴

  • 2015 年 9 月 4 日 v5.0.0 を公開
  • 2017 年 9 月 12 日 v6.0.0 を公開
    • チケット合計数が表示されるようにしました。
    • チケットデータが表示された行をクリックすることで、コメントを表示できるようにしました。
    • 検索条件でカスタムフィールドを選択できるようにしました。
    • 一部の日本語化に対応しました。
    • その他画面の表示など軽微な修正を実施しました。
  • 2017 年 9 月 15 日 v6.0.1 を公開
    • グループフィールドを配置した場合、設定画面のスペースの ID が取得できない不具合を改修しました。
    • その他画面の表示など軽微な修正を実施しました。
  • 2024 年 1 月 12 日 v6.0.2 を公開
    • プラグインの homepage_url を修正しました。
information

このプラグインは、2015 年 9 月のアップデート以前に kintone 製品からインストール可能だった Zendesk プラグインと同じ機能を提供しています。
当時のデザインは一部変更しています。

利用している OSS のライセンス情報

このプラグインで利用している OSS のライセンスは次のとおりです。