Webhook dan Event

Webhook adalah layanan notifikasi sistemik yang memungkinkan integrasi asinkron antar sistem — Unico IDCloud memberi tahu backend Anda setiap kali proses berubah status, sehingga Anda tidak perlu melakukan polling untuk mendapatkan pembaruan.

Bagian ini mencakup empat hal yang Anda butuhkan untuk mengintegrasikan webhook: cara mengatur endpoint dan autentikasi, event yang dikirim Unico, strategi fallback, serta pola keamanan dan keandalan yang harus diterapkan oleh endpoint Anda.

Kapan menggunakan webhook

Webhook adalah cara yang direkomendasikan untuk mendapatkan notifikasi penyelesaian proses. Webhook sangat relevan untuk:

• Alur visual (SDK / Web Redirect / iFrame) — untuk mengetahui kapan pengguna menyelesaikan perjalanan.
• Alur Web & SDK asinkron — untuk mendapatkan notifikasi ketika POST /client/v1/process selesai diproses di sisi Unico.
• Alur berdurasi panjang yang menggabungkan beberapa kapabilitas (mis., analisis dokumen + tinjauan manual). Webhook hanya aktif pada status terminal (PROCESS_STATE_FINISHED); tidak ada event progres perantara yang dikirimkan.

Webhook melengkapi, tetapi tidak menggantikan, endpoint GetProcess. Lihat Fallback.

Di bagian ini

• Setup — pendaftaran endpoint, metode autentikasi (OAuth2, Basic, API Key), pengaturan retry.
• Jenis event — event yang dikirim Unico dan struktur payload.
• Keamanan — idempotency, batas konkurensi, dan tingkat error.
• Fallback — cara mengambil hasil proses ketika webhook tidak tersedia.