Saltar al contenido principal

Solución de problemas

Aquí tienes los problemas más habituales y cómo resolverlos paso a paso. Junto a cada uno te indicamos si afecta a las dos versiones del plugin (FREE y PRO) o solo a la PRO.

Nota: en la versión FREE el plugin está en IndedLabs → Mautic FREE; en la PRO, en IndedLabs → Mautic PRO. Los pasos son los mismos.

Instalación y licencia​

La web muestra "Script error: the ionCube Loader for PHP needs to be installed" (sólo PRO)​

Qué pasa: parte del plugin PRO está protegida con ionCube, y el servidor no tiene activo el ionCube Loader (versión 15 o superior) en la versión de PHP que usa tu web. Sin él, PHP se detiene al cargar el plugin y toda la web deja de funcionar, incluido el escritorio de WordPress.

Recupera la web al momento:

  1. Entra en el administrador de archivos de tu hosting.
  2. Ve a wp-content/plugins/ y cambia el nombre de la carpeta integrations-for-mautic-pro (por ejemplo, a integrations-for-mautic-pro-off).
  3. El plugin queda desactivado y la web vuelve a funcionar.

Soluciónalo: activa el loader en la versión de PHP que usa tu web.

  • Hosting con CloudLinux (selector de PHP): en cPanel, ve a Seleccionar versión de PHP → Extensiones y marca ioncube_loader. Instalarlo desde EasyApache (WHM) no afecta a las cuentas que usan el selector de CloudLinux.
  • Si el selector muestra "native" (o no hay selector): tu web usa el PHP de EasyApache. Mira en MultiPHP Manager qué versión usa el dominio (por ejemplo ea-php83) e instala ionCube en EasyApache para esa versión exacta.
  • Con LiteSpeed: si después de activarlo sigue fallando, reinicia PHP desde el plugin de LiteSpeed en WHM.

Después, vuelve a poner a la carpeta del plugin su nombre original.

Nota: si no tienes acceso a estas opciones, pásale este apartado a tu proveedor de hosting.

"El servidor de licencias no puede ser contactado" (sólo PRO)​

Tu web no ha podido comunicarse con el servidor de licencias. Suele deberse a un bloqueo del hosting, a un cortafuegos o a una caída temporal.

  • Si la licencia ya estaba activa, el plugin sigue funcionando durante un periodo de gracia y lo vuelve a intentar solo.
  • Si el aviso no desaparece, pide a tu hosting que confirme que la web puede hacer conexiones salientes por HTTPS.

Más información en Instalación y licencia.

Conexión con Mautic​

"La conexión con Mautic no está configurada o ha expirado / ha caducado…" (FREE y PRO)​

En la PRO el aviso dice "La conexión con Mautic no está configurada o ha expirado. Los módulos PRO han sido temporalmente pausados."; en la FREE, "La conexión con Mautic no está configurada o ha caducado. Los módulos están en pausa temporalmente." Significa que falta configurar la conexión o que la autorización ha caducado.

  1. Ve a Ajustes de Conexión y comprueba que el Estado es Conectado.
  2. Si no lo es, pulsa Conectar/Reconectar con Mautic (Conectar WordPress con Mautic).
  3. (Sólo PRO) Si te pasa a menudo, sobre todo en webs con pocas visitas, configura el cron externo de renovación del token (Conectar WordPress con Mautic).

"Mautic ha rechazado la conexión y hay que volver a autorizarla…" (sólo PRO)​

Mautic ya no acepta el acceso que tenía guardado tu web. Para no cargar la web ni Mautic, el plugin deja de intentarlo hasta que vuelvas a conectar.

  1. Ve a Ajustes de Conexión y pulsa Conectar/Reconectar con Mautic.
  2. Si la reconexión falla, entra en Mautic, ve a Ajustes → Credenciales API y comprueba que la credencial de tu web sigue existiendo y que el Client ID y el Client Secret coinciden con los del plugin.
  3. Si la credencial se borró, crea una nueva siguiendo los pasos de Conectar WordPress con Mautic.

Nota: mientras tanto, la URL del cron externo responde reconnect_required.

Módulos y formularios​

Una pestaña de Ajustes de Módulos sale en gris (sólo PRO)​

Ese módulo está desactivado o falta el plugin del que depende (Elementor Pro o WooCommerce). Lo que ves es una vista previa de sus opciones. Actívalo en Módulos (Activar los módulos).

No aparece la acción "Mautic" en los formularios de Elementor (FREE y PRO)​

  • Comprueba que el módulo Elementor está activado y que Elementor Pro está activo.
  • Comprueba que el plugin está conectado con Mautic: sin conexión, los módulos se pausan.

En Mautic, el nombre del contacto aparece como su email (FREE y PRO)​

El nombre no ha llegado a Mautic, y Mautic muestra el email en su lugar. Las causas más habituales:

  1. El campo del nombre no tiene el ID name. En Elementor, haz clic en el campo, abre la pestaña Avanzado y en ID escribe name (para los apellidos, lastname). La etiqueta y el texto de ejemplo no cuentan. Mira Formularios de Elementor.
  2. (Sólo PRO) El contacto ya existía en Mautic y el formulario tiene Datos de contactos existentes = No tocar. Con la opción por defecto (Rellenar solo los campos vacíos), el nombre sí se guarda si en Mautic estaba vacío.

