Webhooks

Was du damit machen kannst

• Empfange die Ereignisse video.created, video.ready, video.failed, video.deleted, video.watched und lead.captured.
• Erhalte ein Ereignis video.watched, wenn ein identifizierter Zuschauer ein Video startet, 25 %, 50 % oder 75 % erreicht oder es zu Ende schaut – einmal pro Zuschauer, Video und Meilenstein.
• Sende alle Ereignisse, auch später hinzukommende, oder nur die, die du auswählst.
• Prüf jede Anfrage über eine HMAC-SHA256-Signatur.

Einrichtung

1. Geh in Pellio zu Settings → Developers → Webhooks. Dafür musst du Inhaber oder Admin sein.
2. Füge deinen Endpunkt hinzu. Er muss eine öffentliche HTTPS-Adresse sein.
3. Lass All events eingeschaltet oder schalte es aus und wähle Ereignisse aus.
4. Kopiere das Signatur-Secret. Es wird nur einmal angezeigt.
5. Klicke auf Send test, um ein Ereignis webhook.test zu senden, und prüf unter Deliveries die Antwort.
6. Prüf in deiner App den Header Pellio-Signature (t=…,v1=…) gegen den unveränderten Body.

Gut zu wissen

• Jeder Body hat die Form { "id", "event", "createdAt", "data" }.
• Pellio wartet bis zu 10 Sekunden. Jede 2xx-Antwort gilt als zugestellt, Weiterleitungen zählen als Fehler.
• Fehlgeschlagene Zustellungen werden insgesamt 6-mal versucht: Der erste erneute Versuch kommt nach 20 Sekunden, und die Wartezeit verdoppelt sich bis maximal 320 Sekunden.
• Deliveries zeigt die letzten 50 Versuche. Rotate secret ersetzt das Secret sofort.
• Webhooks lassen sich auch über die API verwalten.
• Benötigt den Standard-Tarif oder höher.

Vollständige Anleitung: Webhooks.