{
  "event": "click",
  "email": "customer@example.com",
  "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
  "timestamp": "2026-10-14T10:34:49+02:00"
}

Dávkový formát (volitelný)

Jeden POST nese pole až 100 událostí v klíči events. Každá položka má stejná pole jako výchozí formát. Hlavička X-SmartMailer-Event má hodnotu batch.

{
  "events": [
    {
      "event": "open",
      "email": "customer@example.com",
      "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
      "timestamp": "2026-10-14T10:34:49+02:00"
    },
    {
      "event": "click",
      "email": "other@example.com",
      "campaignUuid": "019ed1ac-30a6-75be-9204-5a66a318922e",
      "timestamp": "2026-10-14T10:34:50+02:00"
    }
  ]
}

Dávkový formát zapnete při založení webhooku polem "batch": true. Bez něj webhook dostává výchozí formát. Stav vrací GET /api/v1/webhooks v poli batch.

POST /api/v1/webhooks
{
  "url": "https://example.com/smartmailer-webhook",
  "events": ["open", "click", "unsubscribed"],
  "batch": true
}

Hlavičky a podpis

• X-SmartMailer-Event: typ události (open, click, bounce, hardBounce, complaint, unsubscribed), u dávky batch.
• X-SmartMailer-Signature: HMAC-SHA256 těla požadavku v hex, klíčem je secret, který vrátilo založení webhooku.
• Podpis ověřujte nad syrovým tělem požadavku a porovnávejte v konstantním čase (hash_equals, timingSafeEqual).

Doručení a výpadky endpointu

• Na odpověď čekáme nejvýš 5 sekund. Odpovídejte rychle stavem 2xx a těžší zpracování si dejte do vlastní fronty.
• Po 5 neúspěšných doručeních za sebou (stav 4xx nebo 5xx, chyba spojení, vypršený čas) webhook na 15 minut pozastavíme a události z té doby se nedoručí. Dokdy pauza trvá, ukazuje pole suspendedUntil v GET /api/v1/webhooks. Po pauze zkusíme doručit znovu.
• Neúspěšné doručení neopakujeme. Každou událost pošleme nejvýš jednou.
• Výjimečně může stejná událost přijít dvakrát. Deduplikujte podle event, email a campaignUuid.