Webhook Keluar

Webhook membuat FreeMaint mengirim POST ke URL yang Anda kendalikan begitu sesuatu terjadi, sehingga sistem lain (ERP, penagihan, persediaan, akuntansi, kanal chat) tetap selaras tanpa ada yang mengetik ulang. Atur dari /company-settings/webhooks. Starter dibatasi 100 pengiriman/hari; Business ke atas tanpa batas. Untuk rujukan payload lengkap, lihat API & GraphQL > Webhook.

Event yang tersedia

• work_order.created — sebuah perintah kerja dibuat
• work_order.completed — sebuah perintah kerja berpindah ke Selesai
• work_order.status_changed — sebuah perintah kerja berpindah ke status apa pun; work_order.completed tetap dipicu juga
• request.created — sebuah permintaan pemeliharaan dikirim
• request.status_changed — sebuah permintaan disetujui, ditolak, atau dibatalkan
• part.low_stock — sebuah suku cadang turun ke titik pemesanan ulang atau di bawahnya
• part.out_of_stock — stok sebuah suku cadang habis (nol)
• part.low_stock_summary — sekali sehari, suku cadang yang berada pada titik pemesanan ulang atau di bawahnya, termasuk yang tidak pernah bergerak
• part.out_of_stock_summary — sekali sehari, suku cadang yang stoknya nol
• part.consumed — dipakai pada perintah kerja, atau dikembalikan darinya
• compliance.chain_divergence — rantai hash audit terputus (Enterprise)
• asset.downtime_started — sebuah penghentian mesin dibuka
• asset.downtime_ended — sebuah penghentian mesin ditutup
• report.daily_summary — pekerjaan yang selesai hari itu, sekali sehari pada jam yang Anda pilih
• purchase_order.created — sebuah pesanan pembelian dibuat
• purchase_order.status_changed — sebuah pesanan pembelian berpindah ke status lain (disetujui, dipesan, dibatalkan…)
• purchase_order.received — sebuah pengiriman diterima untuk suatu pesanan pembelian, termasuk pengiriman sebagian

Semantik pengiriman

• POST dengan body JSON: { event, timestamp, data }
• Header X-FreeMaint-Signature — t=<detik unix>,v1=<hex>, dengan v1 adalah HMAC-SHA256 dari «<t>.<body mentah>» memakai secret webhook Anda sebagai kunci. Verifikasi pada setiap permintaan, terhadap body mentah
• X-FreeMaint-Event dan X-FreeMaint-Delivery-Id juga dikirim
• Galat jaringan dan 5xx diulang hingga 3 kali dengan backoff eksponensial (sekitar 2 dtk, 4 dtk, 8 dtk); 4xx adalah penolakan permanen dan tidak diulang
• Setiap percobaan dicatat di bawah webhook dengan status, kode respons, dan jumlah percobaan — dan setiap pengiriman yang sudah selesai bisa dikirim ulang dari sana
• Foto opsional: dengan "Sertakan foto" aktif, peristiwa "work_order" dan "request" membawa hingga 4 tautan gambar dalam kolom "photos", berlaku 7 hari bagi siapa pun yang memilikinya — aktifkan hanya untuk endpoint yang Anda kendalikan

Konfigurasi

1. Buka /company-settings/webhooks — Memerlukan izin pengaturan perusahaan atau izin "Mengelola integrasi".
2. Klik «Tambah Webhook» — Beri nama, URL https://, lalu centang event yang diinginkan.
3. Salin secret penanda tangan — Hanya ditampilkan SEKALI saat dibuat. Nanti Anda bisa membuat yang baru lewat «Rotasi secret», yang membatalkan yang lama.
4. Pantau pengiriman — Buka riwayat pengiriman webhook untuk memastikan event sampai dan mengirim ulang yang gagal.

Batas per paket

• Starter — 100 pengiriman/hari per perusahaan (penghitung direset pukul 00:00 UTC)
• Business — tanpa batas
• Enterprise — tanpa batas
• Penghitung menghitung PERCOBAAN: tiga webhook pada event sama memakai tiga unit