Webhook impor peserta
Kirim data peserta dari platform tiket atau CRM langsung ke event Octago. Setiap pengiriman ditandatangani dengan HMAC agar tidak bisa dipalsukan.
1. Buat sumber webhook
Admin EO membuka event › Impor peserta › tambah sumber jenis webhook, mengisi dasar pemrosesan data (mis. persetujuan di form registrasi). Octago menampilkan URL dan secret satu kali — simpan di sistem pengirim.
POST https://api.<domain>/hooks/import/<source-id>2. Header wajib
| Header | Isi |
|---|---|
Content-Type | application/json |
X-Octago-Timestamp | Waktu kirim, detik Unix. Ditolak bila beda lebih dari 5 menit dari jam server. |
X-Octago-Signature | sha256=<hex HMAC-SHA256 dari timestamp + "." + body, kunci = secret> |
Idempotency-Key | ID unik per pengiriman, 8–128 karakter. Kirim ulang dengan kunci yang sama = tidak diproses dua kali. |
3. Isi body
Array objek, atau objek dengan kunci records. Maksimal 5 MB dan 20000 baris per pengiriman.
{
"records": [
{
"registration_id": "GSI-000123",
"email": "[email protected]",
"full_name": "Ani Wijaya",
"company": "PT Maju Bersama",
"job_title": "Kepala Pengadaan",
"country": "Indonesia",
"category": "Buyer"
}
]
}Nama kolom dikenali otomatis (Indonesia/Inggris, huruf besar-kecil bebas):
| Data | Contoh nama kolom |
|---|---|
| Email (wajib) | email, e-mail, alamat email |
| Nama | full name, name, nama lengkap — atau first name + last name |
| ID registrasi | registration id, ticket id, no registrasi, badge id |
| Perusahaan | company, organization, perusahaan, instansi |
| Jabatan | job title, position, jabatan |
| Negara | country, negara |
| Kategori | category, attendee type, jenis peserta — nilai: buyer, exhibitor, visitor, investor, delegate (atau padanannya, mis. pembeli, penjual, pengunjung) |
Peserta dicocokkan dengan ID registrasi lalu email: yang sudah ada diperbarui, yang baru dibuat. Email disimpan terenkripsi; peserta bisa login dengan kode email.
4. Respons
| Kode | Arti |
|---|---|
| 202 | Diterima. Body berisi jumlah baris, dibuat, diperbarui, dan daftar baris yang ditolak beserta alasannya. |
| 200 | {"duplicate": true} — Idempotency-Key sudah pernah diproses. |
| 401 | Tanda tangan, waktu, atau sumber tidak valid (alasan sengaja tidak dirinci). |
| 422 | Body tidak bisa diproses, mis. bukan JSON atau tanpa kolom email. |
| 429 | Terlalu banyak permintaan dari alamat IP ini; coba lagi sesuai header Retry-After. |
Contoh: menandatangani di terminal
SECRET='secret-dari-octago'
TS=$(date +%s)
BODY='{"records":[{"email":"[email protected]","full_name":"Ani Wijaya"}]}'
SIG=$(printf '%s.%s' "$TS" "$BODY" | openssl dgst -sha256 -hmac "$SECRET" | sed 's/^.* //')
curl -X POST "https://api.<domain>/hooks/import/<source-id>" \
-H 'Content-Type: application/json' \
-H "X-Octago-Timestamp: $TS" \
-H "X-Octago-Signature: sha256=$SIG" \
-H "Idempotency-Key: kirim-$(uuidgen)" \
--data "$BODY"Contoh: Node.js
import crypto from "node:crypto";
const ts = Math.floor(Date.now() / 1000).toString();
const body = JSON.stringify({ records });
const sig = crypto.createHmac("sha256", process.env.OCTAGO_SECRET)
.update(`${ts}.${body}`).digest("hex");
await fetch(`https://api.<domain>/hooks/import/${sourceId}`, {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-Octago-Timestamp": ts,
"X-Octago-Signature": `sha256=${sig}`,
"Idempotency-Key": crypto.randomUUID(),
},
body,
});Tanda tangan dihitung atas body persis seperti yang dikirim (byte demi byte). Jangan memformat ulang JSON setelah menandatangani.