Zendeskの統合

Zendeskと統合して、デバイス、イントラネット、またはメッセンジャーから要求を送信および監視します。

次のプロセスを使用して、Zendesk統合を有効にします。前提条件を満たしていることを確認し、クライアントIDとシークレットトークンを取得します。このプロセスを完了すると、Citrixマイクロアプリの使用によって実行されたすべてのアクションを含む、既存のレベルの監査ログが保持されます。

追加設定不要のZendeskマイクロアプリの一覧については、「Zendeskマイクロアプリの使用」を参照してください。

必須条件の確認

専用のZendeskアカウントを作成し、それを使用してZendesk統合をセットアップします。このアカウントには、完全なデータアクセス特権を持つ管理者などの役割が割り当てられている必要があります。Zendeskでこの統合をセットアップした後、Citrix Workspaceマイクロアプリに統合を追加するには、以下のアーティファクトが必要になります:

  • URL
  • クライアントID
  • クライアントシークレット
  • アカウント
  • パスワード

統合プロセスを開始する前に、以下の前提条件を満たしておく必要があります:

  • Citrix GatewayがZendeskのシングルサインオンに対応するように構成して、ユーザーがログインすると、再度資格情報を入力しなくても自動的に再ログインできるようにします。Zendesk Single Sign-on構成の手順に従ってください。SSOの構成について詳しくは、「Citrix Gatewayサービス」を参照してください。

Zendesk統合のセットアップ

  1. 専用ユーザーアカウントでwww.zendesk.comにログインします。
  2. 左側のサイドバーの [管理者](設定アイコン)を選択します。[チャネル][API] を選択します。
  3. [OAuth Clients] タブを選択してから、 [+](プラス)アイコンを選択します。
  4. アプリの クライアント名 を入力します。
  5. (オプション)説明会社、および ロゴ を追加します。
  6. 自動入力された 一意の識別子 の値を、後で使用するためにコピーしておきます。
  7. 以下に示すようにリダイレクトURLを設定します。
  8. [保存][OK] の順に選択します。
  9. ページが更新されると、事前設定された新しいシークレットフィールドが表示されます。生成されたシークレットトークンを、後で使用するためにコピーしておきます。これは、この画面を終了した後には使用できません。
  10. [保存] を選択します。

Citrix Workspaceマイクロアプリで統合を完了する準備ができました。

コールバックURLの追加

インスタンス構成にカスタムURLを追加して、プライベートデータへのアクセスを許可し、OAuth認証済みユーザーアクションを有効にします。管理者としてZendeskにログインし、この統合用に以下の承認済みリダイレクトURLを追加します:

  • https://{yourmicroappserverurl}/admin/api/external-services/com.sapho.services.zendesk.ZendeskService/auth/serverContext
  • https://{yourmicroappserverurl}/app/api/auth/serviceAction/callback

Citrix Workspaceマイクロアプリへの統合の追加

Zendesk統合をCitrix Workspaceマイクロアプリに追加して、アプリケーションに接続します。これにより、通知とアクションが設定済みとなっている追加設定不要のマイクロアプリを、Workspace内で使用できるようになります。

次の手順を実行します:

  1. 概要ページから、[はじめに]を選択します。

    [統合の管理]ページが開きます。

  2. [新しい統合を追加] および [Citrix提供のテンプレートから新しい統合を追加する] を選択します。
  3. Zendeskタイルを選択します。
  4. 統合の名前を入力します。

    zendeskのコネクタのパラメーター、URL、クライアントID、クライアントシークレット、読み込むチケットの月数

  5. 前提条件として収集したコネクタのパラメーターを入力します。
    • インスタンスの [URL] を入力します。
    • [Client ID] を入力します。この値は、アプリケーションをZendeskに登録したときに取得した一意の識別子です。
    • クライアントシークレット を入力します。この値は、Zendeskでアプリケーションを登録したときにコピーされたシークレットです。
    • 読み込むチケットの月数の値を選択します。
  6. [Zendeskアカウントでログインする] を選択して、OAuth認証を有効にします。Zendeskサインインページが新しいタブで開きます。アカウント名の入力、アクセスの確認、パスワードの入力を求められます。
  7. [追加] を選択します。

[マイクロアプリ統合] ページが開き、追加した統合とそのマイクロアプリが表示されています。ここから別の統合を追加したり、追加設定不要のマイクロアプリのセットアップを続行したり、この統合用の新しいマイクロアプリを作成したりできます。

これで、最初のデータ同期を設定して実行する準備ができました。統合アプリケーションからマイクロアプリプラットフォームに大量のデータをプルできるので、[テーブル] ページを使用して、最初のデータ同期のエンティティをフィルタリングし、同期を高速化することをお勧めします。

詳しくは、「統合の構成」で「必要なエンティティの確認」および「データ同期の設定」を参照してください。

APIエンドポイントとテーブルエンティティについて詳しくは、「Zendeskコネクタの仕様」を参照してください。

Zendeskマイクロアプリの使用

既存のアプリケーション統合には、追加設定不要のマイクロアプリが付属しています。これらのマイクロアプリから開始して、ニーズに合わせてカスタマイズします。

Zendeskマイクロアプリ

Zendesk統合には、以下の設定済みで追加設定不要のマイクロアプリが付属しています:

チケットの追加: Zendeskチケットを送信します。

通知またはページ ユースケースワークフロー
チケットの送信ページ チケットを送信するためのフォームを提供します。

チケット: 詳細なZendeskチケットを表示します。

通知またはページ ユースケースワークフロー
新規チケット割り当て(変更)通知 既存のチケットがユーザーに割り当てられると、ユーザーは通知を受け取ります。
新規チケット割り当て(新規)通知 新しいチケットがユーザーに割り当てられると、ユーザーは通知を受け取ります。
チケット状況変更通知 チケットの状況が変更されると、チケットの送信者は通知を受け取ります。
チケット更新通知 チケットが更新されると、送信者は通知を受け取ります。
自分のチケットページ パーソナライズされた、ユーザーに関連するチケットとチケットの詳細へのリンクの一覧を提供します。
チケットの詳細ページ チケットの詳細の読み取り専用ビューを提供します。