Zoho Desk

統合バージョン: 2.0

Chronicle SOAR で Zoho Desk の統合を構成する

Chronicle SOAR で統合を構成する方法の詳細については、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名 種類 デフォルト値 必須 説明
API ルート 文字列 https://desk.zoho.{region} ○ Zoho Desk インスタンスの API ルート。
クライアント ID 文字列 なし ○ Zoho Desk アカウントのクライアント ID。
クライアント シークレット パスワード なし ○ Zoho Desk アカウントのクライアント シークレット。
トークンを更新 パスワード なし いいえ Zoho Desk アカウントの更新トークン。トークンを生成するには、「更新トークンの取得」というアクションを実行する必要があります。
SSL を確認 チェックボックス オン ○ 有効になっている場合は、Zoho Desk サーバーへの接続用の SSL 証明書が有効であることを確認します。

API 認証情報を取得する

  1. Zoho Desk API コンソールに移動します。
  2. [クライアントを追加] をクリックし、[セルフ クライアント] を選択します。
  3. [クライアント シークレット] タブで、「クライアント ID」と「クライアント シークレット」のパラメータの値をコピーし、統合構成ウィンドウのそれぞれのフィールドに貼り付けます。
  4. [コードの生成] タブで、スコープ Desk.tickets.READ,Desk.tickets.CREATE,Desk.tickets.UPDATE,Desk.tickets.DELETE,Desk.settings.READ,Desk.basic.READ,Desk.products.READ,Desk.contacts.READ を指定し、スコープの説明を追加します。
  5. 認証コードを取得するには、[作成] をクリックします。
  6. Chronicle に戻り、ケースをシミュレートして、Zoho Desk 統合内の [更新トークンの取得] アクションに移動します。
  7. アクションを構成するには、認証コードと認証リンクを入力します。
  8. アクションの JSON 結果からトークンをコピーし、統合構成ウィンドウのそれぞれのフィールドに貼り付けてテストを実行します。

ユースケース

優先順位付けアクションを実行します。

アクション

チケットにコメントを追加

説明

Zoho Desk でチケットにコメントを追加します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
チケット ID 文字列 なし ○ コメントを追加するチケットの ID を指定します。
公開設定 DDL

公共

有効な値:

  • パブリック
  • プライベート
 いいえ コメントを公開にするか非公開にするかを指定します。
種類 文字列

書式なしテキスト

有効な値:

  • 書式なしテキスト
  • HTML
 いいえ コメントの種類を指定します。
テキスト 文字列 なし いいえ コメントの内容を指定します。
応答を待つ チェックボックス オフ いいえ 有効の場合、アクションは応答を待機します。

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
JSON の結果
{
    "content": "zsu[@user:11550965]zsu Please fix this ASAP",
    "commentedTime": "2022-07-01T11:18:43.935Z",
    "modifiedTime": "2022-07-01T11:18:43.935Z",
    "contentType": "plainText",
    "impersonatedUser": null,
    "encodedContent": "zsu[@user:11550965]zsu Please fix this ASAP",
    "id": "97709000000179081",
    "commenterId": "97709000000092001",
    "commenter": {
        "id": "97709000000092001",
        "name": "TIP Labops",
        "email": "tip.labops@siemplify.co",
        "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
        "type": "AGENT",
        "firstName": "TIP",
        "lastName": "Labops",
        "roleName": "CEO"
    },
    "attachments": [],
    "isPublic": false
}
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

200 ステータス コードが報告された場合（is_success = true）: 「Zoho Desk のチケット {ticket id} にコメント "{text}" が正常に追加されました。」

非同期メッセージ: 「応答を待っています...」

アクションが失敗し、Playbook の実行を停止します

重大なエラーが報告された場合: 「"チケットにコメントを追加する"という操作の実行中にエラーが発生しました。」理由: {0}''.format(error.Stacktrace)

エラーが報告された場合: 「"チケットにコメントを追加"という操作の実行中にエラーが発生しました。」理由: {errors/errorMessage}

 一般

チケットを作成

説明

Zoho Desk でチケットを作成します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
タイトル 文字列 なし いいえ チケットのタイトルを指定します。
説明 文字列 なし いいえ チケットの説明を指定します。
部門名 文字列 なし いいえ チケットに設定する必要がある部門の名前を指定します。
取引先責任者 文字列 なし いいえ チケットの連絡先のメールアドレスを指定します。
割り当て先のタイプ DDL

1 つ選択

