Saltar al contenido principal
MailPulse
EN ES
Empezar gratis

Documentación

Todo lo que necesitas para configurar, ajustar y sacar el máximo provecho de MailPulse.

Introducción

MailPulse es una plataforma de monitoreo de entregabilidad de email construida específicamente para AWS SES. Te ayuda a rastrear tasas de entrega, detectar problemas antes de que afecten tu reputación como remitente y optimizar el rendimiento de tus emails.

Con MailPulse puedes:

  • Monitorear tasas de entrega, rebotes y quejas en tiempo real
  • Recibir alertas inteligentes cuando las métricas superan umbrales
  • Generar reportes profesionales en PDF y CSV
  • Verificar direcciones de email antes de enviar
  • Realizar pruebas A/B de asuntos con confianza estadística
  • Encontrar los mejores horarios de envío con mapas de calor
  • Enviar emails directamente desde tu configuración SES

Inicio Rápido

Comienza en 5 minutos.

Paso 1: Crear una Cuenta

Ve a app.getmailpulse.net/signup y crea tu cuenta gratuita.

Paso 2: Conectar AWS SES

Navega a Configuración → Configuración de AWS e ingresa tus credenciales:

AWS_ACCESS_KEY_ID=AKIA...
AWS_SECRET_ACCESS_KEY=wJal...
AWS_REGION=us-east-1

Tus credenciales están encriptadas y almacenadas de forma segura. Nunca tenemos acceso a otros servicios de AWS.

Paso 3: Configurar Webhooks

MailPulse configura automáticamente los webhooks de SES cuando te conectas. Esto permite el monitoreo en tiempo real de rebotes y quejas.

Paso 4: Configurar Alertas

Ve a Configuración → Alertas y configura tus umbrales:

  • Tasa de Rebote: 5% por defecto (recomendado: 2-5%)
  • Tasa de Queja: 0.1% por defecto (umbral de AWS)
  • Caída Repentina: 20% por defecto vs promedio

Paso 5: Comenzar a Monitorear

Tu panel de control ya está activo. Los datos empezarán a aparecer en minutos después de tu primer envío.

Configuración de AWS SES

MailPulse requiere una cuenta de AWS con SES habilitado. Aquí se explica cómo preparar tu entorno.

Crear Usuario IAM

Crea un usuario IAM dedicado para MailPulse con permisos mínimos:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "ses:SendEmail",
        "ses:SendRawEmail",
        "ses:GetSendQuota",
        "ses:GetSendStatistics",
        "ses:ListIdentities",
        "ses:GetIdentityVerificationAttributes"
      ],
      "Resource": "*"
    }
  ]
}

Verificar tu Dominio

En la consola de AWS SES:

  1. Ve a Identidades verificadas
  2. Haz clic en Crear identidad
  3. Selecciona Dominio e ingresa tu dominio
  4. Agrega los registros DNS requeridos (DKIM, SPF)
  5. Espera la verificación (generalmente 5-10 minutos)

Solicitar Acceso a Producción

Las cuentas nuevas de AWS SES comienzan en modo sandbox. Para enviar a cualquier dirección:

  1. Ve al Panel de control de la cuenta
  2. Haz clic en Solicitar acceso a producción
  3. Completa el formulario con tu caso de uso
  4. Espera la aprobación (generalmente 24-48 horas)
⚠️ Importante:

En modo sandbox, solo puedes enviar a direcciones de email verificadas. Se requiere acceso a producción para envíos reales.

Monitoreo

MailPulse rastrea el rendimiento de tus emails en tiempo real a través de webhooks de SES.

Métricas Rastreadas

  • Tasa de Entrega: Porcentaje de emails entregados exitosamente
  • Tasa de Rebote: Rebotes duros y blandos combinados
  • Tasa de Queja: Quejas de spam por cada 1000 emails
  • Tasa de Apertura: Si el rastreo está habilitado en SES
  • Puntuación de Reputación: Puntuación de 0-100 basada en todas las métricas

Cálculo de Puntuación de Reputación

Tu puntuación de reputación (0-100) se calcula de la siguiente manera:

  • 90-100: Excelente — tu reputación como remitente es sólida
  • 70-89: Buena — problemas menores por resolver
  • 50-69: Necesita atención — se requiere acción
  • Menos de 50: Crítico — se necesita acción inmediata

Retención de Datos

MailPulse retiene tus datos según tu plan:

  • Gratis: 7 días
  • Starter: 90 días
  • Pro: 1 año

