Webhook — 把品牌事件即時推送到你的後端

# Python（Flask 範例）
import hmac, hashlib
from flask import Flask, request, abort
 
SECRET = b"whsec_xxxxx"  # 從 dashboard 取得
 
@app.post("/webhook/hypelink")
def hypelink_webhook():
    sig = request.headers.get("X-HypeLink-Signature", "")
    if not sig.startswith("sha256="):
        abort(401)
    expected = hmac.new(SECRET, request.data, hashlib.sha256).hexdigest()
    if not hmac.compare_digest(sig[7:], expected):
        abort(401)
 
    payload = request.get_json()
    event_type = request.headers["X-HypeLink-Event"]
    # ...處理事件...
    return "", 200

// Node.js / TypeScript
import crypto from "crypto";
 
const SECRET = "whsec_xxxxx";
 
app.post("/webhook/hypelink", express.raw({ type: "application/json" }), (req, res) => {
  const sig = String(req.headers["x-hypelink-signature"] ?? "");
  if (!sig.startsWith("sha256=")) return res.sendStatus(401);
 
  const expected = crypto
    .createHmac("sha256", SECRET)
    .update(req.body)  // 原始 bytes
    .digest("hex");
 
  if (!crypto.timingSafeEqual(Buffer.from(sig.slice(7)), Buffer.from(expected))) {
    return res.sendStatus(401);
  }
 
  const payload = JSON.parse(req.body.toString());
  // ...處理事件...
  res.sendStatus(200);
});

// event.registration.created
{
  "eventType": "event.registration.created",
  "hypeId": "@goodshot",
  "deliveredAt": "2026-06-01T18:32:11.521Z",
  "eventUuid": "206e879c-a0ec-4964-a43f-5c5f7903c5e5",
  "eventName": "高中同學回娘家聚餐",
  "eventSlug": "reunion-2026",
  "attendee": {
    "uuid": "1adc39bf-2a87-4f59-a43d-4c3f2b77e098",
    "name": "陳小華",
    "email": "[email protected]",
    "phone": "0912345678",
    "status": "registered",
    "ticketNumber": "T-20260601-001",
    "ticketTypeUuid": "a2fc47f9-...",
    "ticketTypeName": "校友票",
    "paymentStatus": "unpaid",
    "paymentLast5": "98765",
    "customValues": { "grad_class": "305 班", "hs_nickname": "華華" },
    "regSource": "social",
    "utmSource": "instagram",
    "utmMedium": "stories",
    "utmCampaign": null
  }
}

// event.attendee.payment_changed
{
  "eventType": "event.attendee.payment_changed",
  "hypeId": "@goodshot",
  "deliveredAt": "2026-06-01T19:01:00.012Z",
  "eventUuid": "206e879c-...",
  "attendeeUuid": "1adc39bf-...",
  "paymentStatus": "paid",
  "paymentNote": "現場現金",
  "name": "陳小華",
  "email": "[email protected]"
}

// link.created
{
  "eventType": "link.created",
  "hypeId": "@goodshot",
  "deliveredAt": "2026-06-01T17:45:22.143Z",
  "linkId": 110,
  "uuid": "5de6b58f-...",
  "name": "我的 IG",
  "url": "https://instagram.com/myhandle",
  "folderId": 180
}