# Otomasi Webhook
SUMMARY: Picu sistem eksternal saat memori berubah — sinkronisasi, notifikasi, otomasi.

Otomasi Webhook
Webhook memungkinkan Anda memicu sistem eksternal saat event Synapse aktif.
Panduan ini mencakup pola otomasi umum.
Pola Umum
Pola 1: Notifikasi pada Memori Critical
Kirim pesan Slack saat memori critical disimpan:
[CODE BLOCK]
Daftarkan webhook:
[CODE BLOCK]
Pola 2: Sinkronisasi ke Sistem Eksternal
Sinkronkan memori ke Notion, Obsidian, atau KB eksternal apa pun:
[CODE BLOCK]
Pola 3: Picu CI/CD
Picu deployment saat memori "release" disimpan:
[CODE BLOCK]
Pola 4: Bangunkan Agen pada Pesan Manusia
Picu menjalankan agen LLM saat manusia mengirim pesan chat:
[CODE BLOCK]
Pola 5: Agregasi Metrik
Lacak pertumbuhan memori, aktivitas chat, penyelesaian tugas:
[CODE BLOCK]
Verifikasi Tanda Tangan
Selalu verifikasi tanda tangan webhook untuk mencegah spoofing:
[CODE BLOCK]
Logika Coba Ulang
Synapse mencoba ulang webhook yang gagal dengan exponential backoff. Handler Anda harus:
1. Mengembalikan 200 dengan cepat — jangan lakukan pekerjaan berat secara sinkron
2. Antri pekerjaan — gunakan sistem pekerjaan latar belakang
3. Idempoten — event yang sama mungkin dikirim dua kali
[CODE BLOCK]
Debugging Webhook
Periksa riwayat pengiriman
Pengiriman webhook dicatat. Periksa pengiriman webhook terbaru Anda:
[CODE BLOCK]
Tes webhook secara manual
[CODE BLOCK]
Masalah umum
| Masalah | Perbaikan |
|-------|-----|
| Respons 4xx | Periksa handler Anda mengembalikan 200 |
| Respons 5xx | Error server — periksa log aplikasi Anda |
| Timeout | Kembalikan 200 cepat, antri pekerjaan asinkron |
| Pengiriman duplikat | Buat handler idempoten |
| Ketidakcocokan tanda tangan | Verifikasi secret benar |
Praktik Terbaik
> [!TIP]
> - Selalu verifikasi tanda tangan — jangan pernah lewati ini
> - Kembalikan 200 cepat — jangan blokir Synapse
> - Idempoten — tangani pengiriman duplikat
> - Gunakan event spesifik —  bukan 
> - Pantau kegagalan pengiriman — siapkan peringatan
Langkah Berikutnya
- Webhooks API
- Cron & Scheduler
- Agen LLM Persisten