Zendesk

Versi integrasi: 8.0

Mengonfigurasi Zendesk agar dapat berfungsi dengan Google Security Operations

Administrator membuat token API, dan untuk melakukannya, ikuti langkah-langkah berikut:

Buka sidebar antarmuka Zendesk Anda dan klik ikon Admin, lalu pilih Channels > API.

  1. Klik tab Setelan, lalu aktifkan Akses Token.
  2. Klik tombol + di sebelah kanan Active API Tokens.
  3. Secara opsional, masukkan deskripsi di bagian Deskripsi Token API.
  4. Salin token untuk digunakan nanti dan tempelkan di tempat yang aman. Token lengkap tidak akan ditampilkan lagi setelah jendela ditutup.
  5. Klik Simpan untuk kembali ke halaman API.

Mengonfigurasi integrasi Zendesk di Google SecOps

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

Tindakan

Menambahkan Komentar ke Tiket

Deskripsi

Menambahkan komentar ke tiket yang ada.

Parameter

Parameter Jenis Nilai Default Deskripsi
ID tiket String T/A Nomor tiket.
Isi Komentar String T/A T/A
Nama Penulis String T/A T/A
Internal Note Boolean T/A T/A

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_success Benar/Salah is_success:False
Hasil JSON
N/A

Menerapkan Makro pada Tiket

Deskripsi

Menerapkan makro ke tiket.

Parameter

Parameter Jenis Nilai Default Deskripsi
ID tiket String T/A Nomor tiket.
Judul Makro String T/A T/A

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_applied Benar/Salah is_applied:False
Hasil JSON
N/A

Buat Tiket

Deskripsi

Buat tiket dengan properti tertentu.

Batasan Umum

Email dengan karakter Unicode tidak didukung oleh Zendesk API. Parameter ini memengaruhi "Email CC". Tindakan hanya akan mengabaikannya

Parameter

Parameter Jenis Nilai Default Deskripsi
Subjek String T/A T/A
Deskripsi String T/A T/A
Pengguna yang Ditetapkan String T/A Nama lengkap pengguna.
Grup Penugasan String T/A Nama grup.
Prioritas String T/A Prioritas akan menjadi salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Jenis Tiket String T/A Prioritas akan menjadi salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Tag String T/A T/A
Internal Note Kotak centang Tidak dicentang Tentukan apakah komentar harus bersifat publik atau internal. Jika tidak dicentang, berarti akan bersifat publik, jika dicentang, berarti hanya bersifat internal
CC Email CSV T/A Tentukan daftar alamat email yang dipisahkan koma, yang juga akan menerima notifikasi pembuatan tiket. Catatan: maksimum 48 penerima CC email dapat ditambahkan. Ini adalah batasan Zendesk.
Memvalidasi CC Email Boolean Dicentang Jika diaktifkan, tindakan akan mencoba memeriksa apakah pengguna dengan email yang diberikan dalam parameter "Email CC" ada. Jika setidaknya satu pengguna tidak ada, tindakan akan gagal. Jika parameter ini dinonaktifkan, tindakan tidak akan melakukan pemeriksaan ini.

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ticket_id T/A T/A
Hasil JSON
N/A
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Jika "Validasi Penerima CC Email" diaktifkan dan setidaknya satu email tidak ditemukan (gagal): Error saat menjalankan tindakan "{nama tindakan}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email".

jika setidaknya satu input bukan alamat email yang valid: Error saat menjalankan tindakan "{action name}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email".

 Umum

Mendapatkan Detail Tiket

Deskripsi

Dapatkan detail tiket, komentar, dan lampiran berdasarkan ID tiket.

Parameter

Parameter Jenis Nilai Default Deskripsi
ID tiket String T/A ID tiket.

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
ticket_details T/A T/A
Hasil JSON
{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Ping

Deskripsi

Uji Konektivitas.

Parameter

T/A

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_connected Benar/Salah is_connected:False
Hasil JSON
N/A

Cari Tiket

Deskripsi

Menelusuri tiket berdasarkan kata kunci.

Parameter

Parameter Jenis Nilai Default Deskripsi
Kueri Penelusuran String T/A Kueri konten (contoh: type:ticket status:pending).

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
results_count T/A T/A
Hasil JSON
N/A

Perbarui Tiket

Deskripsi

Memperbarui detail tiket yang ada

Parameter

Parameter Jenis Nilai Default Deskripsi
ID tiket String T/A Nomor tiket.
Subjek String T/A Subjek tiket.
Pengguna yang Ditetapkan String T/A Nama lengkap pengguna.
Grup Penugasan String T/A Nama grup.
Prioritas String T/A Prioritas akan menjadi salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Jenis Tiket String T/A Jenis tiket akan menjadi salah satu dari berikut ini: masalah, insiden, pertanyaan, atau tugas.
Tag String T/A Tag yang akan ditambahkan ke tiket.
Status String T/A Statusnya akan menjadi salah satu dari berikut ini: baru, terbuka, menunggu keputusan, ditahan, terselesaikan, atau ditutup.
Komentar Tambahan String T/A Jika Anda ingin menambahkan komentar ke tiket, tentukan teks yang ingin Anda tambahkan sebagai komentar di sini.
Internal Note Kotak centang Tidak dicentang Tentukan apakah komentar harus bersifat publik atau internal. Jika tidak dicentang, berarti akan bersifat publik, jika dicentang, berarti hanya bersifat internal

Kasus penggunaan

T/A

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip
Nama Hasil Skrip Opsi Nilai Contoh
is_updated Benar/Salah is_updated:False
Hasil JSON
N/A

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