Com afegir la reserva Mindbody a WordPress: 3 maneres

El teu estudi funciona amb Mindbody i el teu web amb WordPress. Tard o d’hora surt la pregunta: com poso la reserva de Mindbody al web? Hi ha tres maneres de fer-ho, i no són equivalents.

La resposta curta:

1. Enganxar un widget de Mindbody Branded Web (abans Healcode). Gratis, llest en 15 minuts, però la reserva funciona dins d’un iframe de Mindbody, amb l’aspecte de Mindbody.
2. Instal·lar un plugin de Mindbody per a WordPress com MZ Mindbody API. El teu horari es mostra al teu tema, però la inscripció i el pagament tornen a Mindbody.
3. Desenvolupar una integració a mida sobre l’API de Mindbody, normalment en forma de plugin de WordPress propi. Horari, reserva i pagament viuen al teu tema, amb la teva marca i amb un tracking real. És un projecte, no una descàrrega.

	Widget Branded Web	Plugin Mindbody per a WordPress	Integració a mida
Posada en marxa	Copiar i enganxar	Instal·lació + credencials API	Projecte de desenvolupament
Aspecte	El de Mindbody	El teu tema per a la llista, Mindbody per a la reserva	100 % la teva marca
On passa la reserva	Iframe de Mindbody	Pàgines de Mindbody	Al teu web
Seguiment de compres GA4 / Google Ads	No	No	Sí
Tria de lloc, llistes d’espera, pagament a terminis	Només les opcions de Mindbody	No	Sí
Cost recurrent	Inclòs a Mindbody	Plugin gratuït, ús de l’API de Mindbody	Desenvolupament + manteniment

Anem al detall, mètode a mètode.

Mètode 1: enganxar un widget Branded Web

És la via oficial de Mindbody per posar la reserva en qualsevol web. Mindbody en diu Branded Web; abans es deia Healcode, i el codi encara ho recorda.

Pas a pas:

1. Al teu compte Mindbody, obre les eines de Branded Web i crea el widget que necessites: horari, cites, inscripció, un botó «Comprar» per a una tarifa o un enllaç d’accés.
2. Tria colors i tipografies a l’editor del widget i copia el codi d’inserció.
3. A WordPress, edita la pàgina, afegeix un bloc HTML personalitzat (o el widget HTML del teu maquetador) i enganxa-hi el codi.
4. Publica i prova-ho en un mòbil de veritat: desplaça’t per l’horari, reserva una classe, arriba fins al pagament.

El que arriba realment a la teva pàgina. El widget d’horari actual és una etiqueta <healcode-widget data-type="schedules">. Quan es carrega, insereix un iframe que apunta a go.mindbodyonline.com. Tot el que hi ha dins d’aquest marc pertany a Mindbody. El CSS del teu tema s’atura a la seva vora: per això l’editor només et deixa canviar colors i tipografies, no la maquetació ni el recorregut.

Els problemes habituals a WordPress:

• Els plugins d’optimització. WP Rocket, Autoptimize i similars, que endarrereixen o combinen el JavaScript, poden impedir que el widget es carregui. Exclou l’script de Healcode del «retard de JS» i de la minificació.
• El salt de disseny. L’iframe arriba després que es pinti la pàgina i empeny el contingut cap avall. Reserva una alçada mínima al voltant del bloc.
• El desplaçament al mòbil. Un iframe alt dins d’una pàgina que es desplaça crea un «scroll dins de l’scroll» incòmode per al polze.
• Cap dada de compra. El pagament passa dins del marc de Mindbody: GA4 i Google Ads no veuen la venda.

Tria’l si necessites la reserva en línia avui, sense cost, i l’aspecte estàndard de Mindbody ja et va bé.

Mètode 2: instal·lar un plugin de Mindbody per a WordPress

Ja no hi ha cap plugin oficial de Mindbody a WordPress.org: l’antic plugin «MINDBODY Widget» es va tancar el març de 2021. Queden plugins de tercers.

