Freshworks Freshservice

Versi integrasi: 14.0

Kasus Penggunaan

Integrasi dengan meja bantuan.

Konfigurasi Freshservice

Integrasi Freshservice Google Security Operations berfungsi berdasarkan Kunci API Freshservice.

Cara mendapatkan Kunci API akun di Freshservice

  1. Login ke Portal Dukungan Freshservice Anda
  2. Klik foto profil akun di sudut kanan atas portal Anda
  3. Buka Halaman setelan Profil
  4. Kunci API akun akan tersedia di bawah bagian ubah sandi di sebelah kanan Anda
  5. Simpan kunci API ini, Anda akan memerlukannya untuk konfigurasi integrasi Google SecOps.

Mengonfigurasi integrasi Freshworks Freshservice di Google SecOps

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://yourdomain.freshservice.com Ya URL Root API instance Freshservice.
Kunci API Sandi T/A Ya Kunci API Freshservice yang akan digunakan dalam integrasi.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, integrasi akan memverifikasi bahwa URL Root dikonfigurasi dengan sertifikat yang valid.

Tindakan

Ping

Deskripsi

Uji konektivitas ke instance Freshservice dengan parameter yang diberikan di halaman konfigurasi integrasi pada tab Google Security Operations Marketplace.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Repositori Kasus
Jenis Hasil Nilai / Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • jika berhasil: "Berhasil terhubung ke instance Freshservice dengan parameter koneksi yang diberikan!"

Tindakan akan gagal dan menghentikan eksekusi playbook:jika terjadi error penting, seperti kredensial yang salah atau koneksi terputus: "Failed to connect to the Freshservice instance! Error adalah {0}".format(exception.stacktrace)

 Umum

Daftar Tiket

Deskripsi

Mencantumkan tiket Freshservice berdasarkan kriteria penelusuran yang ditentukan. Perhatikan bahwa tindakan tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Jenis Tiket DDL Semua Tidak Tentukan jenis tiket yang akan ditampilkan.
Pemohon String T/A Tidak Tentukan email pemohon tiket yang akan ditampilkan.
Sertakan Statistik Kotak centang Tidak dicentang Tidak Jika diaktifkan, tindakan akan menampilkan statistik tambahan pada tiket.
Menelusuri X Jam Terakhir Bilangan bulat T/A Tidak Tentukan jangka waktu untuk menelusuri tiket.
Baris per Halaman Bilangan bulat 30 Tidak Tentukan jumlah tiket yang harus ditampilkan per halaman untuk penomoran halaman Freshservice.
Mulai di Halaman Bilangan bulat 1 Tidak Tentukan mulai dari halaman mana tiket harus ditampilkan dengan penomoran halaman Freshservice.
Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 30 Tidak Tentukan jumlah total tiket yang harus ditampilkan tindakan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "tickets": [
        {
            "subject": "Support Needed...",
            "group_id": null,
            "department_id": null,
            "category": null,
            "sub_category": null,
            "item_category": null,
            "requester_id": 17000032840,
            "responder_id": null,
            "due_by": "2021-07-08T21:00:00Z",
            "fr_escalated": false,
            "deleted": false,
            "spam": false,
            "email_config_id": null,
            "fwd_emails": [],
            "reply_cc_emails": [],
            "cc_emails": [],
            "is_escalated": false,
            "fr_due_by": "2021-07-01T18:00:00Z",
            "id": 7,
            "priority": 1,
            "status": 2,
            "source": 2,
            "created_at": "2021-06-29T08:56:24Z",
            "updated_at": "2021-06-29T10:04:51Z",
            "to_emails": null,
            "type": "Incident",
            "description": "<div>Details about the issue...</div>",
            "description_text": "Details about the issue...",
            "custom_fields": {},
            "requester": {
                "email": "dana@example.com",
                "id": 17000032840,
                "mobile": "dana@example.com",
                "name": "Dana",
                "phone": null
            }
        }
    ]
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tiket ditemukan (is_success = true): "Successfully fetched Freshservice tickets."
  • Jika tidak ada tiket yang ditampilkan (is_success = false): "No tickets were found for the provided input parameters." (Tidak ada tiket yang ditemukan untuk parameter input yang diberikan.)
  • Jika mendapatkan error API saat mendapatkan tiket (is_success = false): "Gagal mencantumkan tiket dengan parameter input yang diberikan. Errornya adalah: {error from the API}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau lainnya: "Error saat menjalankan tindakan "List Tickets". Alasan: {0}''.format(error.Stacktrace)

 Umum
Tabel

Nama Tabel: Tiket Freshservice yang Ditemukan

Kolom Tabel:

ID

Jenis

Subjek

Deskripsi

Email Pemohon

Kategori

Status

Prioritas

Sumber

Tanggal Dibuat

Tanggal Diperbarui

Batas Waktu

Dieskalasi

Dihapus

 Umum

Buat Tiket

Deskripsi

