Documentación oficial

Guía completa de KlyroMail

Todo lo que necesitas saber para registrarte, configurar tu dominio y empezar a enviar correos transaccionales y campañas de marketing desde tu propia cuenta.

Registro e inicio de sesión

Crea tu cuenta gratuita en menos de 2 minutos.

1

Ir a la página de registro

Visita klyromail.com y haz clic en "Crear cuenta gratis" o dirígete directamente a /register.

[ Imagen: Página de registro — formulario con nombre de organización, correo y contraseña ]

2

Completar el formulario

Rellena los tres campos requeridos:

  • Nombre de organización — el nombre de tu empresa o proyecto.
  • Correo electrónico — será tu usuario para iniciar sesión.
  • Contraseña — mínimo 8 caracteres.
3

Cuenta creada — Plan Free activado

Al registrarte se activa automáticamente el Plan Free que incluye:

  • 200 correos por mes
  • 2 API Keys
  • 2 Webhooks
✓ Consejo:No se requiere tarjeta de crédito para el plan gratuito.
4

Iniciar sesión

Ve a /login, ingresa tu correo y contraseña y haz clic en "Iniciar sesión". Serás redirigido automáticamente al panel.

[ Imagen: Pantalla de inicio de sesión — formulario de email y contraseña ]

Panel principal

Vista general del estado de tu cuenta y estadísticas de envío.

Al ingresar verás el dashboard con un resumen de la actividad de tu cuenta:

  • Correos enviados este mes — total de envíos del período actual.
  • Correos en cola — pendientes de procesarse.
  • Correos entregados — confirmados por el servidor destino.
  • Correos fallidos — intentos que no pudieron completarse.
  • Uso del plan — barra de progreso con los correos usados vs. el límite mensual.

[ Imagen: Dashboard principal — tarjetas de estadísticas y barra de uso del plan ]

ℹ Nota:Las estadísticas se actualizan en tiempo real. Puedes hacer clic en el botón de recarga para forzar la actualización.

El menú lateral izquierdo te da acceso a todas las secciones:

Dashboard

Resumen general y estadísticas

Emails

Historial de correos transaccionales

Plantillas

Diseños reutilizables para campañas y correos

Campañas

Creación y seguimiento de campañas

Listas

Gestión de listas y suscriptores

Contactos

Todos los destinatarios con su estado

Billing

Plan activo y facturación

Settings

Dominios, remitentes, API Keys, Webhooks y supresiones

[ Imagen: Menú lateral — íconos y etiquetas de cada sección ]

Selector de dominio activo

En la parte superior del menú lateral, justo debajo del logo, aparece el selector de dominio cuando tienes al menos un dominio verificado:

  • 1 dominio verificado — se muestra fijo como etiqueta, sin dropdown.
  • 2 o más dominios — aparece un selector desplegable para elegir con cuál trabajar.

El dominio activo determina el contexto de trabajo. La selección se guarda automáticamente y se restaura al volver a iniciar sesión.

[ Imagen: Selector de dominio activo en el menú lateral — dropdown con lista de dominios verificados ]

✓ Consejo:Si no ves el selector, asegúrate de tener al menos un dominio con estado Verificado en Settings → Dominios.

Agregar un dominio

Para enviar correos desde tu propia dirección debes verificar tu dominio.

⚠ Importante:Sin un dominio verificado no podrás crear remitentes ni enviar campañas. Este paso es obligatorio.
1

Ir a Settings → Dominios

En el menú lateral haz clic en Settings y luego selecciona la pestaña Dominios.

[ Imagen: Pestaña Dominios en Settings — campo para ingresar el dominio y botón Agregar ]

2

Escribir el dominio y hacer clic en Agregar

Escribe tu dominio sin http:// ni www. Ejemplo: tuempresa.com

El sistema registrará el dominio automáticamente y te mostrará los registros DNS que debes agregar en tu proveedor.

3

Agregar los registros DNS en tu proveedor

Se generarán 3 registros que debes agregar en el panel de DNS de tu dominio (Cloudflare, GoDaddy, Namecheap, etc.):

TipoNombreValorPropósito
TXTmx._domainkey.tudominio.comk=rsa; p=MII...DKIM (firma digital)
TXT@ (raíz)v=spf1 include:spf.klyromail.com ~allSPF
TXT_dmarc.tudominio.comv=DMARC1; p=none; ...DMARC

Los valores exactos se muestran en la plataforma al agregar el dominio — cópialos directamente desde ahí.

[ Imagen: Panel DNS (Cloudflare) — registros TXT configurados con proxy desactivado ]

⚠ Importante:En Cloudflare, asegúrate de que todos los registros estén en modo DNS only (nube gris), no proxied.
4