• MZ Mindbody API (gratuït, de codi obert, encara mantingut el 2026). Llegeix el teu horari, els esdeveniments i els coaches a través de l’API de Mindbody i els mostra amb shortcodes, en plantilles que pots sobreescriure des del teu tema.
• MB Spirit for Mindbody (plugin d’un servei de pagament, darrera actualització el 2023). Shortcodes per a horaris, esdeveniments, coaches i productes configurats al tauler de MB Spirit.

Configurar MZ Mindbody API, en resum:

1. Crea un compte al portal de desenvolupadors de Mindbody i aconsegueix una clau d’API.
2. Demana al propietari de l’estudi que activi el teu accés al seu site de Mindbody (li envies un enllaç d’activació per al seu Site ID i ell l’aprova).
3. Instal·la el plugin des de WordPress.org i introdueix als seus ajustos les credencials que demana (clau d’API, Site ID, un usuari de staff amb què obté el seu token). L’autor documenta la instal·lació a mZoo.org.
4. Afegeix-ne els shortcodes a les teves pàgines i dona-hi estil amb el CSS del teu tema o sobreescrivint-ne les plantilles.

El que guanyes: l’horari és HTML real a la teva pàgina, amb l’estil del teu tema i llegible per Google.

El que no guanyes: quan algú prem «Inscriure’s», el plugin l’envia a Mindbody per iniciar sessió, pagar i confirmar. La part del recorregut que converteix, la que voldries mesurar, continua passant fora del teu web. A més, Mindbody factura l’ús de l’API per sobre d’una quota gratuïta; consulta les condicions actuals al portal de desenvolupadors.

Tria’l si vols sobretot un horari bonic i indexable a WordPress i el teu volum de reserves és moderat.

Mètode 3: una integració a mida sobre l’API de Mindbody

La tercera via deixa Mindbody exactament on és (horari, clients, tarifes, pagaments, informes) i substitueix només el que veuen els teus socis. A la pràctica, és un plugin de WordPress a mida que es comunica amb l’API pública de Mindbody (v6) des del teu servidor i mostra tot el recorregut al teu tema:

• l’horari, amb els teus filtres (estudi, coach, tipus de classe);
• la fitxa de la classe, amb tria de lloc si les teves sales ho necessiten;
• el carretó i el pagament, amb 3D Secure i, si vols, pagament en 3 o 4 terminis amb Alma;
• l’àrea de soci: crèdits, subscripcions, properes reserves, enllaç de referits.

Les reserves i les vendes s’escriuen de tornada a Mindbody: la recepció veu les visites i els teus informes continuen sent exactes.

El que ha de resoldre una integració seriosa:

• Credencials només al servidor. La clau d’API i el token de staff no arriben mai al navegador.
• Memòria cau. L’horari es desa en memòria cau poc temps i es refresca després de cada reserva: les pàgines continuen sent ràpides i les crides a l’API, sota control.
• Un mode de prova real. Mindbody pot validar un carretó sense cobrar-lo, així que es prova tot el recorregut en un entorn de preproducció abans del llançament.
• El tracking. Els esdeveniments view_item, add_to_cart, begin_checkout i purchase, amb el seu valor, enviats a GA4 i utilitzables per Google Ads.
• El manteniment. L’API de Mindbody evoluciona: algú ha de vigilar els errors en producció i adaptar-s’hi.

Un exemple real. Per a STAT Modern Health, una xarxa nord-americana de clíniques amb WordPress, vam programar la reserva de cites com un plugin de WordPress connectat a Mindbody: necessitat, centre, professional, hora i confirmació, en cinc passos, dins del mateix tema del web. Pots veure’n les pantalles a la nostra pàgina del plugin Mindbody per a WordPress.

Tria’l si la reserva pesa molt en la teva facturació, inverteixes en publicitat o l’iframe et fa perdre socis al pagament.

Decidir en dos minuts

• Només necessites un horari en línia: mètode 1 o 2.
• Vols l’horari amb el teu disseny i indexable per Google: mètode 2.
• Vols que es reservi i es pagui sense sortir del teu web, amb la teva marca i amb vendes mesurables: mètode 3.

Si dubtes entre els plugins, la nostra guia de plugins Mindbody per a WordPress els compara en detall. I si vols una segona opinió sobre la teva configuració actual, auditem pàgines de reserva gratis: envia’ns la URL.