値は次のいずれかです。

  • 1 つ選択
  • エージェント
  • チーム
 いいえ

割り当て先のタイプを指定します。

[エージェント] または [チーム] が選択されている場合、[割り当て先名] パラメータは必須です。
割り当て先名 文字列 なし いいえ チケットの割り当て先の名前を指定します。エージェント タイプには、メールアドレスまたは表示名を指定できます。
優先度 DDL

1 つ選択

有効な値:

  • 1 つ選択
  • 優先度なし
  • 低
  • 中
  • 高
 いいえ チケットの優先度を指定します。
分類 DDL

1 つ選択

有効な値:

  • 1 つ選択
  • 分類なし
  • 問題
  • 問題
  • 特徴
  • その他
 いいえ チケットの分類タイプを指定します。
チャネル DDL

1 つ選択

有効な値:

  • 1 つ選択
  • メールアドレス
  • 電話
  • ウェブ
  • Twitter
  • Facebook
  • チャット
  • フォーラム
 いいえ チケットのチャネルを指定します。
カテゴリ 文字列 なし いいえ チケットのカテゴリを指定します。
サブカテゴリ 文字列 なし いいえ チケットのサブカテゴリを指定します。
Due Date 文字列 なし いいえ

チケットの期限を指定します。

形式: ISO 8601。例: 2022-07-06T07:05:43Z。
カスタム フィールド JSON なし いいえ

更新が必要なカスタム フィールドを含む JSON オブジェクトを指定します。

注: キーの API 名を指定する必要があります。

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
JSON の結果
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

200 ステータス コードが報告された場合（is_success=true）: 「Zoho Desk にID {ticket id} のチケットが正常に作成されました。」

アクションが失敗し、Playbook の実行を停止します。

認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他の情報が報告されます: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: {0}''.format(error.Stacktrace)

エージェントが見つからない場合: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: エージェント {agent_name} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

チームが見つからない場合: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: チーム {team_name} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

[エージェント] または [チーム] が選択されていて、[割り当て先名] パラメータが指定されていない場合: 「操作「チケットの作成」の実行中にエラーが発生しました。理由: "割り当て先の名前"を指定する必要があります。」

部門が見つからなかった場合: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: 部門 {department_name} は Zoho Desk で見つかりませんでした。」

連絡先が見つからない場合: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: Zoho Desk で連絡先 {contact} が見つかりませんでした。スペルを確認してください。」

商品が見つからない場合: 「"チケットの作成"という操作の実行中にエラーが発生しました。理由: 商品 {product} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

 一般

更新トークンを取得する

説明

構成の更新トークンを取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
認証リンク 文字列 https://accounts.zoho.{region} ○ 統合の認証リンクを指定します。
認証コード パスワード なし ○ Zoho の開発コンソールで生成された認証コードを指定します。

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
JSON の結果
{
    "refresh_token": "1000.90567b1fc0c54f540e56200ae4388cef.a8f6b313297d558774bee07d60cc6863"
}
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

成功した場合: 「更新トークンが正常に生成されました。統合構成の「更新トークン」パラメータに値をコピーします。

アクションが失敗し、Playbook の実行も停止した場合。

認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他の情報が報告されます: 「更新トークンの取得操作のエラー」。理由: {0}''.format(error.Stacktrace)

エラーが報告された場合: 「"更新トークンの取得"という操作の実行中にエラーが発生しました。理由: {error}」

 一般

チケットの詳細を取得する

説明

Zoho Desk からチケットの詳細情報を取得します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
チケット ID 文字列 なし ○ 詳細を取得する ID のカンマ区切りのリストを指定します。
分析情報の作成 チェックボックス オフ いいえ 有効にすると、チケットに関する情報を含む分析情報が作成されます。
返されるその他のフィールド CSV contacts、products、assignee、department、contract、isRead、team、skills いいえ

返される追加のフィールドを指定します。

指定できる値: contacts、products、assignee、departments、contract、isRead、team、skill。
コメントの取得 チェックボックス オン いいえ 有効にすると、アクションによってチケットに関連するコメントが取得されます。
返されるコメントの最大数 整数 50 いいえ

チケットごとに返すコメントの数を指定します。

