Permiso requerido: subscribers
Tipos de rebote
| Type | Description | Action |
|---|---|---|
hard |
Fallo de entrega permanente (correo inexistente) | Baja inmediata de suscripción |
soft |
Fallo de entrega temporal (buzón lleno, etc.) | Baja después de 3 repeticiones |
complaint |
Reporte de spam | Cancelación inmediata |
GET
/api/v1/bounces
Obtiene la lista de rebotes.
Query Parameters
| Parameter | Type | Description |
|---|---|---|
limit |
integer | Número de resultados (predeterminado: 20, máximo: 100) |
offset |
integer | Offset de paginación |
Response
{
"success": true,
"data": {
"bounces": [
{
"id": 1,
"email": "invalid@example.com",
"bounce_type": "hard",
"bounce_subtype": "NoEmail",
"source": "ses",
"campaign_name": "January Newsletter",
"subscriber_name": "John Doe",
"created_at": "2026-01-10T12:00:00Z"
}
],
"total": 50,
"limit": 20,
"offset": 0
}
}
POST
/api/v1/bounces
Registra manualmente un rebote.
Request Body
{
"email": "invalid@example.com",
"bounce_type": "hard", // hard, soft, complaint
"bounce_subtype": "NoEmail", // optional
"diagnostic_code": "550 5.1.1..." // optional
}Response
{
"success": true,
"data": {
"bounce_id": 123
}
}Webhooks de proveedores de correo
Puede recibir automáticamente notificaciones de rebote de proveedores de correo como AWS SES, Mailgun, SendGrid, etc.
URLs de webhook
| Provider | Webhook URL |
|---|---|
| AWS SES (SNS) | https://dev.mailpass.im/api/v1/webhooks/ses |
| Mailgun | https://dev.mailpass.im/api/v1/webhooks/mailgun |
| SendGrid | https://dev.mailpass.im/api/v1/webhooks/sendgrid |
Configuración de AWS SES
- Cree un nuevo Topic en AWS SNS.
- Agregue una suscripción HTTPS al Topic:
https://dev.mailpass.im/api/v1/webhooks/ses - Cree un Configuration Set en AWS SES.
- Agregue un Event Destination al Configuration Set y seleccione el SNS Topic.
- Seleccione los eventos de Bounce y Complaint.
Política de procesamiento de rebotes
- • Cuando ocurre un Hard Bounce, el suscriptor se cambia inmediatamente al estado 'bounced'.
- • Cuando ocurren 3 Soft Bounces consecutivos, se trata como Hard Bounce.
- • Cuando se reporta como spam, el suscriptor se cambia al estado 'unsubscribed'.
- • No se enviarán correos a direcciones que han rebotado.
Mejores prácticas
- • Mantenga la tasa de rebote por debajo del 5%. Una alta tasa de rebote afecta negativamente la reputación del remitente.
- • Revise periódicamente la lista de rebotes y limpie los correos no válidos.
- • Use Double Opt-in para recopilar solo correos válidos.
- • Considere la validación en tiempo real al recopilar direcciones de correo.