Documentación y Enciclopedia del Sistema

MarbleSend opera con un único ejecutor maestro en segundo plano: worker.php. El dashboard inspecciona cm_settings['worker_last_run'] para determinar si el cron se está ejecutando cada 60 segundos.

El visualizador de crecimiento muestra la distribución de volumen en cuatro períodos seleccionables: 7 días, 30 días, 90 días y lo que va del año (YTD). Cada barra representa un bloque de tiempo agregado, mostrando el recuento de envíos y aperturas al pasar el cursor.

El feed de la columna derecha muestra en tiempo real las emisiones recientes con insignias animadas de estado (Completed, Sending pulsante, Failed, Draft), tasas de entrega y estado de salud.

La tabla inferior audita las emisiones recientes detallando: nombre de la Campaign, estado, etiqueta de origen (manual, schedule, rss, auto_resend), porcentaje de destinatarios atendidos y aperturas comprobadas.

Cuando su dominio remitente carece de records SPF, DKIM o DMARC verificados, MarbleSend destaca un banner de atención directamente encima de las métricas KPI. Al hacer clic en Verificar DNS del dominio se abre el asistente de diagnóstico de 4 pasos en /settings?tab=deliverability, evitando que los usuarios dañen la reputación de su dominio con buzones no autenticados.

Acciones directas para conectar el panel de control con flujos de alta frecuencia: calendarios de boletines periódicos, procesamiento de fuentes RSS a correo, captación de listas, double opt-in y listas de supresión.

Siempre que se esté enviando una difusión de forma activa, aparece un banner de monitorización fijo en la parte superior de /campaigns. Consulta /api/campaigns/:id/progress cada 1,5 segundos sin recargar la página completa.

La columna izquierda permite una segmentación precisa de suscriptores. Los administradores pueden filtrar por etiquetas personalizadas de contacto, buscar por email/nombre parcial y seleccionar contactos individuales o pulsar Seleccionar todos los coincidentes.

Para evitar errores catastróficos (por ejemplo, enviar emails con placeholders rotos, sin enlace para darse de baja o con detonantes de spam), MarbleSend requiere una verificación preflight antes del lanzamiento.

Antes de comprometer miles de emails en la cola, el botón Enviar email de prueba despacha un único mensaje de prueba instantáneo directamente al administrador o buzón de control de calidad sin tocar la lista de destinatarios en la base de datos. Todas las etiquetas de placeholder ({{first_name}}, {{email}}, {{unsubscribe_link}}) se rellenan con valores de vista previa simulados para que pueda inspeccionar el renderizado del email en Gmail, Apple Mail y Outlook.

Todas las etiquetas de enlace salientes (<a href="...">) se procesan a través de App\Services\TrackingInjector. Los parámetros UTM (utm_source, utm_medium, utm_campaign, utm_content) se anexan automáticamente antes de envolverlos para la redirección de clics. Los enlaces mailto, enlaces tel y bajas se conservan intactos.

El historial completo ofrece filtrado por múltiples atributos: origen (manual, recurring, rss, resend_unopened), estado (completed, sending, failed, draft) y rango de fechas. Los administradores pueden seleccionar múltiples Campaigns para descargar logs de entrega CSV agregados.

En /campaigns/:id/report, MarbleSend presenta un informe completo posterior a la Campaign:

Repositorio centralizado para todos los templates de marketing, transaccionales y de autoresponder. Incorpora filtrado instantáneo, slugs inmutables e indicadores de estado de borrador en vivo.

Los motores de email de escritorio modernos (especialmente Microsoft Outlook con Word HTML) no admiten CSS Grid ni Flexbox. MarbleSend incluye 8 diseños responsivos basados en tablas probados en Gmail, Outlook, Apple Mail y Yahoo:

Un editor enfocado para desarrolladores de email con sangría Tab, telemetría de caracteres en tiempo real y normalizador automático de espacios en blanco.

Simula clientes de escritorio y móviles en un iframe aislado con sandbox, protegiendo la interfaz del panel de administración contra estilos no deseados.