Verificar el dominio

Una vez que hayas agregado los registros, regresa a KlyroMail y haz clic en "Check Verification".

La propagación DNS suele tardar entre 5 y 30 minutos con Cloudflare. Si el estado sigue en Pendiente, espera unos minutos y vuelve a intentarlo — la plataforma te mostrará un mensaje indicando que los registros aún están propagando.

[ Imagen: Estado del dominio — badge verde 'Verificado' junto al nombre de dominio ]

ℹ Nota:Puedes hacer clic en Check Verification varias veces. El estado cambiará de Pendiente a Verificado una vez que los registros DNS sean detectados correctamente.

Crear remitentes

Un remitente es la dirección de correo desde la que enviarás mensajes.

Un remitente se compone de un prefijo más el dominio verificado. Ejemplo: si tu dominio es empresa.com y el prefijo es noreply, el remitente será noreply@empresa.com.

1

Ir a Settings → Remitentes

En el menú lateral haz clic en Settings y selecciona la pestaña Remitentes.

2

Hacer clic en 'Nuevo remitente'

Se abrirá un formulario donde debes:

  • Seleccionar el dominio verificado desde el menú desplegable.
  • Escribir el prefijo (todo en minúsculas, sin espacios). Ej: noreply, soporte, info.

Verás la vista previa del correo completo antes de guardar.

[ Imagen: Modal de nuevo remitente — selector de dominio, campo de prefijo y vista previa ]

3

Guardar el remitente

Haz clic en "Crear remitente". Aparecerá en la tabla y ya podrás usarlo para enviar correos.

✓ Consejo:Puedes crear múltiples remitentes por dominio. Por ejemplo: noreply@, soporte@, facturas@, marketing@.

Enviar correos transaccionales

Correos individuales disparados por eventos: bienvenida, contraseña, notificaciones.

Puedes enviar correos de dos formas: desde el panel visual o usando la API.

Desde el panel

1

Ir a la sección Emails

En el menú lateral haz clic en Emails. Verás el historial de todos los correos enviados.

2

Hacer clic en 'Enviar correo'

Se abrirá un formulario con los siguientes campos:

  • De: selecciona uno de tus remitentes registrados.
  • Para: correo del destinatario.
  • Asunto: asunto del mensaje.
  • HTML: cuerpo del correo en formato HTML.

[ Imagen: Modal de envío de correo — campos From, To, Subject y HTML ]

Editor visual (opcional)

Junto al campo HTML Body encontrarás el botón "Editor visual". Al hacerle clic se abre el editor drag & drop GrapesJS para diseñar el correo sin escribir HTML. Las imágenes que subas se almacenan en nuestros servidores y se reutilizan en futuros envíos.

1

Abrir el editor visual

Haz clic en el botón "Editor visual" (ícono de pincel) que aparece junto a la etiqueta HTML Body. El editor se carga sobre el modal actual.

2

Diseñar el correo con bloques

Arrastra bloques al lienzo: texto, imágenes, botones, separadores y más. Para agregar una imagen haz clic en el bloque de imagen — se abrirá el gestor de assets donde puedes subir archivos nuevos o seleccionar imágenes ya subidas previamente.

3

Aplicar el diseño y enviar

Haz clic en "Usar este diseño". El editor exporta el HTML con los estilos inline automáticamente y lo inyecta en el campo. Luego haz clic en "Enviar correo" como de costumbre.

[ Imagen: Editor visual GrapesJS — lienzo en el centro con bloques arrastrables y panel de propiedades ]

✓ Consejo:Las imágenes subidas desde cualquier editor (correos, campañas o plantillas) quedan guardadas y disponibles para reutilizar en el gestor de assets.
3

El correo queda en cola y se envía en segundos

El estado inicial es En cola y cambiará a Enviado o Entregado según la respuesta del servidor destino.

[ Imagen: Tabla de emails — columnas de destinatario, asunto, estado con badge de color y fecha ]

Uso de la API

Integra KlyroMail directamente en tu aplicación con nuestra API REST.

ℹ Nota:Necesitas una API Key para autenticarte. Ve a Settings → API Keys para crear una.

Enviar un correo vía API

POST https://klyromail.com/api/send-email/
Authorization: Bearer TU_API_KEY
Content-Type: application/json

{
  "from_email": "noreply@tudominio.com",
  "to": "cliente@ejemplo.com",
  "subject": "Bienvenido a nuestra plataforma",
  "html": "<h1>Hola!</h1><p>Gracias por registrarte.</p>",
  "text": "Hola! Gracias por registrarte."
}

Respuesta exitosa

