Documentación · Manual del usuario

Manual del administrador

Este manual documenta las responsabilidades administrativas para el plugin ADP Car Market Hub WordPress. Cubre la propiedad de la configuración inicial, los permisos de usuario, la configuración de la importación, las operaciones programadas, la supervisión del estado del sistema y la coordinación del soporte.

Cuándo utilizar este documento

Lea este documento si usted:

Es un administrador de WordPress responsable de instalar, configurar y mantener el plugin.
Necesita entender qué permisos son necesarios y cómo gestionarlos.
Es responsable de garantizar que las importaciones se ejecuten de manera fiable y de investigar los fallos.
Se coordina con el soporte técnico o con un socio de integración.

Para tareas operativas diarias como comprobar el estado de la importación, revisar los leads y validar el frontend, consulte los Flujos de trabajo de uso diario.

Descripción general

ADP Car Market Hub requiere una configuración inicial cuidadosa antes de poder importar cualquier vehículo. El administrador es responsable de:

Introducir y mantener credenciales de API válidas.
Configurar la programación de la importación y elegir entre WP-Cron y el cron del servidor.
Establecer el estado de publicación por defecto correcto, el autor, la gestión de imágenes y la moneda.
Conceder o restringir el acceso a la interfaz de administración del plugin.
Mantener los contactos de ventas del concesionario que se muestran a los clientes y se utilizan para el enrutamiento de leads (CMH Team).
Supervisar el estado del plugin, la salida de los registros (logs) y el éxito de la importación.
Coordinarse con AutoScout24 o su socio de integración cuando surjan problemas con la API.

Requisitos o prerrequisitos

Se requiere acceso de administrador de WordPress para instalar el plugin y gestionar las capacidades.
El servidor debe ejecutar PHP 8.1 o posterior y WordPress 6.2 o posterior.
Se deben obtener credenciales de API de AutoScout24 válidas (API Base URL, Seller ID(s), Client ID, Client Secret, Token URL, Audience) de AutoScout24 o de su socio de integración antes de la configuración. El plugin no puede importar vehículos sin ellas.
El servidor debe permitir conexiones HTTPS salientes al endpoint de la API configurado.
Si se prefiere el cron del servidor en lugar de WP-Cron, el entorno de hosting debe admitir tareas programadas (crontab o equivalente).

Permisos y capacidades

Capacidad de gestión del plugin

El plugin introduce una capacidad personalizada de WordPress: manage_as24_imports.

Esta capacidad es necesaria para acceder al menú de administración de ADP Car Market Hub, ejecutar importaciones, cambiar la configuración, ver leads y utilizar todas las herramientas de administración.
Al activarse, a los administradores de WordPress (rol administrator) se les concede automáticamente manage_as24_imports.
Otros roles de usuario (editor, gestor de tienda, etc.) no reciben esta capacidad por defecto. Un administrador de WordPress debe concederla explícitamente utilizando un plugin de gestión de roles o código personalizado si se requiere acceso para usuarios que no sean administradores.

Capacidades de publicación de WordPress

El tipo de contenido personalizado as24ci_car (el menú CMH Cars) utiliza sus propias capacidades dedicadas de WordPress (edit_as24ci_cars, publish_as24ci_cars, etc.). Los registros de vehículos aparecen bajo CMH Cars → All Cars, no bajo la pantalla estándar de Entradas de WordPress. El acceso a las páginas de administración dedicadas del plugin bajo CMH Center y CMH Team requiere adicionalmente manage_as24_imports.

Protección de ajustes sensibles

Las credenciales de la API (Client ID y Client Secret) se almacenan en la tabla de opciones de WordPress. El acceso a la pestaña de Ajustes está restringido por manage_as24_imports. Asegúrese de que solo los administradores de confianza dispongan de esta capacidad.

Primera configuración

Siga estos pasos al configurar el plugin por primera vez:

Instale y active el plugin a través de Administración de WordPress → Plugins → Añadir nuevo o subiendo el archivo del plugin.
Navegue a ADP Car Market Hub → Settings.
Introduzca la API Base URL para su entorno de AutoScout24. Las URL base comunes incluyen los hosts de la API regionales de AutoScout24 (verifique la URL correcta con AutoScout24 o su socio de integración).
Introduzca uno o más Seller IDs (separados por comas) que coincidan con su(s) cuenta(s) de distribuidor de AutoScout24.
Introduzca el Client ID y el Client Secret proporcionados por AutoScout24.
Introduzca la Token URL y la Audience si difieren de los valores por defecto derivados de la URL base.
Establezca la Default currency para que coincida con la moneda utilizada en sus anuncios.
Configure el Default post status (publish para que los vehículos sean visibles inmediatamente, draft para revisarlos antes de publicarlos).
Establezca el Default post author al usuario de WordPress que deba figurar como autor de las publicaciones de vehículos.
Configure los ajustes de importación de imágenes: si se deben importar imágenes, el número máximo de imágenes por vehículo y las opciones de conversión a WebP.
Marque la opción Create default pages para que el plugin cree automáticamente las páginas de archivo de vehículos y de comparación.
Haga clic en Save settings.
Utilice la prueba de conexión en la pestaña System & Help o Tools para confirmar que las credenciales de la API funcionan.
Navegue a Import & Limits y ejecute la importación completa inicial utilizando el Batch-Wizard.

