Konfigurasi webhook

Arahkan Timemark ke endpoint Anda, pilih event dan proyek mana yang memicunya, lalu uji pengiriman.

When you’d do this

Anda ingin sistem Anda sendiri bereaksi saat sesuatu terjadi di Teamspace, misalnya untuk mencatat unggahan foto atau memicu proses lanjutan. Webhook membuat Timemark mengirim permintaan POST ke endpoint Anda setiap kali event yang dipilih terjadi.

What you need

Peran: Pemilik Tim
Platform: Web
Paket: Business
Berlaku untuk: Hanya terpicu untuk peristiwa yang terjadi setelah webhook dibuat

Siapkan webhook

Buka Teamspace → Pengaturan → Integrasi → Webhook.
Masukkan URL endpoint Anda. URL ini harus dapat diakses secara publik dan merespons permintaan POST.
Konfirmasikan trigger-nya. Webhook ini terpicu pada Foto baru saat ada foto baru yang diunggah.
Pilih cakupan: Semua foto, atau folder tertentu.
Simpan.

Uji pengiriman

Pada webhook yang baru saja Anda simpan, gunakan fungsi uji atau ping untuk mengirim contoh payload.
Periksa log endpoint Anda untuk memastikan payload sudah sampai.
Pastikan endpoint Anda mengembalikan respons 2xx.

Kolom yang dapat dikonfigurasi

Field	Fungsinya	Catatan
URL Endpoint	Tempat Timemark mengirim permintaan POST	Harus bersifat publik dan mengembalikan `2xx` dalam batas waktu
Trigger	Tindakan yang memicu sebuah pengiriman	Foto baru (`photo.uploaded`) saat ini adalah satu-satunya trigger. Lihat Jenis event webhook
Cakupan	Membatasi pemicu hanya pada satu folder, atau semua foto tim	Cakupan folder hanya terpicu untuk foto di folder tersebut

Common pitfalls

Tidak berlaku surut. Webhook hanya terpicu untuk event yang terjadi setelah webhook dibuat. Foto yang sudah ada sebelumnya tidak akan memicunya.
Endpoint harus mengembalikan 2xx tepat waktu. Timeout atau error dianggap sebagai pengiriman yang gagal. Timemark akan mencoba ulang pengiriman yang gagal, lalu berhenti setelah percobaan ulang habis.
Cakupan tidak cocok. Webhook yang cakupannya dibatasi ke satu folder tidak akan terpicu untuk foto di folder lain. Atur cakupan ke Semua foto jika Anda memerlukan semua folder.
Di balik firewall. Endpoint yang berada di balik VPN atau firewall tidak dapat diakses. Gunakan URL publik.