Cómo integrarme con Totalpass

La integración conecta Nessty con Totalpass para que todo fluya automáticamente:

• Cuando alguien reserva en Totalpass, la reserva aparece en Nessty ✓
• Si cancelan desde Totalpass, se cancela en Nessty (y viceversa) ✓
• Los lugares disponibles se actualizan en tiempo real en ambas plataformas ✓
• Tus sesiones nuevas se activan en Totalpass automáticamente, y las que ya tenías las activas en grupo ✓
• Lo que el miembro de Totalpass ve de cada clase sale de Nessty: el nombre de la sesión, el instructor, la descripción del servicio, los lugares disponibles, el plazo de cancelación y la ventana de reservación ✓

Todo desde un solo lugar, sin tener que estar checando dos apps 🎯

• Una cuenta de administrador en Totalpass
• Tu API Key (te explicamos cómo obtenerla)
• Acceso de administrador a Nessty

💡 Si tienes varias sucursales, cada una necesita su propio API Key. Tendrás que conectarlas por separado.

Primero activa Totalpass en Nessty:

1. Ve a Más ··· (último botón del menú)
2. Entra a Tu estudio
3. Baja hasta encontrar el selector de plataformas externas
4. Selecciona Totalpass
5. Guarda los cambios 💾

Este paso activa todas las funciones de Totalpass en Nessty: la integración, la sincronización de sesiones y el logo en las reservas.

Ahora necesitas generar tu API Key desde Totalpass:

1. Entra a tu cuenta de administrador en Totalpass
2. Ve a Integraciones en el menú
3. Haz clic en la pestaña Nuevas Integraciones
4. Clic en Nueva Configuración
5. Selecciona la ubicación/sucursal que quieres conectar
6. Selecciona Nessty como partner
7. Copia el API Key que se genera

⚠️ El API Key tiene 36 caracteres. Cópialo exactamente como aparece, sin quitar nada.

💡 Solo el propietario de la cuenta en Totalpass tiene acceso a la página de Integraciones. Si no la ves, contacta al dueño del estudio.

Con tu API Key listo, ahora a conectar:

1. Ve a Más ···
2. Baja hasta Plataformas externas y selecciona Totalpass
3. Verás una tarjeta por cada sucursal. Haz clic en Conectar
4. Pega tu API Key de 36 caracteres (asegúrate de pegarlo en la sucursal correcta)
5. Selecciona los servicios que quieres mostrar en Totalpass
   Este es el paso más importante: solo las sesiones de los servicios que selecciones aquí van a aparecer en Totalpass.
6. Para cada servicio, selecciona el plan de Totalpass correspondiente
7. Guarda

¡Listo! Si ves la etiqueta verde "Conectado", la integración está funcionando 🎉

⚠️ No te saltes el paso 5
Es el error más común. La etiqueta "Conectado" solo confirma que la conexión funciona. Los servicios que seleccionas deciden qué clases se ven en Totalpass. Si un servicio no está seleccionado, sus sesiones no van a aparecer.
Si tienes varias sucursales, selecciona los servicios dentro de la tarjeta de cada una.

Las sesiones que ya tenías no se activan solas. Actívalas en grupo:

1. Ve a Sesiones.
2. Marca la casilla a la izquierda de las sesiones de los servicios que seleccionaste.
3. Haz clic en Acciones y selecciona Activar en TotalPass.

Las sesiones se publican en segundo plano. Cuando termine, verás el logo de Totalpass a color junto al nombre de cada sesión ✓

Las sesiones que crees de aquí en adelante se activan solas: al crearlas, Activar en TotalPass ya viene encendido.

⚠️ ¿Una sesión no tiene el logo? Casi siempre es porque su servicio no está seleccionado en la integración. Revísalo en Más ··· > Plataformas externas > Totalpass, dentro de la tarjeta de tu sucursal.

Para activar o desactivar una sesión en particular, lee Cómo activar o desactivar una sesión en Wellhub o Totalpass.

Con todo configurado, las cosas fluyen solas:

Las reservas llegan solas → Cuando alguien reserva en Totalpass, aparece en tu calendario de Nessty con el logo de Totalpass.