Configurando la programación de la importación

WP-Cron (por defecto)

WordPress tiene un sistema de cron integrado (WP-Cron) que se activa con las visitas a las páginas. Esto es suficiente para muchos sitios, pero puede sufrir retrasos en sitios con poco tráfico.

Navegue a ADP Car Market Hub → Import & Limits.
Active Automatic import.
Elija el intervalo: cada hora, cada 6 horas, dos veces al día, a diario o un intervalo personalizado (mínimo 15 minutos).
Para las programaciones diarias y de dos veces al día, establezca la hora de inicio preferida.
Guarde los ajustes de automatización.

Cron del servidor (recomendado para producción)

Para una programación fiable, configure un cron de servidor externo para llamar al endpoint REST del plugin:

Navegue a ADP Car Market Hub → Import & Limits.
Establezca el Cron mode en Server cron.
Copie la URL del endpoint de cron que se muestra (incluye un token de seguridad).
Añada una tarea cron en su servidor (por ejemplo, usando crontab) para llamar a esta URL en el intervalo deseado usando curl o wget.
Si necesita regenerar el token (por ejemplo, después de un incidente de seguridad), haga clic en Regenerate token en la misma pestaña y actualice la tarea cron de su servidor con la nueva URL.

Bloqueo de importación

El plugin utiliza un bloqueo basado en transitorios (aproximadamente 40 minutos) para evitar que se solapen las ejecuciones de importación. Si ya hay una ejecución de importación en curso y llega un segundo activador (desde WP-Cron, el cron del servidor o un activador manual), la segunda ejecución se omite. Este es un comportamiento normal.

Gestionando las importaciones de imágenes

Modo de cola de imágenes: Durante las importaciones programadas por cron, solo la primera imagen de cada vehículo se descarga inmediatamente. Las imágenes restantes son procesadas por un ejecutor de cola en segundo plano aproximadamente cada 5 minutos. Esto evita errores de tiempo de espera de PHP durante importaciones grandes.
Supervisión de la cola de imágenes: La pestaña System & Help muestra el tamaño actual de la cola de imágenes y una advertencia si la cola supera los 1.000 elementos.
Procesamiento manual de la cola: Utilice el botón Run image queue now en la pestaña System & Help para procesar la cola inmediatamente.
Limpiar la cola de imágenes: El botón Clear image queue en la misma pestaña elimina todas las entradas de imágenes pendientes sin procesarlas. Utilice esto con precaución.
Conversión a WebP: Si está activada, las imágenes descargadas se convierten al formato WebP utilizando GD o Imagick. La pestaña System & Help muestra si estas extensiones están disponibles.

Full Sync

Full Sync es un ajuste en la pestaña Import & Limits que, cuando está activado, elimina permanentemente cualquier publicación de vehículo en WordPress que ya no esté presente en el listado activo de AutoScout24 para el vendedor o vendedores configurados.

Utilice Full Sync solo cuando desee que WordPress refleje exactamente el inventario activo de AutoScout24. Cuando está activado:

Cualquier publicación de vehículo local que no se encuentre en el listado remoto actual se elimina de forma permanente, incluidas todas las imágenes adjuntas.
Esto incluye los vehículos que se editaron manualmente, se enriquecieron con contenido adicional o se establecieron en estado de borrador.
La eliminación se registra en el archivo de registro (log) del plugin.

Desactive Full Sync si desea conservar los vehículos en WordPress incluso después de que se eliminen de AutoScout24.

Supervisión del estado del sistema

La pestaña System & Help ofrece una descripción general completa del entorno del servidor y del estado del plugin. Revise esto regularmente para identificar posibles problemas antes de que afecten a las importaciones.

Comprobaciones clave:

