Webhook Integration

Ringkasan

Webhook Integration digunakan untuk mengirim notifikasi otomatis dari TENTA ke sistem lain saat ada aktivitas tertentu.

Dengan webhook, sistem eksternal bisa menerima update tanpa harus mengecek data ke TENTA secara manual terus-menerus.

Webhook biasanya digunakan oleh developer atau tim teknis untuk membuat integrasi yang lebih otomatis.

Kapan Digunakan

Webhook digunakan ketika sistem lain perlu mendapatkan informasi terbaru dari TENTA secara otomatis.

Gunakan webhook untuk:

Menerima notifikasi saat ada pesan baru.
Menerima update saat customer membalas chat.
Mencatat perubahan status percakapan.
Menghubungkan aktivitas TENTA ke sistem internal.
Membuat alur kerja otomatis berdasarkan event tertentu.

Fungsi Webhook

Webhook membantu TENTA mengirim informasi ke sistem lain saat sebuah event terjadi.

Contoh sederhana:

Saat ada pesan baru masuk ke TENTA, webhook dapat mengirim data pesan tersebut ke sistem internal bisnis.

Dengan cara ini, sistem lain bisa langsung mengetahui aktivitas terbaru tanpa menunggu pengecekan manual.

Webhook berguna untuk integrasi yang membutuhkan respon cepat dan update real-time.

Event yang Dikirim Webhook

Event adalah aktivitas tertentu yang memicu webhook.

Contoh event yang dapat digunakan:

Pesan baru masuk.
Customer membalas pesan.
Status chat berubah.
Chat di-assign ke agent.
Campaign mendapatkan respon.
Percakapan ditandai selesai.

Event yang digunakan sebaiknya disesuaikan dengan kebutuhan integrasi.

Tidak semua event harus diaktifkan jika sistem eksternal hanya membutuhkan data tertentu.

Cara Mengatur Webhook

1. Siapkan URL Webhook

Siapkan URL dari sistem eksternal yang akan menerima data webhook.

URL ini harus aktif dan dapat menerima request dari TENTA.

2. Masuk ke Dashboard TENTA

Buka dashboard TENTA melalui:

app.tenta.id/login

Masukkan email dan password akun TENTA Anda.

Masuk ke menu Webhook Integration atau menu pengaturan API yang berkaitan dengan webhook.

4. Masukkan URL Webhook

Tempelkan URL webhook yang sudah disiapkan.

Pastikan URL ditulis dengan benar agar data dapat dikirim ke sistem tujuan.

5. Pilih Event yang Dibutuhkan

Pilih event yang ingin dikirim ke sistem eksternal.

Contoh:

Pesan baru masuk.
Status chat berubah.
Percakapan selesai.

Pilih hanya event yang memang dibutuhkan agar data yang masuk tidak terlalu banyak.

6. Simpan Pengaturan

Setelah URL dan event selesai diatur, klik tombol Simpan.

Pastikan pengaturan webhook berhasil tersimpan.

7. Lakukan Uji Coba

Lakukan uji coba dengan membuat event sesuai pengaturan.

Contoh:

Kirim pesan baru ke channel yang terhubung.
Ubah status chat.
Tandai chat selesai.

Cek apakah sistem eksternal berhasil menerima data dari TENTA.

Contoh Penggunaan Webhook

Bisnis memiliki sistem internal untuk mencatat semua pesan customer.

Tim developer mengatur webhook agar setiap pesan baru yang masuk ke TENTA dikirim ke sistem internal.

Saat customer mengirim pesan melalui WhatsApp, TENTA mengirim event pesan baru ke URL webhook.

Sistem internal kemudian menyimpan data tersebut untuk kebutuhan laporan atau monitoring.

Catatan Penting

Pastikan URL webhook aktif dan bisa menerima data.
Gunakan webhook hanya untuk event yang dibutuhkan.
Simpan log webhook agar mudah mengecek jika terjadi kendala.
Pastikan sistem penerima memiliki keamanan yang baik.
Jangan membagikan URL webhook ke pihak yang tidak berwenang.

Kendala yang Sering Terjadi

Webhook Tidak Terkirim

Cek apakah URL webhook sudah benar, aktif, dan dapat diakses.

Sistem Tidak Menerima Data

Periksa format data yang dikirim dan pastikan sistem penerima sudah siap membaca request webhook.

Event Tidak Muncul

Pastikan event tersebut sudah dipilih dan pengaturan webhook sudah disimpan.

Data Webhook Terlalu Banyak

Batasi event yang dikirim hanya pada aktivitas yang benar-benar dibutuhkan.

Langkah Selanjutnya

Setelah memahami Webhook Integration, lanjutkan ke halaman berikutnya: