Plugin Mindbody per a WordPress a mida: què cal preveure

Els plugins gratuïts de Mindbody i el widget Branded Web s’aturen tots al mateix punt: en el moment de reservar i pagar, el client surt del teu web. Quan un estudi vol tot el recorregut amb la seva marca, la resposta és un plugin de WordPress a mida construït sobre l’API de Mindbody.

Els desenvolupem per a estudis i xarxes (les marques de Monday Sports Club, STAT Modern Health). Aquest és el checklist que repassem a cada projecte. Et serveix tant si ens contractes a nosaltres com a un altre desenvolupador, o si ho fas internament.

1. L’accés a l’API de Mindbody

• Un compte de desenvolupador al portal de desenvolupadors de Mindbody, que et dona una clau d’API.
• L’activació per part de l’estudi. Per a cada site de Mindbody (cada Site ID), el propietari aprova el teu accés mitjançant un enllaç d’activació. Una xarxa amb diversos sites n’aprova cadascun.
• Un usuari de staff dedicat a la integració. Les crides des del servidor fan servir un token de staff. Dona a aquest usuari només els permisos necessaris.
• El sandbox. Mindbody ofereix un site de proves: la major part de la feina es fa abans de tocar dades reals.
• El cost d’ús. Mindbody factura les crides a l’API per sobre d’una quota gratuïta. La teva estratègia de memòria cau (punt 3) decideix la major part d’aquesta factura.

2. L’arquitectura: WordPress davant, Mindbody darrere

L’esquema que aguanta en producció:

• El plugin fa les crides a Mindbody, al servidor. El navegador no veu mai la clau d’API ni el token de staff.
• WordPress exposa les seves pròpies rutes REST (/wp-json/el-teu-plugin/...) que crida la interfície de reserva: horari, fitxa de classe, carretó, pagament, àrea de soci.
• La interfície viu al teu tema, mitjançant un shortcode, un bloc o una plantilla de pàgina dedicada. Pren els colors i les tipografies del tema: sembla nativa sense duplicar el disseny.
• Mindbody continua sent la font de veritat. Cap còpia de clients, tarifes o reserves a WordPress, llevat d’una memòria cau de curta durada. Les dades duplicades divergeixen, i les dades divergents generen incidències.

3. Dades i memòria cau

• Desa l’horari en memòria cau poc temps (minuts, no hores) i refresca’l després de cada reserva o cancel·lació feta des del teu web.
• Torna a llegir les places lliures en el moment de reservar. Un «queden 3 places» en memòria cau serveix per mostrar, no per confirmar.
• Desa més temps les dades de referència: centres, descripcions de classes, biografies de coaches, tarifes.
• Escolta els canvis quan sigui possible: els webhooks de Mindbody avisen quan canvien classes o reserves, per invalidar la memòria cau correcta en lloc de consultar l’API en bucle.

4. Els comptes de client

Aquí és on es compliquen la majoria d’integracions.

• Decideix com inicien sessió els socis: amb el seu usuari de Mindbody actual, o amb un compte al teu web vinculat al seu perfil de Mindbody. Totes dues opcions funcionen; barrejar-les sense regles, no.
• Busca abans de crear. Busca el client per correu electrònic abans de crear un perfil. Els duplicats parteixen l’historial i els crèdits d’un soci, i la recepció acaba fusionant-los a mà.
• Respecta els camps obligatoris. Cada site de Mindbody pot exigir camps diferents (telèfon, adreça, data de naixement, contacte d’emergència). Llegeix-los, no els programis a foc.

5. Les regles de reserva

• Quines tarifes poden pagar quina classe. El plugin ha de descomptar el crèdit correcte, o proposar la compra correcta, exactament com ho faria la recepció.
• Llistes d’espera, cancel·lació tardana, absències: llegeix-les als ajustos del site perquè el web i la recepció no es contradiguin mai.
• Xarxes multicentre: crèdits que funcionen d’un centre a l’altre, el bo correcte descomptat al lloc correcte. Preveu-ho des del principi si tens més d’un site.
• El que el widget no sap fer: triar bici, reformer o sac, venir acompanyat, crèdits de referits. Tot això viu al teu plugin, per sobre de les regles de Mindbody, mai en contra.

6. El pagament

• Targeta amb 3D Secure. Les targetes europees exigeixen autenticació reforçada; el recorregut ha de gestionar la validació bancària sense perdre el carretó.
• Targeta desada per tornar a comprar amb un clic, si l’estudi ho permet.
• Un mode de prova real. Mindbody pot validar un carretó sense cobrar-lo. Fes-lo servir en preproducció per provar tot el recorregut, de principi a fi, abans del llançament.
• Mitjans de pagament de tercers com el pagament en 3 o 4 terminis amb Alma: la reserva i la venda surten bé juntes o s’anul·len juntes. Cap comanda mig confirmada.

7. Tracking i consentiment

• Envia view_item, add_to_cart, begin_checkout i purchase a GA4, amb el seu valor, perquè Google Ads optimitzi sobre vendes reals.
• Respecta el consentiment: amb Consent Mode, els esdeveniments només es converteixen en galetes si el visitant accepta.

8. Tema, accessibilitat i idiomes

• Fes servir la tipografia i els colors del tema; evita un segon sistema de disseny ficat dins del primer.
• Navegació amb teclat, focus visible, contrastos llegibles: la reserva és un formulari, tracta-la com a tal.
• Si el teu web és multilingüe, la reserva també ho ha de ser, correus i missatges d’error inclosos.

9. Velocitat i SEO

• Carrega la interfície de reserva només on es fa servir, i només el que necessita el pas actual.
• Reserva l’espai de l’horari perquè no faci saltar la pàgina en carregar-se.
• Mantén les pàgines de classes i estudis com a pàgines reals i indexables; l’iframe no t’ho va permetre mai.

10. Supervisió i manteniment

• Monitoratge d’errors (fem servir Sentry) en PHP i a la interfície, per saber que un pagament ha fallat abans que un soci t’escrigui.
• Registre de les respostes de Mindbody, amb les dades personals emmascarades, per diagnosticar ràpid.
• Algú és responsable del plugin. L’API de Mindbody evoluciona, WordPress s’actualitza, les regles de pagament canvien. Una reserva és facturació en temps real: necessita un responsable, no un lliurament puntual.

Desenvolupar-lo o encarregar-lo?

Si tens un desenvolupador que coneix bé WordPress i té temps per aprendre les particularitats de l’API de Mindbody, aquest checklist és el teu mapa. Si la reserva és crítica i prefereixes partir de peces que ja funcionen en producció, és exactament el que fem: mira el nostre plugin Mindbody per a WordPress a mida, o compara primer els plugins gratuïts.

No tens clar quin camí li convé al teu estudi? Envia’ns la teva pàgina de reserves i t’ho direm amb franquesa.