Zoho Deskでのコメントの投稿と更新のカスタム関数

Zoho Deskでのコメントの投稿と更新のカスタム関数

お知らせ：当社は、お客様により充実したサポート情報を迅速に提供するため、本ページのコンテンツは機械翻訳を用いて日本語に翻訳しています。正確かつ最新のサポート情報をご覧いただくには、本内容の英語版を参照してください。

  • Zoho Deskは、顧客からの問い合わせに対応できるカスタマーサービスソフトウェアです。このカスタム関数を使用すると、Qntrlでコメントが追加または更新されたときに、Zoho Deskでもコメントを追加または更新できます。

  • コメントは、Qntrlのカードから作成されたチケットに追加されます。指定したカードがZoho Deskにチケットとして存在しない場合は、新しいチケットが作成され、そのチケットにコメントが追加されます。


前提条件  


Zoho Deskに登録し、部門を作成します。コメントは、Zoho Deskで設定された組織と部門に投稿されます。

メモ：
  1. このカスタム関数は、ビジネスルールからトリガーされ、コメントの追加または更新時に実行される場合にのみ動作します。
  1. コメントは、カード依頼者のアカウントからZoho Deskに投稿されます。ただし、カードにコメントしたユーザーの名前が記載されます。

ビジネスシナリオ


開発部門の責任者であるMarkは、開発者を顧客対応に関与させたいと考えています。専任のカスタマーサポートチームはありますが、Markのチームの開発者は、顧客に直接解決策を提示するためにコメントできます。これらのコメントは、カスタマーサポート担当者の連絡先を通じてZoho Deskで追加または更新されます。

「Post_and_Update_Comments_in_Zoho_Desk」カスタム関数のビジネスシナリオ を確認します。

カスタム関数の設定手順

このカスタム関数を実行する前に、引数を設定し、接続を認証する必要があります。以下の手順に従って関数を設定します。

1. 引数の設定


まず、カスタム関数で使用するすべてのパラメーターに［引数の値］を設定します。カスタム値を指定するか、ドロップダウンからフォーム項目を選択できます。フォーム項目には、カスタム関数に対応するカード項目から動的な値が取り込まれます。

   

  • orgName ：組織名を指定します。組織名はQntrlのURL（ core.qntrl.com/blueprint / <orgName>/<タブ>）で確認できます。

  • requestorName ：こちらで ［依頼者］ フォーム項目を選択します。カード依頼者の名前を指定することもできます。

  • jobTitle ：コメントを追加または更新するカードのタイトルを指定します。こちらで ［タイトル］ フォーム項目を選択できます。

  • jobID ：こちらで ［カードID］ フォーム項目を選択します。カードのIDを指定することもできます。これはカードURL（ core.qntrl.com/blueprint/ <org-name>/<job>/<jobID>）で確認できます。

  • deskOrgID ：Zoho Deskの組織IDを指定します。

  • departmentID ：カードが属するZoho Deskの部門IDを指定します。

  • comment ：追加または更新するコメントを入力します。こちらで ［コメント］ フォーム項目を選択できます。

  • jobCommentID ：コメントのIDを指定します。 こちらで ［コメントID］ フォーム項目を選択できます。


2. 接続を使用した認証


接続 を使用すると、カスタム関数で使用するQntrl やZohoの他の内部アプリケーションの特定のスコープに対するAPI呼び出しを認証できます。

    1.   接続を呼び出して、Qntrlアカウントを認証します。

    • ［+接続］ ボタンを カスタム関数でクリックするか、［詳細］配下の［接続］に移動します。

    • ［接続の作成］ を右上でクリックします。

    • ［Zoho Oauth］ を ［サービスの選択］ タブで選択します。

    • ［接続名］ を入力し、 ［スコープ］ として「Orchestly.job.ALL」、「Orchestly.user.ALL」、「Orchestly.attachment.ALL」、「Desk.contacts.READ」、「Desk.search.READ」、「Desk.contacts.CREATE」、「Desk.tickets.ALL」を選択して接続します。

    2.   認証に成功したら、カスタム関数のレスポンスブロックに接続の詳細を含めます。

             例：connection : '<Connection-name>'


上記の手順の設定が完了すると、カスタム関数を実行できるようになります。



Post_and_Update_Comments_in_Zoho_Desk は、関数ギャラリーで利用できるQntrlの定義済みカスタム関数の1つです。ただし、Qntrlでは独自のカスタム関数を作成することもできます。