Semua node pemicu memerlukan pengaturan dalam formulir node, di mana Anda dapat menentukan parameter lebih lanjut agar sebuah flow dapat dipicu. Dalam artikel ini, kami akan memandu Anda cara mengatur setiap node pemicu “Integrasi” sehingga Anda dapat memulai flow berdasarkan kondisi yang diharapkan.
 

Webhook diterima

Pemicu "Webhook diterima" memungkinkan Anda untuk mendaftarkan kontak ke dalam sebuah alur ketika SleekFlow menerima webhook yang sesuai dengan konfigurasi yang ditetapkan di formulir node pemicu.

Atur formulir node pemicu "Webhook diterima" dengan mengikuti langkah-langkah berikut:

1. Aktifkan node pemicu webhook received
2. Atur webhook Anda
3. Tentukan pengidentifikasi kontak
4. Konfigurasikan penyimpanan respons
    

Aktifkan node pemicu “Webhook Diterima” trigger node

Untuk mengaktifkan node pemicu "Webhook diterima":

1. Klik node untuk membuka formulirnya, yang akan muncul di sisi kanan layar.
    
2. Klik tombol "Generate" di dalam formulir untuk mengaktifkan node, sehingga bagian-bagian yang diperlukan akan muncul dan memungkinkan Anda mengonfigurasi pemicu tersebut.
   
   
    
3. Setelah Anda mengklik "Generate", bagian-bagian baru berikut akan muncul di dalam formulir:

• Atur
• Identifikasi kontak
• Simpan respon
   

Atur webhook Anda

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

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

• Webhook URL – URL ini adalah alamat tujuan yang harus digunakan sistem eksternal Anda untuk mengirim webhook agar dapat diterima oleh SleekFlow.
• Webhook trigger ID – ID ini memungkinkan sistem SleekFlow memetakan webhook ke flow, sehingga kontak dapat terdaftar dengan benar. Pastikan untuk mencantumkannya di header webhook Anda.
• Validation token – Token ini memungkinkan sistem SleekFlow memverifikasi bahwa webhook benar-benar berasal dari Anda. Pastikan juga untuk mencantumkannya di header webhook Anda.

Anda dapat menyiapkan koneksi webhook dengan menyertakan parameter di atas dalam header permintaan HTTP Anda, atau Anda dapat menyematkan parameter yang diperlukan dalam satu URL dan menyalin URL tersebut agar sesuai dengan kebutuhan pengaturan integrasi Anda.

Di dalam bagian "Atur" juga terdapat contoh kode "Post request" untuk membantu Anda mengonfigurasi permintaan HTTP agar dapat mengirim webhook ke SleekFlow dengan benar.


 

Bagian ini memiliki 2 kolom yang harus Anda isi:

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

Tentukan identifier kontak

Bagian "Identifikasi kontak" memungkinkan Anda mengonfigurasi bagaimana sistem akan memetakan webhook yang diterimanya ke kontak yang sesuai untuk didaftarkan ke dalam flow.

Bagian ini memiliki 2 kolom yang harus Anda isi:

1. Contact payload key - Kolom ini memungkinkan Anda menentukan variabel mana dalam payload JSON webhook yang diterima oleh sistem yang akan digunakan untuk memeriksa data kontak di SleekFlow. Kami menyarankan menggunakan variabel yang merupakan identifier unik untuk sebuah kontak, misalnya ID kontak, nomor telepon, atau email. Silakan gunakan notasi titik JSON di sini untuk menentukan kolom mana dari payload webhook yang harus diekstrak dan dijadikan referensi oleh sistem.
   
   

   💡 Penjelasan notasi titik JSON

   Notasi titik JSON adalah cara untuk menentukan kolom atau nilai tertentu dalam struktur data bersarang seperti JSON. Ini memungkinkan Anda menavigasi struktur tersebut dengan menunjukkan jalur ke kolom yang diinginkan menggunakan kunci yang dipisahkan titik.

   Format:
   Notasi titik JSON dimulai dengan $, diikuti oleh semua nama kolom yang dicantumkan secara berurutan untuk menavigasi struktur data bersarang hingga mencapai kolom target. Setiap nama kolom dipisahkan oleh titik (misal: $.key1.key2.key3)

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

    
   
    
2. Identifier type - Menu drop-down ini memungkinkan Anda memilih properti kontak mana yang akan digunakan sistem untuk memeriksa identifier kontak yang Anda tentukan terhadap data kontak di akun SleekFlow Anda. Pilih di antara 3 opsi:

• Contact ID (yaitu UUID unik setiap kontak yang diberikan oleh SleekFlow)
• Nomor telepon
• Email
  
  

  💡 Catatan tentang kontak yang tidak ada

  Mungkin ada kasus di mana identifier kontak yang diberikan dalam payload JSON webhook tidak sesuai dengan kontak yang sudah ada di akun SleekFlow Anda.

  Ketika “Nomor telepon” atau “Email” dipilih sebagai “Tipe identifier” Anda, akan muncul toggle tambahan — “Pendaftaran pelanggan baru” — untuk menangani kasus seperti ini.
  
  
  
  Jika “Pendaftaran pelanggan baru” diaktifkan, nomor telepon atau alamat email yang diberikan dalam payload webhook dan tidak dapat dicocokkan dengan kontak yang sudah ada di SleekFlow akan otomatis dibuat sebagai kontak baru dengan identifier yang diberikan. Kontak baru tersebut kemudian akan didaftarkan ke dalam flow.

   

Configure response persistence

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



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

• {{variable}} - Tentukan nama variabel yang akan digunakan sistem untuk menyimpan data yang diekstrak dari payload webhook. Anda dapat menggunakan variabel ini di node kondisi dan aksi berikutnya dalam flow saat ingin merujuk pada nilai yang diekstrak dari payload webhook. Harap tentukan nama variabel yang diinginkan di bidang ini menggunakan tanda kurung kurawal ganda (misal: {{nama_variabel}}).
• $.response_variable - Bidang ini memungkinkan Anda menentukan variabel untuk mengekstrak nilai dari payload JSON webhook yang diterima oleh sistem. Gunakan notasi titik JSON (JSON dot notation) di sini untuk menentukan bidang mana dari payload webhook yang akan diekstrak oleh sistem. (berdasarkan JSON dot notation explainer).