Webhooks

Ce que vous pouvez faire

• Recevoir les événements video.created, video.ready, video.failed, video.deleted, video.watched et lead.captured.
• Recevoir un événement video.watched quand un spectateur identifié démarre une vidéo, dépasse 25 %, 50 % ou 75 %, ou la termine, une fois par spectateur, par vidéo et par étape.
• Envoyer tous les événements, y compris ceux ajoutés plus tard, ou seulement ceux que vous choisissez.
• Vérifier chaque requête grâce à une signature HMAC-SHA256.

Mise en place

1. Dans Pellio, allez dans Settings → Developers → Webhooks. Vous devez être propriétaire ou administrateur.
2. Ajoutez votre endpoint. Il doit s’agir d’une adresse HTTPS publique.
3. Laissez All events activé, ou désactivez-le et choisissez les événements.
4. Copiez le secret de signature. Il ne s’affiche qu’une fois.
5. Cliquez sur Send test pour envoyer un événement webhook.test, et consultez Deliveries pour voir la réponse.
6. Dans votre application, vérifiez l’en-tête Pellio-Signature (t=…,v1=…) à partir du corps brut.

Bon à savoir

• Chaque corps de requête a la forme { "id", "event", "createdAt", "data" }.
• Pellio attend jusqu’à 10 secondes. Toute réponse 2xx compte comme livrée, et les redirections comptent comme des échecs.
• Les livraisons en échec sont tentées 6 fois au total : la première nouvelle tentative a lieu au bout de 20 secondes, puis le délai double jusqu’à 320 secondes.
• Deliveries affiche les 50 dernières tentatives. Rotate secret remplace immédiatement le secret.
• Vous pouvez aussi gérer les webhooks via l’API.
• Nécessite le forfait Standard ou supérieur.

Guide complet : Webhooks.