TINDAKAN ALUR KERJA MARKETPLACE

Apa Itu Marketplace Workflow Actions di SunnyDay?

Marketplace Workflow Actions adalah fitur di SunnyDay yang memungkinkan pengguna membuat aksi otomatisasi khusus (custom actions) dalam workflow. Dengan fitur ini, Anda dapat mengirim (push) atau mengambil (pull) data dari aplikasi atau API eksternal menggunakan field yang disesuaikan dan endpoint API tertentu.

Prasyarat

Catatan : lingkup workflows.readyonly harus diaktifkan untuk mengaktifkan tindakan dan pemicu.

Buat Tindakan

Nama

Masukkan Nama Tindakan

Kunci

Pengenal unik untuk tindakan ini, yang digunakan untuk merujuk tindakan di dalam alur kerja. Nilai ini tidak dapat diubah di kemudian hari. Contoh: {{mycustomaction.data.name}}

Informasi Tindakan

Tambahkan detail tindakan

Ikon

Pilih Ikon untuk Tindakan ini. Ditampilkan dalam alur kerja untuk tindakan ini.

Nama

Nama Tindakan Khusus

Key

Pengenal unik untuk tindakan ini, digunakan untuk merujuk tindakan di dalam alur kerja, Contoh: {{action_a.custom_variable}}. Nilai ini tidak dapat diubah di kemudian hari.

Deskripsi singkat

Deskripsi singkat yang menjelaskan apa yang dilakukan tindakan Anda untuk membantu pengguna memahami. Ditampilkan di alur kerja sebagai sub-judul untuk tindakan ini.

Ringkasan

Informasi terperinci tentang apa yang dilakukan tindakan Anda untuk membantu pengguna memahami mengapa mereka harus menggunakan tindakan ini.

Konfigurasi Tindakan

Mengelola Bidang

Membuat formulir untuk mengumpulkan data yang diperlukan untuk dikirim ke API

Buat Bidang Baru

Nama

Masukkan Nama Bidang

Type

Pilih salah satu jenis bidang berikut ini:

• String

• Numerik

• Textarea

• Pilih

• Beberapa Pilih

• Radio

• Toggle

• Kotak centang

• Lampiran

• Rich Text Editor

• Tersembunyi

• Dinamis

Diperlukan

Aktifkan jika ini adalah bidang yang wajib diisi dalam alur kerja.

Referensi

Masukkan kunci referensi unik. Nilai bidang ini akan diikat ke kunci yang disediakan. Contoh: action_a_name

Nilai Default

Masukkan atau petakan nilai. Nilai yang disediakan akan digunakan sebagai nilai default untuk bidang ini ketika dimuat dalam alur kerja.

Mengubah Bidang Dinamis

Jika diaktifkan, setiap perubahan yang dilakukan pada nilai bidang ini akan memicu/memuat ulang bidang dinamis ke UI konfigurasi tindakan alur kerja.

Validation Rules

Validation Rules memungkinkan Anda melindungi kualitas data dengan memeriksa nilai yang diketikkan pengguna ke dalam bidang formulir, sel tabel, atau input konfigurasi sebelum disimpan atau diteruskan ke hilir.

Contoh Skenario

• Formulir pengambilan prospek Membutuhkan nomor telepon AS yang diformat dengan benar

• Muatan pengait web Pastikan bidang "status" cocok dengan salah satu dari beberapa string yang diizinkan

• Parameter tindakan khusus Memblokir pengguna agar tidak memasukkan sintaks Stang dalam bidang teks biasa

Jenis: Pilih / Multi Pilih / Radio

Jenis Opsi hanya berlaku untuk jenis bidang Select, Multi Select dan Radio.

Pilih salah satu jenis opsi berikut ini:

• Konstanta

• Referensi Internal

• API Eksternal

Konstanta

Memuat opsi dengan menambahkan konstanta Nilai-Label khusus

Referensi Internal

API eksternal

