Resumen de entregabilidad

Supervise la reputación del remitente, las tasas de entrega y el estado de DNS en todos sus dominios

MailLand realiza un seguimiento de la reputación del remitente mediante una puntuación compuesta, tendencias de entrega, análisis por proveedor y monitoreo del estado de DNS. Utilice la API de entregabilidad para mostrar estas métricas en sus propios paneles de control o para activar alertas cuando la reputación disminuya.

Puntuación del remitente

Obtenga una puntuación de reputación de 0 a 100 dividida en cuatro componentes ponderados:

GET https://api.mail.land/v1/deliverability/score

Autentíquese con Authorization: Bearer <token> o X-API-Key: <api key>.

Get sender score

curl https://api.mail.land/v1/deliverability/score \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Sender score response

{
  "totalScore": 87,
  "label": "Good",
  "hasSufficientData": true,
  "totalSentLast30Days": 142500,
  "dnsScore": {
    "name": "DNS Authentication",
    "score": 25,
    "maxScore": 25,
    "detail": "2/2 domains fully authenticated"
  },
  "bounceScore": {
    "name": "Bounce Rate",
    "score": 20,
    "maxScore": 25,
    "detail": "Bounce rate: 1.80%"
  },
  "complaintScore": {
    "name": "Complaint Rate",
    "score": 25,
    "maxScore": 25,
    "detail": "Complaint rate: 0.020%"
  },
  "engagementScore": {
    "name": "Engagement",
    "score": 25,
    "maxScore": 25,
    "detail": "Open rate: 32.0%"
  },
  "calculatedAt": "2026-02-17T12:00:00Z"
}

Cada componente contribuye hasta 25 puntos. Con menos de 100 envíos en los últimos 30 días, hasSufficientData es false. Aun así totalScore se sigue calculando, pero no es significativo a ese volumen: sin ningún envío, los componentes de rebote y quejas obtienen cada uno la puntuación máxima (25), por lo que una cuenta completamente nueva puede mostrar hasta 75 puntos antes de haber enviado nada.

Historial de puntuación

Realice un seguimiento de la evolución de su puntuación a lo largo del tiempo:

GET https://api.mail.land/v1/deliverability/score/history?days=30

Get score history

curl "https://api.mail.land/v1/deliverability/score/history?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Parámetro	Tipo	Predeterminado	Descripción
`days`	int	30	Ventana de historial (7–90)

Score history response

[
  {
    "date": "2026-02-17",
    "totalScore": 87,
    "label": "Good",
    "dnsScore": 25,
    "bounceScore": 22,
    "complaintScore": 25,
    "engagementScore": 15,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 32.0,
    "deliveryRate": 98.5,
    "totalSent": 4750,
    "hasSufficientData": true
  }
]

Estadísticas generales de entregabilidad

Obtenga métricas de entrega agregadas para un período:

GET https://api.mail.land/v1/deliverability/overview?days=30

Get deliverability overview

curl "https://api.mail.land/v1/deliverability/overview?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Parámetro	Tipo	Predeterminado	Descripción
`days`	int	30	Ventana de período (se normaliza a 7, 30 o 90)

Overview response

{
  "totalSent": 142500,
  "totalDelivered": 140325,
  "totalBounced": 1125,
  "totalComplained": 28,
  "totalOpened": 44878,
  "totalClicked": 5843,
  "totalUnsubscribed": 312,
  "deliveryRate": 98.47,
  "bounceRate": 0.79,
  "complaintRate": 0.02,
  "openRate": 31.49,
  "clickRate": 4.1,
  "unsubscribeRate": 0.22
}

Tendencias diarias

Obtenga métricas de entrega por día para visualizar tendencias:

GET https://api.mail.land/v1/deliverability/trends?days=30

Get daily trends

curl "https://api.mail.land/v1/deliverability/trends?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Trends response (abbreviated)

[
  {
    "date": "2026-02-17T00:00:00Z",
    "sent": 4750,
    "delivered": 4680,
    "bounced": 38,
    "complained": 1,
    "opened": 1498,
    "deliveryRate": 98.53,
    "bounceRate": 0.8,
    "complaintRate": 0.02,
    "openRate": 31.53
  }
]

Desglose por proveedor

Consulte las métricas de entregabilidad agrupadas por proveedor de buzón del destinatario (Gmail, Yahoo, Outlook, etc.):

GET https://api.mail.land/v1/deliverability/providers?days=30&limit=10

Get provider breakdown

curl "https://api.mail.land/v1/deliverability/providers?days=30&limit=10" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Parámetro	Tipo	Predeterminado	Descripción
`days`	int	30	Ventana de período (se normaliza a 7, 30 o 90)
`limit`	int	10	Máximo de proveedores a devolver (1–50)

Provider breakdown response

[
  {
    "domain": "gmail.com",
    "sent": 58200,
    "delivered": 57800,
    "bounced": 210,
    "opened": 19500,
    "clicked": 2540,
    "complained": 8,
    "deliveryRate": 99.31,
    "openRate": 33.51,
    "bounceRate": 0.36
  },
  {
    "domain": "outlook.com",
    "sent": 31400,
    "delivered": 30800,
    "bounced": 350,
    "opened": 8650,
    "clicked": 1120,
    "complained": 12,
    "deliveryRate": 98.09,
    "openRate": 27.55,
    "bounceRate": 1.11
  }
]

Desglose de rebotes

Consulte los rebotes clasificados por tipo y motivo:

GET https://api.mail.land/v1/deliverability/bounce-breakdown?days=30