HTTP 202 Accepted

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "queued"
}

Ejemplo en JavaScript

const response = await fetch("https://klyromail.com/api/send-email/", {
  method: "POST",
  headers: {
    "Authorization": "Bearer TU_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    from_email: "noreply@tudominio.com",
    to: "cliente@ejemplo.com",
    subject: "Confirmación de pedido #1234",
    html: "<p>Tu pedido fue confirmado.</p>",
  }),
});

const data = await response.json();
console.log(data.id); // ID del correo en cola

Ejemplo en Python

import requests

response = requests.post(
    "https://klyromail.com/api/send-email/",
    headers={
        "Authorization": "Bearer TU_API_KEY",
        "Content-Type": "application/json",
    },
    json={
        "from_email": "noreply@tudominio.com",
        "to": "cliente@ejemplo.com",
        "subject": "Tu factura de este mes",
        "html": "<p>Adjuntamos tu factura.</p>",
    }
)

print(response.json())

Plantillas de email

Diseña y guarda plantillas reutilizables para campañas y correos transaccionales.

La sección Plantillas te permite crear diseños de correo una sola vez y reutilizarlos en múltiples campañas. Las plantillas se editan con el mismo editor visual GrapesJS y se guardan con nombre y asunto opcional.

1

Ir a la sección Plantillas

En el menú lateral haz clic en Plantillas. Verás la lista de todas tus plantillas guardadas.

2

Crear una nueva plantilla

Haz clic en "Nueva plantilla", escribe un nombre descriptivo y haz clic en "Crear". Serás redirigido al editor visual.

[ Imagen: Página Plantillas — lista de plantillas con nombre y botones de editar/eliminar ]

3

Diseñar con el editor visual

El editor GrapesJS te permite construir el diseño con bloques drag & drop. Puedes:

  • Subir imágenes — quedan guardadas en el servidor y disponibles para futuros diseños.
  • Agregar texto, botones, imágenes, separadores y columnas.
  • Editar el nombre y asunto predeterminado desde los campos del encabezado.
4

Guardar la plantilla

Haz clic en "Guardar". El diseño se guarda con su HTML y estructura interna. Al volver a abrir la plantilla el diseño se carga automáticamente.

[ Imagen: Editor de plantilla — campos de nombre y asunto en el encabezado, editor visual abajo y botón Guardar ]

✓ Consejo:Al crear una campaña, en el paso de Diseño puedes elegir "Usar plantilla existente" para cargar el diseño de cualquier plantilla guardada como punto de partida.

Campañas de marketing

Envía correos masivos a listas de suscriptores con un diseño profesional.

⚠ Importante:Las campañas solo se pueden enviar a suscriptores que se han dado de alta voluntariamente. Importar correos sin consentimiento viola los términos del servicio y las leyes anti-spam.
1

Ir a la sección Campañas

En el menú lateral haz clic en Campañas. Verás la lista de todas tus campañas con su estado y estadísticas.

[ Imagen: Página de campañas — tabla con columnas: nombre, estado, lista, enviados, entregados, aperturas ]

2

Crear una nueva campaña — Paso 1: Configuración

Haz clic en "Nueva campaña". En el primer paso completa:

  • Nombre interno — para identificar la campaña (no lo ve el destinatario).
  • Asunto del email — lo que aparece en la bandeja de entrada.
  • Remitente — selecciona uno de tus remitentes verificados.
  • Nombre del remitente — ej: "Equipo KlyroMail".
  • Lista de contactos — la lista de suscriptores que recibirán el correo.

[ Imagen: Paso 1 — Formulario de configuración de campaña con todos los campos ]

3

Paso 2: Diseñar el correo

Al llegar al paso de Diseño verás dos opciones:

  • Usar plantilla existente — elige una de tus plantillas guardadas como base. El diseño se carga automáticamente en el editor.
  • Crear desde cero — abre el editor visual GrapesJS vacío para diseñar libremente.

En el editor puedes arrastrar bloques al lienzo (texto, imágenes, botones, columnas). Sube imágenes directamente desde el gestor de assets — quedan almacenadas en nuestros servidores.

Usa "Guardar" para preservar el progreso y "Siguiente" para avanzar al paso de envío. El botón "Cambiar" te permite volver al selector de plantilla/desde cero.

[ Imagen: Paso 2 — Selector: Usar plantilla existente vs Crear desde cero ]

[ Imagen: Editor GrapesJS — lienzo de diseño con bloques arrastrables ]

4

Paso 3: Revisar y enviar

Verás un resumen con: nombre, asunto, remitente, lista y número de destinatarios. Revisa que todo esté correcto y haz clic en "Enviar campaña".

