Ir al contenido principal

Integración vía API - EVO y TotalPass

Aprenda a integrar TotalPass a través de la API

Escrito por Viviane Flores

Para aprovechar al máximo las funcionalidades descritas en este artículo, compruebe que la tarjeta de integración está correctamente configurada según sus necesidades.

Opción de Menú

Menú Configuración - Integraciones

Permisos de perfil

Menú Administración - Permisos:

  • Configuración - integraciones

TotalPass es una herramienta que pone a tu disposición el horario de tu local en tu app.

Para acceder a TotalPass para integrarlo con EVO, debe tener acceso a la plataforma mediante el inicio de sesión de propietario con el permiso de administrador.

Paso 1: Activar la integración en la aplicación TotalPass

En el menú de la izquierda, clic en Integraciones.

Si la pantalla que aparece es diferente, clic en el botón Acceder a nueva versión, como se muestra en la imagen siguiente:

En esta pantalla, encontrará dos claves API diferentes:

  • Clave API de validación de token

  • Clave API de reserva

Ambas deben configurarse en la ficha de integración disponible en EVO para garantizar que la integración funciona correctamente.

En la pestaña Token Validation, clic en Configure integrations.

En el campo Seleccionar socio, seleccione la opción EVO. Se generará el código de integración, clic en Copy API Key.

En EVO, en el menú Integraciones, en la tarjeta de integración TotalPass, copia este código en el campo Clave API (Token de validación).

Nota

Aunque está permitido utilizar el mismo clave de integración (Clave API), en caso de que esto no sea deseado, el sistema mostrará una advertencia de duplicidad cuando el clave de integración (Clave API) informado ya esté siendo utilizado en otra sede.

  • El campo Clave API (Clases) es necesario para el nuevo check-in, en el que no es obligatorio vender un plan a los clientes procedentes de TotalPass.

  • Es necesario activar la opción de Integración de reservas API y configurar los planes si desea indicar qué actividades se pondrán a disposición de los clientes en TotalPass.

En el portal TotalPass, clic en la pestaña Clases y, a continuación, en Configurar integraciones.

Si se trata de una cadena de gimnasios, en el campo Gimnasio, seleccione la sede correspondiente. Si se trata de una sola sede, selecciona la que esté disponible.
En el campo Seleccione un socio, seleccione EVO.
Se generará la Clave API. Clic en el botón Copiar Clave API.


En EVO, en la tarjeta de integración, copia en el campo Clave API.

Para una cadena, el proceso debe repetirse para cada una de las sede.

Paso 2: Integración con EVO

Ahora en EVO, vaya a Ajustes - Integraciones:

A continuación, clic en la tarjeta TotalPass.

Rellene el código de integración en Place API Key, introduzca las opciones que desee a continuación, para que se produzca la integración de la reserva, seleccione Integración reserva vía API.

En la tarjeta de integración, se ha habilitado la opción Integración reserva vía API. Al activar esta opción y hacer clic en +Añadir plan, EVO carga todos los planes del cliente en TotalPass y los muestra en la tarjeta. A continuación, el usuario tiene que vincular un grupo de actividades a cada plan. El funcionamiento es similar al que ya conocemos de las reservas de Wellhub.

Importante

  • Cuando guarde los ajustes, se enviará un correo electrónico a TotalPass pidiéndoles que habiliten la nueva integración en su sistema. Si desea recibir una copia de esta solicitud, introduzca una dirección de correo electrónico válida.

  • Para poder reservar actividades a través de TotalPass además de esta integración, es necesario activar la opción de mostrar la actividad en TotalPass. Obtenga más información en el artículo Configuración de la actividad en Otros parámetros.

  • Después de habilitar la opción en las actividades, el envío de ellas a TotalPass se realizará automáticamente durante la noche. Hasta que se complete este proceso, los usuarios de TotalPass seguirán viendo todo el grade de horario en la aplicación.

Nota

Configure la pantalla de programación y cancelación individualmente para cada actividad. Hasta que se realice esta configuración, se adoptará la predeterminada: las lecciones TotalPass pueden reservarse o cancelarse hasta con 7 días de antelación, a contar desde la hora de inicio de la lección.

En los ajustes de la actividad, el campo Permite reservar cuánto tiempo antes define con cuántos días de antelación aparecerán las lecciones para reservar en la aplicación TotalPass.

En el siguiente ejemplo, sólo las lecciones de los próximos 3 días serán visibles para los clientes.

Importante

  • Las lecciones fuera de la ventana de reserva no se muestran en la aplicación TotalPass.

  • Si ya utilizas la configuración de booking, desactivar la integración en la tarjeta eliminará todas las clases previamente creadas en TotalPass.
    Si la integración se reactiva, las clases solo se volverán a enviar al agregador durante el procesamiento nocturno. 

Control de booking y check-in

Es posible realizar el control de booking y check-in. Para más información, consulta el artículo Totalpass - Control de booking y check-in.

Cambio de plan