Get bounce breakdown

curl "https://api.mail.land/v1/deliverability/bounce-breakdown?days=30" \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Bounce breakdown response

{
  "hardBounces": 450,
  "softBounces": 625,
  "blockedBounces": 40,
  "unknownBounces": 10,
  "totalBounces": 1125,
  "topReasons": [
    { "reason": "InvalidRecipient", "count": 380 },
    { "reason": "QuotaIssues", "count": 290 },
    { "reason": "SpamBlock", "count": 40 },
    { "reason": "BadDomain", "count": 70 },
    { "reason": "PolicyRelated", "count": 95 },
    { "reason": "TransientFailure", "count": 55 }
  ]
}

topReasons usa los nombres de clasificación propios del MTA (consulte Rebotes para el vocabulario completo), no las categorías snake_case derivadas de palabras clave que usan los endpoints de rebote transaccionales.

Consulte Rebotes para obtener detalles completos sobre las categorías de rebotes y el comportamiento de manejo.

Estado de DNS

Verifique el estado de autenticación DNS en todos sus dominios:

GET https://api.mail.land/v1/deliverability/dns-status

Get DNS status

curl https://api.mail.land/v1/deliverability/dns-status \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

DNS status response

[
  {
    "domainId": "k3v9x2m8q1w7z4",
    "domainName": "yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Valid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": true
  },
  {
    "domainId": "n7p2q9x4m8w1z3",
    "domainName": "notifications.yourdomain.com",
    "spfStatus": "Valid",
    "dkimStatus": "Valid",
    "dmarcStatus": "Invalid",
    "lastCheckedAt": "2026-02-17T10:00:00Z",
    "isFullyAuthenticated": false
  }
]

Un dominio es isFullyAuthenticated únicamente cuando SPF, DKIM y DMARC son todos Valid.

Estado	Descripción
`Pending`	Registro aún no verificado
`Valid`	Registro correctamente configurado
`Invalid`	Registro faltante o mal configurado

Recomendaciones

Obtenga recomendaciones prácticas para mejorar la reputación de su remitente:

GET https://api.mail.land/v1/deliverability/recommendations

Get recommendations

curl https://api.mail.land/v1/deliverability/recommendations \
  -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIs..."

Recommendations response

[
  {
    "id": "dns_dmarc_missing_notifications.yourdomain.com",
    "category": "dns",
    "severity": "critical",
    "titleKey": "deliverability.recommendations.dns.dmarcMissing.title",
    "descriptionKey": "deliverability.recommendations.dns.dmarcMissing.description",
    "actionUrl": "/domains",
    "impact": 8,
    "parameters": {
      "domain": "notifications.yourdomain.com"
    }
  },
  {
    "id": "bounce_high",
    "category": "bounce",
    "severity": "warning",
    "titleKey": "deliverability.recommendations.bounce.high.title",
    "descriptionKey": "deliverability.recommendations.bounce.high.description",
    "actionUrl": "/deliverability",
    "impact": 15
  }
]

Campo	Tipo	Descripción
`id`	string	Identificador de la recomendación. No es un enum estable: los ids de DNS incluyen el nombre del dominio (por ejemplo, `dns_dmarc_missing_{domain}`), así que el mismo problema en dos dominios produce dos ids distintos.
`category`	string	`dns`, `bounce`, `complaint`, `engagement`, `warmup` o `volume`
`severity`	string	`critical`, `warning` o `info`
`impact`	int	Mejora potencial de la puntuación (0–100) si se resuelve
`actionUrl`	string	Ruta del front-end para abordar el problema: una de `/domains`, `/deliverability`, `/suppression-lists`, `/analytics` o `/dashboard`
`parameters`	object	Valores para interpolación i18n. Solo presente en recomendaciones de DNS (`{"domain": "..."}`); las recomendaciones de rebote, quejas, interacción, calentamiento y volumen no tienen `parameters`.

Se devuelven como máximo 10 recomendaciones, ordenadas por severidad (críticas primero) y luego por impacto descendente.

Caché

Todos los puntos de conexión de entregabilidad se almacenan en caché en el lado del servidor para reducir la carga de consultas en ClickHouse:

Punto de conexión	TTL de caché
`/score`	15 minutos
`/overview`	5 minutos
`/trends`	3 minutos
`/providers`	5 minutos
`/bounce-breakdown`	5 minutos
`/score/history`	Sin caché
`/dns-status`	Sin caché (tiempo real)
`/recommendations`	10 minutos

El parámetro days se normaliza a 7, 30 o 90: los valores ≤ 7 se redondean a 7, los de 8 a 30 se redondean a 30, y cualquier valor superior a 30 se redondea a 90. Un valor como 14 se redondea a 30, no a 7.

Pasos siguientes

Rebotes: comprenda los tipos de rebotes y el manejo automático
Supresiones: gestione las listas de supresión
Calentamiento de IP: caliente los nuevos dominios de envío
Configuración de DNS: configure SPF, DKIM y DMARC

Resumen de entregabilidad

Puntuación del remitenteCopiar enlace de la sección

Historial de puntuaciónCopiar enlace de la sección

Estadísticas generales de entregabilidadCopiar enlace de la sección

Tendencias diariasCopiar enlace de la sección

Desglose por proveedorCopiar enlace de la sección

Desglose de rebotesCopiar enlace de la sección

Estado de DNSCopiar enlace de la sección

RecomendacionesCopiar enlace de la sección

CachéCopiar enlace de la sección

Pasos siguientesCopiar enlace de la sección

En esta página