Zoho Desk

Dokumen ini memberikan panduan tentang cara mengintegrasikan Zoho Desk dengan Google SecOps.

Mengonfigurasi integrasi Zoho Desk di Google Security Operations

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Root API String https://desk.zoho.{region} Ya Root API instance Zoho Desk.
Client ID String T/A Ya Client ID akun Zoho Desk.
Rahasia Klien Sandi T/A Ya Rahasia Klien akun Zoho Desk.
Token Refresh Sandi T/A Tidak Token Refresh akun Zoho Desk. Anda harus menjalankan tindakan "Get Refresh Token" untuk membuatnya.
Verifikasi SSL Kotak centang Dicentang Ya Jika diaktifkan, setelan ini akan memverifikasi bahwa sertifikat SSL untuk koneksi ke server Zoho Desk valid.

Mendapatkan kredensial API

  1. Buka konsol Zoho Desk API.
  2. Klik Add Client, lalu pilih Self Client.
  3. Di tab Client Secret, salin nilai parameter "Client ID" dan "Client Secret", lalu tempelkan ke kolom masing-masing di jendela konfigurasi integrasi.
  4. Di tab Generate Code, berikan cakupan berikut: Desk.tickets.READ,Desk.tickets.CREATE,Desk.tickets.UPDATE,Desk.tickets.DELETE,Desk.settings.READ,Desk.basic.READ,Desk.products.READ,Desk.contacts.READ dan tambahkan deskripsi cakupan.
  5. Untuk mendapatkan kode otorisasi, klik Create.
  6. Kembali ke Google SecOps, simulasikan kasus, lalu buka tindakan Get Refresh Token dalam integrasi Zoho Desk.
  7. Untuk mengonfigurasi tindakan, masukkan kode otorisasi dan link otorisasi Anda.
  8. Salin token dari hasil JSON tindakan, tempelkan ke kolom yang sesuai di jendela konfigurasi integrasi, lalu jalankan pengujian.

Kasus Penggunaan

Melakukan tindakan triase.

Tindakan

Tambahkan Komentar ke Tiket

Deskripsi

Menambahkan komentar ke tiket di Zoho Desk.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket String T/A Ya Tentukan ID tiket yang ingin Anda tambahi komentar.
Visibilitas DDL

Publik

Nilai yang Mungkin Muncul:

  • Publik
  • Pribadi
Tidak Tentukan apakah komentar harus bersifat publik atau pribadi.
Jenis String

Teks Biasa

Nilai yang Mungkin Muncul:

  • Teks Biasa
  • HTML
Tidak Tentukan jenis komentar.
Teks String T/A Tidak Tentukan konten komentar.
Menunggu Balasan Kotak centang Tidak dicentang Tidak Jika diaktifkan, tindakan akan menunggu balasan.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil 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
}
Repositori Kasus
Jenis hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 200 dilaporkan (is_success = true): "Successfully added comment "{text}" to ticket {ticket id}in Zoho Desk."

Pesan Asinkron: "Menunggu balasan..."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error kritis dilaporkan: "Error executing action "Add Comment To Ticket". Reason: {0}''.format(error.Stacktrace)

Jika error dilaporkan: "Error executing action "Add Comment To Ticket". Alasan: {errors/errorMessage}

Umum

Buat Tiket

Deskripsi

Membuat tiket di Zoho Desk.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Judul String T/A Tidak Tentukan judul untuk tiket.
Deskripsi String T/A Tidak Tentukan deskripsi tiket.
Nama Departemen String T/A Tidak Tentukan nama departemen yang harus ditetapkan untuk tiket.
Kontak String T/A Tidak Tentukan email kontak untuk tiket.
Jenis Penerima Tugas DDL

Pilih Satu

Nilai yang memungkinkan:

  • Pilih Satu
  • Agen
  • Tim
Tidak

Tentukan jenis penerima tugas.

Jika "Agen" atau "Tim" dipilih, parameter "Nama Penerima Tugas" wajib diisi.

Nama Penerima Tugas String T/A Tidak Tentukan nama penerima tugas untuk tiket. Untuk jenis agen, Anda dapat memberikan alamat email atau nama tampilan.
Prioritas DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Tidak Ada Prioritas
  • Rendah
  • Sedang
  • Tinggi
Tidak Tentukan prioritas untuk tiket.
Klasifikasi DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Tidak Ada Klasifikasi
  • Pertanyaan
  • Masalah
  • Fitur
  • Lainnya
Tidak Tentukan jenis klasifikasi untuk tiket.
Saluran DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Email
  • Telepon
  • Web
  • Twitter
  • Facebook
  • Chat
  • Forum
