«Si al pulsar el botón funciona, el plugin está bien». Esa conclusión parecía lógica, pero era falsa. En este proyecto, la sincronización manual de clientes con WordPress funcionaba perfectamente. Sin embargo, editar un cliente desde la aplicación no enviaba ningún cambio visible.
La clave fue dejar de tratar ambos comportamientos como si fueran el mismo proceso.
Dos botones, dos caminos técnicos
La sincronización manual se ejecutaba dentro de WordPress. Leía directamente la base de datos externa, transformaba el usuario y lo guardaba. La automática nacía en la aplicación: debía detectar el cambio, construir una petición REST, elegir el entorno correcto, autenticarse y esperar la respuesta.
Que el primer camino funcionara demostraba que WordPress podía crear o actualizar el usuario. No demostraba que la aplicación estuviera llamando al endpoint correcto.
El entorno también formaba parte del error
Al revisar la configuración encontré que una instalación previa podía clasificarse como entorno de pruebas y utilizar una URL predeterminada de Sandbox. El usuario editaba datos en PRE, pero la aplicación intentaba sincronizarlos en otro WordPress.
Este tipo de fallo es especialmente confuso porque no siempre produce un error visible. El servidor de destino puede responder correctamente, solo que no es el servidor que estamos mirando.
Cómo lo convertí en un flujo observable
- Separé claramente configuración de producción, preproducción y sandbox.
- Registré URL de destino, tienda, sitio WordPress y usuario en cada llamada.
- Mostré por separado llamadas recibidas, errores y sincronizaciones completadas.
- Diferencié las acciones «creado», «actualizado», «saltado» y «rechazado».
- Evité que una fila de “llamada recibida” se interpretara como prueba de guardado.
La comprobación que ahorra más tiempo
Cuando una operación manual funciona y la automática no, comparo cuatro puntos: quién inicia el proceso, qué credenciales utiliza, a qué URL se dirige y con qué identificadores. Normalmente la respuesta aparece en una de esas diferencias.
También recomiendo añadir un identificador de correlación. Permite seguir una misma operación desde la aplicación hasta WordPress sin buscar por hora aproximada o correo electrónico.
No basta con que una petición llegue
Una llamada puede constar como recibida y aun así ser rechazada durante la validación. La observabilidad debe mostrar el recorrido completo. Esa diferencia ayudó a dejar de perseguir falsos positivos y a encontrar el verdadero problema de configuración.