El sistema agrega automáticamente un pie de página con el link de baja al final de cada correo. Esto es obligatorio por ley.

[ Imagen: Paso 3 — Resumen de campaña con botones de Editar diseño y Enviar campaña ]

5

Monitorear el envío

Al hacer clic en una campaña enviada verás estadísticas en tiempo real:

  • Enviados — total de correos despachados.
  • Entregados — confirmados por el servidor del destinatario.
  • Aperturas — número de veces que se abrió el correo.
  • Rebotes — correos que no pudieron entregarse.
  • Bajas — suscriptores que hicieron clic en "Cancelar suscripción".

[ Imagen: Dashboard de campaña — tarjetas de estadísticas + pestaña de destinatarios con estado individual ]

Listas de contactos

Organiza a tus suscriptores en listas para segmentar tus campañas.

1

Ir a la sección Listas

En el menú lateral haz clic en Listas. Verás el panel de gestión de listas con dos columnas: tus listas a la izquierda y los suscriptores de la lista seleccionada a la derecha.

[ Imagen: Página Listas — panel izquierdo con listas existentes y panel derecho con suscriptores de la lista seleccionada ]

2

Crear una nueva lista

Haz clic en "Nueva lista", escribe un nombre descriptivo (ej: "Newsletter", "Clientes activos", "Leads 2026") y guarda.

3

Agregar suscriptores manualmente

Selecciona la lista en el panel izquierdo. En el panel derecho ingresa el correo del suscriptor y haz clic en "Agregar".

4

Importar suscriptores desde CSV

Prepara un archivo .csv con las siguientes columnas:

email,first_name,last_name
juan@ejemplo.com,Juan,Pérez
maria@empresa.com,María,López
cliente@otro.com,,

Haz clic en "Importar CSV", selecciona el archivo y confirma. El sistema procesará todos los registros y te mostrará cuántos se crearon y cuántos ya existían.

[ Imagen: Panel de suscriptores — lista de correos con estado 'Activo' y botón de importar CSV ]

✓ Consejo:Solo los suscriptores con estado Activo reciben las campañas. Los que se dieron de baja quedan como Dado de baja y no recibirán más correos.
ℹ Nota:Si un suscriptor se dio de baja y lo vuelves a agregar manualmente a una lista, su bloqueo por baja voluntaria se elimina automáticamente y podrá recibir campañas de nuevo. Los bloqueos por rebote o queja de spam no se eliminan al re-agregar — son permanentes por protección de reputación.

Contactos

Registro automático de todos los destinatarios a los que has enviado correos.

La sección Contactos es un directorio que se construye automáticamente con los destinatarios de tus correos transaccionales (enviados individualmente desde la sección Emails o via API). Los suscriptores de listas de campañas se gestionan en la sección Listas.

Activo

Recibe correos con normalidad.

Dado de baja

Se dio de baja. No recibe más correos.

Rebotado

Su dirección generó un hard bounce.

Queja

Marcó un correo como spam.

Para acceder, haz clic en Contactos en el menú lateral. La tabla muestra:

  • Correo — dirección del destinatario.
  • Estado — Activo, Dado de baja, Rebotado o Queja.
  • Enviados / Entregados / Rebotes — contadores por dirección.
  • Último envío — fecha del último correo enviado a esa dirección.

[ Imagen: Página Contactos — tabla con correo, estado, contadores de enviados/entregados/rebotes y fecha de último envío ]

ℹ Nota:Esta sección es de solo lectura. Los contactos se crean y actualizan automáticamente con cada envío. Para bloquear una dirección manualmente usa la Lista de supresión.

API Keys

Claves de autenticación para usar la API desde tu aplicación.

1

Ir a Settings → API Keys

En el menú lateral haz clic en Settings y selecciona la pestaña API Keys.

[ Imagen: Pestaña API Keys — tabla de claves con nombre, fecha de creación y botón de eliminar ]

2

Crear una nueva API Key

Escribe un nombre descriptivo para identificar para qué la usarás (ej: "Producción", "Staging", "App móvil") y haz clic en "Crear".

3

Copiar y guardar la clave

La clave se muestra una sola vez. Cópiala y guárdala en un lugar seguro (archivo .env, gestor de secretos, etc.).

⚠ Importante:Si pierdes la clave no podrás recuperarla. Deberás eliminarla y crear una nueva.

Cómo usar la API Key

Incluye la clave en el header Authorization de cada petición:

Authorization: Bearer klyro_XXXXXXXXXXXXXXXXXXXXXXXXXX

Webhooks

Recibe notificaciones en tu servidor cuando ocurra un evento de correo.