La capacidad se sincroniza → Si tienes 20 lugares y 5 reservados, Totalpass muestra 15 disponibles automáticamente. Si la sesión tiene un límite de integraciones, Totalpass solo puede ocupar los lugares de ese límite, aunque tengas más libres.

Las cancelaciones van y vienen → Si el cliente cancela en Totalpass, desaparece de Nessty. Si tú cancelas en Nessty, le llega la notificación al cliente.

Los cambios llegan solos → Si cambias en Nessty el nombre, el instructor o la política de cancelación de una sesión, o la ventana de reservación de un servicio, Totalpass lo recibe en 1 a 5 minutos. Puede tardar más si los servidores de Totalpass van lentos.

Cada cliente, hasta un número de clases al mes → Si quieres que cada miembro de Totalpass reserve como máximo, por ejemplo, 8 clases al mes en tu sucursal, activa Límite mensual por cliente dentro de la tarjeta de la sucursal. Lee Cómo poner un límite mensual a los clientes de Wellhub o Totalpass.

Nessty le envía a Totalpass el plazo de cancelación de cada clase. El plazo es la hora de inicio de la clase menos las horas de la Política de cancelación de esa sesión.

Antes del plazo, el miembro de Totalpass cancela a tiempo. Después del plazo, Totalpass cuenta la cancelación como tardía. Lo que pasa con una cancelación tardía lo decide Totalpass, no Nessty.

Para las políticas con horas, Nessty le envía a Totalpass las mismas horas de la política: desde Flexible (2 horas antes) hasta Super estricta (1 semana antes). Por ejemplo, una sesión Levemente firme (8 horas) que empieza a las 9:00 AM se puede cancelar a tiempo en Totalpass hasta la 1:00 AM.

⚠️ No reembolsable aparece en Totalpass como 24 horas
Totalpass no tiene una opción de "sin cancelación", así que para las sesiones No reembolsable Nessty le envía 24 horas antes de la clase, igual que Firme. Para tus clientes directos, No reembolsable significa que ninguna cancelación les devuelve su token. Para un miembro de Totalpass, la misma clase se puede cancelar a tiempo hasta 24 horas antes.

Si quieres otro plazo en Totalpass, cambia la política de la sesión en Nessty, como explica la sección Cambia el plazo de cancelación en Totalpass.

El plazo de cancelación no se cambia en Totalpass: Totalpass lo toma de Nessty. Para cambiarlo, edita la Política de cancelación de la sesión en Nessty:

1. Entra a Sesiones.
2. Haz clic en la sesión que quieres cambiar.
3. Selecciona Editar.
4. Cambia la Política de cancelación.
5. Guarda los cambios.

Nessty actualiza la misma clase en Totalpass con el nuevo plazo en 1 a 5 minutos. Puede tardar más si los servidores de Totalpass van lentos. Las reservaciones de Totalpass que la clase ya tenía se conservan. Si el plazo no se actualiza, haz clic en Sync en la sección Totalpass de la sesión.

💡 La política del servicio solo aplica a las sesiones que crees después de cambiarla. Las sesiones ya programadas conservan su política: cámbialas una por una con estos pasos. Lee Cómo personalizo mi servicio?.

Las sesiones que ya pasaron no se pueden editar: su política se queda como estaba. Nessty guarda en sus registros cada cambio de política de una sesión: cuál tenía, cuál quedó y cuándo se cambió.

Totalpass usa la Ventana de reservación del servicio en Nessty, con dos límites propios de Totalpass:

• Las reservaciones en Totalpass abren como máximo 30 días antes de la clase. Si la ventana de tu servicio abre antes (por ejemplo, 60 días), en Totalpass la clase se puede reservar a partir de 30 días antes.
• Las reservaciones en Totalpass cierran como mínimo 1 minuto antes de que empiece la clase, aunque la ventana de tu servicio cierre justo al inicio.

Si el servicio no tiene ventana de reservación (el interruptor Activar restricciones está apagado), Totalpass abre las reservaciones 30 días antes de la clase y las cierra 1 minuto antes.

Cuando cambias la ventana de reservación de un servicio, Nessty se la envía en 1 a 5 minutos a todas las sesiones futuras de ese servicio que ya están en Totalpass. Para configurarla, lee Cómo personalizo mi servicio?.

