Webhook

Webhook adalah panggilan HTTP yang dipicu Sofia saat postingan tayang atau gagal. Gunakan untuk memasukkan konten ke spreadsheet, memberi tahu alat pesan, atau menjalankan skenario di Zapier atau n8n.

Menambahkan webhook

• 1. Beri alamat. Alamat https publik tempat Sofia mengirim peristiwa.
• 2. Pilih peristiwa. post.published dan post.failed.
• 3. Daftarkan. POST /v1/webhooks: rahasia tanda tangan (whsec_…) hanya ditampilkan dalam respons ini.
• 4. Kirim uji coba. POST /v1/webhooks/{id}/test mengirim peristiwa webhook.test, bertanda tangan seperti yang lain.

Permintaan lengkapnya dirinci di tab API: Mendaftarkan webhook. Hanya postingan yang dibuat oleh aplikasi Anda yang diumumkan.

Membangun penerima

Selalu kirim uji coba lebih dulu dan simpan isi yang diterima: itulah kontraknya, lebih andal daripada deskripsi mana pun. Sofia mengirim setiap peristiwa dengan POST dalam format JSON { id, type, createdAt, data }, dengan header Sofia-Event-Id, Sofia-Event-Type, dan Sofia-Signature.

• Verifikasi tanda tangan. Sofia-Signature bernilai t=<unix time>,v1=<hex>, dengan v1 adalah HMAC-SHA256 dari <t>.<raw body> menggunakan rahasia Anda. Hitung pada isi mentah dan tolak stempel waktu yang lama.
• Balas `2xx` dengan cepat, lalu kerjakan setelahnya: titik tujuan yang lambat tidak bisa dibedakan dari titik tujuan yang mati.
• Bersikap idempoten. Peristiwa yang sama bisa datang dua kali: deduplikasi berdasarkan Sofia-Event-Id.

Saat webhook tidak lagi terpicu

Alamat tidak bisa dijangkau

Sofia memanggil dari servernya: alamat harus berupa https publik. Pengalihan tidak pernah diikuti, dan 10 detik tanpa respons dianggap gagal.

Alamat mengembalikan kesalahan

Respons apa pun selain 2xx memicu percobaan ulang setelah 1 menit, 5 menit, 30 menit, dan 2 jam, hingga 5 kali percobaan. Lihat dulu log Anda sendiri, lalu reproduksi dengan POST /v1/webhooks/{id}/test.

Postingan tidak dibuat oleh aplikasi Anda

Webhook hanya mengumumkan postingan yang dibuat oleh aplikasi Anda; postingan yang dibuat di antarmuka tidak memicunya.

Baca juga

Webhook memberi tahu kapan Sofia bertindak. Untuk membuat Sofia bertindak, gunakan Sofia API, CLI sofia, atau server MCP (tab API dan Agents), atau Integrasi pihak ketiga.