Webhook

Webhook Voxpanda mengirim POST JSON bertanda tangan ke URL Anda saat sesuatu terjadi di workspace, misalnya post terbit, komentar baru, atau balasan otomatis. Pakai untuk menghubungkan Voxpanda ke Zapier, Make, n8n, CRM, atau server Anda sendiri. Pemilik dan admin mengelola webhook di API & MCP, bagian Webhook.

Tambah webhook

1. Buka API & MCP di menu.
2. Di Webhook, isi URL endpoint. Harus diawali https://.
3. Isi Keterangan agar tim tahu fungsi endpoint ini.
4. Centang Kejadian yang Anda perlukan.
5. Pilih Tambah webhook.
6. Salin rahasia penandatangan. Diawali whsec_ dan hanya ditampilkan sekali.

Kirim uji mengantrekan kejadian webhook.test agar Anda bisa mengecek penerima sebelum kejadian sungguhan datang.

Kejadian

Bentuk pengiriman

Setiap pengiriman adalah POST dengan isi JSON:

{
  "id": "6f1c0d6e-1d1a-4b51-9d0e-3f1a5c0d9e21",
  "event": "comment.received",
  "created_at": "2026-10-25T04:05:19Z",
  "workspace_id": "…",
  "brand_id": "…",
  "data": { "platform": "instagram", "kind": "comment", "author": "sari", "text": "Harganya berapa?" }
}

Permintaan membawa tiga header:

• Voxpanda-Event: nama kejadian.
• Voxpanda-Delivery: id pengiriman. Tetap sama saat Voxpanda mencoba ulang, jadi pakai untuk menyaring duplikat.
• Voxpanda-Signature: t=<waktu unix>,v1=<tanda tangan>.

Verifikasi tanda tangan

Tanda tangan adalah HMAC-SHA256 dalam hex dari teks t.body: nilai t, titik, lalu isi permintaan apa adanya. Kuncinya adalah rahasia whsec_ lengkap. Tolak permintaan yang lebih tua dari 5 menit.

import crypto from 'node:crypto';

function verify(secret, rawBody, header) {
  const parts = Object.fromEntries(header.split(',').map((p) => p.split('=')));
  if (Math.abs(Date.now() / 1000 - Number(parts.t)) > 300) return false;
  const mac = crypto.createHmac('sha256', secret).update(`${parts.t}.${rawBody}`).digest('hex');
  return mac.length === parts.v1.length && crypto.timingSafeEqual(Buffer.from(mac), Buffer.from(parts.v1));
}

Pakai isi permintaan persis seperti yang diterima. Mengurai JSON lalu mencetaknya lagi mengubah byte sehingga tanda tangan tidak cocok.

Balas dengan cepat

Balas dengan status 2xx apa pun dalam 10 detik. Voxpanda tidak mengikuti redirect dan hanya membaca maksimal 4 KB balasan Anda. Kerjakan proses yang lama setelah membalas.

Coba ulang dan mati otomatis

Setelah percobaan keenam gagal, pengiriman ditandai Menyerah. Bila sebuah endpoint gagal 25 kali berturut-turut, Voxpanda mematikannya dan menampilkan alasannya. Perbaiki penerima, lalu pilih Aktifkan. Hitungan gagal kembali ke nol.

Ganti rahasia

Pilih Rahasia baru untuk membuat rahasia penandatangan baru. Rahasia lama langsung tidak berlaku, jadi segera perbarui penerima Anda.