Ganchos de red

Un webhook informa a otra herramienta de que ha ocurrido algo en tu cuenta Reigniter. Cuando ocurre el evento, Reigniter envía un mensaje de JSON firmado a la dirección que elijas. Esa dirección puede ser el disparador de webhook de una automatización, otra herramienta de flujo de trabajo o tu propio servidor.

Añade una suscripción y cada evento se envía a tu dirección como JSONfirmado.

Eventos

Evento	Etiqueta en la app	Enviado cuando
video.completed	Vídeo completado	Un renderizado de vídeo termina. El mensaje lleva un enlace de descarga que funciona durante 7 días.
video.failed	Vídeo fallado	Un renderizado de vídeo falla.
training.completed	El estudiante terminó un módulo	Un alumno con nombre llega al final de un módulo, con su puntuación y si ha aprobado.
training.overdue	Estudiante retrasado	Un alumno no ha terminado antes de la fecha límite.

La lista completa está en Webhooks. Dentro de Automatizaciones no necesitas un webhook: los Reigniter disparadores (Vídeo terminado, Aprendiz aprobado y el resto) se registran solos.

Añadir un webhook

1. Conectores abiertos > webhooks.

2. Selecciona Añadir.

3. Elige el evento.

4. Pega la dirección que debería recibirla. Debe ser una dirección web pública. Las direcciones en una red privada son rechazadas.

5. Selecciona Añadir.

6. Copia el secreto de firma y guárdalo en un lugar seguro. Solo se muestra una vez. Luego selecciona Hecho.

Comprueba que funcione

Selecciona el botón de prueba en el webhook para enviar un mensaje de prueba firmado. Comprueba que llegue a tu dirección.

Verifica cada mensaje

Cada mensaje está firmado con tu secreto de firma. Tu herramienta receptora debería comprobar la firma antes de confiar en el mensaje, para que nadie más pueda enviarle eventos falsos. Cómo comprobar la firma está explicado en la guía de API webhooks.

Cada mensaje también lleva un ID de entrega que permanece igual cuando se intenta una entrega de nuevo. Úsalo para ignorar duplicados.

Pausa, reanudar o eliminar

Cada gancho web de la lista tiene botones para:

• Pausa. Muestra pausado y no recibe nada hasta que lo reanudes.
• Bórralo.

Cuando fallan las entregas

• Reigniter intenta varias veces una entrega fallida.
• El webhook muestra cuántas entregas seguidas han fallado, por ejemplo, 3 fallaron. Una entrega exitosa reinicia el conteo.
• Tras muchos fallos seguidos, el webhook se pausa automáticamente. Fija la dirección y luego reanuda.
• Un webhook fallido nunca afecta a tus renders.

Haz vídeos desde otra herramienta

Los webhooks envían eventos fuera de Reigniter. Para hacer vídeos desde otra herramienta, usa una tecla API. Consulta Construir una automatización o el API inicio rápido.