Referencia de Leads

Este documento es una referencia para la pantalla de Leads del plugin ADP Car Market Hub (Car Market Hub → Leads). Cubre la bandeja de entrada de leads, la configuración del formulario de contacto, las opciones de consentimiento y privacidad, los mensajes de notificación, el módulo de reserva de pruebas de conducción (Test Drive Booking), los webhooks y las plantillas de correo electrónico.

Cuándo utilizar este documento

Utilice esta referencia cuando desee revisar los envíos de formularios de contacto, cambiar qué campos aparecen en el formulario, cumplir con los requisitos de consentimiento del RGPD, configurar quién recibe los correos electrónicos de notificación de leads, integrarse con un CRM externo a través de webhooks o habilitar la función de reserva de pruebas de conducción en las páginas de vehículos individuales.

Descripción general

La pantalla de Leads se divide en una tabla de Lead Inquiries (Consultas de leads) y una serie de tarjetas de configuración organizadas de la siguiente manera:

1. Lead Inquiries — lista paginada y con opción de búsqueda de todos los envíos, con acciones en lote y exportación a CSV.
2. Recipient Email Override (Sobrescribir correo del destinatario) + Form Fields (Campos del formulario) (fila lateral).
3. Consent & Privacy (Consentimiento y privacidad) + Notification Messages (Mensajes de notificación) (fila lateral).
4. Test Drive Booking (Reserva de prueba de conducción) (tarjeta de ancho completo).
5. Webhooks.
6. Email Templates (Plantillas de correo electrónico).

Todas las tarjetas de configuración comparten el mismo formulario, por lo que al guardar cualquiera de ellas se conserva toda la página.

Requisitos o prerrequisitos

• Permiso para administrar el plugin.
• Correo de WordPress en funcionamiento. El plugin utiliza el correo estándar de WordPress; si su sitio no puede enviar correos, configure el SMTP por separado.
• Para webhooks: un endpoint externo que pueda aceptar solicitudes HTTPS POST.
• Para Test Drive Booking: active el interruptor de la función y defina al menos el intervalo de tiempo.

Instrucciones paso a paso

Revisar y gestionar leads

1. Abra Car Market Hub → Leads.
2. Utilice el campo Search (Buscar) para filtrar por nombre, correo electrónico, texto del mensaje o vehículo.
3. La tabla muestra cada envío con las columnas Date (Fecha), Name (Nombre), Email (Correo electrónico), Phone (Teléfono), Vehicle (Vehículo), Type (Tipo), Appointment (Cita) y Actions (Acciones). El valor de Vehicle enlaza a la ficha del vehículo activa (se abre en una pestaña nueva); la etiqueta de Type muestra si el lead es una Inquiry (Consulta) o un Test Drive (Prueba de conducción).
4. Haga clic en el icono View (ojo) en una fila para abrir el modal de Lead Details (Detalles del lead) (Fecha, Nombre, Correo electrónico, Teléfono, Vehículo, Tipo, Cita, Mensaje).
5. Haga clic en el icono Delete (papelera) para eliminar un solo lead, o marque las filas y utilice la acción en lote Delete selected (Eliminar seleccionados) + Apply (Aplicar) para eliminar varios a la vez.
6. Utilice Export CSV (Exportar CSV) en la barra de herramientas para descargar todos los leads que coincidan con el filtro actual.

Configurar el formulario de contacto

1. En Recipient Email Override, deje el campo vacío para utilizar la cadena de respaldo (correo público del vendedor → correo de la cuenta de WordPress → correo del administrador del sitio), o introduzca una o más direcciones separadas por comas.
2. En Form Fields, desactive Phone (Teléfono) y/o Message (Mensaje) si no los necesita. Name (Nombre) y Email (Correo electrónico) siempre son obligatorios.
3. En Consent & Privacy, active la casilla de consentimiento, establezca el texto de la etiqueta y, opcionalmente, proporcione una URL de la página de privacidad; las palabras "privacy policy" (política de privacidad) en la etiqueta se enlazarán entonces a esa URL.
4. En Notification Messages, personalice los mensajes de éxito y error que se muestran a los visitantes después del envío.
5. Haga clic en cualquier botón Save Leads settings (Guardar configuración de Leads).

Habilitar la reserva de pruebas de conducción (Test Drive Booking)