En el momento del envío, el motor de plantillas reemplaza dinámicamente los tokens por atributos del destinatario, enlaces de seguimiento seguros, resúmenes de artículos RSS y Publicaciones de noticias.

Herramienta modal que permite despachar emails de prueba a cualquier dirección mediante perfiles SMTP elegidos antes de programar o transmitir.

Redactor con AI integrado operando directamente vía BYOK (Bring Your Own Key) para crear y optimizar templates seguros para email sin demoras de intermediarios.

Examina los asuntos de toda su biblioteca, calculando la tasa de apertura esperada, riesgos de filtros spam y longitud de caracteres con sugerencias en 1 clic.

Escribe artículos en la pestaña Publicaciones de Plantillas (Markdown con vista previa en vivo). Una programación de Boletín configurada en «Publicaciones de noticias» envía cada publicación Lista una sola vez, la más antigua primero, rellenando el marcador {{news_posts}} de su plantilla. Las publicaciones solo existen en tu correo: no hay página pública.

MarbleSend proporciona dos vistas operativas sincronizadas para diferentes flujos de trabajo: un Schedule Manager compacto en cuadrícula Bento (/schedules) y un amplio Calendario Mensual interactivo (/schedules/list).

Los horarios recurrentes funcionan mediante SchedulerService::computeNextRun(), que sustituye los cálculos manuales por matemáticas robustas de DateTimeImmutable en PHP.

MarbleSend se conecta directamente a su blog o feed mediante SimpleXML y cURL nativos, convirtiendo artículos nuevos en campañas automatizadas sin herramientas intermedias.

A diferencia de las campañas estáticas, los envíos programados resuelven su lista de destinatarios dinámicamente en el segundo exacto en que se ejecuta la occurrence.

Cada ejecución automatizada genera un registro inmutable en cm_schedule_occurrences con marcas de tiempo, resultados, conteo de destinatarios y telemetría de errores.

Los administradores pueden omitir el temporizador de cuenta regresiva y disparar un envío inmediato de cualquier horario con la acción "Trigger Send Now".

MarbleSend incorpora un perímetro de concurrencia empresarial diseñado para prevenir envíos duplicados en planes de shared hosting económicos.

La tarjeta dinámica Optimization Tip en Schedules ofrece 8 recomendaciones operativas comprobadas para envíos fiables en shared hosting:

Una programación de Boletín ahora puede enviar artículos en lugar de una plantilla fija. Establece Origen del contenido en «Publicaciones de noticias» y cada ejecución entrega las siguientes Publicaciones Listas de Plantillas → Publicaciones, insertadas en la plantilla mediante {{news_posts}}. No se envía nada cuando no hay publicaciones esperando.

1. 1Abre Plantillas → Publicaciones y escribe tu artículo en Markdown.
2. 2Crea o abre una plantilla y coloca {{news_posts}} donde deban aparecer los artículos (la plantilla inicial «Boletín de publicaciones de noticias» ya lo incluye).
3. 3Abre Programaciones → Nueva, deja el tipo en Boletín y establece Origen del contenido en «Publicaciones de noticias».
4. 4Elige la plantilla, la audiencia, el perfil SMTP, las publicaciones por correo (1–20) y la cadencia.
5. 5Guarda. Solo las publicaciones que queden Listas después de este momento pueden ser enviadas por esta programación.
6. 6Marca la publicación como Lista. La siguiente ocurrencia — o Ejecutar ahora — la envía.

• Cambiar una programación de Solo plantilla a Publicaciones de noticias fija un nuevo punto de corte en ese momento; volver atrás lo borra.
• Guardar el formulario de la programación vuelve a comprobar que la plantilla contiene {{news_posts}}. Pausar y Reanudar solo cambian el interruptor de activado/desactivado y nunca lo comprueban, así que siempre puedes pausar.
• Supresión Inteligente se desactiva automáticamente en el modo Publicaciones de noticias: excluiría a todos los que recibieron una edición anterior.
• Publicaciones de noticias solo está disponible para programaciones de Boletín; las programaciones RSS mantienen su propia lógica de feed.