Tidak Tentukan saluran untuk tiket.
Kategori String T/A Tidak Tentukan kategori untuk tiket.
Sub-Kategori String T/A Tidak Tentukan subkategori untuk tiket.
Batas Waktu String T/A Tidak

Tentukan batas waktu untuk tiket.

Format: ISO 8601. Contoh: 2022-07-06T07:05:43Z.

Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom yang perlu diperbarui.

Catatan: Anda harus memberikan nama API kunci.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil 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
}
Repositori Kasus
Jenis hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 200 dilaporkan (is_success=true): "Successfully created a ticket with ID {ticket id} in Zoho Desk.".

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Create Ticket". Reason: {0}''.format(error.Stacktrace)

Jika agen tidak ditemukan: "Error executing action "Create Ticket". Alasan: agen {agent_name} tidak ditemukan di Zoho Desk. Periksa ejaannya."'

Jika tim tidak ditemukan: "Error executing action "Create Ticket". Alasan: tim {team_name} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Jika "Agen" atau "Tim" dipilih, tetapi parameter "Nama Penerima Tugas" tidak diberikan: "Error saat menjalankan tindakan "Buat Tiket". Alasan: "Nama Penerima Tugas" harus diberikan."

Jika departemen tidak ditemukan: "Error executing action "Create Ticket". Alasan: departemen {department_name} tidak ditemukan di Zoho Desk."

Jika kontak tidak ditemukan: "Error executing action "Create Ticket". Alasan: kontak {contact} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Jika produk tidak ditemukan: "Error executing action "Create Ticket". Alasan: produk {product} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Umum

Mendapatkan Token Refresh

Deskripsi

Dapatkan token refresh untuk konfigurasi.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Link Otorisasi String https://accounts.zoho.{region} Ya Tentukan link otorisasi untuk integrasi.
Kode Otorisasi Sandi T/A Ya Tentukan kode otorisasi yang dibuat di konsol developer Zoho.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
{
    "refresh_token": "1000.90567b1fc0c54f540e56200ae4388cef.a8f6b313297d558774bee07d60cc6863"
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil: "Successfully generated refresh token. Salin nilai ke parameter "token refresh" di konfigurasi integrasi

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Get Refresh Token". Reason: {0}''.format(error.Stacktrace)

Jika error dilaporkan: "Error executing action "Get Refresh Token". Reason: {error}''

Umum

Mendapatkan Detail Tiket

Deskripsi

Mendapatkan informasi mendetail tentang tiket dari Zoho Desk.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID Tiket String T/A Ya Tentukan daftar ID yang dipisahkan koma yang ingin Anda tampilkan detailnya.
Create Insight Kotak centang Tidak dicentang Tidak Jika diaktifkan, tindakan ini akan membuat insight yang berisi informasi tentang tiket.
Kolom Tambahan yang akan Ditampilkan CSV contacts, products, assignee, departments, contract, isRead, team, skills Tidak

Tentukan kolom tambahan yang akan ditampilkan.

Nilai yang mungkin: contacts, products, assignee, departments, contract, isRead, team, skills.

Mengambil Komentar Kotak centang Dicentang Tidak Jika diaktifkan, tindakan ini akan mengambil komentar yang terkait dengan tiket.
Jumlah Komentar Maksimum yang Akan Ditampilkan Bilangan bulat 50 Tidak

Tentukan jumlah komentar yang akan ditampilkan per tiket.

Maksimum: 100

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil 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
        }

}
Repositori Kasus
Jenis hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia untuk setidaknya satu ID (is_success = true): "Successfully returned details related to the following tickets in Zoho Desk: {ticket ids}".

Jika data tidak tersedia untuk setidaknya satu ID (is_success=true): "Action wasn't able to find details related to the following tickets in Zoho Desk: {ticket ids}".

Jika data tidak tersedia untuk semua ID (is_success=false): "No tickets were found."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Get Ticket Details". Reason: {0}''.format(error.Stacktrace)

Umum
Tabel Repositori Kasus

Nama Tabel: Detail Tiket Kolom Tabel:

  • Nomor: ticketNumber
  • Status: status Subject: subject
  • Waktu Pembuatan: createdTime
  • Resolution: resolution
  • Email: email
  • Kontak: {firstName} + {lastName}
Umum

Tandai Tiket Sebagai Spam

Deskripsi

Tandai tiket sebagai spam di Zoho Desk.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket String T/A Ya Tentukan ID tiket yang perlu ditandai sebagai spam.
Tandai Kontak Kotak centang Dicentang Tidak Jika diaktifkan, kontak yang membuat tiket akan ditandai sebagai spammer.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 200 dilaporkan (is_success = true): "Berhasil menandai tiket sebagai spam di Zoho Desk.

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Mark Ticket As Spam". Reason: {0}''.format(error.Stacktrace)