El check-in no es automático.

El cliente debe hacer check-in desde su app de Totalpass, y tú debes confirmarlo en el panel de administración de Totalpass. Esto es clave porque Totalpass te paga por check-ins confirmados, no por reservas.

A veces un cliente de Totalpass llega sin haber reservado desde su app. Para estos casos puedes crear una reserva manual:

1. Ve al Home
2. Selecciona Reservar para plataforma externa
3. Elige Totalpass
4. Busca o crea el cliente (solo necesitas el nombre)
5. Selecciona la sesión
6. Confirma ✓

💡 Usa esto solo para emergencias. Lo normal es que reserven desde su app.

Si Totalpass te da un nuevo API Key o necesitas cambiarlo, el orden importa:

1. Primero → Desconecta el API Key en Nessty (Más ··· > Plataformas externas > Totalpass)
2. Después → Cambia o genera el nuevo API Key en Totalpass
3. Al final → Conecta el nuevo API Key en Nessty

⚠️ Si lo haces al revés (cambiar primero en Totalpass), puede causar errores de conexión.

Mis clases no aparecen en Totalpass → Revisa que el servicio de esas clases esté seleccionado en Más ··· > Plataformas externas > Totalpass, dentro de la tarjeta de tu sucursal. Si ya lo está, activa las sesiones: márcalas en Sesiones, haz clic en Acciones y selecciona Activar en TotalPass.

No veo Totalpass en el menú de Más → Ve a Más > Tu estudio, activa Totalpass en el selector de plataformas y guarda.

La integración no conecta → Verifica que tu API Key tenga 36 caracteres y que lo hayas copiado completo, sin espacios. También checa que estés usando el API Key de la sucursal correcta.

Tengo varias sucursales → Cada sucursal necesita su propio API Key. En la página de integración verás una tarjeta por cada una, conéctalas por separado.

No tengo acceso a Integraciones en Totalpass → Solo el propietario de la cuenta (Account Owner) puede ver esa sección. Contacta al dueño del estudio para que complete ese paso.

Totalpass muestra menos lugares de los que tengo libres → La sesión tiene un límite de integraciones y Totalpass solo ve los lugares que le quedan de él. Revísalo en la línea Límite de integraciones del detalle de la sesión. Con límite compartido, lo que reserva Wellhub también se descuenta. Si acabas de cambiarlo y Totalpass no se actualiza, haz clic en Sync en la sección Totalpass de la sesión.

Un cliente de Totalpass no puede reservar → Abre su perfil y mira las etiquetas debajo de su nombre: Sin reservas de TotalPass significa que lo bloqueaste y Nessty rechaza sus reservaciones por Totalpass; una etiqueta roja como "TotalPass · 8 de 8 este mes · límite alcanzado" significa que llegó al límite mensual de tu sucursal. Si no tiene ninguna, puede que el límite de la sesión esté lleno y Totalpass le muestre la clase llena. En Actividad, la fila del intento dice la razón. Sigue Mi alumno de Wellhub o Totalpass no puede reservar.

Totalpass muestra 24 horas de cancelación y mi sesión es No reembolsable → Es lo esperado. Totalpass no tiene una opción de "sin cancelación", así que Nessty le envía 24 horas para las sesiones No reembolsable, igual que Firme. Si quieres otro plazo, cambia la Política de cancelación de la sesión en Nessty.

Totalpass no me deja cambiar el plazo de cancelación → El plazo se cambia en Nessty: edita la Política de cancelación de la sesión en Sesiones. Totalpass recibe el nuevo plazo en 1 a 5 minutos.

Cambié la política del servicio y Totalpass sigue con el plazo anterior → La política del servicio solo aplica a las sesiones nuevas. Las sesiones ya programadas conservan su política: edítalas una por una en Sesiones.

Mi clase ya se puede reservar en Nessty pero en Totalpass todavía no → Totalpass abre las reservaciones como máximo 30 días antes de la clase. Si la ventana de reservación de tu servicio abre antes, en Totalpass la clase se puede reservar a partir de 30 días antes.