osFoundry / Platform
Webhook keluar
Sebarkan event platform ke endpoint Anda sendiri. Auto-retry, verifikasi tanda tangan.
Apa itu
Webhook keluar memungkinkan osFoundry mendorong event ke endpoint yang Anda kendalikan. Alih-alih terus melakukan polling untuk mendeteksi perubahan, Anda mendaftarkan sebuah URL dan osFoundry mengirim permintaan HTTP ke URL itu setiap kali terjadi event yang relevan di ruang kerja Anda. Dengan begitu, aktivitas di permukaan chat, agen, aplikasi, kode, pengetahuan, dan data Anda menjadi sinyal yang bisa ditindaklanjuti oleh sistem Anda sendiri, tanpa harus merangkai integrasi khusus untuk masing-masing.
Di dalam osFoundry, webhook berada di bawah Pengaturan dan Keamanan karena melintasi batas kepercayaan: webhook membawa event ruang kerja keluar menuju penerima milik Anda. Setiap pengiriman ditandatangani, sehingga endpoint Anda dapat memverifikasi bahwa permintaan itu benar-benar berasal dari osFoundry dan tidak diubah selama transit. Periksa tanda tangan terhadap secret bersama Anda sebelum mempercayai isi payload. Pengiriman yang gagal, entah karena endpoint Anda mati, lambat, atau mengembalikan error, akan dicoba ulang secara otomatis alih-alih dibuang, sehingga gangguan singkat di sisi Anda tidak diam-diam menghilangkan event. Karena osFoundry bersifat local-first dan BYOK, webhook adalah cara yang disengaja dan opt-in untuk memindahkan data keluar: Anda yang menentukan endpoint mana yang menerima event, dan payload hanya menuju ke tempat yang Anda arahkan.
Manfaat praktisnya adalah pemisahan (decoupling). Layanan notifikasi, sistem tiket, gudang data, atau automasi internal Anda tidak perlu berada di dalam osFoundry maupun menyimpan kredensial osFoundry. Cukup menyediakan endpoint HTTPS yang memverifikasi tanda tangan dan mengembalikan status sukses. Verifikasi tanda tangan ditambah percobaan ulang otomatis itulah yang membuat endpoint tersebut aman dipercaya dan dapat diandalkan, dan itu pula yang membedakan webhook yang bisa Anda jadikan fondasi alur kerja dengan webhook yang harus terus Anda awasi.
Kemampuan utama
- Daftarkan endpoint HTTPS milik Anda dan terima event platform saat kejadian itu berlangsung, tanpa perlu memelihara loop polling
- Setiap payload ditandatangani, sehingga penerima Anda dapat memverifikasi bahwa permintaan berasal dari osFoundry sebelum menindaklanjutinya
- Pengiriman yang gagal dicoba ulang otomatis, sehingga gangguan di sisi hilir tidak diam-diam menghilangkan event
- Dikelola di bawah Pengaturan dan Keamanan sebagai jalur keluar opt-in per endpoint yang sepenuhnya Anda kendalikan
- Sesuai dengan model local-first dan BYOK: data hanya keluar ke endpoint yang Anda tunjuk secara eksplisit
Kasus penggunaan
- Platform engineer: meneruskan event ruang kerja ke layanan automasi internal tanpa memberinya kredensial osFoundry atau menyematkannya di dalam aplikasi
- Ops/on-call: menyalurkan event ke sistem alerting atau notifikasi yang sudah ada agar orang yang tepat mengetahui aktivitas secara real time
- Tim data: mengalirkan event ke gudang data atau endpoint ETL agar catatan eksternal tetap sinkron dengan apa yang terjadi di ruang kerja
Pertanyaan yang sering diajukan
Bagaimana cara memverifikasi bahwa permintaan webhook benar-benar berasal dari osFoundry?
Setiap pengiriman ditandatangani. Endpoint Anda menghitung ulang tanda tangan atas isi permintaan menggunakan secret bersama Anda, lalu membandingkannya dengan tanda tangan yang dikirim osFoundry. Jika tidak cocok, tolak permintaan itu. Inilah yang mencegah pihak ketiga memalsukan event ke endpoint Anda.
Apa yang terjadi jika endpoint saya mati saat sebuah event terpicu?
osFoundry mencoba ulang pengiriman secara otomatis alih-alih membuangnya, sehingga gangguan singkat atau proses deploy di sisi Anda tidak membuat Anda kehilangan event. Endpoint Anda sebaiknya mengembalikan status sukses setelah menerima payload.
Apakah memakai webhook mengirim data saya ke suatu tempat yang dikendalikan osFoundry?
Tidak. osFoundry bersifat local-first dan BYOK, dan webhook mengarah keluar ke endpoint yang Anda daftarkan. Event hanya menuju URL yang Anda konfigurasikan, dan Anda mengendalikan endpoint mana yang ada. Ini adalah cara opt-in untuk memindahkan event tertentu ke sistem yang sudah menjadi milik Anda.