1. Abra la tarjeta Test Drive Booking.
2. Active Enable Test Drive booking. La barra de resumen en vivo en la parte superior de la tarjeta refleja la configuración activa: un punto de estado (Active / Inactive), el número de días seleccionados, el rango de tiempo, la etiqueta de duración del intervalo (por ejemplo, "30 min slots") y una etiqueta de "N blocked dates" cuando hay fechas bloqueadas.
3. En Available Days (Días disponibles), seleccione los días de la semana en los que se pueden reservar citas. Deje todos desmarcados para permitir todos los días.
4. Añada Blocked Dates (Fechas bloqueadas) en formato YYYY-MM-DD, una por línea.
5. Establezca Start Time (Hora de inicio), End Time (Hora de finalización) y Slot Duration (minutes) (Duración del intervalo en minutos) (5–480, paso 5; mínimo 5 minutos).
6. Guarde.

Configurar webhooks para sistemas externos

1. Introduzca la New lead webhook URL para recibir un HTTP POST cuando un visitante envíe el formulario de contacto.
2. Introduzca la New import webhook URL para recibir un HTTP POST cuando un vehículo se importe o se actualice.
3. Opcionalmente, establezca un Webhook secret (Secreto de webhook). El plugin firma cada solicitud con HMAC-SHA256 y envía la firma en la cabecera X-AS24CI-Signature para su verificación. Una vez guardado un secreto, aparece una nota de confirmación y el marcador de posición del campo cambia a "Leave empty to keep the current secret" (Dejar vacío para mantener el secreto actual); el secreto guardado solo se sobrescribe si escribe un nuevo valor, por lo que dejar el campo vacío lo mantiene sin cambios.
4. Guarde. Deje una URL vacía para desactivar ese webhook.

Personalizar las plantillas de correo electrónico

1. Abra la tarjeta Email Templates.
2. Edite el asunto de la notificación para el concesionario, el asunto de la confirmación para el cliente y los cuerpos de correo HTML correspondientes.
3. Utilice marcadores de posición para inyectar datos del lead y del vehículo: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.
4. Deje cualquier campo vacío para utilizar el valor predeterminado integrado.
5. Guarde.

Referencia de configuración

Tabla de Lead Inquiries

Recipient Email Override

Form Fields

Consent & Privacy

Notification Messages

Test Drive Booking

Webhooks

Email Templates

Marcadores de posición admitidos: {name}, {email}, {phone}, {message}, {vehicle_title}, {vehicle_url}.

Notas operativas

• Todas las tarjetas de configuración pertenecen a un único formulario. Cualquier botón Save Leads settings envía y guarda todos los campos de la página.
• El envío de correos electrónicos utiliza el correo estándar de WordPress. Los rebotes, la entregabilidad y el filtrado de spam están fuera del control del plugin.
• La firma del webhook se vuelve a calcular para cada carga útil. Para verificarla en el lado del receptor, calcule HMAC-SHA256(payload, secret) y compárela con la cabecera X-AS24CI-Signature.
• Test Drive Booking solo muestra el formulario de reserva cuando el interruptor principal está activo. Sin días seleccionados, todos los días se consideran disponibles.
• Los leads se almacenan en un custom post type, por lo que las copias de seguridad y las exportaciones los cubren automáticamente. La exportación a CSV respeta el filtro de búsqueda activo.
• El modal Lead Details es de solo lectura; para añadir notas internas o estados de flujo de trabajo, utilice un CRM a través de la integración de webhooks.

Resolución de problemas

• No se reciben correos electrónicos. Confirme que el sitio de WordPress puede enviar correos (pruebe con otro plugin o con una prueba a nivel de sitio). Compruebe si hay errores tipográficos en el campo de sobrescritura del destinatario.
• Los visitantes no pueden enviar el formulario. Compruebe el interruptor de consentimiento y la etiqueta; si se requiere consentimiento, la casilla de verificación debe estar marcada. Inspeccione la consola de la página en busca de errores de JavaScript y confirme que las cookies/el almacenamiento local no estén bloqueados.
• El receptor del webhook no recibe ninguna solicitud. Verifique que la URL sea accesible desde el servidor, utilice HTTPS y no esté bloqueada por un cortafuegos. Compruebe la pantalla de Logs para ver si hay errores de entrega.
• La firma del webhook no se valida. Asegúrese de que ambas partes utilicen el mismo secreto y que el receptor calcule el HMAC-SHA256 del cuerpo bruto del POST, no de ningún JSON preanalizado.
• Faltan intervalos de Test Drive. Asegúrese de que End Time sea posterior a Start Time y que la fecha no esté en Blocked Dates. Si no hay días marcados, todos los días están abiertos por diseño.
• Las plantillas de correo muestran los marcadores de posición de forma literal. Confirme que el texto del marcador de posición coincide exactamente (incluidas las llaves) y que es uno de los tokens admitidos.

Documentos relacionados

• Referencia de configuración
• Referencia de Logs
• Referencia de Analytics
• Referencia de alertas de búsqueda