Buat tiket Freshservice.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Subjek String T/A Ya Tentukan kolom subjek untuk tiket yang dibuat.
Deskripsi String T/A Ya Tentukan kolom deskripsi untuk tiket yang dibuat.
Email Pemohon String T/A Ya Tentukan email pemohon untuk tiket yang dibuat.
Agen yang Ditugaskan String T/A Tidak Tentukan email agen yang akan diberi tugas tiket.
Tetapkan Grup Ke String T/A Tidak Tentukan nama grup untuk menetapkan tiket.
Prioritas DDL Sedang Ya Tentukan prioritas yang akan ditetapkan ke tiket.
Urgensi DDL Sedang Tidak Tentukan urgensi yang akan ditetapkan ke tiket.
Dampak DDL Sedang Tidak Tentukan dampak yang akan ditetapkan ke tiket.
Tag String T/A Tidak Tentukan tag yang akan ditetapkan ke tiket. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke tiket. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}
Lampiran File yang Akan Ditambahkan String (CSV) T/A Tidak Tentukan jalur lengkap untuk file yang akan diupload dengan tiket. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Ukuran total lampiran tidak boleh melebihi 15 MB.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "fr_escalated": false,
        "spam": false,
        "email_config_id": null,
        "group_id": null,
        "priority": 2,
        "requester_id": 17000032840,
        "responder_id": null,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 4...",
        "to_emails": null,
        "department_id": null,
        "id": 10,
        "type": "Incident",
        "due_by": "2021-07-02T18:00:00Z",
        "fr_due_by": "2021-06-30T20:00:00Z",
        "is_escalated": false,
        "description": "<div>Details about the issue...</div>",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "created_at": "2021-06-30T08:01:30Z",
        "updated_at": "2021-06-30T08:01:30Z",
        "tags": [
            "test"
        ],
        "attachments": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true): Tiket freshservice baru dibuat.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false): Gagal membuat tiket baru dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error saat menjalankan tindakan "Buat Tiket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Perbarui Tiket

Deskripsi

Memperbarui tiket Freshservice berdasarkan parameter input tindakan yang diberikan. Perhatikan bahwa jika tag baru untuk tiket diberikan, karena batasan API Freshservice, tindakan ini akan menggantikan tag yang ada di tiket, bukan menambahkan tag baru ke tag yang ada.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket yang akan diperbarui.
Status DDL Tidak berubah Tidak Tentukan status baru untuk tiket.
Subjek String T/A Tidak Tentukan kolom subjek yang akan diperbarui.
Deskripsi String T/A Tidak Tentukan kolom deskripsi yang akan diperbarui.
Email Pemohon String T/A Tidak Tentukan email pemohon yang akan diperbarui.
Agen yang Ditugaskan String T/A Tidak Tentukan email agen yang akan diperbarui.
Tetapkan Grup Ke String T/A Tidak Tentukan nama grup yang akan diupdate.
Prioritas DDL Tidak Berubah Tidak Tentukan prioritas yang akan diperbarui.
Urgensi DDL Tidak Berubah Tidak Tentukan urgensi untuk memperbarui.
Dampak DDL Tidak Berubah Tidak Tentukan dampak untuk diperbarui.
Tag String T/A Tidak Tentukan tag yang akan diganti dalam tiket. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Perhatikan bahwa karena batasan API Freshservice, tindakan menggantikan tag yang ada dalam tiket, bukan menambahkan tag baru ke tag yang ada.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke tiket. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}
Lampiran File yang Akan Ditambahkan String (CSV) T/A Tidak Tentukan jalur lengkap untuk file yang akan diupload dengan tiket. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Ukuran total lampiran tidak boleh melebihi 15 MB.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "ticket": {
        "cc_emails": [],
        "fwd_emails": [],
        "reply_cc_emails": [],
        "spam": false,
        "email_config_id": null,
        "fr_escalated": false,
        "group_id": 17000034192,
        "priority": 1,
        "requester_id": 17002188556,
        "responder_id": 17002188556,
        "source": 2,
        "status": 2,
        "subject": "Support Needed 9...",
        "description": "Details about the issue...",
        "description_text": "Details about the issue...",
        "category": null,
        "sub_category": null,
        "item_category": null,
        "custom_fields": {
            "test": "very_test"
        },
        "id": 12,
        "type": "Incident",
        "to_emails": null,
        "department_id": 17000016543,
        "is_escalated": false,
        "tags": [
            "test"
        ],
        "due_by": "2021-07-09T17:00:00-04:00",
        "fr_due_by": "2021-07-02T14:00:00-04:00",
        "created_at": "2021-06-30T08:36:43Z",
        "updated_at": "2021-06-30T09:39:12Z",
        "attachments": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Tiket Freshservice <ticket id> diperbarui.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false)

    • Gagal memperbarui tiket <ticket_id> dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Update Ticket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mencantumkan Percakapan Tiket

Deskripsi