Alertas

Recibe notificaciones cuando algo salga mal con la entrega de tus emails.

Tipos de Alertas

  • Tasa de Rebote Excedida: Cuando la tasa de rebote supera tu umbral
  • Tasa de Queja Excedida: Cuando la tasa de queja supera tu umbral
  • Caída Repentina: Cuando la entrega cae significativamente vs promedio
  • Remitente Bloqueado: Cuando una IP o dominio de remitente es bloqueado

Canales de Notificación

  • Email: Notificaciones SMTP a cualquier dirección
  • Slack: Notificaciones webhook a tu canal
  • Dentro de la App: Alertas en tiempo real en el panel

Configurar Slack

Para recibir notificaciones de Slack:

  1. Crea un Webhook Entrante en tu espacio de trabajo de Slack
  2. Copia la URL del webhook
  3. Pégala en Configuración → Notificaciones → URL de Webhook de Slack

Reportes

Genera reportes profesionales de entregabilidad para tu equipo o clientes.

Tipos de Reportes

  • Resumen General: Todos los dominios combinados
  • Por Dominio: Desglose detallado por dominio de envío
  • Tendencias: Análisis de tendencias de 7d, 30d, 90d

Formatos de Exportación

  • PDF: Reportes atractivos con gráficos y tablas
  • CSV: Datos sin procesar para análisis en Excel/Sheets

Reportes de Marca Blanca (Pro)

Los usuarios Pro pueden personalizar reportes con su propia marca:

  • Logo personalizado
  • Colores personalizados
  • Texto de pie de página personalizado

Verificación de Email

Valida direcciones de email antes de enviar para mejorar la entregabilidad.

Qué Verificamos

  • Formato: Cumplimiento de RFC 5322
  • DNS: Existencia de registros MX
  • Desechables: Más de 100 dominios de email desechables conocidos
  • Proveedores Gratuitos: Gmail, Yahoo, Outlook, etc.

Verificación Masiva

Los usuarios Pro pueden verificar hasta 1,000 emails a la vez a través de la API o el panel.

POST /api/verification/verify-bulk
Content-Type: application/json

{
  "emails": [
    "[email protected]",
    "[email protected]",
    "[email protected]"
  ]
}

Respuesta de la API

{
  "results": [
    {
      "email": "[email protected]",
      "valid": true,
      "format_ok": true,
      "dns_ok": true,
      "mx_found": true,
      "disposable": false,
      "free_provider": false,
      "confidence": 0.95
    }
  ]
}

Pruebas A/B

Compara asuntos y descubre qué resuena con tu audiencia.

Cómo Funciona

  1. Crea una prueba con dos variantes (A y B)
  2. Establece el tamaño de muestra para cada variante
  3. Inicia la prueba — MailPulse divide tu audiencia
  4. Rastrea aperturas y clics para cada variante
  5. La prueba Z estadística calcula el nivel de confianza

Confianza Estadística

MailPulse utiliza una prueba Z para determinar significancia estadística:

  • 90% de confianza: Probable ganador
  • 95% de confianza: Ganador confiable
  • 99% de confianza: Ganador definitivo

Mapa de Calor de Engagement

Descubre los mejores días y horas para enviar tus emails.

Cómo Funciona

MailPulse analiza tus datos históricos de engagement para crear un mapa visual que muestra cuándo está más activa tu audiencia.

Recomendaciones de Envío

Basado en los datos de tu mapa de calor, MailPulse proporciona recomendaciones impulsadas por IA para los horarios de envío óptimos.

Envío Directo con SES

Envía emails directamente desde MailPulse usando tu configuración SES.

Configuración

  1. Ve a Configuración → Configuración de SES
  2. Ingresa tus credenciales de AWS (igual que para monitoreo)
  3. Selecciona tu identidad de remitente verificada
  4. Comienza a enviar

Uso de la API

POST /api/ses/send
Content-Type: application/json

{
  "from": "[email protected]",
  "to": ["[email protected]"],
  "subject": "Hola desde MailPulse",
  "html": "<h1>¡Funciona!</h1>",
  "text": "¡Funciona!"
}

Gestión de Cuota

Consulta tu cuota de envío SES:

GET /api/ses/quota

{
  "max24Hour": 200,
  "maxSendRate": 1,
  "sentLast24Hours": 42
}

Resumen de la API

MailPulse proporciona una API RESTful para todas las funciones.

URL Base

https://api.getmailpulse.net

