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

HeaderIsi
Content-Typeapplication/json
X-Octago-TimestampWaktu kirim, detik Unix. Ditolak bila beda lebih dari 5 menit dari jam server.
X-Octago-Signaturesha256=<hex HMAC-SHA256 dari timestamp + "." + body, kunci = secret>
Idempotency-KeyID 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):

DataContoh nama kolom
Email (wajib)email, e-mail, alamat email
Namafull name, name, nama lengkap — atau first name + last name
ID registrasiregistration id, ticket id, no registrasi, badge id
Perusahaancompany, organization, perusahaan, instansi
Jabatanjob title, position, jabatan
Negaracountry, negara
Kategoricategory, 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

KodeArti
202Diterima. Body berisi jumlah baris, dibuat, diperbarui, dan daftar baris yang ditolak beserta alasannya.
200{"duplicate": true} — Idempotency-Key sudah pernah diproses.
401Tanda tangan, waktu, atau sumber tidak valid (alasan sengaja tidak dirinci).
422Body tidak bisa diproses, mis. bukan JSON atau tanpa kolom email.
429Terlalu 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.