Guía básica para activar el panel de desarrolladores y configurar webhooks que envían pagos exitosos en tiempo real a servicios externos.
Descripción general
Trainingym Manager permite activar un sistema de webhooks para suscribirse a eventos de pagos exitosos. Desde el panel de desarrolladores, cualquier centro con permisos adecuados puede configurar puntos de conexión (endpoints) y recibir notificaciones en tiempo real con los datos necesarios para automatizar procesos externos, como la generación de facturas o integraciones con sistemas de terceros.
✅ Webhooks disponibles
Actualmente, el sistema permite suscribirse a los siguientes eventos:
Pagos exitosos
Se activa cuando se registra un pago completado con éxito. Ideal para integraciones con software de facturación, ERPs, CRMs o gestión contable.
Actividades
Se activa cada vez que se crea, edita o elimina una actividad en la parrilla del centro. Muy útil para integraciones con:
-
Sistemas de cartelería digital
-
Plataformas de domótica
-
Aplicaciones móviles personalizadas
-
Otros servicios que necesiten estar sincronizados con el horario de clases
Beneficios del sistema de Webhooks
📌 Un sistema flexible y abierto a múltiples integraciones
-
Compatible con cualquier software de facturación o CRM.
-
Datos en tiempo real para automatizar acciones.
⚡ Inspirado en sistemas líderes como Stripe y Zapier
-
Interfaz sencilla e intuitiva.
-
Lógica basada en eventos que desencadenan acciones automatizadas.
🔗 Beneficios clave para el ecosistema de Trainingym
-
Escalable y reutilizable en distintos países y normativas.
-
No requiere desarrollo adicional por parte del centro.
-
Mejora la digitalización y automatización de gestiones internas.
Estructura de datos enviada
Webhook de pagos exitosos
Datos del cliente:
-
Nombre
-
Apellidos (si aplica)
-
Documento de identificación (si aplica)
-
Email (si aplica)
Datos del pago:
-
Tipo de transacción (tarifa, producto…)
-
Concepto
-
Precio unitario
-
Cantidad
-
Cupón aplicado / descuento (si aplica)
-
Total
-
Impuestos
-
Método de pago
-
Fecha de registro
-
Fecha de valor
-
Estado (exitoso)
-
ID de transacción
-
Canal (empleado, online)
-
Empleado responsable (si aplica)
-
Notas (si aplica)
Webhook de actividades
Datos de la actividad:
-
Nombre de la actividad
-
Fecha y hora de inicio
-
Duración
-
Sala o área asignada
-
Empleado asignado
-
Código de color configurado
-
Estado (alta, edición o baja)
-
ID único de la actividad
-
Canal de creación o modificación
-
Timestamp del evento
Funcionamiento del sistema
Activar el panel de desarrolladores
Desde Mi Centro > Permisos, habilita el permiso “Desarrolladores”. Esto te dará acceso al menú lateral “Desarrolladores” en TGManager.
Crear y gestionar puntos de conexión
Desde el panel de desarrolladores:
-
Crea un nuevo endpoint (URL de destino)
-
Asigna un nombre
-
Selecciona los eventos a los que te quieres suscribir (Pagos exitosos y/o Actividades)
-
Activa o desactiva según necesidad
Puedes configurar hasta 10 endpoints distintos.
Consultar el historial de eventos
El panel incluye un log con:
-
Fecha y hora del evento
-
Tipo de evento
-
Estado de envío (entregado o error)
-
Posibilidad de reenviar la petición
Notas adicionales
-
El panel de desarrolladores está disponible para todos los centros con permiso activo.
-
El JSON expuesto está estandarizado y documentado para facilitar la integración con terceros.