Mencantumkan percakapan tiket Freshservice berdasarkan kriteria penelusuran yang ditentukan. Perhatikan bahwa tindakan ini tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menampilkan percakapan.
Baris per Halaman Bilangan bulat 30 Tidak Tentukan berapa banyak percakapan tiket yang harus ditampilkan per halaman untuk penomoran halaman Freshservice.
Mulai di Halaman Bilangan bulat 1 Tidak Tentukan mulai dari halaman mana percakapan tiket harus ditampilkan dengan penomoran halaman Freshservice.
Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 30 Tidak Tentukan jumlah total tindakan percakapan tiket yang harus ditampilkan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "conversations": [
        {
            "id": 17014994010,
            "user_id": 17000032840,
            "to_emails": [],
            "body": "<div>This is a test note!</div>",
            "body_text": "This is a test note!",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:58:32Z",
            "updated_at": "2021-07-05T06:58:32Z",
            "incoming": false,
            "private": false,
            "support_email": null,
            "source": 2,
            "from_email": null,
            "cc_emails": [],
            "bcc_emails": null,
            "attachments": []
        },
        {
            "id": 17014993985,
            "user_id": 17000032840,
            "to_emails": [
                "dana@example.com"
            ],
            "body": "<div>We are working on this issue. Will keep you posted.</div>",
            "body_text": "We are working on this issue. Will keep you posted.",
            "ticket_id": 12,
            "created_at": "2021-07-05T06:57:27Z",
            "updated_at": "2021-07-05T06:57:27Z",
            "incoming": false,
            "private": false,
            "support_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "source": 0,
            "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
            "cc_emails": [],
            "bcc_emails": [],
            "attachments": []
        }
    ],
    "meta": {
        "count": 2
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika percakapan tiket ditemukan (is_success = true):
    "Berhasil mengambil percakapan tiket Freshservice <ticket id>."
  • Jika tidak ada percakapan tiket yang ditampilkan (is_success = false):
    "Tidak ada percakapan tiket yang ditemukan untuk tiket <ticket id>"
  • Jika ID tiket yang diberikan tidak ditemukan (is_success = false):
    "Tiket <ticket id> tidak ditemukan di Freshservice.
  • Jika mendapatkan error API saat mendapatkan tiket (is_success = false): "Failed to list ticket conversations with the provided input parameters. Errornya adalah: {error from the API}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

"Error saat menjalankan tindakan "List Ticket Conversations". Alasan: {0}''.format(error.Stacktrace)

 Umum
Tabel

Nama Tabel: Percakapan Tiket Freshservice <ticket id>

Kolom Tabel:

ID

Jenis

Visibilitas

Email Pengguna

Teks

Dari Email

Ke Email

CC Email

Email BCC

 Umum

Menambahkan Balasan Tiket

Deskripsi

Menambahkan balasan ke tiket Freshservice. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menampilkan percakapan.
Teks Balasan String T/A Ya Tentukan teks balasan yang akan ditambahkan ke tiket.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
    "conversation": {
        "id": 17014998560,
        "user_id": 17000032840,
        "from_email": "helpdesk@siemplifyservicedesk.freshservice.com",
        "cc_emails": [],
        "bcc_emails": [],
        "body": "<div>We are working on this issue. Will keep you posted.2</div>",
        "body_text": "We are working on this issue. Will keep you posted.2",
        "ticket_id": 12,
        "to_emails": [
            "dana@example.com"
        ],
        "attachments": [],
        "created_at": "2021-07-05T09:19:02Z",
        "updated_at": "2021-07-05T09:19:02Z"
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Balasan baru ditambahkan ke tiket <ticket id>.

  • Jika ID tiket yang diberikan tidak ditemukan (is_success = false):

    • "Tiket <ticket id> tidak ditemukan di Freshservice.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Tambahkan Balasan Tiket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menambahkan Catatan Tiket

Deskripsi

Menambahkan catatan ke tiket Freshservice. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menampilkan percakapan.
Jenis Catatan DDL Pribadi Tidak Tentukan jenis tindakan catatan yang harus ditambahkan ke tiket.
Teks Catatan String T/A Ya Tentukan teks catatan yang akan ditambahkan ke tiket.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "conversation": {
        "id": 17014999107,
        "incoming": false,
        "private": false,
        "user_id": 17000032840,
        "support_email": null,
        "body": "<div>This is a test note2!</div>",
        "body_text": "This is a test note2!",
        "ticket_id": 12,
        "to_emails": [],
        "attachments": [],
        "created_at": "2021-07-05T09:35:28Z",
        "updated_at": "2021-07-05T09:35:28Z"
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Catatan <note type> baru ditambahkan ke tiket <ticket id>.

  • Jika ID tiket yang diberikan tidak ditemukan (is_success = false):

    • "Tiket <ticket id> tidak ditemukan di Freshservice.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Tambahkan Catatan Tiket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mencantumkan Agen

Deskripsi

Mencantumkan agen Freshservice berdasarkan kriteria penelusuran yang ditentukan. Perhatikan bahwa tindakan tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Email Agen String T/A Tidak Tentukan alamat email untuk menampilkan catatan agen.
Status Agen DDL SEMUA Tidak Tentukan status agen yang akan ditampilkan.
Sertakan Agen yang tidak Aktif Kotak centang Tidak dicentang Tidak Jika diaktifkan, hasil akan menyertakan catatan agen yang tidak aktif.
Baris per Halaman Bilangan bulat 30 Tidak Tentukan jumlah data agen yang harus ditampilkan per halaman untuk penomoran halaman Freshservice.
Mulai di Halaman Bilangan bulat 1 Tidak Tentukan mulai dari halaman mana rekaman agen harus ditampilkan dengan penomoran halaman Freshservice.
Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 30 Tidak Tentukan jumlah total rekaman agen yang harus ditampilkan oleh tindakan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "agents": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2021-06-29T10:37:36Z",
            "custom_fields": {},
            "department_ids": [
                17000016543
            ],
            "email": "dana@example.com",
            "external_id": null,
            "first_name": "dmitry",
            "has_logged_in": false,
            "id": 17002188556,
            "job_title": null,
            "language": "en",
            "last_active_at": null,
            "last_login_at": null,
            "last_name": "s",
            "location_id": null,
            "mobile_phone_number": null,
            "occasional": true,
            "reporting_manager_id": null,
            "role_ids": [
                17000023339
            ],
            "roles": [
                {
                    "role_id": 17000023339,
                    "assignment_scope": "entire_helpdesk",
                    "groups": []
                }
            ],
            "scopes": {
                "ticket": null,
                "problem": null,
                "change": null,
                "asset": null,
                "solution": null,
                "contract": null
            },
            "scoreboard_level_id": 1,
            "signature": "<p> </p>\n",
            "time_format": "12h",
            "time_zone": "American Samoa",
            "updated_at": "2021-06-29T10:37:36Z",
            "work_phone_number": null,
            "group_ids": [
                17000034192
            ],
            "member_of": [
                17000034192
            ],
            "observer_of": []
        },
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika agen ditemukan (is_success = true): "Berhasil mengambil agen Freshservice."
  • Jika tidak ada agen yang ditampilkan (is_success = false): "Tidak ada agen yang ditemukan untuk parameter input yang diberikan."
  • Jika mendapatkan error API saat mengambil agen (is_success = false): "Failed to list agents with the provided input parameters. Errornya adalah: {error from the API}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

"Error saat menjalankan tindakan "List Agents". Alasan: {0}''.format(error.Stacktrace)

 Umum

Tabel

Nama Tabel: Agen Freshservice yang Ditemukan

Kolom Tabel:

ID

Email

Nama Depan

Nama Belakang

Peran

Grup

Departemen

Lokasi

Aktif

Sesekali

Kolom Kustom

Tanggal Dibuat

Tanggal Diperbarui

Tanggal Terakhir Aktif

Tanggal Login Terakhir

 Umum

Mencantumkan Pemohon

Deskripsi

Mencantumkan pemohon yang terdaftar di Freshservice berdasarkan kriteria penelusuran yang ditentukan. Perhatikan bahwa tindakan ini tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Email Pemohon String T/A Tidak Tentukan alamat email untuk menampilkan catatan pemohon.
Baris per Halaman Bilangan bulat 30 Tidak Tentukan jumlah data agen yang harus ditampilkan per halaman untuk penomoran halaman Freshservice.
Mulai di Halaman Bilangan bulat 1 Tidak Tentukan mulai dari halaman mana rekaman agen harus ditampilkan dengan penomoran halaman Freshservice.
Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 30 Tidak Tentukan jumlah total rekaman agen yang harus ditampilkan oleh tindakan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "requesters": [
        {
            "active": true,
            "address": null,
            "background_information": null,
            "can_see_all_tickets_from_associated_departments": false,
            "created_at": "2020-07-06T08:07:30Z",
            "custom_fields": {
                "test": null
            },
            "department_ids": [],
            "external_id": null,
            "first_name": "Dana",
            "has_logged_in": false,
            "id": 17000038164,
            "job_title": null,
            "language": "en",
            "last_name": "Doe",
            "location_id": null,
            "mobile_phone_number": null,
            "primary_email": "dana@example.com",
            "reporting_manager_id": null,
            "secondary_emails": [],
            "time_format": "12h",
            "time_zone": "Eastern Time (US & Canada)",
            "updated_at": "2020-07-06T08:07:30Z",
            "work_phone_number": null
        }
    ]
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika ditemukan pemohon (is_success = true):
    "Berhasil mengambil pemohon terdaftar Freshservice."
  • Jika tidak ada pemohon yang ditampilkan (is_success = false):
    "Tidak ada pemohon yang ditemukan untuk parameter input yang diberikan."
  • Jika mendapatkan error API saat mengambil pemohon (is_success = false): "Gagal mencantumkan pemohon dengan parameter input yang diberikan. Errornya adalah: {error from the API}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

"Error saat menjalankan tindakan "List Requesters". Alasan: {0}''.format(error.Stacktrace)

 Umum

Tabel

Nama Tabel: Freshservice Requester Found

Kolom Tabel:

ID

Email

Nama Depan

Nama Belakang

Departemen

Lokasi

Aktif

Kolom Kustom

Tanggal Dibuat

Tanggal Diperbarui

 Umum

Membuat Agen

Deskripsi

Buat Agen Freshservice baru. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Email String T/A Ya Tentukan email agen yang akan dibuat.
Nama Depan String T/A Ya Tentukan nama depan agen yang akan dibuat.
Nama Belakang String T/A Tidak Tentukan nama belakang agen yang akan dibuat.
Sesekali Kotak centang Tidak dicentang Tidak Jika diaktifkan, agen akan dibuat sebagai agen sesekali, jika tidak, agen purnawaktu akan dibuat.
Dapat Melihat Semua Tiket dari Departemen Terkait Kotak centang Tidak dicentang Tidak

Jika diaktifkan, agen akan dapat melihat semua tiket dari Departemen terkait.
Departemen CSV T/A Tidak Tentukan nama departemen yang terkait dengan agen. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Lokasi String T/A Tidak Tentukan nama lokasi yang terkait dengan agen.
Keanggotaan Grup CSV T/A Tidak Tentukan nama grup yang harus diikuti oleh agen.
Peran CSV T/A Ya

Tentukan peran yang akan ditambahkan ke agen. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Contoh: {"role_id":17000023338,"assignment_scope": ""}
Jabatan String T/A Tidak Tentukan jabatan agen.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke agen. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Agen Freshservice baru telah dibuat.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false)

    • Gagal membuat agen baru dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Buat Agen". Alasan: {0}''.format(error.Stacktrace)

 Umum

Memperbarui Agen

Deskripsi

Memperbarui Agen Freshservice yang ada. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID Agen Bilangan bulat T/A Ya Tentukan ID agen yang akan diperbarui.
Email String T/A Tidak Tentukan email agen yang akan diperbarui.
Nama Depan String T/A Tidak Tentukan nama depan agen yang akan diperbarui.
Nama Belakang String T/A Tidak Tentukan nama belakang agen yang akan diperbarui.
Sesekali Kotak centang Tidak dicentang Tidak Jika diaktifkan, agen akan diperbarui sebagai agen paruh waktu, jika tidak, agen akan menjadi agen purnawaktu.
Dapat Melihat Semua Tiket dari Departemen Terkait Kotak centang Tidak dicentang Tidak

Jika diaktifkan, agen akan dapat melihat semua tiket dari Departemen terkait.
Departemen CSV T/A Tidak Tentukan nama departemen yang terkait dengan agen. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Lokasi String T/A Tidak Tentukan nama lokasi yang terkait dengan agen.
Keanggotaan Grup CSV T/A Tidak Tentukan nama grup yang harus diikuti oleh agen.
Peran CSV T/A Tidak

Tentukan peran yang akan ditambahkan ke agen. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.

Contoh: {"role_id":17000023338,"assignment_scope": "entire_helpdesk"}
Jabatan String T/A Tidak Tentukan jabatan agen.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke agen. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Agen Freshservice <agent_id> diperbarui.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false)

    • Gagal memperbarui agen freshservice <agent_id> dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Update Agent". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menonaktifkan Agen

