> 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/scoreholio-seasons/que-es-scoreholio-seasons/webhooks.md).

# Webhooks

## 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 captura manual a posteriori.

Los webhooks lo invierten. 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 golpeamos esa URL cada vez que ocurre uno de ellos.

<br>

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.
* Activar un correo electrónico cuando se registra una transacción de temporada.
* Mantener un panel o una hoja de cálculo externa actualizada en tiempo real.

Los webhooks son actualmente la única forma de obtener datos programáticamente desde Seasons. No hay una API REST pública.

### ¿No tienes desarrollador? Usa Zapier.

No necesitas escribir código para usar webhooks. Zapier (y herramientas parecidas como Make, n8n o Pipedream) puede captar un webhook de Scoreholio y convertirlo en casi cualquier acción que se te ocurra: añadir una fila a Google Sheets, enviar una campaña de Mailchimp, publicar en Slack, crear un contacto en HubSpot, enviar un SMS, y así sucesivamente.

Así es como lo conectas en Zapier:

1. En Zapier, crea un nuevo Zap y elige Webhooks by Zapier como el disparador.
2. Elige el evento Catch Hook.
3. Zapier te dará una URL que se parece a <https://hooks.zapier.com/hooks/catch/12345/abcde/>. 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. De vuelta en Zapier, haz clic en Probar disparador; deberías ver cómo llega el evento.
7. Añade la acción que quieras a continuación: Google Sheets, Slack, Mailchimp, Gmail, etc.

El plan gratuito de Zapier incluye Webhooks by Zapier, pero un gran volumen de eventos puede 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 webhook" o "capturar webhook".

### ¿Qué puedes escuchar?

Cada vez que una de estas cosas pase 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 de 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 <https://seasons.scoreholio.com> 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 a la que quieres que enviemos los eventos (por ejemplo, <https://your-server.com/scoreholio-events>, o tu URL de Catch Hook de Zapier)
5. Marca las casillas de los eventos que te interesan
6. (Opcional) Elige temporadas específicas para vigilar; 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 (ver más abajo).

### "Solo para estas temporadas" vs "todas las temporadas"

Por defecto, 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.

Ojo: season.created, season.updated y season.deleted siempre se activan para todas las temporadas sin importar este filtro, porque en el momento en que una temporada se crea o se elimina, el filtro realmente todavía no aplica.

### ¿Cómo sé que realmente es Scoreholio?

Cada solicitud que enviamos incluye un encabezado llamado 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 del encabezado
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 usas Zapier (u otra herramienta sin código), puedes saltarte la verificación de firma: las URLs de webhook de Zapier ya son una cadena aleatoria larga que es casi imposible de 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 borrar el webhook; solo edítalo y cambia Activo a Pausado. Dejaremos de enviar hasta que lo vuelvas a activar.

### ¿Cómo sé si está funcionando?

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 intentamos enviar por última vez

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.)

<br>