Konfigurasi blok pemicu "Integrasi"

Pelajari cara menyiapkan blok pemicu seperti "Webhook diterima"

Ditulis oleh Iqmal (Administrator)

Diperbarui pada July 12th, 2024

Semua blok pemicu memerlukan pengaturan dalam bentuk blok, tempat Anda dapat menentukan lebih lanjut parameter flow yang akan dipicu. Dalam artikel ini, kami akan memandu Anda tentang cara menyiapkan setiap blok pemicu “Integrasi” sehingga Anda dapat memulai flow berdasarkan keadaan yang diharapkan.
 

Webhook diterima

⚠️ Pemicu "Webhook diterima" hanya akan tersedia untuk pengguna paket Premium dan Enterprise

 

Pemicu "Webhook diterima" memungkinkan Anda mendaftarkan kontak ke dalam flow ketika SleekFlow menerima webhook yang cocok dengan konfigurasi yang diatur dalam bentuk blok pemicu.

Siapkan blok pemicu "Webhook diterima" dengan mengikuti langkah-langkah yang diuraikan di bawah ini:

  1. Aktifkan blok pemicu yang diterima webhook
  2. Siapkan webhook Anda
  3. Tentukan pengidentifikasi kontak
  4. Konfigurasikan persistensi respons
     

Aktifkan blok pemicu “Webhook diterima”.

Untuk mengaktifkan blok pemicu "Webhook diterima":

  1. Klik pada blok untuk membuka bentuknya, yang akan muncul di sisi kanan layar
     
  2. Klik tombol "Generate/buat" di dalam formulir untuk mengaktifkan blok, menghasilkan bagian yang diperlukan yang memungkinkan Anda mengonfigurasi pemicu


     
  3. Setelah Anda mengklik "Buat", bagian baru berikut akan muncul dalam:
    • Menyiapkan
    • Identifikasi kontak
    • Simpan respons
       

Bagian artikel berikut ini menguraikan tujuan setiap bagian dan cara mengonfigurasinya.
 

Siapkan webhook Anda

Setelah pemicu "Webhook diterima" diaktifkan, bagian pertama yang ditampilkan adalah "Pengaturan". Bagian ini memberikan informasi yang diperlukan untuk menyiapkan konektivitas yang diperlukan antara sistem eksternal Anda dan SleekFlow. Jadi, sistem eksternal Anda dapat mengirimkan webhook yang valid untuk memicu pendaftaran flow.

Anda harus menggunakan 3 item berikut yang disediakan di bagian "Pengaturan" untuk menyiapkan koneksi webhook yang tepat dari sistem eksternal Anda ke SleekFlow:

  1. URL Webhook - Ini adalah URL yang dibutuhkan sistem eksternal Anda untuk mengirim webhook agar dapat diterima oleh SleekFlow
  2. ID pemicu webhook - ID ini memungkinkan sistem SleekFlow memetakan webhook ke flow, memastikan kontak terdaftar dengan benar. Harap berikan ini di header webhook Anda.
  3. Token validasi - Ini memungkinkan sistem SleekFlow memverifikasi webhook berasal dari Anda. Harap berikan ini di header webhook Anda.


     

Di bagian "Pengaturan" juga terdapat contoh kode "Permintaan posting" untuk membantu Anda mengonfigurasi permintaan HTTP agar dapat mengirim webhook ke SleekFlow dengan benar.


 

Informasi yang diberikan di bagian "Penyiapan" akan memungkinkan Anda mengonfigurasi webhook yang valid untuk dikirim dari sistem eksternal Anda ke SleekFlow, sehingga memicu pendaftaran flow yang Anda inginkan.
 

Tentukan pengidentifikasi kontak

Bagian "Identifikasi kontak" memungkinkan Anda mengonfigurasi cara sistem akan memetakan webhook yang diterimanya ke kontak terkait yang terdaftar ke flow.