Formato de Respuesta

Todas las respuestas son JSON con estructura consistente:

{
  "success": true,
  "data": { ... },
  "message": "Mensaje opcional"
}

Formato de Error

{
  "success": false,
  "error": "Descripción del error",
  "code": "ERROR_CODE"
}

Autenticación

Todas las solicitudes de API requieren un token JWT en el encabezado Authorization.

Iniciar Sesión

POST /api/auth/login
Content-Type: application/json

{
  "email": "[email protected]",
  "password": "your-password"
}

Response:
{
  "access_token": "eyJ...",
  "token_type": "bearer"
}

Usar el Token

Authorization: Bearer eyJ...

Endpoints de la API

Autenticación

  • POST /api/auth/login — Iniciar sesión y obtener token
  • POST /api/auth/register — Crear cuenta

Emails

  • GET /api/emails — Listar todos los emails
  • GET /api/emails/:id — Obtener detalles del email

Alertas

  • GET /api/alerts — Listar alertas
  • GET /api/alerts/config — Obtener configuración de alertas
  • PUT /api/alerts/config — Actualizar configuración de alertas
  • PUT /api/alerts/:id/read — Marcar como leída
  • PUT /api/alerts/:id/resolve — Resolver alerta

Reportes

  • GET /api/reports — Reporte general
  • GET /api/reports/domain/:domain — Reporte por dominio
  • GET /api/reports/trends — Análisis de tendencias
  • GET /api/reports/export/csv — Exportar CSV
  • GET /api/reports/export/pdf — Exportar PDF

Verificación

  • POST /api/verification/verify — Verificar un email
  • POST /api/verification/verify-bulk — Verificar múltiples
  • POST /api/verification/disposable/check — Verificar desechables

Pruebas A/B

  • GET /api/ab-tests — Listar pruebas
  • POST /api/ab-tests — Crear prueba
  • POST /api/ab-tests/:id/start — Iniciar prueba
  • POST /api/ab-tests/:id/complete — Completar prueba

Mapa de Calor

  • GET /api/heatmap — Obtener datos del mapa de calor
  • GET /api/heatmap/recommendations — Mejores horarios de envío

SES

  • POST /api/ses/configure — Configurar SES
  • POST /api/ses/send — Enviar email
  • GET /api/ses/quota — Obtener cuota

Solución de Problemas

Webhook No Recibe Datos

  • Verifica que tus credenciales de AWS sean correctas
  • Comprueba que el topic de SNS esté suscrito y confirmado
  • Asegúrate de que el endpoint del webhook sea accesible desde Internet
  • Revisa los logs del webhook en Configuración → Webhooks

Puntuación de Reputación Baja

  • Revisa tu lista de emails — elimina direcciones inválidas
  • Comprueba si usas listas compradas o alquiladas (no las uses)
  • Implementa doble opt-in para nuevos suscriptores
  • Monitorea la tasa de quejas y elimina los quejicosos
  • Consulta listas negras en mxtoolbox.com

Alertas No Se Activan

  • Verifica que los umbrales de alerta estén configurados correctamente
  • Comprueba que el canal de notificación esté configurado (email/Slack)
  • Asegúrate de que el cron de evaluación esté ejecutándose
  • Revisa la tabla de alertas para alertas existentes

Preguntas Frecuentes

¿Es seguro MailPulse?

Sí. Las credenciales de AWS están encriptadas en reposo. Todas las llamadas a la API usan HTTPS. Seguimos las mejores prácticas de seguridad incluyendo headers CSP, protección XSS y limitación de tasa.

¿Puedo usar MailPulse con múltiples cuentas de AWS?

Sí. MailPulse soporta arquitectura multi-tenant. Puedes configurar diferentes credenciales de AWS por tenant.

¿Soportan SES v2?

Actualmente, MailPulse usa la API de SES v1. El soporte para SES v2 está en nuestra hoja de ruta.

¿Cuál es la diferencia entre planes gratis y de pago?

El plan gratis incluye 100 emails/mes y 1 dominio. Los planes de pago aumentan los límites y agregan funciones como pruebas A/B, mapa de calor, acceso a API y reportes de marca blanca.

¿Cómo cancelo mi suscripción?

Ve a Configuración → Facturación y haz clic en Cancelar Suscripción. Tu cuenta pasará a nivel Free al final del período de facturación.

¿Listo para empezar?

Crea tu cuenta gratuita y comienza a monitorear en 5 minutos.

Empezar gratis →