最大値: 100

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
JSON の結果
{
  "modifiedTime": "2022-06-27T17:12:35.000Z",
  "subCategory": null,
  "statusType": "Open",
  "subject": "tesa",
  "dueDate": null,
  "departmentId": "97709000000007061",
  "channel": "Phone",
  "onholdTime": null,
  "language": null,
  "source": {
      "appName": null,
      "extId": null,
      "permalink": null,
      "type": "SYSTEM",
      "appPhotoURL": null
  },
  "resolution": null,
  "sharedDepartments": [],
  "closedTime": null,
  "approvalCount": "0",
  "isOverDue": false,
  "isTrashed": false,
  "contact": {
      "firstName": null,
      "lastName": "test",
      "phone": null,
      "mobile": null,
      "id": "97709000000159194",
      "isSpam": false,
      "type": null,
      "email": "test@test.com",
      "account": {
          "website": null,
          "accountName": "test!@test.com",
          "id": "97709000000159182"
      }
  },
  "createdTime": "2022-06-27T17:12:35.000Z",
  "id": "97709000000159224",
  "isResponseOverdue": false,
  "customerResponseTime": "2022-06-27T17:12:35.000Z",
  "productId": null,
  "contactId": "97709000000159194",
  "threadCount": "1",
  "secondaryContacts": [],
  "priority": null,
  "classification": null,
  "commentCount": "0",
  "taskCount": "0",
  "accountId": "97709000000159182",
  "phone": null,
  "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000159224",
  "assignee": {
      "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
      "firstName": "TIP",
      "lastName": "Labops",
      "id": "97709000000092001",
      "email": "tip.labops@siemplify.co"
  },
  "isSpam": false,
  "status": "Open",
  "entitySkills": [],
  "ticketNumber": "102",
  "sentiment": null,
  "customFields": {},
  "isArchived": false,
  "skillsInfo": [],
  "isRead": false,
  "description": "<div style=\"font-size: 13px; font-family: Regular, Lato, Arial, Helvetica, sans-serif\"><div>tetsta</div></div>",
  "timeEntryCount": "0",
  "channelRelatedInfo": null,
  "responseDueDate": null,
  "isDeleted": false,
  "modifiedBy": "97709000000092001",
  "department": {
      "name": "Siemplify",
      "id": "97709000000007061"
  },
  "followerCount": "0",
  "email": "test@test.com",
  "layoutDetails": {
      "id": "97709000000023011",
      "layoutName": "Siemplify"
  },
  "channelCode": null,
  "product": null,
  "isFollowing": false,
  "cf": {},
  "slaId": null,
  "team": null,
  "layoutId": "97709000000023011",
  "assigneeId": "97709000000092001",
  "createdBy": "97709000000092001",
  "teamId": null,
  "contractId": null,
  "tagCount": "0",
  "attachmentCount": "0",
  "isEscalated": false,
  "category": null
  "comments":          {
            "content": "<div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><div style=\"font-size: 14px; font-family: LatoRegular, Regular, Lato, &quot;Lato 2&quot;, Arial, Helvetica, sans-serif\"><ul><li>asdasdasdasd<br /></li></ul></div><div><br /></div></div>",
            "commentedTime": "2022-06-29T10:21:24.000Z",
            "modifiedTime": "2022-06-29T10:23:42.000Z",
            "contentType": "html",
            "impersonatedUser": null,
            "encodedContent": "&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;div style&#x3d;&quot;font-size&#x3a; 14px&#x3b; font-family&#x3a; LatoRegular, Regular, Lato, &amp;quot&#x3b;Lato 2&amp;quot&#x3b;, Arial, Helvetica, sans-serif&quot;&gt;&lt;ul&gt;&lt;li&gt;asdasdasdasd&lt;br &#x2f;&gt;&lt;&#x2f;li&gt;&lt;&#x2f;ul&gt;&lt;&#x2f;div&gt;&lt;div&gt;&lt;br &#x2f;&gt;&lt;&#x2f;div&gt;&lt;&#x2f;div&gt;",
            "id": "97709000000172003",
            "commenterId": "97709000000092001",
            "commenter": {
                "id": "97709000000092001",
                "name": "TIP Labops",
                "email": "tip.labops@siemplify.co",
                "photoURL": "https://desk.zoho.eu/api/v1/agents/97709000000092001/photo?orgId=20083004796",
                "type": "AGENT",
                "firstName": "TIP",
                "lastName": "Labops",
                "roleName": "CEO"
            },
            "attachments": [],
            "isPublic": false
        }

}
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

少なくとも 1 つの ID に関するデータが利用可能な場合（is_success = true）: 「Zoho Desk の次のチケットに関連する詳細が正常に返されました: {ticket ids}」。

