Kirim acara ke sistem Anda sendiri dengan webhooks
Tambahkan endpoint, pilih acara, verifikasi tanda tangan, uji dan baca log pengiriman.
Webhook memungkinkan IDup memanggil alamat web Anda saat sesuatu terjadi, misalnya ketika faktur dibayar. Setiap pengiriman ditandatangani dan diulang jika sistem Anda tidak menjawab.
Tambahkan endpoint
- Buka Webhook tab dan tekan Tambahkan endpoint.
- Masukkan Nama dan URL. Ini harus dapat diakses secara publik. Alamat di dalam jaringan pribadi ditolak karena alasan keamanan.
- Centang Acara yang Anda inginkan.
- Opsional: pilih sebuah Kunci API. Endpoint kemudian hanya menerima peristiwa yang dapat dibaca oleh kunci ini.
- Tekan Simpan. IDup menampilkan Rahasia penandatanganan Anda sekali. Simpan dengan aman.
Acara
- Faktur dibuat, Faktur dibayar, Pembayaran diterima
- Pelanggan baru, Kontak baru, Prospek baru, Tiket baru
- Penawaran diterima — penawaran harga yang diterima pelanggan
Setiap pengiriman memiliki tiga header: nama acara, nomor pengiriman, dan tanda tangan. Pengulangan menggunakan nomor pengiriman yang sama, sehingga sistem Anda dapat mengenali duplikat.
Periksa tanda tangan
Sistem Anda harus menghitung HMAC-SHA256 atas waktu dan badan mentah dengan rahasia Anda, membandingkannya dengan tanda tangan, dan menolak waktu yang lebih lama dari 5 menit. Tekan Verifikasi tanda tangan dan contoh untuk kode siap pakai.
Uji, jeda, dan perbarui
- Kirim tes mengirim acara uji coba dan menunjukkan kode HTTP serta waktu yang dibutuhkan.
- Jeda menghentikan pengiriman; Aktifkan memulainya kembali.
- Rahasia roll membuat rahasia baru. Yang lama berhenti berfungsi segera.
- Hapus menghapus endpoint. Log-nya disimpan.
Percobaan ulang dan log
Alamat Anda harus merespons dengan kode 2xx dalam waktu 5 detik. Pengalihan tidak diikuti. Jika gagal, IDup mencoba lagi setelah 1 menit, 5 menit, 30 menit, 2 jam, dan 12 jam. Setelah percobaan keenam, pengiriman ditandai Menyerah.
Log menunjukkan setiap percobaan dengan acara, titik akhir, percobaan, kode HTTP, durasi, dan awal jawaban. Status adalah Menunggu, Terkirim, Gagal atau Menyerah. Gunakan Kirim ulang untuk mengirimkan pengiriman lagi.
Tidak ada yang dilacak — tombol hanya membuka pesan sehingga Anda dapat memberi tahu kami apa yang hilang.
