Kirim webhook pesan yang dipicu

Fitur ini memungkinkan Anda mengirim data terkait pesan pelanggan yang memicu flow ke sistem eksternal.

Sebelum menggunakan node ini, pastikan:

• Blok pemicu yang digunakan adalah salah satu dari berikut:
  • Incoming message received (pesan masuk diterima)
  • Outgoing message sent (pesan keluar terkirim)
  • Incoming message from Click-to-WhatsApp (CTWA) ad (pesan masuk dari CTWA)
• Sistem eksternal Anda dapat menerima webhook dari SleekFlow

Menyiapkan blok aksi "Kirim webhook pesan dipicu"

1. Klik blok aksi Kirim webhook pesan dipicu untuk membuka formulirnya, yang akan muncul di sisi kanan layar.

2. Formulir blok ini berisi beberapa field yang perlu Anda konfigurasi agar SleekFlow dapat mengirim data payload webhook dari pesan yang terpicu ke sistem eksternal Anda:

• Setup tab
  • URL: Masukkan URL webhook yang disediakan oleh sistem eksternal tujuan pengiriman data
  • Header: Aktifkan opsi ini untuk menyertakan data tambahan yang diperlukan oleh webhook melalui request header. Silakan merujuk ke dokumentasi webhook dari sistem eksternal Anda untuk mengetahui apakah ada data tambahan yang perlu dikirim melalui request header.
  • Preview payload: Menampilkan contoh payload kontak beserta parameternya yang akan dikirim ke webhook sistem eksternal Anda. Struktur data payload ditampilkan dalam format JSON

Kirim webhook kontak

Aksi "Kirim webhook kontak" memungkinkan Anda mengirim data terkait kontak yang terdaftar dalam flow ke sistem eksternal. Prasyarat untuk menggunakan blok ini adalah sistem eksternal Anda harus dapat menerima webhook masuk (incoming webhook) dari SleekFlow.

Menyiapkan blok aksi "Kirim webhook kontak"

1. Klik blok aksi Kirim webhook kontak untuk membuka formulirnya, yang akan muncul di sisi kanan layar.

2. Formulir blok ini berisi beberapa field yang perlu Anda konfigurasi agar SleekFlow dapat mengirim data payload webhook dari kontak yang terdaftar ke sistem eksternal Anda:

• Setup tab
  • URL: Masukkan URL webhook yang disediakan oleh sistem eksternal tujuan pengiriman data
  • Header: Aktifkan opsi ini untuk menyertakan data tambahan yang diperlukan oleh webhook melalui request header. Silakan merujuk ke dokumentasi webhook dari sistem eksternal Anda untuk mengetahui apakah ada data tambahan yang perlu dikirim melalui request header
  • Preview payload: Menampilkan contoh payload kontak beserta parameternya yang akan dikirim ke webhook sistem eksternal Anda. Struktur data payload ditampilkan dalam format JSON

Kirim HTTP request

Aksi "Kirim HTTP request" memungkinkan Anda mengirim dan/atau menerima data antara SleekFlow dan API dari sistem eksternal Anda. Prasyarat untuk menggunakan blok ini adalah sistem eksternal Anda harus menyediakan API publik yang dapat digunakan untuk integrasi dengan SleekFlow.

Ikuti langkah-langkah berikut untuk mengatur formulir blok aksi "Kirim HTTP request":

1. Menyiapkan HTTP request
2. Mengonfigurasi body HTTP request
3. Mengonfigurasi penyimpanan respons (response persistence) dari HTTP response
    

Menyiapkan blok aksi “Kirim HTTP request”

1. Klik blok aksi Kirim HTTP request untuk membuka formulirnya, yang akan muncul di sisi kanan layar.

2. Formulir blok ini berisi beberapa field yang perlu Anda konfigurasi agar SleekFlow dapat berinteraksi dengan sistem eksternal Anda untuk mengirim dan/atau mengambil data:

• Setup tab
  • Method: Tentukan metode HTTP yang digunakan oleh API sistem eksternal Anda
    • GET: Pilih "GET" untuk mengambil data dari API sistem eksternal
    • POST: Pilih "POST" untuk mengirim data dari SleekFlow ke sistem eksternal melalui API
    • PUT:  Pilih "PUT" untuk memperbarui atau mengganti data yang sudah ada di sistem eksternal melalui API
    • DELETE: Pilih "DELETE" untuk menghapus data yang sudah ada dari sistem eksternal melalui API

• URL: Masukkan URL untuk mengakses API sistem eksternal Anda beserta fungsinya
• Headers: Konfigurasikan pasangan key-value header yang diperlukan untuk mengakses API
• Query string: Konfigurasikan pasangan key-value query string yang diperlukan untuk mengakses API

• Handle error: Aktifkan opsi ini untuk menyiapkan jalur fallback ketika HTTP request gagal. Jika diaktifkan:
  • Cabang tambahan akan muncul dalam flow, khusus untuk request yang gagal
  • Anda dapat mengonfigurasi cabang ini untuk menentukan apa yang harus terjadi ketika request tidak berhasil diproses, misalnya mengirim pesan error

Mengonfigurasi body HTTP request

Bagian Body pada formulir blok memungkinkan Anda mengonfigurasi data serta jenis konten (content type) yang akan dikirim oleh HTTP request ke server API dari sistem eksternal. Silakan merujuk ke dokumentasi API dari sistem eksternal Anda untuk mengetahui konfigurasi dan parameter yang diperlukan untuk integrasi.

Bagian ini memiliki field berikut yang dapat Anda konfigurasi:

• Body type: Tentukan jenis body yang diterima oleh API sistem eksternal Anda. Anda dapat mengatur content type menggunakan opsi yang dijelaskan pada tabel di bawah ini.

Body type	Deskripsi
raw	Pilih jenis body raw jika API Anda menerima data berupa plain text, JSON, atau string. Tentukan content type yang didukung oleh server API Anda, yaitu Text (text/plain), JSON (application/json), XML (application/xml), HTML (text/html), atau XML (text/xml).   Anda dapat memasukkan data ke dalam kotak konten request berwarna biru tua menggunakan sintaks sesuai dengan content type yang dipilih.
Form-data or x-www-form-urlencoded	Pilih jenis body yang sesuai dengan kebutuhan API Anda, lalu masukkan data konten request dalam bentuk pasangan key-value.     Jika Anda memiliki lebih dari satu pasangan key-value yang ingin ditambahkan, klik “+ Add set” untuk menambahkan pasangan key-value lainnya.

Mengonfigurasi penyimpanan respons dari HTTP response

Setelah Anda menyiapkan HTTP request, Anda dapat langsung memproses (parse) respons API melalui tab Variable. Fitur ini memudahkan Anda untuk mengekstrak field data tertentu dari sistem eksternal dan menggunakannya di flow tanpa perlu menuliskan JSON path secara manual.

Cara memproses respons API

1. Buka tab Variable pada formulir blok Kirim HTTP request
2. Tempelkan contoh payload respons dari sistem eksternal Anda ke dalam kotak input
3. Klik Parse data.
4. SleekFlow akan menganalisis payload tersebut dan secara otomatis mendeteksi semua field yang tersedia dalam respons.
5. Setelah diproses, field-field ini akan menjadi variabel yang dapat Anda gunakan untuk:
   • Menyisipkan ke dalam pesan keluar
   • Digunakan sebagai kondisi untuk percabangan (branching) atau routing kontak
   • Disimpan untuk referensi di blok aksi berikutnya