Comprobación	Valor recomendado	Notas
Versión de PHP	8.1 o posterior	Requerido
Límite de memoria	256 MB o más	Valores más bajos pueden causar fallos en la importación
Tiempo máximo de ejecución	60 segundos o más	Recomendado para importaciones grandes
Directorio de subidas	Con permisos de escritura	Requerido para las importaciones de imágenes
GD o Imagick	Presente	Requerido para la conversión a WebP
cURL	Presente	Requerido para las llamadas a la API
OpenSSL	Presente	Requerido para conexiones HTTPS a la API
Conexión API	OK	Confirma que las credenciales funcionan
Tamaño de la cola de imágenes	Por debajo de 1.000	Las colas grandes indican un retraso en el procesamiento
Estado de la programación de cron	Activo	Confirma que WP-Cron o el cron externo se están ejecutando

Los indicadores de estado utilizan un sistema de semáforo: verde (OK), amarillo (advertencia), rojo (problema).

Supervisión de registros (logs)

La pestaña Logs muestra el registro de actividad del plugin.

El registro registra llamadas a la API, solicitudes de tokens, acciones de importación, descargas de imágenes, errores y advertencias.
Los paneles Recent Errors y Recent Warnings en la parte superior de la pestaña Logs destacan las últimas entradas de error y advertencia de las últimas 2.000 líneas de registro.
El Log Viewer muestra las últimas N líneas del archivo de registro completo (configurable, 100–2.000 líneas).
El archivo de registro se rota automáticamente cuando alcanza los 10 MB.
Para borrar el archivo de registro manualmente, haga clic en el botón Clear log file. Esto es irreversible.
El registro detallado (verbose) (cuando está activado en los ajustes) escribe detalles por vehículo y por imagen en el registro. Desactive el registro detallado en producción si el registro crece demasiado rápido.

Exportación de diagnósticos

La pestaña Tools incluye una función de Diagnostics export. Esta genera un archivo JSON que contiene:

Versión del plugin
Versión de WordPress
Versión de PHP
URL del sitio
Tamaño y ruta del archivo de registro
Resumen del entorno del sistema

Cuando se ponga en contacto con el soporte técnico, exporte este archivo y compártalo con su equipo de soporte. No comparta el archivo de registro sin procesar públicamente, ya que puede contener URL de la API e identificadores de listados.

Gestión de características

La mayoría de las características opcionales se activan o desactivan desde la pantalla de Configuración en lugar de desde una pestaña dedicada a "Características". Abra Car Market Hub → Configuración y utilice las tarjetas de Características del Frontend y Características de Administración para alternar las capacidades individuales. Los cambios surten efecto inmediatamente después de guardar. Los selectores disponibles incluyen:

Datos estructurados de Schema.org y etiquetas meta de Open Graph
Botones para compartir en redes sociales
Favoritos / Lista de deseos
Comparador de vehículos
PDF datasheet
Integración con sitemap
Widget del escritorio
Lazy loading (carga diferida)
Acciones en lote
Exportación
REST API
Seguimiento analítico
Calculadora de financiación (con tasa de interés, plazo del préstamo y pago inicial configurables)
Reserva de prueba de conducción
AI Assistant

Desactivar una característica elimina su funcionalidad tanto del frontend como de la administración sin borrar ningún dato almacenado. Consulte la Referencia de Configuración para ver la lista completa de selectores.

Las URL de webhooks salientes (nuevo lead, nueva importación) y el secreto del webhook se configuran en la pantalla de Leads — consulte la Referencia de Leads. El selector de la característica PDF datasheet está en Configuración, mientras que sus plantillas y branding se gestionan en el PDF Manager (consulte la Referencia de PDF Manager).

El AI Assistant y el Content Studio no son simples selectores de encendido/apagado de la misma manera. El AI Assistant se configura en su propia pantalla CMH Center → AI Assistant, y Content Studio es un espacio de trabajo independiente en CMH Center → Content Studio. Estas áreas operativas también pueden requerir una licencia activa del plugin antes de poder utilizarse; si el plugin no tiene licencia para ellas, la pantalla se sustituye por un aviso de "licencia requerida" y los datos existentes no se modifican.

Gestión del CMH Team

CMH Team es un menú independiente de nivel superior para los contactos de ventas del concesionario gestionados por el plugin. Los miembros del equipo se almacenan completamente dentro del plugin (no se requiere una cuenta de usuario de WordPress) y se pueden mostrar en las páginas de detalles del vehículo y utilizarse como el destinatario preferido para los leads.

El menú CMH Team ofrece las siguientes pantallas:

Pantalla	Propósito
Descripción general	Resumen de la configuración del equipo con enlaces rápidos.
Miembros	Lista de todos los contactos de ventas; añada, edite o elimine miembros.
Nuevo	Cree o edite un único miembro (nombre, foto, correo electrónico, teléfono, rol).
Ubicaciones	Establezca un contacto predeterminado por ubicación del concesionario / Seller ID.
Asignación	Asigne un contacto a vehículos individuales (manual, automático, contacto general del concesionario o ninguno).
Estándares	Contacto de respaldo global y detalles de contacto general del concesionario.
Reglas	Comportamiento de asignación automática, incluyendo si se envía también una copia de cada consulta al correo electrónico general del concesionario.

Cómo se resuelve un contacto para un vehículo determinado: un contacto asignado manualmente por vehículo tiene prioridad, luego el predeterminado de la ubicación/vendedor y, por último, el predeterminado global. Las elecciones manuales (manual, general, ninguno) nunca son sobrescritas por el importador; las asignaciones automáticas pueden actualizarse al importar. Consulte CMH Team y enrutamiento de contactos para ver la referencia completa, y el Flujo de trabajo de gestión de leads para saber cómo afecta CMH Team al enrutamiento de notificaciones de leads.

Gestión de leads

Las consultas de contacto de clientes y de pruebas de conducción se almacenan como entradas personalizadas de WordPress (as24ci_lead) y se muestran en la pestaña Leads.

Responsabilidades del administrador:

Configurar la dirección de correo electrónico del destinatario para las notificaciones de leads (pestaña Leads).
Revisar periódicamente los estados de los leads y actualizarlos a Contactado, Cerrado o Spam según corresponda.
Exportar leads a CSV para su importación en CRM o archivo.
Eliminar leads obsoletos o spam de la pestaña Leads.

Nota: Los registros de las entradas de leads se almacenan en WordPress. Si la opción Eliminar datos al desinstalar está activada en la Configuración, estos registros se eliminarán de forma permanente cuando se desinstale el plugin.

Desinstalación y limpieza

La pestaña Configuración incluye la opción Eliminar datos al desinstalar. Cuando está activada:

Al desinstalar el plugin a través de Administración de WordPress → Plugins se eliminarán de forma permanente todas las entradas de vehículos importados, las entradas de leads, las imágenes importadas y las opciones del plugin.

Cuando esta opción está desactivada (por defecto), al desinstalar el plugin se conservan todos los datos en WordPress. De este modo, puede volver a instalar el plugin y reanudar el funcionamiento sin pérdida de datos.

Active esta opción únicamente si tiene la intención de realizar una eliminación completa. No se puede deshacer una vez completada la desinstalación.

Coordinación del soporte

Cuando un problema requiera derivarse a AutoScout24 o a su socio de integración:

Revise la pestaña Logs para buscar mensajes de error relevantes y anote la marca de tiempo.
Exportar el archivo de Diagnósticos desde la pestaña Herramientas.
Anote la versión del plugin (que se muestra en la lista de plugins y en la pestaña Sistema y Ayuda) y las versiones de WordPress y PHP.
Confirme si la prueba de conexión de la API es correcta (Sistema y Ayuda → prueba de conexión).
Facilite toda la información anterior a su contacto de soporte. No comparta el Client Secret en formato de texto plano.

Resolución de problemas

Síntoma	Causa probable	Comprobación
La pestaña de configuración muestra "URL base de la API no válida"	Se ha introducido la URL sin un esquema o formato válido	Introduzca una URL completa que incluya `https://`
La prueba de conexión falla	Credenciales incorrectas, URL base incorrecta o bloqueo de red	Verifique las credenciales con su socio de integración; compruebe las reglas del cortafuegos
La importación programada no se ejecuta	WP-Cron está desactivado o el sitio no tiene tráfico	Cambie al cron del servidor; verifique que el endpoint del cron sea accesible
Capacidad de manageas24imports no asignada	La activación del plugin no completó la actualización de capacidades	Desactive y vuelva a activar el plugin; o conceda la capacidad manualmente
La Sincronización Completa eliminó vehículos inesperadamente	La Sincronización Completa estaba activada y los vehículos se eliminaron de AutoScout24	Revise los Logs para buscar entradas de eliminación; desactive la Sincronización Completa si no es necesaria
La importación se ejecuta pero no aparecen vehículos	El estado por defecto de la entrada es `draft`	Cambie el Estado por defecto de la entrada a `publish` en la Configuración
La conversión a WebP falla	GD o Imagick no están disponibles	Compruebe el estado de las extensiones en Sistema y Ayuda; contacte con el proveedor de hosting
La exportación de diagnósticos falla	Permisos de PHP insuficientes para leer los datos del entorno	Revise el registro de errores de PHP en el servidor