少なくとも 1 つの ID のデータがない場合（is_success=true）: 「Zoho Desk で次のチケットに関連する詳細情報が見つかりませんでした: {ticket ids}」。

すべての ID のデータを利用できない場合（is_success=false）: 「チケットが見つかりませんでした」。

アクションが失敗し、Playbook の実行を停止します。

認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他の情報が報告されます: 「チケットの詳細を取得」というアクションの実行エラー。理由: {0}''.format(error.Stacktrace)

 一般
Case Wall テーブル

テーブル名: Ticket Details テーブル列:

  • 番号: ticketNumber
  • ステータス: status Subject: subject
  • 作成時刻: createdTime
  • 解像度: resolution
  • Email: email
  • 連絡先: {firstName} + {lastName}
 一般

チケットをスパムとしてマークする

説明

Zoho Desk でチケットをスパムとしてマークできるようになりました。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
チケット ID 文字列 なし ○ スパムとしてマークする必要があるチケットの ID を指定します。
連絡先をマークする チェックボックス オン いいえ 有効にすると、チケットを作成した連絡先がスパマーとしてマークされます。

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止することはありません。

200 ステータス コードが報告された場合（is_success = true）: 「Zoho Desk でチケットをスパムとしてマークしました。

アクションが失敗し、Playbook の実行を停止します。

認証情報が誤っている、サーバーへの接続がないなどの致命的なエラーが報告される場合、その他の情報が報告されます。: 「"チケットをスパムとしてマークする"という操作の実行中にエラーが発生しました。理由: {0}''.format(error.Stacktrace)

エラーが報告された場合: 「"チケットをスパムとしてマークする"という操作の実行中にエラーが発生しました。理由: {errors/errorMessage}

 一般

Ping

説明

[Chronicle Marketplace] タブの統合構成ページで提供されたパラメータを使用して、Zoho Desk への接続をテストします。

パラメータ

なし

実行

アクションはエンティティに対して実行されず、必須入力パラメータもありません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

成功した場合（is_success=true）: 「指定された接続パラメータを使用して Zoho Desk サーバーに正常に接続しました。」

アクションが失敗し、Playbook の実行を停止します。

失敗した場合（is_success= false）: 「Zoho Desk サーバーに接続できませんでした。エラー: {0}".format(exception.stacktrace)

 一般

更新チケット

説明

Zoho Desk でチケットを更新します。

パラメータ

パラメータの表示名 種類 デフォルト値 必須 説明
チケット ID 文字列 なし ○ 更新する必要があるチケットの ID を指定します。
タイトル 文字列 なし いいえ チケットに設定するタイトルを指定します。
説明 文字列 なし いいえ チケットの説明を指定します。
部門名 文字列 なし いいえ チケットに設定する必要がある部門の名前を指定します。
取引先責任者 文字列 なし いいえ チケットの連絡先のメールアドレスを指定します。
割り当て先のタイプ DDL

1 つ選択

値は次のいずれかです。

  • 1 つ選択
  • エージェント
  • チーム
 いいえ

割り当て先のタイプを指定します。

[エージェント] または [チーム] が選択されている場合、[割り当て先名] パラメータは必須です。
割り当て先名 文字列 なし いいえ チケットの割り当て先の名前を指定します。エージェント タイプには、メールアドレスまたは表示名を指定できます。
解決策 文字列 なし いいえ チケットの解決策を指定します。
優先度 DDL

1 つ選択

有効な値:

  • 1 つ選択
  • 優先度なし
  • 低
  • 中
  • 高
 いいえ チケットの優先度を指定します。
ステータス DDL

1 つ選択

有効な値:

  • 1 つ選択
  • オープン
  • 保留中
  • Escalated
  • クローズ
 いいえ チケットのステータスを指定します。
状態をマークする DDL

1 つ選択

値は次のいずれかです。

  • 1 つ選択
  • 読み取り
  • 未読
 いいえ チケットのマーク状態を指定します。
分類 DDL

1 つ選択

有効な値:

  • 1 つ選択
  • 分類なし
  • 問題
  • 問題
  • 特徴
  • その他
 いいえ チケットの分類タイプを指定します。
チャネル DDL

1 つ選択

有効な値:

  • 1 つ選択
  • メールアドレス
  • 電話
  • ウェブ
  • Twitter
  • Facebook
  • チャット
  • フォーラム
 いいえ チケットのチャネルを指定します。
