> For the complete documentation index, see [llms.txt](https://docs.scoreholio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.scoreholio.com/es/lleva-el-seguimiento-de-puntos-entre-eventos/track-points-across-events/webhooks.md).
# Webhooks de Seasons
## Webhooks
Antes de los webhooks, la única forma de sacar datos de Scoreholio Seasons era iniciar sesión y ejecutar un informe o una exportación: una instantánea manual y posterior al hecho.
Los webhooks invierten eso. En vez de que tú vayas a buscar los datos, Scoreholio te los envía en el momento en que algo cambia. Nos das una URL, nos dices qué eventos te interesan y llamamos a esa URL cada vez que ocurra uno de ellos.
Esto significa que puedes:
* Sincronizar miembros con tu CRM en el momento en que se registran, sin exportación nocturna.
* Publicar en Slack/Discord/Teams cuando se crea un nuevo torneo.
* Disparar un correo electrónico cuando se registra una transacción de temporada.
* Mantener un panel externo o una hoja de cálculo actualizada en tiempo real.
Los webhooks son actualmente la única forma de obtener datos de Seasons de manera programática. No hay una API REST pública.
### ¿No tienes un desarrollador? Usa Zapier.
No necesitas escribir código para usar webhooks. Zapier (y herramientas similares como Make, n8n o Pipedream) puede capturar un webhook de Scoreholio y convertirlo en casi cualquier acción que se te ocurra: añadir una fila a una hoja de Google, enviar una campaña de Mailchimp, publicar en Slack, crear un contacto en HubSpot, enviar un SMS, etcétera.
Así es como lo configuras en Zapier:
1. En Zapier, crea un nuevo Zap y elige Webhooks by Zapier como el desencadenador.
2. Elige el evento Catch Hook.
3. Zapier te dará una URL que se parece a . Cópiala.
4. En Scoreholio, ve a Configuración → Webhooks → Añadir webhook, pega esa URL y elige los eventos que quieres.
5. Guarda. Ahora haz la acción en Scoreholio que debería disparar el evento (por ejemplo, añadir un miembro de prueba) para que Zapier pueda ver cómo se ve la carga útil.
6. Vuelve a Zapier y haz clic en Probar desencadenador: deberías ver que el evento llega.
7. Añade la acción que quieras después: Google Sheets, Slack, Mailchimp, Gmail, etc.
El plan gratis de Zapier incluye Webhooks by Zapier, pero un volumen alto de eventos podría llevarte a un plan de pago. Si esperas muchos eventos, revisa los límites de tareas de Zapier.
El mismo patrón funciona con Make, n8n, Pipedream y otras herramientas sin código: todas tienen un paso de "disparador de webhook" o "capturar webhook".
### ¿Qué puedes escuchar?
Cada vez que una de estas cosas ocurra en tu cuenta, enviaremos un mensaje a tu URL:
* Temporadas: creadas, actualizadas, eliminadas
* Torneos: creados, actualizados, eliminados
* Miembros: creados, actualizados, eliminados
* Transacciones de temporada: creadas, actualizadas, eliminadas
* Organizadores: creados, actualizados, eliminados
* Equipos: creados, actualizados, eliminados (solo si las clasificaciones por equipos están activadas para esa temporada)
Tú eliges exactamente cuáles te interesan: no hace falta suscribirte a todos.
### Cómo configurar uno
1. Abre e inicia sesión con tu cuenta Pro
2. Ve a Configuración → Webhooks
3. Haz clic en Añadir webhook
4. Pega la URL donde quieres que enviemos los eventos (por ejemplo, , o tu URL de Catch Hook de Zapier)
5. Marca las casillas de los eventos que te interesan
6. (Opcional) Elige temporadas específicas a las que quieres hacer seguimiento; déjalo en blanco para recibir eventos de todas las temporadas
7. Haz clic en Guardar
Cuando lo guardes, te mostraremos un secreto de firma: cópialo en un lugar seguro. Solo te lo mostraremos una vez. Lo necesitarás para verificar que los mensajes realmente vienen de nosotros (mira abajo).
### "Solo para estas temporadas" vs "todas las temporadas"
De forma predeterminada, un webhook se activa para cada temporada de tu cuenta. Si solo te interesa, por ejemplo, tu liga de primavera de 2026, haz clic en Editar temporadas en el formulario y elige las que quieras.
Aviso: season.created, season.updated y season.deleted siempre se activan para todas las temporadas, independientemente de este filtro, porque en el momento en que se crea o se elimina una temporada, el filtro todavía no aplica realmente.
### ¿Cómo sé que realmente es Scoreholio?
Cada solicitud que enviamos incluye una cabecera llamada X-Scoreholio-Signature. Es una huella hecha a partir de tu secreto de firma más el cuerpo del mensaje.
Cuando recibas un webhook:
1. Toma el cuerpo bruto de la solicitud
2. Calcula la misma huella usando tu secreto de firma
3. Compárala con el valor de la cabecera
4. Si coinciden → somos nosotros. Si no → deséchalo.
Esto evita que gente cualquiera en internet haga POST de eventos falsos a tu URL.
Si estás usando Zapier (u otra herramienta sin código), puedes saltarte la comprobación de firma: las URLs de webhook de Zapier ya son una cadena larga y aleatoria que es casi imposible adivinar. La verificación de firma es principalmente para cuando ejecutas tu propio servidor.
### Pausar un webhook
Si tu servidor está caído por mantenimiento, no tienes que eliminar el webhook: solo edítalo y cambia Activo a Pausado. Dejaremos de enviar hasta que lo vuelvas a activar.
### ¿Cómo sé que funciona?
La lista de webhooks te muestra, para cada uno:
* Último — si la entrega más reciente fue un ✓ o un ✗
* Cuándo — hace cuánto fue el último intento de envío
Si sigues viendo ✗, probablemente tu URL no está respondiendo con un código de estado 2xx, o está caída.
### Eliminar
Haz clic en Opciones → Eliminar en la fila. Deja de recibir eventos de inmediato. (El secreto de firma también desaparece para siempre, así que si alguna vez lo vuelves a crear, obtendrás un secreto nuevo.)