Webhooks

Qué puedes hacer

• Recibir los eventos video.created, video.ready, video.failed, video.deleted, video.watched y lead.captured.
• Recibir un evento video.watched cuando un espectador identificado empieza un vídeo, pasa el 25 %, el 50 % o el 75 %, o lo termina, una sola vez por espectador, vídeo e hito.
• Enviar todos los eventos, incluidos los que se añadan más adelante, o solo los que elijas.
• Verificar cada petición con una firma HMAC-SHA256.

Configúralo

1. En Pellio, ve a Settings → Developers → Webhooks. Tienes que ser propietario o administrador.
2. Añade tu endpoint. Tiene que ser una dirección HTTPS pública.
3. Deja activado All events o desactívalo y elige los eventos.
4. Copia el secreto de firma. Solo se muestra una vez.
5. Haz clic en Send test para enviar un evento webhook.test y revisa la respuesta en Deliveries.
6. En tu aplicación, comprueba la cabecera Pellio-Signature (t=…,v1=…) con el cuerpo sin procesar.

Conviene saber

• Todos los cuerpos tienen la forma { "id", "event", "createdAt", "data" }.
• Pellio espera hasta 10 segundos. Cualquier respuesta 2xx cuenta como entregada, y las redirecciones cuentan como fallos.
• Las entregas fallidas se intentan 6 veces en total: el primer reintento llega a los 20 segundos y la espera se duplica hasta 320 segundos.
• Deliveries muestra los últimos 50 intentos. Rotate secret sustituye el secreto al instante.
• También puedes gestionar los webhooks a través de la API.
• Requiere el plan Standard o superior.

Guía completa: Webhooks.