Integrasi Zapier

Se-Hari belum punya app resmi di Zapier, tapi Webhooks by Zapier sudah cukup untuk merangkai alur yang sama.

#Kenapa menghubungkannya

Zapier tetap pilihan praktis untuk tim tanpa infrastruktur sendiri: tidak ada yang perlu di-hosting, dan ratusan aplikasi tersedia langsung. Untuk alur sederhana seperti "notulen selesai → kirim ke Slack", ia bekerja tanpa satu pun server milik Anda.

#Cara kerjanya

Se-Hari belum punya aplikasi resmi di platform ini, tapi API-nya berbentuk JSON biasa dan webhook-nya berbentuk POST standar — keduanya bisa dipakai lewat modul HTTP dan webhook bawaan platform tersebut.

#Langkah pemasangan

1. Buat Zap dengan trigger Webhooks by Zapier → Catch Hook dan salin URL-nya
2. Daftarkan URL itu lewat POST /api/v1/webhooks dengan event yang Anda inginkan
3. Jalankan uji lewat tombol Kirim uji di dashboard supaya Zapier menangkap bentuk datanya
4. Rangkai langkah berikutnya dengan aplikasi tujuan Anda

#Mendaftarkan webhook secara manual

Node trigger n8n melakukan ini otomatis saat workflow diaktifkan. Kalau Anda merangkainya sendiri, atau sekadar ingin tahu apa yang terjadi di baliknya, ini padanannya:

curl -X POST "https://se-hari.com/api/v1/webhooks" \
  -H "Authorization: Bearer $SEHARI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://hooks.contoh.com/xxxx","event_types":["note.completed","note.failed"],"description":"Integrasi Zapier"}'

Responsnya memuat secret yang hanya ditampilkan sekali. Simpan sekarang — ia dibutuhkan untuk memverifikasi tanda tangan setiap kiriman. Kalau hilang, POST /webhooks/{id}/rotate-secret memberi yang baru.

#Yang perlu disesuaikan

Untuk memanggil Se-Hari dari Zapier — misalnya membuat notulen dari rekaman — pakai Webhooks by Zapier → Custom Request dengan header Authorization: Bearer sh_live_.... Semua endpoint kami berbentuk JSON biasa, jadi tidak ada yang khusus.

#Hal yang mudah terlewat

Zapier tidak memverifikasi tanda tangan webhook untuk Anda. Siapa pun yang menebak URL Catch Hook bisa mengirim data palsu ke Zap Anda. Kalau alurnya menyentuh sesuatu yang penting, tambahkan langkah Code yang memeriksa header X-Sehari-Signature sebelum melanjutkan.

#Kredit dan keamanan

Buat API key khusus untuk integrasi Zapier ini, jangan memakai ulang key yang sudah dipakai sistem lain. Manfaatnya baru terasa saat ada masalah: key yang dicabut hanya mematikan satu integrasi, log aktivitas menunjukkan integrasi mana yang melakukan apa, dan batas kredit harian bisa disesuaikan per integrasi. Pasang batas kredit harian pada key tersebut. Angkanya tidak perlu presisi — beberapa kali lipat pemakaian normal sudah cukup. Kalau suatu saat key itu bocor atau ada alur yang salah rakit, kerugian Anda berhenti di angka itu alih-alih di saldo yang habis. Beri scope sesempit mungkin. Scope tidak bisa ditambahkan ke key yang sudah ada — itu disengaja, supaya key yang bocor tidak bisa menjadi lebih berbahaya dari waktu ke waktu.

#Kalau tidak berfungsi

Tiga tempat yang perlu diperiksa, dalam urutan ini:

1. Tab Aktivitas di dashboard developer — apakah request-nya sampai sama sekali, dan apa status responsnya
2. Tab Webhooks — kalau integrasi ini memakai event, riwayat pengiriman menampilkan kode respons dari sistem Zapier Anda
3. Riwayat eksekusi di alat otomasi Anda — bentuk data yang benar-benar diterima tiap langkah Kalau yang muncul adalah kode error dari Se-Hari, setiap kode punya halaman penjelasannya sendiri di daftar kode error, lengkap dengan penyebab yang paling sering dan cara memperbaikinya.

#Integrasi lain

• Semua integrasi
• Galeri resep n8n
• Referensi API — kalau Anda memilih merangkainya sendiri