Skip to main content

Menyiapkan Webhook Anda

1

Akses Dashboard

Login ke dashboard CSKU AI Anda
2

Navigasi ke Pengaturan

Buka Settings → Webhook
3

Masukkan URL

Input URL webhook Anda yang dapat diakses publik
4

Generate Secret

Generate atau masukkan secret key Anda untuk autentikasi
5

Simpan Konfigurasi

Klik simpan untuk mengaktifkan webhook
Perubahan pada konfigurasi webhook berlaku segera.

Prasyarat

Sebelum mengkonfigurasi webhook, pastikan Anda memiliki:
URL webhook Anda harus dapat diakses publik dari internet. URL localhost tidak akan berfungsi untuk produksi.
Gunakan HTTPS untuk lingkungan produksi. HTTP hanya dapat diterima untuk pengujian.
Pastikan server Anda dapat menangani volume webhook yang diharapkan.

Menguji Webhook Anda

Sebelum mengaktifkan webhook untuk produksi, uji endpoint Anda:

1. Pengujian Lokal dengan ngrok

Gunakan URL ngrok untuk menguji webhook Anda secara lokal sebelum deploy.

2. Uji dengan curl

3. Uji dengan Tool Pengujian Webhook

Gunakan layanan seperti:

Field Konfigurasi

URL Webhook

Endpoint Anda yang akan menerima request POST.
Harus dimulai dengan https:// untuk produksi. http:// hanya untuk pengujian.
Contoh:
  • ✅ Valid: https://api.yourdomain.com/webhooks/csku
  • ✅ Valid: https://abc123.ngrok.io/webhook (pengujian)
  • ❌ Tidak Valid: http://api.yourdomain.com/webhook (produksi)
  • ❌ Tidak Valid: http://localhost:3000/webhook (tidak publik)

Secret Key

Digunakan untuk mengautentikasi request webhook. Praktik Terbaik:
  • Generate key yang kuat dan acak
  • Simpan dengan aman (environment variables, secrets manager)
  • Rotasi secara berkala
  • Jangan bagikan secara publik

Rekomendasi URL Webhook

Struktur Path

Gunakan path yang jelas dan deskriptif:

Konfigurasi DNS

Sertifikat SSL

Pastikan endpoint webhook Anda memiliki sertifikat SSL yang valid:

Konfigurasi Firewall dan Jaringan

Aturan Firewall

Izinkan koneksi masuk dari server CSKU AI:

Konfigurasi Load Balancer

Jika menggunakan load balancer:

Contoh Konfigurasi

Lingkungan Produksi

Lingkungan Staging

Lingkungan Development

Monitoring Webhook Anda

Monitoring Dashboard

Periksa dashboard CSKU AI Anda untuk:
  • Status pengiriman webhook
  • Percobaan pengiriman yang gagal
  • Waktu respons
  • Log error

Log Server

Monitor endpoint webhook Anda:

Praktik Terbaik

Selalu gunakan HTTPS di produksi untuk mengenkripsi payload webhook.
Simpan secret key di environment variables, bukan di kode.
Uji dengan semua jenis event sebelum mengaktifkan di produksi.
Lacak waktu pemrosesan webhook dan tingkat error.
Implementasikan penanganan error dan logging untuk webhook yang gagal.

Troubleshooting

Webhook Tidak Diterima

1

Periksa Dashboard

Verifikasi URL webhook dikonfigurasi dengan benar
2

Uji Endpoint

Gunakan curl atau tool pengujian webhook untuk memverifikasi aksesibilitas
3

Periksa Log

Tinjau log dashboard CSKU AI dan server Anda
4

Verifikasi Autentikasi

Pastikan secret key cocok persis

Error 404

URL webhook Anda mengembalikan 404 Not Found.
Solusi:
  • Verifikasi path URL benar
  • Periksa apakah web server berjalan
  • Pastikan port dapat diakses
  • Tinjau aturan firewall

Error Timeout

Solusi:
  • Tingkatkan pengaturan timeout server Anda
  • Optimalkan pemrosesan webhook
  • Gunakan pemrosesan async untuk tugas berat
  • Periksa konektivitas jaringan

Langkah Selanjutnya

Autentikasi

Amankan endpoint webhook Anda

Referensi Event

Pelajari tentang jenis event

Praktik Terbaik

Pastikan penanganan yang andal

Contoh

Sampel kode implementasi

Dukungan

Butuh bantuan mengkonfigurasi webhook?