Un webhook es un mensaje que RecReview envía a una dirección web tuya en el momento en que algo pasa: una entrega, una aprobación, una nueva versión. Apúntalo a Make, Zapier, n8n o tu propio servicio y el resto de tus herramientas se entera de inmediato.
Este artículo es para quien arma la integración. Si solo quieres que RecReview mueva una tarea o envíe un correo cuando algo pasa, lo que buscas son las automatizaciones.
Antes de empezar: los webhooks necesitan el plan Pro o Studio, y tienes que ser propietario o administrador del espacio de trabajo.
Configura uno
- Haz clic en tu avatar, arriba a la derecha, y elige Configuración del espacio de trabajo.
- Abre la pestaña Automatizaciones y desplázate hasta la sección de webhooks, al final.
- Busca el evento que te interesa y haz clic en Configurar.
- Pega la dirección web que debe recibir el mensaje.
- Si quieres, completa Secreto (opcional, para firma HMAC), para que tu lado pueda comprobar que la solicitud vino de RecReview.
- Haz clic en Guardar.
- Con el webhook activado, usa el botón de envío de su fila para disparar una prueba.
Una prueba devuelve ¡Webhook enviado! con el código de respuesta, o Error al enviar con el error.
Una URL por evento, por espacio de trabajo. Guardar de nuevo reemplaza la URL anterior.
Los eventos
| Evento | Se dispara cuando |
|---|---|
video.delivery |
Un video se envía a revisión del cliente |
video.delivery_approved |
El cliente aprueba el video final |
video.uploaded |
Se sube una nueva versión |
video.comment_added |
Se agrega un comentario |
gallery.delivery |
Una galería de fotos se envía a revisión del cliente |
gallery.delivery_approved |
El cliente aprueba la galería de fotos |
gallery.comment_added |
Se agrega un comentario a una foto de la galería |
plan.delivery |
Un plan de producción se envía a un cliente |
script.delivery |
Un guion se envía a un cliente |
Qué llega
Todas las solicitudes tienen la misma forma: el nombre del evento, cuándo pasó y un objeto data con los detalles.
{
"event": "video.delivery",
"timestamp": "2026-09-02T14:03:11.000Z",
"data": { "project_name": "...", "client_name": "...", "video_title": "...", "version_number": 3 }
}
Un mensaje de entrega también trae stats (versiones, horas registradas, días abierto, comentarios resueltos y total), assets con los enlaces de descarga, revisión y miniatura, el resumen de la IA, quién entregó y cuándo, y la tarea vinculada.
Descargar el video desde tu integración
assets trae dos enlaces de descarga, y sirven para cosas distintas:
download_url: el enlace para PERSONAS. Es el que reenvías por mensaje o correo: quien lo abre pasa por las reglas de acceso habituales. Si tu espacio de trabajo separa gestor y revisor, un programa que intente descargar aquí sin iniciar sesión como nadie será rechazado, y eso es intencional.automation_download_url: el enlace para PROGRAMAS. Tu integración descarga el archivo directamente desde él, sin nadie con sesión iniciada. Úsalo en los pasos automáticos: subir a una unidad, archivar, publicar.
El enlace de automatización vale por 7 días y funciona solo para ese video. Deja de funcionar en cuanto rotas o desactivas el uso compartido del video: así es como cortas el acceso.
Atención: Estos mensajes incluyen datos del cliente, como nombre y teléfono, y el enlace de automatización descarga el archivo sin pedir nada más. Envíalos solo a un servicio que controles, y no le pases
automation_download_urlal cliente ni lo uses fuera de tu automatización.
Verifica la solicitud
Cada solicitud lleva estos encabezados:
X-Webhook-Signature:sha256=seguido de un HMAC-SHA256 del cuerpo de la solicitud, con tu secreto como clave.X-Webhook-Event: el nombre del evento.X-Webhook-Timestamp: la misma marca de tiempo del payload.
Calcula la misma firma sobre el cuerpo sin procesar y compárala con el encabezado. Define un secreto al guardar el webhook: sin él no hay contra qué comparar y no puedes confirmar quién envió el mensaje.
Fallas y reintentos
Si tu dirección no responde, RecReview vuelve a enviar el mensaje algunas veces antes de rendirse. Si tu lado responde con un error que indica que rechazó el mensaje, eso es definitivo: corrígelo y vuelve a disparar el evento. RecReview no guarda un historial de envíos que puedas consultar, así que lleva tu propio registro.
La dirección tiene que ser accesible desde internet: una dirección local o interna no funciona.