Cómo añadir la reserva Mindbody a WordPress: 3 formas

Tu estudio funciona con Mindbody y tu web con WordPress. Tarde o temprano surge la pregunta: ¿cómo pongo la reserva de Mindbody en la web? Hay tres formas de hacerlo, y no son equivalentes.

La respuesta corta:

1. Pegar un widget de Mindbody Branded Web (antes Healcode). Gratis, listo en 15 minutos, pero la reserva funciona dentro de un iframe de Mindbody, con el aspecto de Mindbody.
2. Instalar un plugin de Mindbody para WordPress como MZ Mindbody API. Tu horario se muestra en tu tema, pero la inscripción y el pago vuelven a Mindbody.
3. Desarrollar una integración a medida sobre la API de Mindbody, normalmente en forma de plugin de WordPress propio. Horario, reserva y pago viven en tu tema, con tu marca y con un tracking real. Es un proyecto, no una descarga.

	Widget Branded Web	Plugin Mindbody para WordPress	Integración a medida
Puesta en marcha	Copiar y pegar	Instalación + credenciales API	Proyecto de desarrollo
Aspecto	El de Mindbody	Tu tema para la lista, Mindbody para la reserva	100 % tu marca
Dónde ocurre la reserva	Iframe de Mindbody	Páginas de Mindbody	En tu web
Seguimiento de compras GA4 / Google Ads	No	No	Sí
Elección de sitio, listas de espera, pago a plazos	Solo las opciones de Mindbody	No	Sí
Coste recurrente	Incluido en Mindbody	Plugin gratuito, uso de la API de Mindbody	Desarrollo + mantenimiento

Vamos al detalle, método a método.

Método 1: pegar un widget Branded Web

Es la vía oficial de Mindbody para poner la reserva en cualquier web. Mindbody lo llama Branded Web; antes se llamaba Healcode, y el código todavía lo recuerda.

Paso a paso:

1. En tu cuenta Mindbody, abre las herramientas de Branded Web y crea el widget que necesitas: horario, citas, inscripción, un botón «Comprar» para una tarifa o un enlace de acceso.
2. Elige colores y tipografías en el editor del widget y copia el código de inserción.
3. En WordPress, edita la página, añade un bloque HTML personalizado (o el widget HTML de tu maquetador) y pega el código.
4. Publica y prueba en un móvil de verdad: desplázate por el horario, reserva una clase, llega hasta el pago.

Lo que realmente llega a tu página. El widget de horario actual es una etiqueta <healcode-widget data-type="schedules">. Al cargarse, inserta un iframe que apunta a go.mindbodyonline.com. Todo lo que hay dentro de ese marco pertenece a Mindbody. El CSS de tu tema se detiene en su borde: por eso el editor solo te deja cambiar colores y tipografías, no la maquetación ni el recorrido.

Los problemas habituales en WordPress:

• Los plugins de optimización. WP Rocket, Autoptimize y similares, que retrasan o combinan el JavaScript, pueden impedir que el widget se cargue. Excluye el script de Healcode del «retraso de JS» y de la minificación.
• El salto de diseño. El iframe llega después de que se pinte la página y empuja el contenido hacia abajo. Reserva una altura mínima alrededor del bloque.
• El scroll en móvil. Un iframe alto dentro de una página que se desplaza crea un «scroll dentro del scroll» incómodo para el pulgar.
• Ningún dato de compra. El pago ocurre dentro del marco de Mindbody: GA4 y Google Ads no ven la venta.

Elígelo si necesitas la reserva online hoy, sin coste, y el aspecto estándar de Mindbody te vale.

Método 2: instalar un plugin de Mindbody para WordPress

Ya no hay un plugin oficial de Mindbody en WordPress.org: el antiguo plugin «MINDBODY Widget» se cerró en marzo de 2021. Quedan plugins de terceros.

