Notifikasi Klik Real-Time ke Slack dan Webhook

Statistik di dasbor menjawab pertanyaan "berapa banyak". Notifikasi real-time menjawab "sekarang terjadi apa". Saat kampanye baru tayang, tim ingin tahu klik pertama masuk, dari mana, dan apakah iklan benar-benar berjalan. Kencang.in mendukung tiga saluran notifikasi: Slack, Zapier, dan webhook kustom ke server Anda sendiri.

Mengaktifkan saluran notifikasi

Buka dasbor, menu Channel atau Integrasi, lalu pilih saluran yang ingin dihubungkan. Setiap link dapat diarahkan ke satu atau beberapa saluran. Notifikasi tersedia pada paket Pro dan Bisnis; lihat halaman harga.

Slack

1. Klik Hubungkan Slack dan izinkan aplikasi Kencang.in mengakses workspace Anda.
2. Pilih channel tujuan, misalnya #kampanye.
3. Pada pengaturan link, aktifkan notifikasi dan pilih channel Slack.

Setiap klik mengirim pesan ringkas: alias, lokasi, perangkat, dan sumber rujukan. Untuk link bervolume tinggi, gunakan ringkasan per jam agar channel tidak penuh. Selain notifikasi klik, Anda juga bisa membuat link langsung dari Slack dengan perintah /kencang https://... setelah aplikasi terpasang. Dokumentasi API Slack ada di api.slack.com.

Zapier

Hubungkan Zapier di menu Integrasi, lalu di Zapier buat Zap dengan trigger "Kencang.in: New Click" (atau Webhooks by Zapier "Catch Hook" dengan URL yang kami berikan). Dari sini data klik bisa dialirkan ke mana saja: baris baru di Google Sheets, kartu di Trello, pesan di WhatsApp Business API, atau email. Cara menghubungkan Zapier untuk arah sebaliknya, yaitu membuat link otomatis, dibahas di artikel Zapier dan Google Sheets.

Webhook kustom

Untuk integrasi langsung ke sistem Anda, masukkan URL endpoint HTTPS. Setiap klik mengirim permintaan POST dengan body JSON.

Endpoint Anda harus membalas status 2xx dalam beberapa detik. Jika gagal, kami mencoba ulang beberapa kali dengan jeda bertambah. Praktik terbaik di sisi penerima:

• Balas cepat, proses belakangan. Terima payload, masukkan ke antrean, balas 200, lalu proses di worker. Jangan melakukan pekerjaan berat di dalam request.
• Verifikasi sumber. Kami menyertakan header tanda tangan HMAC berdasarkan secret yang ditampilkan di dasbor. Hitung ulang HMAC dari body mentah dan bandingkan sebelum memproses. Gunakan perbandingan waktu-konstan seperti hash_equals() di PHP.
• Idempoten. Karena ada mekanisme retry, event yang sama bisa datang dua kali. Simpan ID event atau kombinasi alias + time untuk mendeteksi duplikat.
• Pakai HTTPS dengan sertifikat valid. Webhook ke HTTP biasa ditolak.

Prinsip umum merancang penerima webhook yang andal dirangkum dengan baik dalam panduan praktik terbaik webhook GitHub, dan sebagian besar berlaku untuk layanan apa pun.

Contoh penerima minimal (PHP)

<?php
$raw    = file_get_contents('php://input');
$sig    = $_SERVER['HTTP_X_KENCANG_SIGNATURE'] ?? '';
$secret = getenv('KENCANG_WEBHOOK_SECRET');

if (!hash_equals(hash_hmac('sha256', $raw, $secret), $sig)) {
    http_response_code(401);
    exit;
}
$event = json_decode($raw, true);
// masukkan ke antrean, mis. Redis/database
http_response_code(200);

Ide pemanfaatan

• Deteksi anomali: lonjakan klik dari satu negara dalam semenit bisa berarti bot; kirim peringatan.
• Atribusi penjualan: cocokkan waktu klik dengan pesanan yang masuk untuk memperkirakan konversi per kanal.
• Lead scoring: klik dari link personal (/budi, /sari) langsung memperbarui CRM.
• Dashboard internal: tampilkan klik real-time di layar kantor saat peluncuran.

Data yang sama juga dapat ditarik secara berkala melalui API statistik; pilih webhook saat Anda butuh kecepatan, dan API saat butuh laporan lengkap. Lihat dokumentasi developer untuk detail kedua pendekatan.

Pertanyaan umum

Apakah setiap klik mengirim satu pesan Slack?

Secara default ya. Untuk link bervolume tinggi, pilih mode ringkasan per jam agar channel tidak dibanjiri, atau arahkan notifikasi ke webhook kustom dan buat agregasi sendiri sebelum mengirim ke Slack.

Bagaimana memastikan webhook benar-benar dari Kencang.in?

Setiap permintaan menyertakan tanda tangan HMAC berdasarkan secret yang tampil di dasbor. Hitung ulang HMAC dari body mentah dan bandingkan dengan header menggunakan perbandingan waktu-konstan sebelum memproses data.

Apa yang terjadi jika server saya sedang mati?

Kami mencoba ulang beberapa kali dengan jeda yang bertambah. Jika semua percobaan gagal, event dilewati dan tercatat sebagai gagal di dasbor. Statistik klik tetap tersimpan di Kencang.in dan bisa ditarik lewat API.

Bisakah satu link mengirim ke beberapa saluran?

Bisa. Satu link dapat dihubungkan ke Slack, Zapier, dan beberapa webhook kustom sekaligus. Setiap saluran menerima payload yang sama, sehingga tim marketing dan sistem internal mendapat data yang identik.