Los webhooks te permiten enterarte en tiempo real cuando un correo es enviado, entregado, falla o rebota, sin necesidad de consultar la API constantemente.

1

Ir a Settings → Webhooks

En el menú lateral haz clic en Settings y selecciona la pestaña Webhooks.

[ Imagen: Pestaña Webhooks — formulario con campo URL y selector de evento ]

2

Agregar un webhook

Completa los campos:

  • URL — endpoint HTTPS de tu servidor que recibirá las notificaciones.
  • Evento — selecciona qué evento quieres escuchar: email_sent, email_delivered, email_failed.

Payload de ejemplo

POST https://tuservidor.com/webhooks/klyromail
Content-Type: application/json

{
  "event": "email_sent",
  "data": {
    "email_id": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Lista de supresión

Correos bloqueados automáticamente para proteger tu reputación de envío.

La lista de supresión es un mecanismo de protección automática. Cuando un correo rebota permanentemente (dirección inválida o inexistente) o el destinatario reporta el correo como spam, el sistema agrega automáticamente esa dirección a la lista y bloquea futuros envíos a ese correo.

Rebote permanente (Hard Bounce)

La dirección no existe o el servidor rechaza permanentemente el correo.

Queja de spam (Complaint)

El destinatario marcó el correo como spam en su cliente de correo.

[ Imagen: Pestaña Supresiones — tabla con correo, motivo (rebote/queja), fecha y botón de eliminar ]

✓ Consejo:Puedes eliminar manualmente un correo de la lista si fue un error (ej: el usuario corrigió su dirección). Solo haz clic en el ícono de papelera junto al registro.
ℹ Nota:Si el correo fue suprimido por baja voluntaria (el usuario hizo clic en "Cancelar suscripción"), al re-agregarlo manualmente a una lista el bloqueo se levanta automáticamente. Los bloqueados por rebote o queja deben eliminarse manualmente desde aquí antes de poder volver a enviarles.

Configuración general

Ajustes de tu organización y plan de facturación.

Pestañas de Settings

La sección Settings (ícono de engranaje en la parte inferior del menú) contiene las siguientes pestañas:

Organización

Cambiar el nombre de tu organización y ver los detalles de tu cuenta.

API Keys

Crear y eliminar claves de autenticación para la API.

Webhooks

Configurar endpoints para recibir eventos en tiempo real.

Dominios

Agregar y verificar dominios para el envío de correos.

Remitentes

Crear direcciones de remitente desde tus dominios verificados.

Supresiones

Ver y gestionar la lista de correos bloqueados por rebotes o quejas.

[ Imagen: Settings — barra de pestañas con Organización, API Keys, Webhooks, Dominios, Remitentes y Supresiones ]

Facturación

En la sección Billing del menú lateral puedes ver y cambiar tu plan. Los planes disponibles son:

PlanPrecioCorreos/mesAPI KeysWebhooksCampañas
Free$0/mes20022No
Starter$9/mes10,00033
Growth$29/mes50,00055
Pro$59/mes200,0001010
Scale$99/mes500,000

[ Imagen: Página de Billing — plan activo, correos usados y cards de los 5 planes disponibles ]

ℹ Nota:El contador de correos se reinicia el primer día de cada mes. Los correos no usados no se acumulan para el siguiente período. El plan Free no requiere tarjeta de crédito.

WhatsApp Chat

Conecta un número de WhatsApp Business para atender clientes en tiempo real desde KlyroMail.

ℹ Nota:WhatsApp Chat está disponible en planes de pago (Starter y superiores). Cada dominio puede tener un número de WhatsApp independiente.

Flujo de trabajo general

Conecta

Escanea el QR desde Configuración → WhatsApp

Recibe

Los mensajes llegan en tiempo real al módulo Chat

Responde

El agente escribe y envía desde el chat

Automatiza

El bot responde fuera de horario o muestra menú

Conectar un número de WhatsApp

1

Ve a Configuración → pestaña WhatsApp

Cada fila corresponde a un dominio. Los dominios sin número conectado muestran el botón Conectar.

2

Genera el QR

Haz clic en Conectar. Se abrirá un modal con el código QR. El QR se renueva automáticamente cada 25 segundos.

3

Escanea desde WhatsApp

  1. Abre WhatsApp o WhatsApp Business en tu teléfono.
  2. Ve a Dispositivos vinculados → Vincular dispositivo.
  3. Escanea el código QR.
4

Verifica la conexión

El punto de estado cambiará a verde y aparecerá el número conectado. La instancia queda activa hasta que la desconectes manualmente.

⚠ Importante:Si cierras el modal antes de escanear, la instancia pendiente se elimina automáticamente para no dejar conexiones huérfanas.

[ Imagen: Configuración → WhatsApp — tarjeta de dominio con estado Conectado y bot desplegado ]

Bandeja de conversaciones

Ve a WhatsApp en el menú lateral para acceder a la bandeja. Cada conversación muestra: nombre/número del contacto, último mensaje, hora, estado y etiquetas.

Filtros de estado

Filtra por Todas / Abiertas / En progreso / Resueltas / En espera desde las pestañas de la parte superior de la lista.

Buscar contacto

Usa la barra de búsqueda para filtrar por nombre o número de teléfono.

Etiquetas visibles

Las etiquetas asignadas aparecen como chips de colores debajo de cada conversación.

Mensajes no leídos

Un contador verde indica cuántos mensajes nuevos hay en cada conversación.

[ Imagen: Bandeja de WhatsApp — lista con conversaciones, filtros, estados y chips de etiquetas ]

Chat y acciones en conversación

Al seleccionar una conversación se abre el panel del chat. En el encabezado encontrarás las acciones disponibles:

AcciónDescripción
Cambiar estadoDropdown (hover) con Abierta / En progreso / Resuelta / En espera. El estado se refleja en la lista.
Panel de etiquetasBotón con ícono de etiqueta. Muestra un panel lateral para asignar/quitar etiquetas de colores.
Panel de notasBotón con ícono de nota. Permite agregar notas internas visibles solo para el equipo (no se envían al cliente).
Respuestas rápidasEscribe / en el input del chat. Aparece un menú con los shortcuts guardados. Selecciona uno para insertarlo.

[ Imagen: Chat abierto — header con dropdown de estado, botones de etiquetas y notas, panel lateral de etiquetas visible ]

Etiquetas (Tags)

Las etiquetas son labels de colores que puedes asignar a conversaciones para organizarlas y filtrarlas.

1

Crear una etiqueta

Abre cualquier conversación → panel de etiquetas (ícono de tag) → sección Nueva etiqueta → escribe un nombre, elige color y haz clic en Crear etiqueta.

2

Asignar a una conversación

En la misma lista de etiquetas, haz clic en cualquier etiqueta para agregarla o quitarla de la conversación activa.

3

Filtrar por etiqueta

Próximamente desde los filtros de la bandeja. Por ahora las etiquetas son visibles como chips en cada conversación.

Notas internas

Las notas son comentarios visibles solo para tu equipo. Nunca se envían al cliente. Se muestran en un panel lateral con fondo amarillo.

Agregar contexto sobre el cliente (ej: 'Cliente VIP, descuento del 20%')
Dejar instrucciones para otro agente que tome la conversación
Registrar acuerdos verbales o compromisos
No son mensajes — el cliente nunca las verá

Respuestas rápidas

Guarda mensajes frecuentes como shortcuts para enviarlos con solo escribir /.

1

Crear una respuesta rápida

Ve a Configuración → WhatsApp (próximamente tendrá su propia sección). Por ahora se crean vía API o directamente desde el chat al escribir un shortcut nuevo.

2

Usar en el chat

Escribe / en el input del chat. Aparecerá un menú con todas las respuestas guardadas. Sigue escribiendo para filtrar por nombre del shortcut. Haz clic para insertar el texto completo.

[ Imagen: Chat — overlay de respuestas rápidas al escribir '/', con shortcut y preview del texto ]

Bot de respuestas automáticas

El bot se configura por número (dominio) desde Configuración → WhatsApp → Bot de respuestas automáticas. Haz clic en la fila del número conectado para expandir la configuración.

Fuera de horario

Cuando un cliente escribe fuera del horario configurado, el bot envía un mensaje automático una vez y marca la conversación como En espera.

Menú de bienvenida

Al recibir el primer mensaje de un contacto, el bot envía un menú numerado. El cliente responde con un número y el bot confirma con la respuesta configurada.

Configurar el bot paso a paso

1

Activa el bot

En la tarjeta del número conectado, expande la sección Bot de respuestas automáticas y activa el toggle Bot activo.

2

Define el horario de atención

Selecciona los días hábiles (Lun-Dom), la hora de inicio y fin, y tu zona horaria. El bot solo responde fuera de este horario (si está habilitado).

3

Configura el mensaje fuera de horario

Escribe el mensaje que se enviará cuando un cliente contacte fuera de horario. Puedes usar variables:

  • {{nombre}} — nombre del contacto (o su número si no está guardado)
  • {{numero}} — número de teléfono
4

Crea el menú de bienvenida (opcional)

Activa el toggle Menú de bienvenida, escribe el mensaje inicial y agrega opciones con el botón + Agregar opción. Para cada opción puedes definir:

  • Etiqueta — el texto que verá el cliente (ej: "Ventas")
  • Respuesta automática — lo que el bot responde al seleccionar esa opción
  • Asignar etiqueta — tag que se aplica automáticamente a la conversación
5

Guarda los cambios

Haz clic en Guardar bot. Los cambios tienen efecto inmediato para los nuevos mensajes entrantes.

✓ Consejo:El bot solo responde al primer mensaje de cada conversación. Si el agente ya respondió, el bot no vuelve a activarse en esa misma conversación.
⚠ Importante:Para que el bot funcione correctamente el número debe estar conectado y el toggle Bot activo debe estar en verde.

[ Imagen: Bot configurado — horario Lun-Vie 9-18, mensaje fuera de horario y menú con 3 opciones ]

Flujo completo: de mensaje a resolución

Cliente escribe primer mensaje

Llega vía webhook de Evolution API

Bot evalúa horario

¿Es horario de atención? → Sí: menú bienvenida | No: mensaje fuera de horario

Cliente selecciona opción del menú

Bot responde con el texto configurado y asigna etiqueta

Agente recibe la conversación

Aparece en la bandeja con estado 'En progreso'

Agente responde en tiempo real

Los mensajes pasan por la cola (rate limiter) antes de llegar a WhatsApp

Conversación resuelta

El agente cambia el estado a 'Resuelta'

Tracking de aperturas y clics

KlyroMail registra automáticamente cuándo cada destinatario abre tu correo y en qué enlaces hace clic.

Cuando envías una campaña, el sistema transforma el HTML del correo antes de despacharlo. Este proceso ocurre de forma transparente — no necesitas hacer nada extra en tu diseño.

Pixel de apertura

Justo antes de la etiqueta </body>, el sistema inyecta automáticamente una imagen invisible de 1×1 píxel:

<!-- Inyectado automáticamente al enviar la campaña -->
<img src="https://app.klyromail.com/api/t/o/{token}.gif"
     width="1" height="1" style="display:none" />

Cuando el destinatario abre el correo y su cliente carga las imágenes, el servidor recibe la petición y registra la apertura. Esto actualiza las estadísticas de la campaña en tiempo real y marca la hora exacta de apertura para ese destinatario en la pestaña Destinatarios.

ℹ Nota:Los clientes de correo que bloquean la carga de imágenes (como algunos clientes corporativos) no dispararán el pixel. Las tasas de apertura reales pueden ser ligeramente más altas que las reportadas.

Tracking de clics

Todos los enlaces http:// y https:// del correo son reemplazados por una URL de redirección antes del envío:

<!-- URL original en tu diseño -->
<a href="https://tutienda.com/producto">Ver producto</a>

<!-- URL reescrita automáticamente al enviar -->
<a href="https://app.klyromail.com/api/t/c/abc123?r=TOKEN_DESTINATARIO">Ver producto</a>

Cuando el destinatario hace clic, el servidor registra el evento y lo redirige inmediatamente a la URL original. El proceso es instantáneo y transparente para el usuario.

Estadística global

El contador de clics de la campaña aumenta con cada clic único.

Por destinatario

Se registra la hora del primer clic de cada persona en la pestaña Destinatarios.

Por enlace

Cada URL distinta en el correo tiene su propio contador independiente.

Baja con un clic (List-Unsubscribe)

Cada correo de campaña incluye los headers estándar List-Unsubscribe y List-Unsubscribe-Post. Esto permite que clientes de correo modernos (como Gmail) muestren un botón nativo de "Cancelar suscripción" junto al remitente, sin que el usuario tenga que abrir el correo.

✓ Consejo:Esta funcionalidad es automática. Cumplir con el estándar List-Unsubscribe es un requisito de Google y Yahoo para remitentes masivos desde febrero 2024 y mejora significativamente la reputación de envío.

Dónde ver los resultados

Ve a Campañas → [nombre de campaña]. Encontrarás:

  • Tarjetas de estadísticas — Enviados, Entregados, Aperturas, Rebotes y Bajas en la parte superior.
  • Pestaña Destinatarios — tabla con estado individual, hora de envío y hora de apertura por persona.

[ Imagen: Detalle de campaña — tarjetas de estadísticas y pestaña Destinatarios con columnas Enviado y Abierto ]

Segmentación de suscriptores

Filtra suscriptores por estado o nivel de engagement para campañas más precisas.

Dentro de cada lista de contactos puedes aplicar filtros para ver y exportar solo el segmento que te interesa. Esto es útil para reenviar campañas a quienes no abrieron el correo o para identificar suscriptores inactivos.

Filtros disponibles

Filtro por estado

  • activorecibe correos con normalidad
  • dado de bajacanceló la suscripción
  • rebotadodirección inválida o rechazada
  • quejamarcó un correo como spam

Filtro por engagement

  • openedabrió al menos una campaña
  • clickedhizo clic en al menos un enlace
  • inactivenunca ha abierto ni hecho clic en ninguna campaña
1

Abre la lista y aplica un filtro

Ve a Listas → [nombre de la lista]. En la barra superior del panel de suscriptores encontrarás los selectores Estado y Engagement. Selecciona el valor que quieres filtrar — la tabla se actualiza automáticamente.

[ Imagen: Panel de suscriptores con filtros de Estado y Engagement — tabla actualizada mostrando solo los que coinciden ]

2

Exportar el segmento a CSV

Con el filtro aplicado, haz clic en el botón "Exportar CSV". Se descargará un archivo con todos los suscriptores que cumplen el filtro activo. El archivo incluye: correo, nombre, apellido, estado y fecha de suscripción.

✓ Consejo:Para reenviar una campaña a quienes no la abrieron: exporta los suscriptores con filtro engagement = inactive, crea una nueva lista, importa el CSV y lanza la campaña a esa lista.
ℹ Nota:Los filtros de engagement se calculan en tiempo real basándose en el historial de todas las campañas enviadas a esa lista. Un suscriptor pasa a opened en cuanto se registra la primera apertura, aunque sea de una campaña anterior.

Generación de contenido con IA

Redacta el contenido de tus campañas con Inteligencia Artificial en segundos.

Al crear una nueva campaña, el paso de Diseño incluye una tercera opción: Generar con IA. Describe el propósito del correo y la IA genera un diseño completo listo para usar.

Cómo usar la generación con IA

1

Selecciona 'Generar con IA' en el paso de Diseño

Al crear una campaña, en el paso Diseño, elige la tercera opción "Generar con IA". Verás un formulario con cuatro campos.

[ Imagen: Paso de diseño — tres opciones: Usar plantilla, Crear desde cero y Generar con IA (resaltada) ]

2

Completa el formulario de generación

Rellena los campos para guiar a la IA:

CampoDescripciónEjemplo
Descripción *Qué quieres comunicar en el correo (campo obligatorio)Promoción de verano con 30% de descuento en toda la tienda
TonoEl estilo del texto generadoProfesional / Amigable / Urgente
Texto del botón CTATexto del botón de llamada a la acción (opcional)Ver ofertas ahora
URL del botón CTAEnlace al que apunta el botón (opcional)https://tutienda.com/verano
3

Haz clic en 'Generar con IA'

El sistema envía tu descripción a la IA (Gemini 1.5 Flash). En unos segundos verás una vista previa del correo generado junto con el asunto sugerido. Si el resultado no te convence, haz clic en "Regenerar" para obtener una nueva versión.

[ Imagen: Panel de IA — formulario a la izquierda y vista previa del correo generado a la derecha con botón Regenerar ]

4

Usa el diseño generado

Si el resultado te satisface, haz clic en "Usar este diseño →". El correo se guarda automáticamente en la campaña y avanzas al paso de revisión y envío.

✓ Consejo:Entre más detallada sea la descripción, mejor será el resultado. En lugar de "correo de bienvenida", prueba: "correo de bienvenida para nuevos clientes de una tienda de ropa, tono amigable, con botón para ver el catálogo".
ℹ Nota:El contenido generado por IA es un punto de partida. Después de seleccionarlo, puedes editarlo en el editor visual antes de enviar la campaña.

Guardar campaña como plantilla

Cuando una campaña ya fue enviada exitosamente y el diseño te gustó, puedes reutilizarlo en futuras campañas guardándolo como plantilla.

1

Abre la campaña enviada

Ve a Campañas y haz clic en la campaña con estado Enviada.

2

Haz clic en 'Guardar como plantilla'

En la esquina superior derecha del detalle de la campaña aparece el botón "Guardar como plantilla" (solo visible en campañas enviadas). Haz clic en él.

3

Plantilla disponible de inmediato

Aparecerá una confirmación verde con el nombre de la plantilla creada. La plantilla queda disponible en la sección Plantillas y también en el selector del paso de diseño al crear futuras campañas.

[ Imagen: Detalle de campaña enviada — botón 'Guardar como plantilla' en el header y toast de confirmación verde ]

✓ Consejo:Las plantillas creadas desde campañas se identifican automáticamente con el nombre "Plantilla de: [nombre de la campaña]". Puedes renombrarlas desde la sección Plantillas.

¿Tienes dudas? Escríbenos a soporte@klyromail.com

Crear cuenta gratis