• La lista de programaciones etiqueta estas programaciones como «Publicaciones de noticias» en lugar de «Boletín».
• El panel de detalle muestra cuántas publicaciones Listas esperan a esta programación.
• En el formulario, las plantillas sin {{news_posts}} aparecen marcadas, y aparece un aviso si eliges una.

MarbleSend desacopla la ejecución de campañas de los relays de envío mediante dos modelos de transporte: (1) Bring Your Own (BYO) SMTP para conectar sus servidores de correo existentes, y (2) MarbleSend SMTP via Amazon SES para entrega empresarial en la nube sin configurar cuentas AWS ni calentar IPs. Las campañas se vinculan dinámicamente con respaldo predeterminado y contabilidad atómica de créditos.

# Check resolution via dig (macOS / Linux):
dig CNAME <token1>._domainkey.yourdomain.com +short

# Check resolution via nslookup (Windows / PowerShell):
nslookup -type=CNAME <token1>._domainkey.yourdomain.com

MarbleSend envía correo en segundo plano. Un cron job es un temporizador en su panel de hosting que despierta a MarbleSend cada minuto para que pueda ejecutar programaciones y autoresponders, reintentar envíos fallidos, recoger bounces y mantener en marcha una Campaign larga. Una Campaign que usted envía empieza de inmediato, pero todo lo que deba ocurrir después depende de este temporizador. Si Settings → Sistema muestra Cron No Detectado, el temporizador no existe, no se ejecuta cada minuto o apunta al lugar equivocado. Los tres pasos siguientes lo resuelven.

Para usuarios técnicos

La compilación de correos electrónicos, la resolución de consultas de audiencia, el despacho de entregas y el procesamiento de webhooks funcionan de forma asíncrona mediante un worker en segundo plano de 1 minuto. MarbleSend emplea una arquitectura de doble punto de entrada (CLI nativa worker.php o HTTP cron.php) protegida por bloqueos de archivos no bloqueantes para eliminar ejecuciones superpuestas en shared hosting con recursos limitados.

* * * * * php /home/USER/your-folder/worker.php >/dev/null 2>&1

GET https://your-domain.com/cron.php?token=SECURE_TOKEN

MarbleSend está diseñado como una plataforma autoalojada internacional. Incluye 23 diccionarios de idiomas nativos completos seleccionados por humanos, duplicación automática de diseño de derecha a izquierda para árabe, personalización de tema tri-state persistente y un perímetro de seguridad de inquilino único inquebrantable.

La REST API permite que sitios web externos, landing pages, aplicaciones móviles y el plugin oficial de WordPress MarbleSend Forms interactúen de forma segura con su base de datos de contactos y motor de transmisión. Las claves API utilizan prefijos criptográficos, almacenamiento SHA-256 unidireccional y delimitación granular de capacidades.

Los webhooks proporcionan transmisión de eventos HTTP en tiempo real a endpoints externos, lo que permite que las sincronizaciones de CRM, notificaciones de Slack o flujos de trabajo personalizados reaccionen instantáneamente ante suscripciones, envíos, bajas y rebotes duros.

La entregabilidad del correo electrónico determina si sus mensajes llegan a la bandeja de entrada o se desvían a spam. MarbleSend cuenta con un motor de inspección DNS integrado que ejecuta cuatro consultas secuenciales no bloqueantes directamente en nameservers autorizados sin dependencias de API de terceros.

MarbleSend proporciona un motor de IA versátil de modo dual para redacción, generación de asuntos y auditoría de spam: (1) Bring Your Own Key (BYOK) para conectar directamente con los principales modelos LLM sin márgenes, y (2) Créditos IA MarbleSend para acceso inmediato pay-as-you-go a modelos selectos sin administrar claves API.

MarbleSend verifica la autenticidad del producto mediante criptografía asimétrica Ed25519 a través de la extensión libsodium nativa de PHP. Se emite un License Grant Token firmado tras la activación inicial y se valida localmente sin demandas constantes de conexión.

