Pemberitahuan Klik Masa Nyata ke Slack dan Webhook

Statistik dalam papan pemuka menjawab soalan "berapa banyak". Pemberitahuan masa nyata menjawab "apa yang berlaku sekarang". Apabila kempen baharu bermula, pasukan ingin mengetahui klik pertama yang masuk, asalnya dan sama ada iklan benar-benar berjalan. Kencang.in menyokong tiga saluran pemberitahuan: Slack, Zapier dan webhook tersuai ke pelayan anda sendiri.

Dayakan saluran pemberitahuan

Pergi ke papan pemuka, menu Saluran atau Integrasi, kemudian pilih saluran yang ingin anda sambungkan. Setiap pautan boleh diarahkan ke satu atau lebih saluran. Pemberitahuan tersedia pada pelan Pro dan Business; tengok halaman harga.

Slack

1. Klik Sambung Slack dan benarkan aplikasi Kencang.in mengakses ruang kerja anda.
2. Pilih saluran destinasi, contohnya #kampanye.
3. Dalam tetapan pautan, dayakan pemberitahuan dan pilih saluran Slack.

Setiap klik menghantar mesej ringkas: alias, lokasi, peranti dan sumber rujukan. Untuk pautan volum tinggi, gunakan ringkasan setiap jam untuk mengelak daripada mengisi saluran. Selain pemberitahuan klik, anda juga boleh membuat pautan terus dari Slack dengan arahan /kencang https://... selepas aplikasi dipasang. Dokumentasi API Slack berada di api.slack.com.

Zapier

Sambungkan Zapier dalam menu Integrasi, kemudian buat Zap dalam Zapier dengan pencetus "Kencang.in: New Click" (atau Webhooks by Zapier "Catch Hook" dengan URL yang kami sediakan). Dari sini, data klik boleh dihantar ke mana-mana: baris baharu dalam Google Sheets, kad dalam Trello, mesej dalam WhatsApp Business API atau e-mel. Cara menyambungkan Zapier dalam arah sebaliknya, iaitu membuat pautan automatik, dibincangkan dalam artikel Zapier dan Google Sheets.

Webhook tersuai

Untuk penyepaduan terus ke dalam sistem anda, masukkan URL titik akhir HTTPS. Setiap klik menghantar permintaan POST dengan badan JSON.

Titik akhir anda patut membalas status 2xx dalam beberapa saat. Jika gagal, kami mencuba semula beberapa kali dengan jeda yang semakin panjang. Amalan terbaik pada pihak penerima:

• Balas cepat, proses kemudian. Terima muatan, masukkan ke baris gilir, balas 200, kemudian proses dalam worker. Jangan lakukan kerja berat dalam permintaan.
• Sahkan sumber. Kami menyertakan pengepala tandatangan HMAC berdasarkan rahsia yang dipaparkan dalam papan pemuka. Kira semula HMAC badan mentah dan bandingkan sebelum diproses. Gunakan perbandingan masa tetap seperti hash_equals() dalam PHP.
• Idempoten. Oleh sebab terdapat mekanisme cuba semula, peristiwa yang sama boleh tiba dua kali. Simpan ID peristiwa atau gabungan alias + masa untuk mengesan pendua.
• Gunakan HTTPS dengan sijil yang sah. Webhooks ke HTTP biasa ditolak.

Prinsip umum untuk mereka bentuk penerima webhook yang boleh dipercayai diringkaskan dengan baik dalam Panduan amalan terbaik webhook GitHub, dan kebanyakannya digunakan untuk mana-mana perkhidmatan.

Contoh penerima minimum (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);

Idea penggunaan

• Pengesanan anomali: lonjakan dalam klik dari satu negara dalam seminit boleh bermakna bot; hantar makluman.
• Atribusi jualan: padankan masa klik dengan pesanan masuk untuk menganggarkan penukaran bagi setiap saluran.
• Pemarkahan prospek: klik dari pautan peribadi (/budi, /sari) kemas kini CRM serta-merta.
• Papan pemuka dalaman: tunjukkan klik masa nyata pada skrin pejabat semasa pelancaran.

Data yang sama juga boleh ditarik secara berkala melalui API statistik; pilih webhooks apabila anda memerlukan kelajuan dan API apabila anda memerlukan laporan lengkap. Tengok dokumentasi pembangun untuk butiran kedua-dua pendekatan.

Soalan lazim

Adakah setiap klik menghantar satu mesej Slack?

Secara lalai ya. Untuk pautan volum tinggi, pilih mod ringkasan setiap jam supaya saluran tidak dibanjiri, atau teruskan pemberitahuan ke webhook tersuai dan buat pengagregatan anda sendiri sebelum dihantar ke Slack.

Bagaimana untuk memastikan webhook benar-benar daripada Kencang.in?

Setiap permintaan termasuk tandatangan HMAC berdasarkan rahsia yang muncul dalam papan pemuka. Kira semula HMAC badan mentah dan bandingkan dengan pengepala menggunakan perbandingan masa malar sebelum memproses data.

Apakah yang berlaku jika pelayan saya tidak beroperasi?

Kami mencuba semula beberapa kali dengan jeda yang semakin panjang. Jika semua percubaan gagal, peristiwa dilangkau dan direkodkan sebagai gagal dalam papan pemuka. Statistik klik tetap disimpan di Kencang.in dan boleh diambil melalui API.

Bolehkah satu pautan dihantar ke berbilang saluran?

Boleh. Satu pautan boleh disambungkan ke Slack, Zapier dan beberapa webhook tersuai serentak. Setiap saluran menerima muatan yang sama, supaya pasukan pemasaran dan sistem dalaman mendapat data yang seragam.