Opsi pemuatan dari titik akhir API eksternal

URL (GET)

Sediakan URL untuk mendukung metode GET dan kirimkan respons yang valid sesuai dengan contoh struktur respons yang dibagikan di bawah ini.

Header

Tambahkan header sesuai kebutuhan Anda

Ketik: Tersembunyi

Ini akan disembunyikan dalam konfigurasi tindakan dan data yang dipetakan akan dikirim dalam muatan. Digunakan untuk mengumpulkan informasi penting seperti company_id, customerid, dll. dari data sistem atau dari pemicu khusus Anda

Jenis: Dinamis

Bidang dinamis digunakan untuk membangun bidang khusus dari panggilan API. Panggilan API harus mengembalikan struktur respons di bawah ini untuk membuat bidang di UI formulir konfigurasi tindakan Alur Kerja. Hanya satu tipe Dinamis yang dapat dibuat per tindakan.

URL (POST)

Masukkan URL titik akhir API Anda. Ketika dieksekusi, data akan dikirim ke titik akhir API ini melalui metode POST dalam format muatan yang disebutkan di bawah ini dan respons yang valid diharapkan sesuai dengan contoh struktur respons yang dibagikan di bawah ini.

Header

Tambahkan header sesuai kebutuhan Anda

Aturan Validasi

1. Aturan yang Telah Ditetapkan Sebelumnya

Menerapkan validasi umum dengan mudah seperti email, nomor telepon, URL, nilai numerik, dan pemeriksaan sintaks stang.

2. Dukungan Regex

   Gunakan ekspresi reguler khusus untuk memvalidasi input terhadap pola tertentu.

   

3. Fungsi Panah

   Tulis fungsi panah khusus yang menerima nilai input dan mengembalikan nilai benar atau salah berdasarkan apakah validasi lolos atau gagal.

   

Multi-cabang

Fitur Multi-Cabang memungkinkan pembuatan cabang yang dapat menyesuaikan secara dinamis berdasarkan berbagai kondisi yang telah ditentukan sebelumnya. Dengan mengizinkan beberapa cabang dalam alur kerja, setiap kontak dapat diarahkan ke jalur yang sesuai berdasarkan interaksi atau status mereka.

• Bagian Cabang: Menentukan nama atau pengenal untuk bagian cabang tertentu.

• Deskripsi Bagian Cabang: Memberikan deskripsi singkat atau detail tentang bagian cabang.

• Label Nama Cabang: Menentukan label yang akan ditampilkan untuk nama cabang.

• Teks Bantuan Nama Cabang: Menawarkan informasi tambahan yang terkait dengan nama cabang.

• Hapus Judul Cabang: Menetapkan judul atau label yang digunakan saat menghapus cabang.

• Hapus Deskripsi Cabang: Menjelaskan saat cabang dihapus.

  

• Izinkan Cabang Baru: Memungkinkan pengguna untuk menambahkan cabang baru di dalam tindakan.

• Apakah Cabang yang Telah Ditentukan Dapat Diedit: Memungkinkan pengguna mengedit cabang yang sudah ditentukan sebelumnya di dalam tindakan.

• Tampilkan Bagian Cabang: Menampilkan detail bagian cabang kepada pengguna.

Dinonaktifkan Izinkan cabang baru

Eksekusi Tindakan

Memungkinkan Anda memilih antara API atau kode khusus.

kode khusus

Kode Khusus memungkinkan pengguna untuk membuat logika khusus yang ingin mereka capai. Hal ini memberikan fleksibilitas dan kontrol di luar API yang telah dibuat sebelumnya, sehingga pengguna dapat mengotomatiskan tugas-tugas kompleks dan berintegrasi dengan berbagai layanan yang tidak didukung oleh API.

Editor Kode

Anda dapat menulis kode di Code Editor

Anda dapat memasukkan permintaan HTTP seperti Get, Put, Post, Delete, dll. melalui tombol.