El plugin llama a la REST API de MarbleSend por HTTPS, así que WordPress y MarbleSend pueden funcionar en servidores distintos. No tiene acceso a la base de datos de MarbleSend.

curl -X POST https://your-domain.com/api/contacts \
  -H "Authorization: Bearer ms_live_abc123..." \
  -H "Content-Type: application/json" \
  -d '{"email":"visitor@example.com","name":"John Doe","tags":["newsletter","source:wpforms"]}'

Un MarbleSend lento o inaccesible no debe colgar el formulario de un visitante ni hacer perder un lead. Los envíos de los plugins de formularios se ponen en cola y se mandan en segundo plano.

// Non-blocking submission buffer in WordPress
set_transient('marblesend_forms_queue_' . wp_generate_uuid4(), $payload, 3600);
if (!wp_next_scheduled('marblesend_forms_process_queue')) {
    wp_schedule_single_event(time() + 5, 'marblesend_forms_process_queue');
}

El plugin incluye un formulario de suscripción, así que no necesitas un constructor de formularios. Añádelo con un shortcode, un bloque de Gutenberg o un widget. Los tres ejecutan el mismo código.

[marblesend_form tags="newsletter,inbound" show_name="1" consent="I agree to receive email updates and accept the privacy policy."]

WPForms es uno de los constructores de formularios más usados. El plugin lee el envío cuando WPForms lo ha validado, así que no necesitas ningún complemento de WPForms.

add_action('wpforms_process_complete', function($fields, $entry, $form_data, $entry_id) {
    $email = $fields[1]['value'] ?? ''; // Numeric Field ID #1
    $name  = $fields[0]['value'] ?? ''; // Numeric Field ID #0
    MarbleSend_Integration_Base::dispatch('wpforms', $form_data['id'], $email, $name);
}, 10, 4);

Contact Form 7 define sus campos como tags en una plantilla de texto. El plugin se engancha después de que se haya enviado el email del formulario.

add_action('wpcf7_mail_sent', function($contact_form) {
    $submission = WPCF7_Submission::get_instance();
    $data = $submission ? $submission->get_posted_data() : [];
    $email = $data['your-email'] ?? '';
    $name  = $data['your-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('cf7', $contact_form->id(), $email, $name);
}, 10, 1);

El plugin escucha la acción que Fluent Forms lanza después de guardar una entrada.

add_action('fluentform/submission_inserted', function($entryId, $formData, $form) {
    $email = $formData['email'] ?? '';
    $name  = is_array($formData['names'] ?? null) ? implode(' ', $formData['names']) : ($formData['first_name'] ?? '');
    MarbleSend_Integration_Base::dispatch('fluentforms', $form->id, $email, $name);
}, 10, 3);

El plugin lee la entrada justo después de que Formidable Forms la guarde.

add_action('frm_after_create_entry', function($entryId, $formId) {
    $entry = FrmEntry::getOne($entryId, true);
    $email = $entry->metas[12] ?? $entry->metas['email-address'] ?? '';
    $name  = $entry->metas[11] ?? $entry->metas['full-name'] ?? '';
    MarbleSend_Integration_Base::dispatch('formidable', $formId, $email, $name);
}, 30, 2);

El plugin escucha el hook que Forminator lanza mientras procesa un envío.

add_action('forminator_custom_form_submit_before_set_fields', function($formId, $response, $fieldData) {
    $fields = array_column($fieldData, 'value', 'name');
    $email  = $fields['email-1'] ?? '';
    $name   = $fields['name-1'] ?? '';
    MarbleSend_Integration_Base::dispatch('forminator', $formId, $email, $name);
}, 10, 3);

Captar un email es solo el primer paso. Los tags deciden qué pasa después con el contacto.

{
  "email": "lead@agency.com",
  "name": "Jane Smith",
  "tags": ["source:wpforms", "ebook-download", "vip-inbound"],
  "consent_source": "api"
}