Bagian ini memiliki 2 kolom yang harus Anda isi:

  1. Kunci payload kontak - Bidang ini memungkinkan Anda menentukan variabel mana dalam payload webhook JSON yang diterima oleh sistem yang harus digunakan untuk melakukan pemeriksaan silang terhadap catatan kontak di SleekFlow. Sebaiknya gunakan variabel yang merupakan pengidentifikasi unik untuk suatu kontak, misalnya ID kontak, nomor telepon, atau email. Silakan gunakan notasi titik JSON di sini untuk menentukan bidang mana dari payload webhook yang harus diekstraksi dan dirujuk oleh sistem. 

    💡 Penjelasan notasi titik JSON

    Notasi titik JSON adalah cara untuk menentukan bidang atau nilai tertentu dalam struktur data bertingkat seperti JSON. Ini memungkinkan Anda menavigasi struktur dengan menunjukkan jalur ke bidang yang diinginkan menggunakan tombol yang dipisahkan titik.

    Format:
    Notasi titik JSON dimulai dengan $., diikuti oleh semua nama bidang yang dicantumkan secara berurutan untuk menavigasi struktur data bertingkat untuk sampai ke bidang target Anda. Setiap nama field yang ditentukan dalam notasi dipisahkan dengan titik (misalnya $.key1.key2.key3)

    Contoh:
    Untuk payload yang ditentukan di bawah, kolom nomor telepon akan direpresentasikan menggunakan notasi titik JSON seperti: $.data.profile.phone
    {
    "data": {
    "id": "12345",
    "nama": "Bob Chan",
    "Profil": {
    "email": "bob@ sleekflow .io",
    "telepon": "85298007899"
    }
    }

     

     
  2. Jenis pengidentifikasi - Menu tarik-turun ini memungkinkan Anda memilih properti kontak mana yang akan diperiksa ulang oleh sistem terhadap pengidentifikasi kontak yang Anda tentukan dalam catatan kontak akun SleekFlow Anda. Pilih di antara 3 opsi:
    • ID Kontak (yaitu UUID unik dari setiap kontak yang disediakan oleh SleekFlow)
    • Nomor telepon
    • Email

      💡 Catatan tentang kontak yang tidak ada

      Mungkin ada kejadian di mana pengidentifikasi kontak yang disediakan dalam payload webhook JSON tidak sesuai dengan kontak yang ada dalam akun SleekFlow Anda.

      Ketika "Nomor telepon" atau "Email" dipilih sebagai "Jenis pengenal" Anda, tombol tambahan - "Pendaftaran customer baru" - disediakan untuk menangani kasus tersebut.



      Jika "Pendaftaran customer baru" diaktifkan, nomor telepon atau alamat email yang diberikan dalam payload webhook yang tidak dapat dicocokkan dengan kontak yang ada di SleekFlow akan secara otomatis membuat catatan kontak baru dengan pengidentifikasi kontak yang disediakan. Kontak yang baru dibuat kemudian akan didaftarkan ke flow.

       

 

Konfigurasikan persistensi respons

Bagian "Simpan respons" memungkinkan Anda menentukan titik data dalam payload webhook JSON yang diterima untuk disimpan dan digunakan nanti sebagai variabel dalam flow. Ini akan memberi Anda lebih banyak fleksibilitas dalam menciptakan interaksi yang disesuaikan dengan kontak Anda melalui data dinamis.



Bagian ini memungkinkan Anda menambahkan pasangan nilai kunci untuk nilai dalam webhook yang ingin Anda simpan sebagai variabel, serta memberikan nama variabel untuk menyimpannya. Setiap pasangan nilai kunci terdiri dari 2 bidang berikut:

  • {{variable}} - Tentukan nama variabel yang akan digunakan sistem untuk menyimpan data yang diekstraksi dari payload webhook. Anda dapat menggunakan variabel ini dalam blok kondisi dan tindakan berikutnya dalam flow ketika Anda ingin mereferensikan nilai yang diekstraksi dari payload webhook. Silakan tentukan nama variabel yang Anda inginkan di kolom ini menggunakan kurung kurawal ganda (yaitu {{nama_variabel}} )
  • $.response_variable - Bidang ini memungkinkan Anda menentukan variabel untuk mengekstrak nilai dari dalam payload webhook JSON yang diterima oleh sistem. Silakan gunakan notasi titik JSON di sini untuk menentukan bidang mana dari payload webhook yang harus diekstraksi sistem (lihat penjelasan notasi titik JSON).