Jika error dilaporkan: "Error executing action "Mark Ticket As Spam". Alasan: {errors/errorMessage}

Umum

Ping

Deskripsi

Uji konektivitas ke Zoho Desk dengan parameter yang disediakan di halaman konfigurasi integrasi di halaman Google SecOps Content Hub.

Parameter

T/A

Dijalankan pada

Tindakan ini tidak berjalan di entity, dan tidak memiliki parameter input wajib.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output\*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika berhasil (is_success=true): "Successfully connected to the Zoho Desk server with the provided connection parameters!"

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika tidak berhasil (is_success= false): "Failed to connect to the Zoho Desk server! Error is {0}".format(exception.stacktrace)

Umum

Perbarui Tiket

Deskripsi

Memperbarui tiket di Zoho Desk.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket String T/A Ya Tentukan ID tiket yang perlu diperbarui.
Judul String T/A Tidak Tentukan judul yang harus ditetapkan untuk tiket.
Deskripsi String T/A Tidak Tentukan deskripsi untuk tiket.
Nama Departemen String T/A Tidak Tentukan nama departemen yang harus ditetapkan untuk tiket.
Kontak String T/A Tidak Tentukan email kontak untuk tiket.
Jenis Penerima Tugas DDL

Pilih Satu

Nilai yang memungkinkan:

  • Pilih Satu
  • Agen
  • Tim
Tidak

Tentukan jenis penerima tugas.

Jika "Agen" atau "Tim" dipilih, parameter "Nama Penerima Tugas" wajib diisi.

Nama Penerima Tugas String T/A Tidak Tentukan nama penerima tugas untuk tiket. Untuk jenis agen, Anda dapat memberikan alamat email atau nama tampilan.
Resolusi String T/A Tidak Tentukan penyelesaian untuk tiket.
Prioritas DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Tidak Ada Prioritas
  • Rendah
  • Sedang
  • Tinggi
Tidak Tentukan prioritas untuk tiket.
Status DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Buka
  • Ditangguhkan
  • Dieskalasi
  • Tutup
Tidak Tentukan status untuk tiket.
Status Tanda DDL

Pilih Satu

Nilai yang memungkinkan:

  • Pilih Satu
  • Baca
  • Belum Dibaca
Tidak Tentukan status tanda untuk tiket.
Klasifikasi DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Tidak Ada Klasifikasi
  • Pertanyaan
  • Masalah
  • Fitur
  • Lainnya
Tidak Tentukan jenis klasifikasi untuk tiket.
Saluran DDL

Pilih Satu

Nilai yang Mungkin Muncul:

  • Pilih Satu
  • Email
  • Telepon
  • Web
  • Twitter
  • Facebook
  • Chat
  • Forum
Tidak Tentukan saluran untuk tiket.
Kategori String T/A Tidak Tentukan kategori untuk tiket.
Sub-Kategori String T/A Tidak Tentukan subkategori untuk tiket.
Batas Waktu String T/A Tidak

Tentukan batas waktu untuk tiket.

Format: ISO 8601. Contoh: 2022-07-06T07:05:43Z.

Catatan: Parameter ini tidak akan berpengaruh jika status "On Hold" ditetapkan.

Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom yang perlu diperbarui.

Catatan: Anda harus memberikan nama API kunci.

Dijalankan pada

Tindakan ini tidak berjalan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil 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
}
Repositori Kasus
Jenis hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 200 dilaporkan (is_success = true): "Successfully updated ticket with ID {ticket id} in Zoho Desk.".

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error executing action "Update Ticket". Reason: {0}''.format(error.Stacktrace)

Jika agen tidak ditemukan: "Error executing action "Update Ticket". Alasan: agen {agent_name} tidak ditemukan di Zoho Desk. Periksa ejaannya."'

Jika tim tidak ditemukan: "Error executing action "Update Ticket". Alasan: tim {team_name} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Jika departemen tidak ditemukan: "Error executing action "Update Ticket". Alasan: departemen {department} tidak ditemukan di Zoho Desk. Periksa ejaannya."'

Jika kontak tidak ditemukan: "Error executing action "Update Ticket". Alasan: kontak {contact} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Jika produk tidak ditemukan: "Error executing action "Update Ticket". Alasan: produk {product} tidak ditemukan di Zoho Desk. Periksa ejaannya."

Jika "Agent" atau "Team" dipilih, tetapi parameter "Assignee Name" tidak diberikan: "Error executing action "Update Ticket". Alasan: "Nama Penerima Tugas" harus diberikan."

Umum

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.