Webhooks
Un webhook informa a tus propios sistemas de lo que ocurre en un espacio de trabajo: aprobaciones, episodios nuevos, videos terminados, publicaciones realizadas y más. ShowBits envía cada evento firmado a tu dirección. Los webhooks se incluyen en los planes Enterprise y OnPremise; en todos los planes, las conexiones para n8n, Zapier y Make tienen sus propios webhooks.
- Quién lo configura
- Los administradores del espacio de trabajo
- Planes
- Enterprise y OnPremise
- Qué envía ShowBits
- Eventos firmados que identifican los objetos por su ID, sin nombres, títulos ni textos
Añadir un webhook
Los administradores del espacio de trabajo añaden los webhooks. Tu sistema necesita una dirección que acepte solicitudes POST a través de https y sea accesible desde internet.
- Abre Settings → API.
- En Webhooks, haz clic en Add webhook.
- Introduce la dirección de tu sistema en Address (https). Debe empezar por
https://, no contener nombre de usuario ni contraseña y ser accesible desde internet. - Si quieres, escribe una descripción en Description, por ejemplo, el nombre del sistema.
- En Events, marca lo que necesita tu sistema. La casilla de un grupo, como Clips, marca todos sus eventos.
- Haz clic en Add.
- Haz clic en Copy y guarda el secreto en tu sistema. ShowBits solo lo muestra esta vez.
- Haz clic en Done.
Un espacio de trabajo tiene como máximo 10 webhooks, incluidos los de las conexiones de n8n, Zapier y Make. Para n8n, usa la Production URL del nodo Webhook; el diálogo te avisa si introduces su URL de prueba.

Eventos y su contenido
Los eventos se agrupan en Clips, Episodes, Posts, Quote cards, Team, Integrations, Brand kits y Workspace. Por ejemplo: clip.approved cuando se aprueba un clip, clip.forwarded cuando pasa al siguiente paso de aprobación, clip.video_ready cuando su video está terminado, episode.analysed, episode.embargo_ended, post.published, post.failed y clip.delivered para una entrega a tu MAM o DAM.
Cada evento es un POST con un cuerpo JSON: id (el ID del evento), type, occurredAt, workspace (ID y slug), object (tipo e ID del episodio, el clip o la publicación), via (app, api, automation o system) y data con unos pocos campos inofensivos, como el canal o la hora. Los nombres, los títulos y los textos nunca forman parte de él; tu sistema obtiene los detalles a través de la API REST.
Comprobar la firma
Cada evento lleva los encabezados ShowBits-Event (el tipo del evento), ShowBits-Delivery (el ID de la entrega) y ShowBits-Signature: t=…,v1=…. Comprueba la firma antes de que tu sistema actúe a partir de un evento.
- Lee el cuerpo de la solicitud como texto sin procesar, antes de que tu sistema analice el JSON.
- De
ShowBits-Signature, tomat, la hora en segundos Unix, y todos los valoresv1. - Calcula un HMAC-SHA256 de
t, un punto y el cuerpo sin procesar, con el secreto completo como clave, incluidowhsec_, y escribe el resultado en hexadecimal. - Acepta el evento solo si el resultado coincide con uno de los valores
v1; compáralos en tiempo constante. - Descarta el evento si
ttiene más de cinco minutos de antigüedad.
Durante un día después de crear un secreto nuevo, el encabezado lleva un segundo v1, firmado con el secreto anterior. Encontrarás código de ejemplo en la documentación de la API.
Probar, pausar y revisar las entregas
Cada webhook muestra su host, su estado (Active, Paused o Paused after failures), la descripción, el número de eventos y cuándo aceptó la dirección un evento por última vez.
- Haz clic en Test para enviar un evento de prueba (
webhook.test). También llega a un webhook pausado. - Haz clic en Deliveries para ver los 20 últimos eventos con su resultado: aceptado (con el código de estado), en reintento (con el número de intentos y el error) o abandonado (con el error).
- Haz clic en Pause para dejar de enviar eventos y en Resume para reanudar el envío.
Los eventos que ocurren mientras un webhook está pausado no se envían después.

Crear un secreto nuevo
Crea un secreto nuevo si el anterior puede haberse filtrado, o para cambiarlo de vez en cuando. El secreto anterior también sigue firmando durante un día, para que puedas cambiar tu sistema sin interrupciones.
- Haz clic en New secret junto al webhook.
- Confirma con New secret.
- Haz clic en Copy y guarda el secreto nuevo en tu sistema.
- Haz clic en Done.
Eliminar un webhook
Eliminar un webhook lo termina definitivamente: no se le envían más eventos y las entregas pendientes se descartan.
- Haz clic en el icono de la papelera (Delete) junto al webhook.
- Confirma con Delete.
Reintentos, pausa automática y eventos repetidos
Tu dirección debe responder con un estado entre 200 y 299 en un plazo de 10 segundos; ShowBits no sigue redirecciones. De lo contrario, ShowBits vuelve a intentarlo al cabo de 1 minuto, 5 minutos, 30 minutos, 2 horas, 6 horas y 24 horas, y después abandona ese evento. Si la dirección no acepta nada durante tres días, ShowBits pausa el webhook (Paused after failures) y envía un correo electrónico a los administradores del espacio de trabajo. Soluciona el problema en la dirección y, después, haz clic en Resume.
Un evento puede llegar más de una vez: tras un reintento o a dos webhooks con la misma dirección. Reconoce las repeticiones por el id: es el mismo en cada intento y en cada webhook.
Preguntas
¿Puede estar la dirección en nuestra red interna?
No. ShowBits solo envía a direcciones https accesibles desde internet, sin nombre de usuario ni contraseña.
¿Por qué un evento no contiene el título del clip?
Los eventos solo identifican los objetos por su ID, de modo que por esta vía no salen de ShowBits nombres, títulos ni textos. Con un token, tu sistema obtiene los detalles a través de la API REST.
¿Cuánto tiempo se conservan las entregas?
30 días. Deliveries muestra las 20 últimas de un webhook.
¿Puede nuestro sistema gestionar sus webhooks por sí mismo?
Sí, a través de la API REST, con un token que tenga los permisos webhooks:read y webhooks:write. La persona a la que pertenece el token debe tener el rol de administrador del espacio de trabajo.
Tenemos Creator o Business. ¿Podemos recibir eventos?
Los webhooks de Settings → API se incluyen en Enterprise y OnPremise. En todos los planes, las conexiones para n8n, Zapier y Make tienen sus propios webhooks, con la misma firma: consulta n8n, Zapier y Make.