Integrasi Make

Rangkai skenario Make yang bereaksi terhadap event Se-Hari, atau memanggil API-nya, lewat modul HTTP dan webhook bawaan.

#Kenapa menghubungkannya

Make (dulu Integromat) memberi kendali percabangan dan penanganan error yang lebih rinci daripada kebanyakan alat serupa, dan itu berguna untuk alur yang perlu membedakan kegagalan yang layak diulang dari yang tidak.

#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 skenario dengan modul Webhooks → Custom webhook dan salin URL-nya
2. Daftarkan URL itu lewat POST /api/v1/webhooks
3. Picu satu event uji supaya Make bisa menentukan struktur datanya
4. Tambahkan modul HTTP → Make a request untuk memanggil endpoint Se-Hari lain

#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 Make"}'

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

Make menentukan struktur data dari kiriman pertama yang diterimanya. Kirim event uji dari dashboard sebelum merangkai modul berikutnya, supaya field yang tersedia sudah lengkap dan Anda tidak perlu mengulang pemetaan.

#Hal yang mudah terlewat

Sama seperti Zapier, verifikasi tanda tangan tidak dilakukan otomatis. Tambahkan pemeriksaan X-Sehari-Signature lewat modul Tools kalau skenario Anda menyentuh sistem produksi.

#Kredit dan keamanan

Buat API key khusus untuk integrasi Make 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 Make 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