Anda juga dapat menggunakan nilai kustom menggunakan pemilih.

Keluarannya harus berupa Objek JavaScript atau Larik Objek.

Uji dan format Kode Anda

• Menguji kode adalah langkah wajib, jika pengujian tidak dilakukan maka pengguna tidak akan dapat menggunakan output dari kode tersebut pada langkah selanjutnya.

• Untuk menguji kode klik pada tombol "Test Code".

• Setelah mengklik tombol "Jalankan tes", jika tidak ada kesalahan dalam kode, maka akan muncul "Hasil Tes Berhasil" dan jika ada kesalahan dalam kode maka hasilnya adalah "Hasil Tes Gagal" dan Anda harus memeriksa ulang kode untuk menghilangkan kesalahan tersebut.

• Anda juga dapat memformat kode menggunakan tombol "Format kode".

Jeda Eksekusi

• Toggle ini digunakan kontak akan ditahan pada tindakan ini kecuali jika resume webhook diminta.

• Jika pilihan ini benar, maka objek tambahan yang disediakan harus diteruskan sebagai muatan tubuh untuk titik akhir alur kerja resume.

• Tombol Tampilkan detail API menunjukkan contoh respons yang akan diteruskan ke webhook untuk Eksekusi Berhasil dan Eksekusi Gagal.

  

Dalam hal Eksekusi Sinkronisasi

Ketika eksekusi jeda dimatikan bersama dengan dukungan percabangan, kontak akan dipindahkan ke cabang yang disediakan menggunakan properti branchId dari respons API atau dari Kode Kustom menggunakan pernyataan return. BranchId di sini akan menjadi cabang yang dilalui oleh kontak yang akan dipindahkan.

Data Respons

Menambahkan data respons sampel untuk mengonfigurasi variabel khusus.

Menambahkan respons sampel

Masukkan struktur JSON respons sampel yang valid yang akan dikirim sebagai respons ke titik akhir API Kirim Data.

Array didukung dalam data respons. Data ini dapat digunakan dalam variabel khusus berdasarkan referensi dan tersedia untuk digunakan dalam Fungsi Array, Kode Khusus, dan Webhook Khusus.

Opsi dropdown baru memungkinkan pengguna untuk memilih antara nilai standar atau pemilih nilai khusus.

• Nilai Standar: Pengguna dapat memasukkan data berdasarkan jenis bidang (misalnya, tanggal, dropdown, tag).

• Pemilih Nilai Khusus: Pengguna dapat memasukkan data dari bidang khusus, seperti nilai dari pemicu webhook masuk atau bidang khusus lainnya.

  

Mengelola Variabel Khusus

Menambahkan variabel khusus menggunakan data respons sampel, untuk digunakan pengguna dalam alur kerja

Tambahkan Variabel Khusus

Nama

Masukkan nama label

Referensi

Pilih kunci referensi dari respons sampel yang disimpan ke Data Respons.

Kirim untuk Ditinjau

Versi tindakan akan berada dalam status draf secara default. Setelah memperbarui informasi dan konfigurasi tindakan, versi tindakan harus diserahkan untuk ditinjau.

Klik Kirim untuk ditinjau dan tambahkan informasi log perubahan yang diperlukan untuk versi yang dikirimkan.

Buat Versi Baru

Klik + Versi Baru untuk membuat versi baru untuk tindakan tersebut

Dengan mengklik + Versi Baru, ini akan membuat versi draf baru dengan semua data yang diterbitkan sebelumnya telah terisi sebelumnya.

Menghapus Tindakan

Setelah sebuah Tindakan dihapus, tindakan tersebut akan terhapus secara permanen dan tidak dapat dikembalikan. Tindakan yang dihapus akan dihapus dari Aplikasi Marketplace dan daftar Tindakan Alur Kerja. Jika tindakan yang dihapus merupakan bagian dari alur kerja, eksekusi tindakan akan dilewati.

Masukkan nama tindakan untuk mengonfirmasi penghapusan