カテゴリ 文字列 なし いいえ チケットのカテゴリを指定します。
サブカテゴリ 文字列 なし いいえ チケットのサブカテゴリを指定します。
Due Date 文字列 なし いいえ

チケットの期限を指定します。

形式: ISO 8601。例: 2022-07-06T07:05:43Z。

注: ステータスが「保留中」に設定されている場合、このパラメータによる影響はありません。
カスタム フィールド JSON なし いいえ

更新が必要なカスタム フィールドを含む JSON オブジェクトを指定します。

注: キーの API 名を指定する必要があります。

実行

このアクションはエンティティでは実行されません。

アクションの結果

スクリプトの結果
スクリプトの結果名 VALUE オプション 例
is_success True/False is_success:False
JSON の結果
{
    "modifiedTime": "2022-07-01T11:00:33.000Z",
    "subCategory": null,
    "statusType": "On Hold",
    "subject": "Here's your first ticket.",
    "dueDate": null,
    "departmentId": "97709000000007061",
    "channel": "Chat",
    "onholdTime": "2022-07-01T09:32:14.717Z",
    "language": "English",
    "source": {
        "appName": null,
        "extId": null,
        "permalink": null,
        "type": "SYSTEM",
        "appPhotoURL": null
    },
    "resolution": "Koko",
    "sharedDepartments": [],
    "closedTime": null,
    "approvalCount": "0",
    "isOverDue": true,
    "isTrashed": false,
    "createdTime": "2022-06-27T17:02:17.000Z",
    "id": "97709000000160077",
    "isResponseOverdue": false,
    "customerResponseTime": "2022-06-27T17:02:17.000Z",
    "productId": null,
    "contactId": "97709000000160029",
    "threadCount": "1",
    "secondaryContacts": [],
    "priority": null,
    "classification": null,
    "commentCount": "1",
    "taskCount": "0",
    "accountId": "97709000000160001",
    "phone": "1 888 900 9646",
    "webUrl": "https://desk.zoho.eu/support/siemplify/ShowHomePage.do#Cases/dv/97709000000160077",
    "isSpam": false,
    "status": "On Hold",
    "entitySkills": [],
    "ticketNumber": "101",
    "customFields": {},
    "isArchived": false,
    "description": "Hello<",
    "timeEntryCount": "0",
    "channelRelatedInfo": null,
    "responseDueDate": null,
    "isDeleted": false,
    "modifiedBy": "97709000000092001",
    "email": "support@zohosupport.com",
    "layoutDetails": {
        "id": "97709000000023011",
        "layoutName": "Siemplify"
    },
    "channelCode": null,
    "cf": {},
    "slaId": null,
    "layoutId": "97709000000023011",
    "assigneeId": null,
    "teamId": "97709000000182001",
    "attachmentCount": "0",
    "isEscalated": false,
    "category": null
}
Case Wall
結果のタイプ 値 / 説明 種類
出力メッセージ

アクションが失敗したり、Playbook の実行を停止したりすることはありません。

200 ステータス コードが報告された場合（is_success = true）: 「Zoho Desk にて ID {ticket id}のチケットの更新が成功しました。」

アクションが失敗し、Playbook の実行を停止します。

認証情報が誤っているなどの致命的なエラーで、サーバーへの接続がない場合、その他の情報が報告されます: 「"チケットを更新"という操作の実行中にエラーが発生しました。理由: {0}''.format(error.Stacktrace)

エージェントが見つからない場合: 「"チケットを更新"という操作の実行中にエラーが発生しました。理由: エージェント {agent_name} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

チームが見つからない場合: 「"チケットの更新"という操作の実行中にエラーが発生しました。理由: チーム {team_name} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

部門が見つからない場合: 「"チケットの更新"という操作の実行中にエラーが発生しました。理由: 部門 {department} が Zoho Desk に見つかりませんでした。スペルを確認してください。」

連絡先が見つからない場合: 「"チケットの更新"という操作の実行中にエラーが発生しました。理由: Zoho Desk で連絡先 {contact} が見つかりませんでした。スペルを確認してください。」

商品が見つからない場合: 「"チケットを更新"という操作の実行中にエラーが発生しました。理由: 商品 {product} が Zoho Desk で見つかりませんでした。スペルを確認してください。」

[エージェント] または [チーム] が選択されていて、[割り当て先名] パラメータが指定されていない場合: 「"チケットを更新"という操作の実行中にエラーが発生しました。理由: "割り当て先の名前"を指定する必要があります。」

 一般