Deskripsi

Nonaktifkan agen Freshservice. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID Agen Bilangan bulat T/A Ya Tentukan ID agen yang akan dinonaktifkan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "agent": {
        "active": false,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue3"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 2,
        "signature": "<p> </p>\n",
        "time_format": "24h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T06:26:59Z",
        "work_phone_number": "443532",
        "group_ids": [],
        "member_of": [],
        "observer_of": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Agen Freshservice <agent_id> dinonaktifkan.

  • Jika tindakan gagal dijalankan karena error 404 (is_success =false)

    • Gagal menemukan agen freshservice <agent_id> untuk dinonaktifkan.

  • Jika tindakan gagal dijalankan karena error 403 (is_success =false)

    • Gagal menonaktifkan agen freshservice <agent_id>, mungkin sudah dinonaktifkan? Respons API: "code": "access_denied","message": "You are not authorized to perform this action".

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Deactivate Agent". Alasan: {0}''.format(error.Stacktrace)

 Umum

Buat Peminta

Deskripsi

Buat pemohon Freshservice baru. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Email String T/A Ya Tentukan email pemohon yang akan dibuat.
Nama Depan String T/A Ya Tentukan nama depan pembuat permintaan yang akan dibuat.
Nama Belakang String T/A Tidak Tentukan nama belakang pembuat yang akan dibuat.
Dapat Melihat Semua Tiket dari Departemen Terkait Kotak centang Tidak dicentang Tidak

Jika diaktifkan, pemohon akan dapat melihat semua tiket dari Departemen terkait.
Departemen CSV T/A Tidak Tentukan nama departemen yang terkait dengan pemohon . Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Lokasi String T/A Tidak Tentukan nama lokasi yang terkait dengan pemohon .
Jabatan String T/A Tidak Tentukan jabatan pemohon.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke pemohon. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "requester": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T08:12:47Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198308,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": null,
        "primary_email": "rolanda.hooch2@hogwarts.edu",
        "reporting_manager_id": null,
        "secondary_emails": [],
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T08:12:47Z",
        "work_phone_number": null
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Pemohon freshservice baru dibuat.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false)

    • Gagal membuat pemohon baru dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