En caso de cambio de plan, es necesario reconfigurar la tarjeta de integración de TotalPass. Para ello:

  1. Deshabilita la integración y, a continuación, vuelve a habilitarla.

  2. Todas las actividades creadas en TotalPass, así como los clientes vinculados a ellas, se eliminarán automáticamente.

  3. Después de reactivar la integración, habilita el booking y configura cada producto de TotalPass de acuerdo con las actividades de tu establecimiento.

Durante el procesamiento nocturno, el sistema recreará automáticamente todas las clases en TotalPass.


Importante

Al solo eliminar y volver a relacionar los productos de TotalPass con las actividades, la actualización de esta información ocurrirá en un intervalo de hasta 5 días.

Cómo funciona la integración

TotalPass para EVO

Elección del lugar de entrenamiento y acceso al horario:

  • En la app TotalPass, el cliente elige dónde quiere entrenar.

  • El cliente tiene acceso al horario de las actividades, de acuerdo con las actividades definidas que se mostrarán en TotalPass.

Registro y reserva en EVO

  • Cuando EVO recibe una solicitud de reserva, comprueba si el registro del cliente ya existe en CPF. Si no encuentra ninguno, el sistema crea automáticamente el registro del cliente y lo inserta en la actividad deseada. Del mismo modo, cuando recibe una solicitud de registro, EVO busca el CPF y, si no encuentra el registro, lo crea según la configuración definida en la tarjeta, ya sea como prospecto o como cliente.

En este escenario, los siguientes datos son enviados por TotalPass y quedan registrados en el registro del cliente:

  • Nombre

  • Apellido

  • CPF (o CURP, en el caso de México)

  • Teléfono

Acceso

  • Los clientes sólo pueden entrar a través del control de acceso una vez que se han registrado en TotalPass, es decir, la mera petición de cita no da acceso a través del torniquete. Para garantizar el control de acceso, es necesario registrar los datos biométricos (digitales y/o faciales) del cliente.

EVO para TotalPass

Requisitos del plan

  • No es obligatorio que el cliente tenga un plan, pero el gimnasio puede optar por vender un plan TotalPass para facilitar el control de los paneles e informes.

    Nota: La configuración del plan nunca autorizará el acceso a un cliente TotalPass. Sólo la validación del check-in directamente en TotalPass garantizará el acceso.

Registro y validación del acceso

  • El sistema consulta TotalPass para comprobar que el cliente puede ser autorizado.

  • La validación incluye:

    • Comprobación de si el cliente está activo en TotalPass.

    • Comprobación de si el cliente ya ha entrado en otro gimnasio el mismo día:

    • Si es así, no será liberado.

    • Si está intentando entrar en el mismo gimnasio en el que entró anteriormente, será liberado.

Configuración del control de acceso

  • En Ajustes - Control de acceso - pestaña Bloqueo de acceso, puede configurar que sólo se permita una entrada por día.

Reservas TotalPass

  • Las reservas realizadas por TotalPass, ya sea en el momento de la reserva o en el momento de la liberación en el control de acceso, no validan reglas de plan como:

    • Grupos de actividades.

    • Horarios.

    • Control de sesiones.

Si, en EVO, la actividad está configurada para mostrarse en TotalPass y la opción Permitir elegir número de asiento está activada si el área vinculada está personalizada con equipos configurados, esta información se enviará automáticamente a la clases en TotalPass.

Para asegurarse de que el equipo se muestra correctamente en la aplicación TotalPass, es necesario vincular el equipo correspondiente en EVO en Administración - Equipos en el campo Seleccionar lo que se mostrará en la aplicación Totalpass. Consulte más información sobre los equipos en este artículo.

Importante

En caso de que sea necesario remover al cliente del agendamiento, como en situaciones de sobrecupo (overbooking), el cliente será notificado por correo electrónico y SMS.

Configuración del plan - Acceso

Si sólo trabaja con facturación y no con reservas, puede configurar en el plan qué sede de sus clientes TotalPass tienen acceso al horario de clases a través de través del aplicativo del cliente y del sitio web. Vea cómo configurarlo clic aquí.

Importante

Si desea que el cliente acceda al espacio utilizando el torniquete, es necesario:

  • Utilizar la clave API de la tarjeta de integración: la API es única para todos los gimnasios que el propietario tenga en el portal TotalPass.

¿Cómo aparece este cliente en la agenda?

En la ficha de la actividad, clic en el nombre del participante; el origen de la cita será "TotalPass".

Cómo identificar al cliente en el registro

En el Menú Clientes, al acceder al registro, clic en la pestaña Agregadores y seleccione la opción TotalPass.


Se mostrarán dos situaciones: una cuando el cliente esté vinculado a TotalPass y otra cuando no lo esté. Veamos este ejemplo:


Clic en Validar si necesita comprobarlo de nuevo.

¿Quieres saber más acerca de la generación del token de TotalPass? Lee aquí.

¿Ha quedado contestada tu pregunta?