Plugin Mindbody para WordPress a medida: qué hay que prever

Los plugins gratuitos de Mindbody y el widget Branded Web se detienen todos en el mismo punto: en el momento de reservar y pagar, el cliente sale de tu web. Cuando un estudio quiere todo el recorrido con su marca, la respuesta es un plugin de WordPress a medida construido sobre la API de Mindbody.

Los desarrollamos para estudios y redes (las marcas de Monday Sports Club, STAT Modern Health). Este es el checklist que repasamos en cada proyecto. Te sirve tanto si nos contratas a nosotros como a otro desarrollador, o si lo haces internamente.

1. El acceso a la API de Mindbody

• Una cuenta de desarrollador en el portal de desarrolladores de Mindbody, que te da una clave de API.
• La activación por parte del estudio. Para cada site de Mindbody (cada Site ID), el propietario aprueba tu acceso mediante un enlace de activación. Una red con varios sites aprueba cada uno.
• Un usuario de staff dedicado a la integración. Las llamadas desde el servidor usan un token de staff. Dale a ese usuario solo los permisos necesarios.
• El sandbox. Mindbody ofrece un site de pruebas: la mayor parte del trabajo se hace antes de tocar datos reales.
• El coste de uso. Mindbody factura las llamadas a la API por encima de un cupo gratuito. Tu estrategia de caché (punto 3) decide la mayor parte de esa factura.

2. La arquitectura: WordPress delante, Mindbody detrás

El esquema que aguanta en producción:

• El plugin hace las llamadas a Mindbody, en el servidor. El navegador nunca ve la clave de API ni el token de staff.
• WordPress expone sus propias rutas REST (/wp-json/tu-plugin/...) que llama la interfaz de reserva: horario, ficha de clase, carrito, pago, área de socio.
• La interfaz vive en tu tema, mediante un shortcode, un bloque o una plantilla de página dedicada. Toma los colores y tipografías del tema: parece nativa sin duplicar el diseño.
• Mindbody sigue siendo la fuente de verdad. Ninguna copia de clientes, tarifas o reservas en WordPress, salvo una caché de corta duración. Los datos duplicados divergen, y los datos divergentes generan incidencias.

3. Datos y caché

• Guarda el horario en caché poco tiempo (minutos, no horas) y refréscalo después de cada reserva o cancelación hecha desde tu web.
• Vuelve a leer las plazas libres en el momento de reservar. Un «quedan 3 plazas» en caché vale para mostrar, no para confirmar.
• Guarda más tiempo los datos de referencia: centros, descripciones de clases, biografías de coaches, tarifas.
• Escucha los cambios cuando sea posible: los webhooks de Mindbody avisan cuando cambian clases o reservas, para invalidar la caché correcta en lugar de consultar la API en bucle.

4. Las cuentas de cliente

Aquí es donde se complican la mayoría de las integraciones.

• Decide cómo inician sesión los socios: con su usuario de Mindbody actual, o con una cuenta en tu web vinculada a su perfil de Mindbody. Las dos opciones funcionan; mezclarlas sin reglas, no.
• Busca antes de crear. Busca al cliente por email antes de crear un perfil. Los duplicados parten el historial y los créditos de un socio, y la recepción acaba fusionándolos a mano.
• Respeta los campos obligatorios. Cada site de Mindbody puede exigir campos distintos (teléfono, dirección, fecha de nacimiento, contacto de emergencia). Léelos, no los programes a fuego.

5. Las reglas de reserva

• Qué tarifas pueden pagar qué clase. El plugin debe descontar el crédito correcto, o proponer la compra correcta, exactamente como lo haría la recepción.
• Listas de espera, cancelación tardía, ausencias: léelas en los ajustes del site para que la web y la recepción nunca se contradigan.
• Redes multicentro: créditos que funcionan de un centro a otro, el bono correcto descontado en el sitio correcto. Prevéelo desde el principio si tienes más de un site.
• Lo que el widget no sabe hacer: elegir bici, reformer o saco, venir acompañado, créditos de referidos. Todo eso vive en tu plugin, por encima de las reglas de Mindbody, nunca en contra.

6. El pago

• Tarjeta con 3D Secure. Las tarjetas europeas exigen autenticación reforzada; el recorrido debe gestionar la validación bancaria sin perder el carrito.
• Tarjeta guardada para volver a comprar en un clic, si el estudio lo permite.
• Un modo de prueba real. Mindbody puede validar un carrito sin cobrarlo. Úsalo en preproducción para probar todo el recorrido, de principio a fin, antes del lanzamiento.
• Medios de pago de terceros como el pago en 3 o 4 plazos con Alma: la reserva y la venta salen bien juntas o se anulan juntas. Ningún pedido a medio confirmar.

7. Tracking y consentimiento

• Envía view_item, add_to_cart, begin_checkout y purchase a GA4, con su valor, para que Google Ads optimice sobre ventas reales.
• Respeta el consentimiento: con Consent Mode, los eventos solo se convierten en cookies si el visitante acepta.

8. Tema, accesibilidad e idiomas

• Usa la tipografía y los colores del tema; evita un segundo sistema de diseño metido dentro del primero.
• Navegación con teclado, foco visible, contrastes legibles: la reserva es un formulario, trátala como tal.
• Si tu web es multilingüe, la reserva también debe serlo, emails y mensajes de error incluidos.

9. Velocidad y SEO

• Carga la interfaz de reserva solo donde se usa, y solo lo que necesita el paso actual.
• Reserva el espacio del horario para que no haga saltar la página al cargarse.
• Mantén las páginas de clases y estudios como páginas reales e indexables; el iframe nunca te lo permitió.

10. Supervisión y mantenimiento

• Monitorización de errores (usamos Sentry) en PHP y en la interfaz, para saber que un pago ha fallado antes de que un socio te escriba.
• Registro de las respuestas de Mindbody, con los datos personales enmascarados, para diagnosticar rápido.
• Alguien es responsable del plugin. La API de Mindbody evoluciona, WordPress se actualiza, las reglas de pago cambian. Una reserva es facturación en tiempo real: necesita un responsable, no una entrega puntual.

¿Desarrollarlo o encargarlo?

Si tienes un desarrollador que conoce bien WordPress y tiene tiempo para aprender las particularidades de la API de Mindbody, este checklist es tu mapa. Si la reserva es crítica y prefieres partir de piezas que ya funcionan en producción, es exactamente lo que hacemos: mira nuestro plugin Mindbody para WordPress a medida, o compara primero los plugins gratuitos.

¿No tienes claro qué camino le conviene a tu estudio? Envíanos tu página de reservas y te lo diremos con franqueza.