if fatal error, SDK error, like wrong credentials, no connection to server, other: "Error executing action "Create Requester". Alasan: {0}''.format(error.Stacktrace)

 Umum

Memperbarui Pemohon

Deskripsi

Memperbarui Pemohon Freshservice yang sudah ada. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID pemohon Bilangan bulat T/A Ya Tentukan ID pemohon yang akan diperbarui.
Email String T/A Tidak Tentukan email pemohon yang akan diperbarui.
Nama Depan String T/A Tidak Tentukan nama depan pemohon yang akan diupdate.
Nama Belakang String T/A Tidak Tentukan nama belakang pemohon yang akan diperbarui.
Dapat Melihat Semua Tiket dari Departemen Terkait Kotak centang Tidak dicentang Tidak

Jika diaktifkan, pemohon akan dapat melihat semua tiket dari Departemen terkait.
Departemen CSV T/A Tidak Tentukan nama departemen yang terkait dengan pemohon. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Lokasi String T/A Tidak Tentukan nama lokasi yang terkait dengan pemohon.
Jabatan String T/A Tidak Tentukan jabatan pemohon.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke pemohon. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "agent": {
        "active": true,
        "address": null,
        "background_information": null,
        "can_see_all_tickets_from_associated_departments": false,
        "created_at": "2021-07-06T05:40:41Z",
        "custom_fields": {
            "test": "testvalue"
        },
        "department_ids": [],
        "email": "rolanda.hooch@hogwarts.edu",
        "external_id": null,
        "first_name": "Rolanda",
        "has_logged_in": false,
        "id": 17002198254,
        "job_title": "Flying Instructor",
        "language": "en",
        "last_active_at": null,
        "last_login_at": null,
        "last_name": "Hooch",
        "location_id": null,
        "mobile_phone_number": "553632",
        "occasional": true,
        "reporting_manager_id": null,
        "role_ids": [
            17000023338
        ],
        "roles": [
            {
                "role_id": 17000023338,
                "assignment_scope": "entire_helpdesk",
                "groups": []
            }
        ],
        "scopes": {
            "ticket": null,
            "problem": null,
            "change": null,
            "asset": null,
            "solution": null,
            "contract": null
        },
        "scoreboard_level_id": 1,
        "signature": null,
        "time_format": "12h",
        "time_zone": "Eastern Time (US & Canada)",
        "updated_at": "2021-07-06T05:40:41Z",
        "work_phone_number": "443532",
        "group_ids": [
            17000034192
        ],
        "member_of": [
            17000034192
        ],
        "observer_of": []
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Pemohon Freshservice <requester_id> diperbarui.

  • Jika tindakan gagal dijalankan karena parameter yang diberikan(is_success =false)

    • Gagal memperbarui pemohon freshservice <requester_id> dengan parameter yang diberikan, errornya adalah: <error text>.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Perbarui Peminta". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menonaktifkan Peminta

Deskripsi

Nonaktifkan pemohon Freshservice. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID pemohon Bilangan bulat T/A Ya Tentukan ID pemohon yang akan dinonaktifkan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Pemohon Freshservice <requester_id> dinonaktifkan.

  • Jika tindakan gagal dijalankan karena error 404 (is_success =false)

    • Gagal menemukan pemohon freshservice <requester_id> untuk dinonaktifkan.

  • Jika tindakan gagal dijalankan karena error 405 (is_success =false)

    • Gagal menonaktifkan pemohon freshservice <requester_id>, mungkin sudah dinonaktifkan? Respons API: "message": "DELETE method is not allowed". Harus berupa salah satu metode berikut: GET"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Nonaktifkan Peminta". Alasan: {0}''.format(error.Stacktrace)

 Umum

Mencantumkan Entri Waktu Tiket

Deskripsi

Mencantumkan entri waktu tiket Freshservice berdasarkan kriteria penelusuran yang ditentukan. Perhatikan bahwa tindakan ini tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menampilkan entri waktu.
Email Agen String T/A Ya Tentukan email agen untuk mencantumkan entri waktu tiket.
Baris per Halaman Bilangan bulat 30 Tidak Tentukan berapa banyak entri waktu tiket yang harus ditampilkan per halaman untuk penomoran halaman Freshservice.
Mulai di Halaman Bilangan bulat 1 Tidak Tentukan mulai dari entri waktu tiket halaman mana yang harus ditampilkan dengan penomoran halaman Freshservice.
Jumlah Baris Maksimum yang Akan Ditampilkan Bilangan bulat 30 Tidak Tentukan jumlah total entri waktu tiket yang harus ditampilkan oleh tindakan.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
   "time_entries": [
       {
           "id": 17000399635,
           "created_at": "2021-07-08T06:26:47Z",
           "updated_at": "2021-07-08T06:26:47Z",
           "start_time": "2021-07-08T06:26:47Z",
           "timer_running": false,
           "billable": true,
           "time_spent": "01:00",
           "executed_at": "2021-07-08T06:26:47Z",
           "task_id": null,
           "note": "test_entry2",
           "agent_id": 17002188556,
           "custom_fields": {}
       }
   ]
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika entri waktu tiket ditemukan (is_success = true):
    "Successfully fetched Freshservice ticket <ticket id> time entries." (Entri waktu tiket Freshservice <ticket id> berhasil diambil.)
  • Jika tidak ada entri waktu tiket yang ditampilkan (is_success = false):
    "Tidak ada entri waktu tiket yang ditemukan untuk tiket <ticket id>"
  • Jika ID tiket yang diberikan tidak ditemukan (is_success = false):
    "Tiket <ticket id> tidak ditemukan di Freshservice.
  • Jika tidak ada ID agen yang ditemukan untuk email agen yang diberikan (is_success = false):
    "Agen <agent_email> tidak ditemukan di Freshservice.
  • Jika mendapatkan error API saat mengambil entri waktu tiket (is_success = false): "Gagal mencantumkan entri waktu tiket dengan parameter input yang diberikan. Errornya adalah: {error from the API}"

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, lainnya:

"Error saat menjalankan tindakan "List Ticket Time Entries". Alasan: {0}''.format(error.Stacktrace)

 Umum
Tabel

Nama Tabel: Entri Waktu Tiket Freshservice <ticket id>

Kolom Tabel:

ID Entri Waktu

Email Agen

Catatan

Dapat Ditagih

Waktu yang Dihabiskan

ID Tugas

Kolom Kustom

Timer Berjalan

Waktu Dibuat

Waktu Diperbarui

Waktu Mulai

Waktu Eksekusi

 Umum

Menambahkan Entri Waktu Tiket

Deskripsi

Menambahkan entri waktu ke tiket Freshservice. Perhatikan bahwa tindakan tidak berfungsi di entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menambahkan entri waktu.
Email Agen String T/A Ya Tentukan email agen yang akan ditambahkan entri waktu tiketnya.
Catatan String T/A Tidak Tentukan catatan yang akan ditambahkan ke entri waktu tiket.
Waktu yang Dihabiskan String T/A Ya Menentukan waktu yang dihabiskan untuk entri waktu tiket. Format: {hh:mm}
Dapat Ditagih Kotak centang Salah Tidak Jika diaktifkan, entri waktu tiket akan ditandai sebagai dapat ditagih.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke entri waktu tiket. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
   "time_entry": {
       "id": 17000405061,
       "created_at": "2021-07-10T18:22:18Z",
       "updated_at": "2021-07-10T18:22:18Z",
       "start_time": "2021-07-10T18:22:18Z",
       "timer_running": false,
       "billable": true,
       "time_spent": "01:00",
       "executed_at": "2021-07-10T18:22:18Z",
       "task_id": null,
       "note": "test_entry3",
       "agent_id": 17002188556,
       "custom_fields": {
           "test": "very_test"
       }
   }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Entri waktu baru ditambahkan ke tiket <ticket id>.

  • Jika ID tiket yang diberikan tidak ditemukan (is_success = false):

    • "Tiket <ticket id> tidak ditemukan di Freshservice.

  • Jika email agen yang diberikan tidak ditemukan (is_success = false):

    • "Agent with email <agent_email> was not found in Freshservice.

  • Jika waktu yang dihabiskan memiliki format yang salah (is_success = false):

    • "Nilai waktu yang dihabiskan <time_spent> yang ditentukan dalam format yang salah, seharusnya dalam format 'hh:mm'.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Tambahkan Entri Waktu Tiket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Memperbarui Entri Waktu Tiket

Deskripsi

Memperbarui entri waktu untuk tiket Freshservice. Perhatikan bahwa tindakan tidak berfungsi pada entitas Google SecOps

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk memperbarui entri waktu.
ID Entri Waktu Bilangan bulat T/A Ya Tentukan ID entri waktu yang akan diperbarui.
Email Agen String T/A Tidak Tentukan email agen yang entri waktunya ingin diubah.
Catatan String T/A Tidak Tentukan catatan untuk entri waktu tiket.
Waktu yang Dihabiskan String T/A Tidak Menentukan waktu yang dihabiskan untuk entri waktu tiket. Format: {hh:mm}
Dapat Ditagih Kotak centang Salah (tidak dicentang) Tidak Jika diaktifkan, entri waktu tiket akan ditandai sebagai dapat ditagih.
Kolom Kustom JSON T/A Tidak

Tentukan objek JSON yang berisi kolom kustom untuk ditambahkan ke entri waktu tiket. ActOn menambahkan kolom kustom baru ke kolom yang sudah ada untuk tiket. Contoh format:

{"key1":"value1", "key2":"value2"}

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Hasil JSON
{
    "time_entry": {
        "id": 17000405061,
        "created_at": "2021-07-10T18:22:18Z",
        "updated_at": "2021-07-10T18:30:54Z",
        "start_time": "2021-07-10T18:22:18Z",
        "timer_running": false,
        "billable": false,
        "time_spent": "03:30",
        "executed_at": "2021-07-10T18:22:18Z",
        "task_id": null,
        "note": "test_entry_updated",
        "agent_id": 17002188556,
        "custom_fields": {
            "test": "very_test2"
        }
    }
}
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Entri waktu <time_entry_id> diperbarui untuk tiket <ticket id>.

  • Jika ID tiket atau ID entri waktu yang diberikan tidak ditemukan (is_success = false):

    • "ID tiket <ticket_id> atau ID entri waktu <time_entry id> yang diberikan tidak ditemukan di Freshservice.

  • Jika email agen yang diberikan tidak ditemukan (is_success = false):

    • "Agent with email <agent_email> was not found in Freshservice.

  • Jika waktu yang dihabiskan memiliki format yang salah (is_success = false):

    • "Nilai waktu yang dihabiskan <time_spent> yang ditentukan dalam format yang salah, seharusnya dalam format 'hh:mm'.

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Update Ticket Time Entry". Alasan: {0}''.format(error.Stacktrace)

 Umum

Menghapus Entri Waktu Tiket

Deskripsi

Menghapus entri waktu untuk tiket Freshservice. Perhatikan bahwa tindakan tidak berfungsi pada entitas Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
ID tiket Bilangan bulat T/A Ya Tentukan ID tiket untuk menghapus entri waktu.
ID Entri Waktu Bilangan bulat T/A Ya Tentukan ID entri waktu yang akan dihapus.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip
Nama Hasil Skrip Opsi Nilai
is_success is_success=False
is_success is_success=True
Repositori Kasus
Jenis hasil Nilai/Deskripsi Jenis
Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

  • Jika tindakan berhasil dijalankan:(is_success=true)

    • Entri waktu <time_entry_id> dihapus untuk tiket <ticket id>.

  • Jika ID tiket atau ID entri waktu yang diberikan tidak ditemukan (is_success = false):

    • "ID tiket <ticket_id> atau ID entri waktu <time_entry id> yang diberikan tidak ditemukan di Freshservice

Tindakan akan gagal dan menghentikan eksekusi playbook:

jika error fatal, error SDK, seperti kredensial salah, tidak ada koneksi ke server, lainnya: "Error saat menjalankan tindakan "Hapus Entri Waktu Tiket". Alasan: {0}''.format(error.Stacktrace)

 Umum

Konektor

Konektor Tiket Freshservice

Deskripsi

Konektor dapat digunakan untuk mengambil tiket Freshservice guna membuat pemberitahuan Google SecOps. Daftar izin konektor dapat digunakan untuk menyerap hanya jenis tiket tertentu - Insiden atau Permintaan Layanan.

Mengonfigurasi Freshservice Tickets Connector di Google SecOps

Untuk mendapatkan petunjuk mendetail tentang cara mengonfigurasi konektor di Google SecOps, lihat Mengonfigurasi konektor.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Nama Tampilan Parameter Jenis Nilai Default Wajib Deskripsi
Nama Kolom Produk String Freshworks Freshservice Ya
Nama Kolom Peristiwa String "type" Ya
Nama Kolom Lingkungan String "" Tidak Tidak
Pola Regex Lingkungan String .* Tidak Tidak
Root API String

https://yourdomain.freshservice.com

 Ya URL Root API instance Freshservice.
Kunci API Sandi T/A Ya Kunci API Freshservice yang akan digunakan dalam integrasi.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, integrasi akan mencoba memverifikasi bahwa URL Root dikonfigurasi dengan sertifikat yang valid.
Selisih waktu dalam jam Bilangan bulat 24 Ya Mengambil tiket dari X jam sebelumnya.
Tiket Maksimum Per Siklus Bilangan bulat 30 Ya Jumlah tiket yang harus diproses selama satu kali eksekusi konektor.
Prioritas Minimum untuk Mengambil String Sedang Tidak Prioritas minimum tiket yang akan di-ingest ke Google SecOps, misalnya, Rendah atau Sedang. Kemungkinan nilai: Rendah, Sedang, Tinggi, Mendesak
Status Tiket yang Akan Diambil CSV Terbuka, Tertutup Tidak Status tiket yang akan diproses ke Google SecOps. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma. Nilai yang mungkin: Terbuka, Tertunda, Terselesaikan, Tertutup
Menggunakan daftar yang diizinkan sebagai daftar blokir Kotak centang Tidak dicentang Ya Jika diaktifkan, daftar yang diizinkan akan digunakan sebagai daftar yang diblokir.

Aturan Konektor

Dukungan Proxy

Konektor mendukung proxy.

Pekerjaan

Tugas Penutupan Tiket Sinkronisasi Freshservice

Deskripsi

Tutup tiket di Freshservice jika pemberitahuan SOAR Google Security Operations SOAR yang sesuai telah ditutup.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Root API String https://yourdomain.freshservice.com Ya URL Root API instance Freshservice.
Kunci API Sandi T/A Ya Kunci API Freshservice yang akan digunakan dalam integrasi.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, integrasi akan mencoba memverifikasi bahwa URL Root dikonfigurasi dengan sertifikat yang valid.
Selisih waktu dalam jam Bilangan bulat 24 Ya Sinkronkan penutupan tiket dari X jam sebelumnya.
Deskripsi Tiket Default String Tiket ditutup oleh Siemplify Freshservice Sync Tickets Closure Job. Ya Tentukan deskripsi yang harus ditambahkan ke tiket jika tiket tidak memiliki deskripsi, sehingga tiket dapat ditutup di Freshservice, karena kolom deskripsi wajib diisi untuk Freshservice.

Tugas Sinkronisasi Percakapan Tiket Freshservice

Deskripsi

Menyinkronkan percakapan (dianggap sebagai balasan dan catatan) antara kasus pemberitahuan Google SecOps dan tiket Freshservice yang sesuai. Mekanisme sinkronisasi berfungsi dua arah, Google SecOps → Freshservice dan Freshservice → Google SecOps.

Parameter

Nama Tampilan Parameter Jenis Nilai Default Wajib Diisi Deskripsi
Root API String https://yourdomain.freshservice.com Ya URL Root API instance Freshservice.
Kunci API Sandi T/A Ya Kunci API Freshservice yang akan digunakan dalam integrasi.
Verifikasi SSL Kotak centang Dicentang Tidak Jika diaktifkan, integrasi akan mencoba memverifikasi bahwa URL Root dikonfigurasi dengan sertifikat yang valid.
Selisih waktu dalam jam Bilangan bulat 24 Ya Menyinkronkan percakapan tiket dari X jam sebelumnya
Awalan Komentar Siemplify String SIEMPLIFY: Ya Awalan yang akan ditambahkan oleh tugas sinkronisasi ke komentar yang dibuat untuk tiket Freshservice.
Awalan Komentar Freshservice String Tugas Sinkronisasi Komentar Freshservice: Ya Awalan yang akan ditambahkan oleh tugas sinkronisasi ke komentar kasus pemberitahuan Google SecOps.
Jenis Percakapan yang Akan Disinkronkan CSV Balasan, Catatan Ya Tentukan jenis percakapan Freshservice yang harus disinkronkan oleh tugas. Parameter menerima beberapa nilai sebagai string yang dipisahkan koma.
Ambil Catatan Pribadi? Kotak centang Kotak Centang Tidak Dicentang (salah) Tidak Jika diaktifkan, akan mengambil catatan publik dan pribadi untuk tiket Freshservice terkait.
Menyinkronkan Komentar dari Siemplify sebagai X String Catatan Pribadi Ya Tentukan jenis tugas percakapan mana yang harus digunakan untuk menambahkan komentar dari Google SecOps. Nilai yang mungkin: Catatan Pribadi, Catatan Publik, Balasan.

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