~ digitalchk / docs / leads-chk
Leads Chk convierte WordPress en una herramienta de email marketing que envía a través de Emailit. Los contactos, las listas y el consentimiento viven en tu propia base de datos; Emailit entrega el correo e informa de lo que pasó con él. Los demás plugins de esta documentación le envían sus contactos, así que cada dirección que recogen tus herramientas acaba en un solo lugar, con su origen y su consentimiento.
Cómo funciona
Contactos con su origen
Cada contacto conserva de dónde vino: el formulario, la página, la campaña UTM, la procedencia, el país y el idioma, además de un historial de lo que hizo.
Consentimiento
Doble confirmación, página de preferencias y baja con un clic (RFC 8058). Cada consentimiento queda registrado con el texto exacto, la dirección IP y la página.
Formularios y ventanas
Formularios de suscripción como shortcode, bloque o widget de Elementor, además de ventanas emergentes, paneles laterales y barras con disparadores, segmentación, Cloudflare Turnstile y sus propias estadísticas de conversión. Las estadísticas no cuentan los bots, tus propias visitas con la sesión de administrador iniciada ni las IP que indiques en Settings, así que los números reflejan visitantes reales. Un formulario también puede ser una llamada a la acción sin campos: su botón lleva al visitante a una página que eliges para cada idioma, por ejemplo una herramienta gratis, y se cuentan los clics. Las ventanas pueden abrirse cuando aparece un elemento (el resultado de una herramienta, por ejemplo) o cuando se lanza un evento de JavaScript, y un límite por visita con prioridad por ventana evita que alguien vea más de una a la vez.
Listas, etiquetas y segmentos
Agrupa los contactos por lista, etiquétalos desde cualquier origen y crea segmentos para campañas y automatizaciones.
Campañas
En uno o varios idiomas, con vista previa, envíos de prueba y programación. Los informes cubren aperturas, clics, enlaces, bajas y rebotes, y una campaña se pausa sola cuando los rebotes o las quejas suben demasiado.
Automatizaciones
Correos de bienvenida y de seguimiento que se disparan por lista, origen o etiqueta.
Borradores automáticos
Cuando publicas una entrada, una regla prepara con ella un borrador de campaña y te envía por correo un enlace para revisarlo. También puede juntar varias entradas en un resumen semanal, mensual o cuando tú lo decidas. Nunca envía por su cuenta.
Integraciones
Otros plugins envían aquí sus contactos. Cada uno tiene su propia política (guardarlo como contacto, ofrecer la newsletter con una casilla o suscribirlo) y la política se aplica dentro de la captura, así que ningún plugin puede suscribir a alguien que tú no aceptaste suscribir.
Reseñas
Una página de reseña para cada contacto, a la que se llega desde cinco estrellas en cualquier correo, con moderación y un shortcode para mostrar los testimonios aprobados. Cada reseña etiqueta al contacto como promotor, pasivo o detractor.
El correo de WordPress por Emailit
De manera opcional, todo el correo que envía WordPress pasa por la API de Emailit, con respaldo en tu servidor de correo habitual y un registro de cada mensaje. Puede reemplazar a un plugin SMTP.
Requisitos
- WordPress 6.0 o superior
- PHP 7.4 o superior
- Una cuenta de Emailit y una clave de API con acceso completo
Cómo publicarlo
Coloca un formulario de suscripción con un shortcode, el bloque o el widget de Elementor. Las ventanas emergentes, los paneles laterales y las barras se muestran con sus propios disparadores y no necesitan shortcode.
[leads_chk id="1"][leads_chk_reviews limit="6" columns="3"]
Atribución. El plugin muestra una línea pequeña, «Una herramienta de Digital Checkmark», con un enlace a digitalchk.com, debajo de cada formulario y ventana emergente que muestra en tu sitio, nunca en los correos ni en las campañas que envía. Es parte del plugin y no tiene ajuste para quitarla. Si una herramienta y un formulario de Leads Chk comparten página, la línea sale una sola vez.
Configuración
Conecta Emailit Obligatorio
En Settings, pega una clave de API de Emailit con acceso completo y, si quieres informes en vivo, el secreto de firma del webhook. Los envíos se reparten por debajo del límite de Emailit de 2 peticiones por segundo (el ritmo es un ajuste; 1 por segundo deja margen al resto del correo), con un tope diario que deja sitio al correo de WordPress.
Pon un formulario en el sitio Recomendado
En Forms and popups, crea un formulario en línea, una ventana emergente, un panel lateral o una barra. Cada uno lleva sus propias estadísticas de conversión.
Conecta tus otros plugins Opcional
En Integrations ves cada plugin que envía contactos aquí y cuántos trajo. Cómo se comporta cada uno (solo se guarda, se ofrece la newsletter con una casilla o se suscribe, y a qué lista) se configura dentro del plugin que lo envía, en su propia pantalla Integrations.
Envía tu primera campaña Opcional
En Campaigns, escríbela en cada idioma, revísala, envíate una prueba y prográmala.
Verificación de correo y ayuda con IA Opcional
Las direcciones se pueden verificar con Reoon Email Verifier o con Emailit. Para asuntos, borradores y traducciones puedes conectar cualquier servicio de IA con una API de tipo Chat Completions, fijar su esfuerzo de razonamiento y agregar un servicio de respaldo que responde cuando el principal falla.
Envía cada minuto con un cron del sistema Recomendado
Los correos salen de una cola en segundo plano. Solo con el cron de WordPress, la cola avanza cuando el sitio recibe visitas o cuando tu hosting lo ejecuta, a menudo cada pocos minutos. Agrega un cron del sistema que ejecute el proceso cada minuto:
* * * * * wp leads-chk worker --time=50 --path=/ruta/a/wordpressEjecútalo con el usuario del servidor web. En Settings ves cuándo corrió el proceso por última vez y si vino del cron del sistema, y en Sending puedes recibir un correo si el cron del sistema se detiene y otro cuando vuelve.
Recibe un borrador cada vez que publicas Opcional
En Campaigns > Auto-drafts, crea una regla: qué entradas (tipo de contenido, categorías o entradas con un campo personalizado), un borrador por entrada o un resumen, la plantilla en cada idioma, a quién va y a dónde enviar el aviso. Las etiquetas como {{posts}}, {{post_title}}, {{post_excerpt}} y {{post_url}} se completan al crear el borrador. Las traducciones publicadas dentro del tiempo de espera entran en el mismo borrador, y nada de lo que edites a mano se sobrescribe. Guardar y probar con las últimas entradas crea un borrador de prueba para que veas el resultado.
Úsalo en lugar de un plugin SMTP Opcional
En Settings, activa el correo de WordPress por Emailit. Todo el correo que envía WordPress (restablecer contraseñas, avisos de formularios, otros plugins) pasa entonces por la API de Emailit y aparece en el Email log. Si la API falla, el correo sale por tu servidor de correo habitual, así que conserva tu plugin SMTP instalado como respaldo.
Consentimiento y privacidad
- Nadie recibe una newsletter sin confirmar antes su dirección.
- Los contactos que llegan por integraciones se guardan como contactos y nunca se suscriben sin una aceptación explícita.
- Cada correo lleva un enlace de baja y un enlace a la página de preferencias.
- Los rebotes y las quejas por spam detienen las siguientes newsletters por sí solos.
- Una cookie propia,
lchk_attr, recuerda durante 90 días qué página o campaña trajo al visitante al sitio. - Los contactos se incluyen en las herramientas de exportación y borrado de datos personales de WordPress.
Para desarrolladores
Leads Chk nunca lee otros plugins: son ellos los que le envían sus contactos. La acción no hace nada cuando Leads Chk no está activo, así que no hace falta comprobarlo. Pasa newsletter como verdadero solo cuando la persona marcó una casilla de suscripción, y describe qué aceptó.
do_action( 'lchk_capture', array(
'email' => $email,
'source' => 'my-plugin', // quién lo envía
'source_detail' => 'Formulario de contacto', // detalle opcional
'tags' => array( 'customer' ),
'newsletter' => ! empty( $_POST['subscribe'] ),
'consent_text' => 'Envíenme la newsletter',
) );Otros sitios pueden enviar los mismos campos como JSON a /wp-json/leads-chk/v1/capture, con la clave de Settings en la cabecera X-Leads-Chk-Key. El filtro lchk_source_label le da a tu origen un nombre legible en los informes, y el filtro lchk_merge_tag permite que tu plugin ofrezca sus propias variables en los correos: devuelve un texto, que se escapa por ti, o un array con la clave html y un HTML que ya escapaste. Para los borradores automáticos, el filtro lchk_autodraft_post_tags recibe las etiquetas, el ID de la entrada y el idioma, y tu plugin puede agregar las suyas para sus entradas como array( texto plano, HTML escapado ).
Las ventanas que se abren solas (tras un tiempo, al hacer scroll o al ir a salir) no aparecen mientras la página tenga el atributo data-lchk-quiet en <html>. Cualquier script puede ponerlo, por ejemplo una ventana de chat mientras el visitante conversa, y quitarlo después. Las que se abren con un clic siguen funcionando, y una retenida así no cuenta como cerrada, así que puede salir en otra página más adelante.
Si algo no funciona
Los contactos de un plugin nunca reciben la newsletter.
Es a propósito: los contactos que envía una integración se guardan como contactos salvo que la persona aceptara. Revisa la política de Integrations de ese plugin si esperabas una casilla.
Una campaña se detuvo sola.
Su tasa de rebotes o de quejas pasó el límite y se pausó para proteger tu reputación de envío. Su informe muestra qué direcciones fallaron.
Una campaña tarda minutos en empezar.
La cola espera a la siguiente pasada del cron. Agrega el cron del sistema del paso 6.
No aparece el borrador automático al publicar.
Revisa que la regla esté activa y que la entrada coincida, y espera el tiempo de espera más un minuto. Una entrada que ya estaba publicada y se actualiza no lo dispara.
No llegan los correos de confirmación.
Revisa la conexión con Emailit y el estado del dominio en Settings. La clave necesita acceso completo.
Cómo pedir ayuda
Escríbenos desde la página de soporte. Incluye la versión del plugin, tus versiones de WordPress y PHP, y el texto exacto de cualquier error.