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

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 ]

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á automáticamente el dominio en Amazon SES y te mostrará los registros DNS que debes agregar.

3

Agregar los registros DNS en tu proveedor

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

TipoNombreValorPropósito
CNAMEabc123._domainkeyabc123.dkim.amazonses.comDKIM firma (×3)
TXTtudominio.comv=spf1 include:amazonses.com ~allSPF
TXT_dmarcv=DMARC1; p=none; ...DMARC
MXtudominio.comfeedback-smtp.us-east-1.amazonses.comRebotes

[ Imagen: Panel DNS (Cloudflare) — registros CNAME y TXT configurados ]

4

Verificar el dominio

Una vez que hayas agregado los registros, regresa a KlyroMail y haz clic en "Verificar dominio". La verificación puede tardar entre 15 minutos y 48 horas dependiendo de tu proveedor DNS.

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

ℹ Nota:Puedes hacer clic en Verificar varias veces. El estado cambiará de Pendiente a Verificado cuando Amazon SES confirme los registros.

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 Unlayer en pantalla completa para diseñar el correo sin escribir HTML.

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 del panel izquierdo al lienzo: texto, imágenes, botones, separadores y más. Configura colores, fuentes y estilos en el panel derecho.

3

Aplicar el diseño y enviar

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

[ Imagen: Editor visual Unlayer en pantalla completa — bloques a la izquierda, lienzo en el centro, propiedades a la derecha ]

✓ Consejo:Si ya aplicaste un diseño del editor, aparecerá una nota verde indicándolo. Aún puedes editar el HTML directamente en el textarea si lo necesitas.
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())

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 con el editor visual

El editor drag & drop te permite crear el diseño arrastrando bloques: texto, imágenes, botones, divisores y más.

  • Panel izquierdo: bloques disponibles para arrastrar al diseño.
  • Centro: lienzo del email con vista previa en tiempo real.
  • Panel derecho: propiedades del bloque seleccionado (color, fuente, tamaño, etc.).

Al terminar haz clic en "Guardar" para preservar el diseño y luego en "Siguiente".

[ Imagen: Editor Unlayer — lienzo de diseño con bloques en panel izquierdo y propiedades a la derecha ]

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 se les vuelve a enviar.

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. Cada vez que envías un correo transaccional, el destinatario se registra aquí con su estado y estadísticas de entrega.

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.

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.

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

Crear cuenta gratis