Webhooks

Webhooks memungkinkan Shifton mengirim notifikasi secara real-time ke sistem eksternal saat terjadi peristiwa di perusahaan Anda.

Petunjuk Langkah demi Langkah

Mengakses tab Webhooks

Di panel navigasi kiri, klik Integrasi.

Buka halaman Pengembang → tab Webhook.

Membuat webhook baru

Klik «Webhook baru».

Isi konfigurasi:

Kolom	Keterangan
URL	Endpoint untuk menerima data peristiwa
Acara	Peristiwa Shifton yang mengaktifkan webhook
Aktif	Sakelar untuk mengaktifkan/menonaktifkan

Simpan. Shifton akan mengirim permintaan HTTP POST ke URL yang ditentukan.

Mengelola webhooks

Klik pada webhook untuk mengedit URL, memperbarui peristiwa, atau mengubah status aktivitas.

Menguji webhook

Picu peristiwa yang sesuai di Shifton (misalnya, buat shift percobaan).

Periksa log server — data harus masuk.

Pertanyaan yang Sering Diajukan

T: Dalam Bentukat apa pergeseranon mengirim data?
HTTP POST dengan body dalam format JSON. Struktur data untuk setiap jenis peristiwa lihat di dokumentasi API.

T: Bisakah membuat beberapa webhook untuk Sabu peristiwa?
Ya, dengan URL yang berbeda.

T: Apa yang terjadi jika server tidak tersedia saat webhook dipicu?
Pengiriman mungkin gagal. Detail tentang kebijakan percobaan ulang — di dokumentasi API.

T: Webhook tidak dipicu — mengapa?
Pastikan sakelar Aktif aktif dan URL dapat diakses secara publik.

T: Bagaimana cara memeriksa bahwa webhook menerima data?
Buat peristiwa percobaan di Shifton (misalnya, tambahkan shift) dan periksa log server Anda untuk permintaan POST masuk.

T: Bisakah mengonfigurasi autentikasi webhook?
Ya. Tambahkan kunci rahasia atau token ke URL atau header webhook. Detail di dokumentasi API.

T: Seperti apa body permintaan webhook?
Objek JSON dengan data peristiwa. Struktur tergantung pada jenis peristiwa — lihat dokumentasi API untuk contoh.

T: Bisakah Sabu webhook melacak beberapa peristiwa?
Ya. Saat membuat webhook, pilih beberapa peristiwa — satu URL akan menerima notifikasi untuk semua yang dipilih.

T: Apa itu «kebijakan percobaan ulang» untuk webhook?
Jika server mengembalikan kesalahan (bukan 200), Shifton dapat mengulangi permintaan. Detail tergantung pada konfigurasi platform.

T: Apakah ada batas jumlah webhook?
Batasan jumlah tidak disebutkan dalam dokumentasi, tetapi disarankan untuk membuat hanya yang diperlukan.

T: Apakah perlu menggunakan HTTPS untuk URL webhook?
Disarankan. Alamat HTTP mungkin berfungsi, tetapi HTTPS memastikan transfer data yang aman.

T: Bisakah menerima notifikasi webhook setiap kali jadwal berubah?
Ya. Tambahkan peristiwa seperti «Shift dibuat» atau «schedule updated» saat mengonfigurasi webhook.

T: Siapa yang memiliki akses untuk membuat webhook?
Hanya Owner. Manajer dan karyawan tidak melihat bagian Developer.

T: Bisakah menonaktifkan webhook tanpa menghapusnya?
Ya. Matikan sakelar Aktif di pengaturan webhook — webhook berhenti dipicu tetapi mempertahankan konfigurasi.

T: Apakah pemicuan webhook dicatat di pergeseranon?
Log detail pengiriman webhook tidak disediakan dalam antarmuka. Pelacakan — di sisi server Anda.

T: Bisakah memfilter webhook berdasarkan proyek atau jadwal?
Tidak. Webhook dipicu untuk semua peristiwa dari jenis yang dipilih di seluruh perusahaan. Pemfilteran — di sisi server penerima.

T: Apa yang terjadi dengan webhook saat perusahaan dihapus?
Semua webhook dihapus bersama perusahaan.