Webhooks
Abonniere die Ereignisse, die dich interessieren, und Modiva sendet sie per POST an deinen Endpunkt. Eingehende Ereignisse von jeder Plattform werden in eine einheitliche Hülle normalisiert – ein Instagram-Kommentar und eine TikTok-DM treffen in derselben Form ein.
{
"id": "evt_5c1f9a2b",
"type": "comment.created",
"platform": "instagram",
"profile_id": "acme",
"connection_id": "conn_18a2",
"payload": { "text": "…", "author": "@mara_k" },
"received_at": "2026-06-22T09:31:04Z"
}Zustellungsablauf
Wiederholungen & Backoff
Eine Zustellung gilt nur dann als erfolgreich, wenn dein Endpunkt innerhalb von 5 Sekunden einen 2xx zurückgibt. Alles andere wird nach einem exponentiellen Zeitplan wiederholt – bis zu 8 Versuche, gedeckelt auf 24 h Abstand.
Nach dem 8. Fehlschlag wandert das Ereignis in eine Dead-Letter-Queue – spiel es jederzeit aus Dashboard → Webhook-Logs erneut ab. Endpunkte werden nie automatisch deaktiviert; du pausierst oder entfernst sie selbst.
Wiederholungen verwenden dieselbe Ereignis-id. Dedupliziere darüber – behandle jede Zustellung als Benachrichtigung, nicht als Quelle der Wahrheit.
Jeder POST trägt einen X-Modiva-Signature-HMAC-SHA256-Header. Verifiziere ihn gegen dein Signaturgeheimnis.
const sig = req.headers["x-modiva-signature"]; const expected = hmacSHA256(rawBody, process.env.MODIVA_WH_SECRET); if (sig !== expected) return res.status(401).end();