Configurar un webhook

Cuándo hacer esto

Quieres que tu propio sistema reaccione cuando algo sucede en Teamspace, por ejemplo para registrar la subida de una foto o iniciar un proceso posterior. Un webhook hace que Timemark envíe una solicitud POST a tu endpoint cada vez que ocurre un evento elegido.

Qué necesitas

Rol

Propietario del equipo

Plataforma

Web

Plan

Business

Afecta a

Se activa solo para eventos que ocurren después de que se crea el webhook

Configura el webhook

1. Ve a Teamspace → Configuración → Integraciones → Webhook.
2. Ingresa tu URL del endpoint. Debe ser accesible públicamente y responder a una solicitud POST.
3. Confirma el activador. El webhook se activa con Nueva foto cuando se sube una foto nueva.
4. Elige el alcance: Todas las fotos, o una carpeta específica.
5. Guardar.

Prueba la entrega

1. En el webhook que acabas de guardar, usa la función prueba o ping para enviar una carga útil de muestra.
2. Revisa los registros de tu endpoint para confirmar que la carga útil llegó.
3. Confirma que tu endpoint devolvió una respuesta 2xx.

Campos que puedes configurar

Campo	Qué hace	Notas
URL del endpoint	Adónde Timemark envía la solicitud POST	Debe ser pública y devolver 2xx dentro del tiempo de espera
Activador	La acción que activa una entrega	Nueva foto (photo.uploaded) es actualmente el único activador. Consulta Tipos de eventos de webhook
Alcance	Limita la activación a una carpeta, o a todas las fotos del equipo	El alcance de carpeta solo se activa para fotos en esa carpeta

Errores comunes

• Sin activación retroactiva. El webhook solo se activa para eventos posteriores a su creación. Las fotos existentes no lo activarán.
• El endpoint debe devolver 2xx a tiempo. Un tiempo de espera agotado o un error se trata como una entrega fallida. Timemark reintenta las entregas fallidas y se detiene una vez que se agotan los reintentos.
• Alcance incorrecto. Un webhook con alcance limitado a una carpeta no se activará para fotos en otras carpetas. Configura el alcance en Todas las fotos si necesitas todas las carpetas.
• Detrás de un firewall. Un endpoint detrás de una VPN o firewall no es accesible. Expón una URL pública.

Ver también

• Tipos de eventos de webhook
• Referencia de carga útil del webhook

Última actualización: 28 de junio de 2026