Webhook
Iscriviti agli eventi che ti interessano e Modiva li invia in POST al tuo endpoint. Gli eventi in entrata da ogni piattaforma sono normalizzati in un unico envelope: un commento di Instagram e un DM di TikTok arrivano nella stessa 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"
}Flusso di consegna
Retry e backoff
Una consegna è considerata riuscita solo quando il tuo endpoint restituisce un 2xx entro 5 secondi. Tutto il resto viene ritentato con una pianificazione esponenziale, fino a 8 tentativi con un tetto di 24h di distanza.
Dopo l'8° fallimento l'evento passa a una coda dead-letter: rigiocalo in qualsiasi momento da Dashboard → Log dei webhook. Gli endpoint non vengono mai disattivati automaticamente; li metti in pausa o li rimuovi tu.
I retry riutilizzano lo stesso id dell'evento. Deduplica su di esso: tratta ogni consegna come una notifica, non come fonte di verità.
Ogni POST porta un header X-Modiva-Signature HMAC-SHA256. Verificalo con il tuo segreto di 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();