Node trigger webhook memungkinkan sistem eksternal berkomunikasi dengan SleekFlow dengan mengirim data untuk memulai alur. Dengan menggunakan trigger terkait webhook, Anda dapat mendaftarkan kontak ke dalam alur secara otomatis ketika SleekFlow menerima permintaan webhook yang sesuai dengan konfigurasi Anda.
ℹ️ Pelajari lebih lanjut tentang trigger alur di artikel ini: Flow trigger overview
Ini sangat berguna untuk integrasi dengan platform pihak ketiga, sistem internal, atau alat khusus yang perlu memicu alur kerja di SleekFlow secara real-time.
Payload webhook diterima
⚠️ Trigger “Payload webhook diterima” hanya tersedia untuk pengguna paket Premium dan Enterprise.
Trigger “Payload webhook diterima” memungkinkan Anda mendaftarkan kontak ke dalam alur ketika SleekFlow menerima webhook masuk yang sesuai dengan konfigurasi yang ditetapkan di formulir node pemicu.
Atur formulir node trigger “Payload webhook diterima” dengan mengikuti langkah-langkah berikut:
- Pilih node trigger “Webhook diterima”
- Atur webhook Anda
- Tentukan identifier kontak
Atur node trigger “Payload webhook diterima”
- Klik node trigger “Payload webhook diterima” untuk membuka formulir node-nya, yang akan muncul di sisi kanan layar
- Form node berisi kolom-kolom berikut untuk mengatur trigger.
- Atur tab
- Bagian ini menyediakan semua informasi yang diperlukan untuk menghubungkan sistem eksternal Anda ke SleekFlow. Jika dikonfigurasi dengan benar, SleekFlow dapat menerima permintaan webhook dan mendaftarkan kontak yang relevan ke dalam alur.
- URL Webhook: Ini adalah URL yang harus dikirimkan oleh sistem eksternal Anda agar diterima oleh SleekFlow.
- ID pemicu Webhook: ID ini memungkinkan sistem SleekFlow memetakan webhook ke alur, memastikan kontak terdaftar dengan benar. Sertakan ini di header webhook
- Token Webhook: Ini memungkinkan sistem SleekFlow memverifikasi bahwa webhook berasal dari Anda. Sertakan ini di header webhook
-
Contoh permintaan post Webhook: Contoh yang sudah terisi disediakan, yang bisa Anda gunakan untuk pengujian atau referensi saat implementasi.
Tentukan identifier pelanggan
Di bagian “Info Setup”, Anda juga akan menemukan bagian “Identifier pelanggan”. Bagian ini memungkinkan Anda mengonfigurasi bagaimana sistem memetakan webhook yang diterima ke kontak yang sesuai untuk didaftarkan ke dalam flow.
Bagian ini memiliki 2 kolom yang harus Anda isi:
-
Tipe identifier: Menu drop-down ini memungkinkan Anda memilih properti kontak yang akan dicek silang oleh sistem terhadap identifier kontak yang Anda tentukan di dalam catatan kontak akun SleekFlow Anda. Pilih di antara 3 opsi:
- Contact ID (yaitu UUID unik dari setiap kontak yang disediakan oleh SleekFlow)
- Nomor telepon
💡Catatan mengenai kontak yang tidak ada:
Ada kemungkinan identifier kontak yang diberikan dalam payload JSON webhook tidak sesuai dengan kontak yang ada di akun SleekFlow Anda.
Ketika “Nomor telepon” atau “Email” dipilih sebagai “Tipe identifier”, akan tersedia toggle tambahan - “Pendaftaran pelanggan baru” - untuk menangani kasus seperti ini.
Jika “Pendaftaran pelanggan baru” diaktifkan, nomor telepon atau alamat email yang diberikan di payload webhook yang tidak dapat dicocokkan dengan kontak yang ada di SleekFlow akan otomatis dibuatkan catatan kontak baru dengan identifier yang diberikan. Kontak baru ini kemudian akan didaftarkan ke dalam alur.
- Payload key kontak: Kolom ini memungkinkan Anda menentukan variabel mana dalam payload JSON webhook yang diterima oleh sistem yang akan digunakan untuk dicek silang dengan catatan kontak di SleekFlow. Kami menyarankan menggunakan variabel yang menjadi identifier unik untuk sebuah kontak, misalnya contact ID, nomor telepon, atau email. Gunakan notasi titik JSON untuk menentukan kolom dari payload webhook yang akan 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 dengan menunjukkan jalur ke kolom yang diinginkan menggunakan kunci yang dipisahkan titik.
Format:
Notasi titik JSON diawali dengan $., diikuti semua nama kolom yang disusun secara berurutan untuk menavigasi struktur data bersarang hingga mencapai kolom target Anda. Setiap nama kolom dipisahkan dengan titik (misal: $.key1.key2.key3)
Contoh:
Notasi titik JSON diawali dengan $., diikuti semua nama kolom yang disusun secara berurutan untuk menavigasi struktur data bersarang hingga mencapai kolom target Anda. Setiap nama kolom dipisahkan dengan titik (misal: $.key1.key2.key3) $.data.profile.phone
{
"data": {
"id": "12345",
"name": "Bob Chan",
"profile": {
"email": "bob@sleekflow.io",
"phone": "85298007899"
}
}
Tempel contoh respon payload
Setelah mengatur webhook dan menentukan identifier kontak, Anda dapat membuka tab “Variabel”. Tab ini digunakan untuk menentukan bagaimana SleekFlow menafsirkan dan mengekstrak data dari payload webhook yang masuk. Tab ini memungkinkan Anda untuk meninjau dan mengonfigurasi variabel yang dapat digunakan di seluruh alur.
Panduan langkah demi langkah:
- Tempelkan payload JSON contoh
Salin payload permintaan webhook contoh dari sistem eksternal Anda dan tempelkan ke dalam kotak teks yang disediakan. Ini harus berupa objek JSON mentah yang mencerminkan struktur dan konten yang akan dikirim sistem Anda saat webhook dipicu.
⚠️ Data yang ditempel di sini hanya digunakan untuk mem-parsing jalur variabel dan tidak akan disimpan di SleekFlow setelah parsing.
- Klik “Parse data”
Setelah parsing, variabel ini akan dapat diakses di seluruh alur. Anda dapat merujuknya dalam template pesan, cabang kondisi, atau node lain yang mendukung variabel dinamis.
- Gunakan variabel hasil parsing
Setelah parsing, variabel ini akan dapat diakses di seluruh alur. Anda dapat merujuknya dalam template pesan, cabang kondisi, atau node lain yang mendukung variabel dinamis.