Webhooks
Suscríbete a los eventos que te importan y Modiva los envía por POST a tu endpoint. Los eventos entrantes de cada plataforma se normalizan en un único envelope: un comentario de Instagram y un DM de TikTok llegan con la misma forma.
{
"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"
}Flujo de entrega
Reintentos y backoff
Una entrega cuenta como exitosa solo cuando tu endpoint devuelve un 2xx en 5 segundos. Todo lo demás se reintenta con una programación exponencial, hasta 8 intentos con un tope de 24h de separación.
Tras el 8.º fallo el evento pasa a una cola dead-letter: reprodúcelo en cualquier momento desde Dashboard → Logs de webhooks. Los endpoints nunca se desactivan automáticamente; los pausas o eliminas tú.
Los reintentos reutilizan el mismo id de evento. Deduplica sobre él: trata cada entrega como una notificación, no como fuente de verdad.
Cada POST lleva un header X-Modiva-Signature HMAC-SHA256. Verifícalo con tu secreto de firma.
const sig = req.headers["x-modiva-signature"]; const expected = hmacSHA256(rawBody, process.env.MODIVA_WH_SECRET); if (sig !== expected) return res.status(401).end();