• MZ Mindbody API (gratuito, de código abierto, todavía mantenido en 2026). Lee tu horario, tus eventos y tus coaches a través de la API de Mindbody y los muestra con shortcodes, en plantillas que puedes sobrescribir desde tu tema.
• MB Spirit for Mindbody (plugin de un servicio de pago, última actualización en 2023). Shortcodes para horarios, eventos, coaches y productos configurados en el panel de MB Spirit.

Configurar MZ Mindbody API, en resumen:

1. Crea una cuenta en el portal de desarrolladores de Mindbody y consigue una clave de API.
2. Pide al propietario del estudio que active tu acceso a su site de Mindbody (le envías un enlace de activación para su Site ID y él lo aprueba).
3. Instala el plugin desde WordPress.org e introduce en sus ajustes las credenciales que pide (clave de API, Site ID, un usuario de staff con el que obtiene su token). El autor documenta la instalación en mZoo.org.
4. Añade sus shortcodes a tus páginas y dale estilo con el CSS de tu tema o sobrescribiendo sus plantillas.

Lo que ganas: el horario es HTML real en tu página, con el estilo de tu tema y legible por Google.

Lo que no ganas: cuando alguien pulsa «Inscribirse», el plugin lo envía a Mindbody para iniciar sesión, pagar y confirmar. La parte del recorrido que convierte, la que querrías medir, sigue ocurriendo fuera de tu web. Además, Mindbody factura el uso de la API por encima de un cupo gratuito; consulta las condiciones actuales en el portal de desarrolladores.

Elígelo si quieres sobre todo un horario bonito e indexable en WordPress y tu volumen de reservas es moderado.

Método 3: una integración a medida sobre la API de Mindbody

La tercera vía deja Mindbody exactamente donde está (horario, clientes, tarifas, pagos, informes) y sustituye solo lo que ven tus socios. En la práctica, es un plugin de WordPress a medida que se comunica con la API pública de Mindbody (v6) desde tu servidor y muestra todo el recorrido en tu tema:

• el horario, con tus filtros (estudio, coach, tipo de clase);
• la ficha de la clase, con elección de sitio si tus salas lo necesitan;
• el carrito y el pago, con 3D Secure y, si quieres, pago en 3 o 4 plazos con Alma;
• el área de socio: créditos, suscripciones, próximas reservas, enlace de referidos.

Las reservas y las ventas se escriben de vuelta en Mindbody: la recepción ve las visitas y tus informes siguen siendo exactos.

Lo que tiene que resolver una integración seria:

• Credenciales solo en el servidor. La clave de API y el token de staff nunca llegan al navegador.
• Caché. El horario se guarda en caché poco tiempo y se refresca tras cada reserva: las páginas siguen siendo rápidas y las llamadas a la API, bajo control.
• Un modo de prueba real. Mindbody puede validar un carrito sin cobrarlo, así que se prueba todo el recorrido en un entorno de preproducción antes del lanzamiento.
• El tracking. Los eventos view_item, add_to_cart, begin_checkout y purchase, con su valor, enviados a GA4 y utilizables por Google Ads.
• El mantenimiento. La API de Mindbody evoluciona: alguien tiene que vigilar los errores en producción y adaptarse.

Un ejemplo real. Para STAT Modern Health, una red estadounidense de clínicas con WordPress, programamos la reserva de citas como un plugin de WordPress conectado a Mindbody: necesidad, centro, profesional, hora y confirmación, en cinco pasos, dentro del propio tema de la web. Puedes ver las pantallas en nuestra página del plugin Mindbody para WordPress.

Elígelo si la reserva pesa mucho en tu facturación, inviertes en publicidad o el iframe te está haciendo perder socios en el pago.

Decidir en dos minutos

• Solo necesitas un horario online: método 1 o 2.
• Quieres el horario con tu diseño e indexable por Google: método 2.
• Quieres que se reserve y se pague sin salir de tu web, con tu marca y con ventas medibles: método 3.

Si dudas entre los plugins, nuestra guía de plugins Mindbody para WordPress los compara en detalle. Y si quieres una segunda opinión sobre tu configuración actual, auditamos páginas de reserva gratis: envíanos la URL.