He añadido un campo personalizado y no se guarda en Mautic (FREE y PRO)​

Revisa estos puntos:

  1. El ID del campo en Elementor debe ser exactamente el alias del campo en Mautic, en minúsculas y sin espacios. Por ejemplo, si en Mautic el alias es provincia, el ID en Elementor tiene que ser provincia, no Provincia ni field_a1b2c3.
  2. Si el campo de Mautic es una lista, la opción que elige la persona tiene que existir también en la lista de Mautic, ya sea como valor o como etiqueta. Si en Elementor ofreces "Sevilla" y en Mautic no existe esa opción, ese dato no se guarda.
  3. Si el campo de Mautic es un número, lo escrito tiene que ser un número. Se aceptan decimales con coma (3,5), pero no letras.

Tranquilo: aunque un dato no encaje, el contacto se crea igualmente en Mautic con el resto de la información. Solo se pierde ese dato.

Tienes todos los detalles en Enviar datos a tus propios campos de Mautic.

Un contacto que ya existía no actualiza su nombre o su teléfono (sólo PRO)​

Con la opción por defecto del formulario, Datos de contactos existentes = Rellenar solo los campos vacíos, solo se guardan los datos que en Mautic estaban vacíos. Si quieres guardar siempre lo último que escribe la persona (por ejemplo, en un formulario de citas), elige Sobrescribir con los datos del formulario. Mira Formularios de Elementor.

Cupón de bienvenida (sólo PRO)​

No se genera el cupón de bienvenida​

Comprueba, por orden:

  1. El módulo WooCommerce está activado y WooCommerce está instalado.
  2. Activar cupón de bienvenida está marcado.
  3. En formularios de Elementor: el formulario tiene activada la opción Generar cupón de bienvenida.
  4. La persona no tenía ya un cupón: cada persona tiene uno solo. Mira qué pasa en ese caso en El cupón de bienvenida.

Google Tag Manager (sólo PRO)​

No llegan los eventos a Google Tag Manager​

  1. Google Tag Manager está instalado en la web.
  2. Activar eventos de dataLayer está marcado en Ajustes de Conexión.
  3. En el formulario de Elementor, Enviar evento a GTM = Sí.
  4. Si Cuándo enviarlo = Solo si el contacto no existe en Mautic, prueba con un email que no esté en Mautic.
  5. En GTM, el activador usa exactamente el mismo nombre de evento.
  6. Compruébalo con el modo Vista previa de GTM (Tag Assistant).

Más información en Medir conversiones con Google Tag Manager.

Post Digest (sólo PRO)​

El Post Digest no se actualiza al publicar​

  1. El módulo Post Digest está activado.
  2. Sincronización automática está marcada.
  3. La entrada es del Tipo de contenido que elegiste.
  4. Han pasado al menos 5 minutos desde la última sincronización.
  5. Si tienes prisa, pulsa Sincronizar con Mautic ahora.

Más información en Post Digest.

Newsletter de WooCommerce​

Saqué a un cliente del segmento del newsletter y todavía no le sale la casilla del checkout (sólo PRO)​

Para que el checkout no espere nunca a Mautic, WordPress guarda una copia del estado de cada cliente y la actualiza en segundo plano: al iniciar sesión y al entrar en el carrito o el checkout, como mucho una vez cada 5 minutos. La primera carga después del cambio todavía usa la copia anterior; en la siguiente ya le sale la casilla.

Si se había suscrito hace menos de una hora, hay que esperar a que pase esa hora. Mira El newsletter en el checkout.

No aparece el campo "Consent Text" en Mautic (sólo PRO)​

Se crea al guardar los ajustes del newsletter o la primera vez que alguien se suscribe. Si el usuario de Mautic con el que conectaste no tiene permiso para crear campos, no se crea y se vuelve a intentar al día siguiente; mientras tanto, todo lo demás funciona igual.

Para solucionarlo, dale permiso en Mautic para gestionar campos de contacto, o créalo tú a mano: tipo Área de texto, alias consent_text.

En el historial del contacto no aparece la IP junto a la suscripción (sólo PRO)​

Mautic solo apunta una IP cuando es nueva para ese contacto. Si ya la tenía registrada (por una visita o una suscripción anterior desde la misma conexión), no la repite, aunque sigue en la lista de IPs del contacto. Tampoco se guarda si la IP es privada o de un rango reservado, o si el navegador del cliente parece un robot.

Campos y sincronización de WooCommerce (sólo PRO)​

Un cliente tiene vacíos en Mautic el número de pedidos, el valor total o el pedido medio​

Ese cliente se ha quedado sin ningún pedido pagado: se canceló o reembolsó el único que tenía, o solo tiene pedidos en espera o pendientes de pago. Mautic no permite guardar un 0 al editar un contacto, así que esos campos se vacían.

Para encontrar a estos clientes en un segmento de Mautic, usa el filtro está vacío en lugar de "igual a 0". Mira Campos y sincronización de WooCommerce.