Webhooks
Abonnez-vous aux événements qui vous intéressent et Modiva les envoie en POST vers votre endpoint. Les événements entrants de chaque plateforme sont normalisés dans une enveloppe unique — un commentaire Instagram et un DM TikTok arrivent sous la même forme.
{
"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"
}Flux de livraison
Retries et backoff
Une livraison n'est considérée comme réussie que lorsque votre endpoint renvoie un 2xx en 5 secondes. Tout le reste est réessayé selon un calendrier exponentiel — jusqu'à 8 tentatives plafonnées à 24h d'écart.
Après le 8e échec, l'événement passe dans une file dead-letter — rejouez-le à tout moment depuis Dashboard → Logs de webhooks. Les endpoints ne sont jamais désactivés automatiquement ; vous les mettez en pause ou les supprimez vous-même.
Les retries réutilisent le même id d'événement. Dédupliquez dessus — traitez chaque livraison comme une notification, pas comme une source de vérité.
Chaque POST porte un en-tête X-Modiva-Signature HMAC-SHA256. Vérifiez-le avec votre secret de signature.
const sig = req.headers["x-modiva-signature"]; const expected = hmacSHA256(rawBody, process.env.MODIVA_WH_SECRET); if (sig !== expected) return res.status(401).end();