Copy page

Pengembang

Webhook

Konfigurasi webhook untuk menerima notifikasi real-time ketika peristiwa terjadi di organisasi Qwetty Anda.

Cara kerja webhook

Ketika peristiwa terjadi (misalnya, pesan baru masuk), Qwetty mengirim permintaan HTTP POST ke URL webhook yang telah dikonfigurasi beserta data peristiwa.

Menyiapkan webhook

1. Buka Pengaturan → Channel dan temukan bagian Webhook Settings
2. Klik Create Webhook
3. Konfigurasi:
   • Name — Nama deskriptif
   • URL — Endpoint HTTPS Anda
   • Events — Peristiwa mana yang ingin diterima (pesan, pembaruan status, kontak, media)
   • Secret — Rahasia bersama untuk verifikasi tanda tangan HMAC
4. Simpan dan aktifkan

Jenis peristiwa

Peristiwa	Deskripsi
message	Pesan baru diterima
status	Pembaruan status pengiriman/baca pesan
contact	Kontak dibuat atau diperbarui
media	Lampiran media diterima

Payload webhook

Setiap pengiriman webhook mencakup:

• Jenis peristiwa
• Data peristiwa (konten pesan, informasi kontak, dsb.)
• Stempel waktu
• ID organisasi

Memverifikasi tanda tangan

Qwetty menandatangani setiap payload dengan HMAC-SHA256 menggunakan rahasia webhook Anda. Selalu verifikasi tanda tangan:

Code
const crypto = require('crypto');

function verifyWebhook(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(JSON.stringify(payload))
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expected)
  );
}

Pengujian lokal

Gunakan alat seperti ngrok untuk mengekspos server lokal Anda:

Code
ngrok http 3000

Kemudian gunakan URL ngrok sebagai endpoint webhook Anda selama pengembangan.

Praktik terbaik

• Selalu verifikasi tanda tangan untuk memastikan permintaan berasal dari Qwetty
• Respons dengan cepat — Kembalikan status 2xx dalam 5 detik
• Tangani percobaan ulang — Qwetty dapat mencoba ulang pengiriman yang gagal
• Gunakan HTTPS — URL webhook harus menggunakan HTTPS di lingkungan produksi

Langkah selanjutnya

• Referensi API — Dokumentasi endpoint lengkap