¿Cómo recibir avisos con webhooks?
Un webhook es un aviso automático: cada vez que un cliente hace algo (te escribe por el chat, termina un entreno, comenta un ejercicio…), TrainerStudio llama a una dirección web (una URL) que tú le das. Así tu agente de IA, tu automatización de Zapier o Make, o tu propio sistema se enteran al momento, sin tener que preguntar cada pocos minutos.
No necesitas saber programar: la herramienta que quieres conectar te da una URL y tú la pegas en TrainerStudio. Los detalles técnicos están en la documentación para desarrolladores (en inglés).
1. Abre la pestaña Webhooks
Ve a Tu app → Desarrolladores en el menú lateral (también está en Configuración → Desarrolladores) y abre la pestaña Webhooks.
Solo el propietario de la cuenta puede gestionar los webhooks.
2. Añade un endpoint
Un endpoint es la URL que recibe los avisos.
- Pulsa Añadir endpoint.
- En URL del endpoint, pega la dirección que te ha dado tu herramienta. Tiene que empezar por
https://. - En Descripción, escribe algo que te ayude a reconocerlo: «Zapier, mensajes nuevos», «Agente de IA».
- Elige qué quieres recibir:
- Todos los eventos: recibes todo, también los tipos de evento que añadamos más adelante.
- Solo los eventos que elija: marcas los que te interesan.
- Guarda.
Puedes tener hasta 10 endpoints. Crea uno por herramienta: si un día dejas de usar una, eliminas solo el suyo.
Eventos disponibles
| Evento | Cuándo se envía |
|---|---|
| Mensaje de chat recibido | Un cliente te escribe por el chat de la app |
| Entreno completado | Un cliente termina el entreno del día |
| Comentario en un entreno | Un cliente deja un comentario, una foto o un vídeo en un ejercicio |
| Métrica registrada | Se registra un valor en una métrica de un cliente |
| Tarea completada | Un cliente completa una tarea |
| Foto de progreso subida | Un cliente sube una foto de progreso |
| Formulario respondido | Un cliente responde un formulario |
El aviso dice qué ha pasado y a qué cliente, pero no incluye el contenido (ni el texto del mensaje ni las medidas). Tu herramienta consulta los detalles con su propio acceso a tu cuenta.
3. Copia el secreto de firma
Al crear el endpoint aparece la ventana Copia tu secreto de firma. El secreto (empieza por whsec_) permite a tu herramienta comprobar que el aviso viene de verdad de TrainerStudio.
- Solo se muestra esta vez. Cópialo y pégalo en tu herramienta antes de pulsar Ya lo he copiado.
- Si tu herramienta no pide ningún secreto (pasa con muchas automatizaciones sencillas), puedes continuar sin usarlo.
- Si lo pierdes, no pasa nada: rota el secreto y tendrás uno nuevo.
4. Envía un evento de prueba
En la página del endpoint, pulsa Enviar evento de prueba. En unos segundos verás cómo ha respondido tu herramienta:
- Entregado: todo funciona.
- Fallido: verás el motivo (la URL no responde, tarda más de 10 segundos, devuelve un error…). Revisa la URL en tu herramienta y prueba otra vez.
5. Revisa los envíos
La página de cada endpoint muestra:
- Estadísticas de los últimos 7 o 30 días: porcentaje de éxito, tiempo de respuesta y envíos por día.
- Registro de envíos: cada aviso enviado en los últimos 30 días. Abre uno para ver sus intentos, la respuesta de tu herramienta y el contenido exacto que se envió.
- Volver a enviar: reenvía un aviso que falló, por ejemplo después de arreglar tu herramienta.
Si un envío falla, TrainerStudio lo reintenta solo hasta 8 veces durante algo más de un día, cada vez con más espera. No tienes que hacer nada.
6. Rota el secreto si lo pierdes
En la página del endpoint, pulsa Rotar secreto. Recibes un secreto nuevo y, durante 24 horas, los avisos se firman con el nuevo y con el anterior: tienes ese tiempo para cambiarlo en tu herramienta sin perder avisos.
7. Desactiva o elimina un endpoint
- Desactivar deja de enviar avisos a ese endpoint y cancela los pendientes. Puedes Activar de nuevo cuando quieras. Los eventos que ocurran mientras está desactivado no se envían después.
- Eliminar endpoint lo borra del todo. No se puede deshacer.
Si TrainerStudio lo desactiva solo
Un endpoint se desactiva automáticamente cuando:
- lleva 3 días sin aceptar ningún envío, o
- tu herramienta responde que esa dirección ya no existe.
Verás un aviso con el motivo en la página del endpoint. Arregla el problema en tu herramienta y pulsa Volver a activar.
Lo que conviene saber
- Trata la URL y el secreto como una contraseña. No los compartas ni los publiques.
- Un endpoint por herramienta, con una descripción clara.
- Un mismo aviso puede llegar dos veces si hubo un reintento. Las herramientas serias lo tienen en cuenta; si usas una automatización sencilla, tenlo presente.
- Los avisos pueden llegar desordenados. Cada uno lleva la hora a la que ocurrió.
- ¿Solo quieres hablar con tus datos desde ChatGPT o Claude? No necesitas webhooks: sigue las guías específicas.