Vivoldi Webhook — Pengiriman Event Real-Time
Kirim dan terima data event secara real-time untuk klik tautan, penggunaan kupon, dan stamp reward dengan stabil bahkan di lingkungan dengan traffic tinggi.
Mulai dari verifikasi tanda tangan HMAC-SHA256, pencegahan event duplikat, hingga retry otomatis — semuanya dirancang untuk memberikan stabilitas tingkat enterprise tanpa konfigurasi tambahan.
Apa Itu Vivoldi Webhook?
Vivoldi Webhook adalah sistem integrasi real-time antar server yang mengirim data event langsung ke endpoint Anda saat sebuah event terjadi.
Tanpa perlu melakukan API polling secara terpisah, data event langsung dikirim ke endpoint yang terdaftar di Vivoldi sehingga memungkinkan sinkronisasi data real-time yang cepat dan stabil.
💡 Mengapa menggunakan Webhook?
Metode API polling tradisional mengharuskan pengiriman request ke server secara berkala, sehingga dapat menyebabkan traffic API yang tidak diperlukan dan keterlambatan dalam mendeteksi event.
Vivoldi Webhook hanya memanggil server Anda saat event benar-benar terjadi, sehingga memungkinkan respons instan tanpa request yang tidak perlu.
Sangat cocok untuk workflow yang sensitif terhadap waktu seperti update CRM, pemrosesan pembayaran, dan marketing automation.
Cara Kerja Webhook
Webhook Vivoldi bekerja dalam empat tahap: deteksi event → pembuatan signature → pengiriman HTTPS → konfirmasi penerimaan.
Deteksi event
Saat event terjadi pada tautan, kupon, atau kartu stempel yang Webhook-nya diaktifkan, Vivoldi langsung mendeteksinya.
Pembuatan signature
Sebelum dikirim, Vivoldi membuat signature HMAC-SHA256 untuk payload dan menyertakannya dalam header permintaan.
Server Anda dapat memverifikasi signature ini untuk memastikan bahwa permintaan tersebut berasal dari Vivoldi.
Pengiriman HTTPS
Vivoldi mengirim permintaan POST ke Callback URL yang terdaftar. Batas waktu respons adalah 5 detik.
Konfirmasi penerimaan
Jika server Anda mengembalikan respons 2xx, pengiriman dianggap berhasil. Jika tidak ada respons atau server mengembalikan error HTTP, Vivoldi akan melanjutkan ke proses percobaan ulang di bawah ini.
Di mana Webhook dikonfigurasi?
Mengatur Webhook global saja tidak membuat event dikirim secara otomatis. Pengaturan global menentukan Callback URL dan Secret Key default yang digunakan untuk mengirim event. Event hanya dikirim jika Webhook diaktifkan pada tautan, kupon, atau kartu stempel terkait.
Jika grup tautan, grup kupon, atau kartu stempel memiliki konfigurasi Webhook sendiri, konfigurasi tersebut akan diprioritaskan daripada pengaturan global. Meskipun Webhook global dan individual sama-sama aktif, setiap event hanya dikirim satu kali.
Apa yang terjadi jika pengiriman gagal?
Pengiriman dianggap gagal jika kode status respons bukan 2xx atau tidak ada respons dalam waktu 5 detik.
Permintaan yang gagal akan dicoba ulang terlepas dari kode status respons, sehingga satu kegagalan pengiriman tidak langsung menonaktifkan Webhook.
Kegagalan pengiriman tidak langsung menonaktifkan Webhook.
Vivoldi akan terlebih dahulu mengirim notifikasi kegagalan melalui email, lalu memberikan masa tenggang selama 60 menit.
Jika server penerima kembali berfungsi normal dalam periode tersebut, Webhook tetap aktif dan pengiriman akan terus dilanjutkan.
| Tahap | Waktu | Tindakan |
|---|---|---|
| Percobaan ulang langsung | Setelah 1 dtk · 2 dtk | Percobaan ulang dilakukan untuk menangani gangguan jaringan sementara. Termasuk pengiriman awal, total dilakukan 3 kali percobaan. |
| Percobaan ulang tertunda | Setelah 10 mnt · 20 mnt | Percobaan ulang tambahan dilakukan untuk mengatasi server penerima yang dimulai ulang atau gangguan sementara. Termasuk pengiriman awal, dilakukan hingga 5 kali percobaan. |
| Notifikasi peringatan | Sekitar 30 mnt | Webhook tidak dinonaktifkan pada tahap ini. Notifikasi email dikirim dengan informasi tentang tujuan yang gagal dan penyebab kegagalan. |
| Masa tenggang | 60 mnt | Jika server penerima kembali normal selama masa tenggang, pengiriman akan dilanjutkan secara otomatis tanpa menonaktifkan Webhook. Event kupon dan kartu stempel yang terjadi selama masa tenggang juga dikirim secara berurutan. |
| Penonaktifan otomatis | Sekitar 90 mnt | Jika kegagalan pengiriman tetap terjadi setelah masa tenggang berakhir, status Webhook akan diubah menjadi Dinonaktifkan oleh sistem dan notifikasi email akan dikirim. |
Jika kegagalan terus terjadi dari endpoint penerima yang sama, pengiriman akan dijeda sementara dan Vivoldi melakukan pengiriman uji untuk memeriksa apakah server telah pulih.
Permintaan dikelola agar tidak terus menumpuk pada server penerima yang tidak merespons. Gangguan singkat seperti deployment pelanggan atau masalah sementara akan dipulihkan secara otomatis.
Event penggunaan kupon dan pemberian stempel tidak akan pernah hilang.
Karena merupakan event penting yang hanya terjadi satu kali, event tersebut akan disimpan dalam antrean selama proses percobaan ulang pengiriman atau saat terjadi pembatasan permintaan, lalu dikirim secara berurutan setelah pengiriman dapat dilanjutkan.
Event klik tautan terjadi secara berulang dan seluruh data analitik disimpan di Vivoldi. Oleh karena itu, tidak ada pengiriman tambahan yang dilakukan selama pembatasan pengiriman sementara.
Jika Webhook dinonaktifkan secara otomatis
Status Webhook dikelola dalam tiga kondisi.
Gunakan filter Webhook pada halaman daftar untuk melihat Webhook berdasarkan statusnya.
- Aktif Webhook berjalan normal dan event sedang dikirim.
- Dinonaktifkan Webhook telah dinonaktifkan secara manual oleh pengguna.
- Dinonaktifkan oleh sistem Webhook telah dinonaktifkan otomatis oleh Vivoldi karena kegagalan pengiriman yang berulang. Notifikasi email dikirim saat Webhook dinonaktifkan.
Status Dinonaktifkan oleh sistem dapat diaktifkan kembali dari dashboard setelah masalah pada server penerima diperbaiki.
Setelah diaktifkan kembali, pengiriman akan dilanjutkan untuk event baru. Event yang terjadi saat Webhook dinonaktifkan akan diproses sesuai kebijakan sebelumnya.
Fitur Utama Webhook
Otomatisasi Real-time
Otomatiskan alur kerja pemasaran, CRM, dan pembayaran Anda dengan pembaruan instan untuk kunjungan tautan, penggunaan kupon, serta penambahan & penukaran stempel.
Keamanan Enterprise
Mencegah pemalsuan dan serangan ulang pada acara Tautan, Kupon, dan Stempel melalui tanda tangan HMAC-SHA256, hash konten, dan verifikasi cap waktu.
Keandalan Operasional
Menjamin pemrosesan yang andal untuk acara Tautan, Kupon, dan Stempel bahkan saat terjadi gangguan sistem melalui pengiriman minimal satu kali, upaya ulang otomatis, notifikasi email, dan logika penonaktifan.
Ketersediaan berdasarkan paket
Webhook tersedia pada paket Premium dan paket yang lebih tinggi. Jumlah Webhook yang tersedia dibatasi berdasarkan jumlah target tempat Webhook dapat diaktifkan.
| Gratis · Personal | Premium | Business | Business Plus | Enterprise | |
|---|---|---|---|---|---|
| Penggunaan Webhook | — | ✓ | ✓ | ✓ | ✓ |
| Tautan individual | — | 1 | 5 | 1 untuk setiap 1,000 tautan per bulan (maks. 50) |
Tidak terbatas |
| Grup tautan | — | — | — | — | Tidak terbatas |
| Kupon individual | — | Tidak terbatas | Tidak terbatas | Tidak terbatas | Tidak terbatas |
| Grup kupon | — | — | Tidak terbatas | Tidak terbatas | Tidak terbatas |
| Kartu stempel | — | 1 | 5 | 1 untuk setiap 1,000 tautan per bulan (maks. 50) |
Tidak terbatas |
| Permintaan per menit / jam | — | 240 / 12,000 | 384 / 20,000 | Mulai dari 614 / 32,000 | Mulai dari 960 / 48,000 |
Batas permintaan Webhook ditetapkan sebesar 80% dari batas permintaan API.
Pada paket Business Plus, jumlah Webhook yang tersedia meningkat berdasarkan batas pembuatan tautan bulanan yang dipilih.
Paket Enterprise disediakan melalui kesepakatan khusus berdasarkan kebutuhan penggunaan.
Lihat batas permintaan berdasarkan paket untuk informasi detail.
Webhook grup tautan hanya tersedia pada paket Enterprise.
Saat Webhook diaktifkan pada grup tautan, Webhook tersebut akan otomatis diterapkan ke semua tautan yang termasuk dalam grup tersebut.
Beralih ke paket yang lebih tinggi akan langsung memperluas batas penggunaan Webhook.
Jika beralih ke paket yang lebih rendah dan terdapat target yang melebihi batas baru, target yang lebih lama akan dinonaktifkan secara otomatis terlebih dahulu. Daftar target yang dinonaktifkan akan dikirim melalui email.
Meskipun akun berubah ke paket Gratis setelah masa langganan berakhir, pengaturan Webhook tetap tersimpan dan akan aktif kembali secara otomatis tanpa pengaturan tambahan saat berlangganan paket berbayar lagi.
✨ Integrasi Real-time Tingkat Enterprise
Dioptimalkan untuk lingkungan enterprise yang menangani pemrosesan event tautan, kupon, dan stamp dalam skala besar.
Dibangun di atas infrastruktur high-availability dan sistem queueing yang andal, Vivoldi memastikan integrasi stabil dengan platform CRM, pembayaran, dan analitik tanpa kehilangan event, bahkan saat terjadi lonjakan traffic mendadak.