Tracking · Email API
Rastrea tus emails de la API
Añade unos pocos campos al envío que ya haces. Obtienes aperturas, clics, baja con un clic y cada destinatario guardado como contacto — sin crear nada antes.
POST mail.sendcorex.com/v3.0/send
Los campos
Todos opcionales. Añádelos junto a to, from, subject y body — usa solo los que necesites.
trackstringEl nombre con el que se agrupan estos emails en Analytics.
- Se crea en el primer envío — nada que configurar antes.
- Mismo nombre, mismo track: las mayúsculas y los espacios de más no importan ("Welcome Email" = "welcome email").
- Hasta 100 caracteres. Usa uno por tipo de email, como "Welcome" o "Invoice".
"track": "Weekly Newsletter"
track_opensbooleanCuenta quién abrió el email.
- Añade un píxel invisible al HTML.
- Las aperturas automáticas (privacidad de Apple Mail, escáneres de seguridad) se cuentan aparte — nunca inflan tu tasa de apertura.
- Sin track, la apertura igual se guarda en el contacto, solo que no se agrupa en Analytics.
"track_opens": true
track_clicksbooleanCuenta quién hizo clic en cada enlace.
- Los enlaces del cuerpo pasan por Sendcorex y redirigen al instante a tu página.
- Ves los enlaces más clicados y qué contactos hicieron clic.
"track_clicks": true
unsubscribebooleanUsa el enlace de baja de Sendcorex.
- Pon [unsubscribe] en el cuerpo (o [unsubscribe_url], [unsub_url], [opt_out_url]). Cada destinatario recibe un enlace personal.
- También añade los headers List-Unsubscribe y one-click que piden Gmail y Yahoo. Un List-Unsubscribe que envíes tú se ignora.
- Quien se da de baja deja de recibir emails de toda tu cuenta: campañas, API y SMTP.
- true sin el placeholder devuelve MISSING_UNSUBSCRIBE_PLACEHOLDER y no se envía nada.
"unsubscribe": true
contact_liststringLa lista de contactos donde se guardan los destinatarios.
- Se crea si todavía no existe. Sin ella, los destinatarios van a "API Contacts".
- Los destinatarios solo se guardan cuando usas track, track_opens, track_clicks, unsubscribe o contact_list. Un envío simple no guarda nada.
- Quien ya está en tus contactos se actualiza, nunca se duplica.
"contact_list": "Newsletter"
Ejemplo
Una newsletter con todo activado.
curl -X POST https://mail.sendcorex.com/v3.0/send \
-H "Authorization: Bearer $SENDCOREX_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"to": "subscriber@example.com",
"from": "news@yourdomain.com",
"sender_name": "The Weekly",
"subject": "Issue #42",
"body": "<p>This week in tech...</p><a href=\"[unsubscribe]\">Unsubscribe</a>",
"track": "Weekly Newsletter",
"track_opens": true,
"track_clicks": true,
"unsubscribe": true,
"contact_list": "Newsletter"
}'Dónde ves los resultados
Nada que configurar. El primer email con un track ya aparece en tu dashboard.
Analytics
Cuántos abrieron e hicieron clic
Cada track es una fila en la tabla Sends, junto a tus campañas. Ábrelo para ver el informe completo: actividad por hora, mejor hora de envío, proveedores, dispositivos, países y enlaces más clicados.
Abrir AnalyticsContactos
Cada destinatario, guardado
Los destinatarios se guardan en la lista de contactos que elijas (o "API Contacts"). Cada contacto conserva su historial: recibido, abierto, clic, rebotado, dado de baja.
Abrir ContactosPersonas
Quién abrió, quién hizo clic
En Analytics, abre tu track y pulsa "Who opened", "Who clicked" o "Unsubscribed". Tus contactos se abren ya filtrados — expórtalos, etiquétalos o añádelos a una lista.
Ver quién abrióRespuesta
La respuesta habitual del envío, más lo que hizo el tracking.
{
"success": true,
"code": "EMAIL_QUEUED_SUCCESS",
"id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
"recipients": 1,
"track": "Weekly Newsletter",
"track_id": "6ad757c8aaf59feb",
"contact_list": "Newsletter"
}trackEl nombre del track usado, sin los espacios de los extremos. Ausente cuando el email no tiene track.
track_idID estable del track: el mismo nombre siempre da el mismo ID.
contact_listLa lista en la que se guardaron los destinatarios. Ausente cuando no se guarda nada.
warningsLo que ajustamos sin hacer fallar el envío: [[Name]] heredado encontrado, límite de tracks alcanzado.
| Código | HTTP | Cuándo |
|---|---|---|
MISSING_UNSUBSCRIBE_PLACEHOLDER | 400 | unsubscribe es true pero el cuerpo no tiene [unsubscribe]. No se envía nada. |
UNSUBSCRIBE_UNAVAILABLE | 503 | La baja no está disponible temporalmente. No se envía nada — vuelve a intentarlo en un momento. |
Conviene saber
Cualquier escritura funciona
sender_name, senderName y SENDER-NAME son el mismo campo: las mayúsculas, _ y - no importan. Los campos sí/no aceptan true, 1 o "true".
500 tracks por cuenta
Superado el límite, el email sale igual, solo que sin track, y la respuesta lo indica en warnings.
Varios destinatarios
Con hasta 50 direcciones en to, cada una tiene su propio tracking y su propio enlace de baja.
Emails programados
scheduled_at funciona con todos los campos de esta página — el tracking empieza cuando sale el email.
Heredado
La antigua etiqueta [[Name]]
Los emails que todavía llevan la etiqueta siguen funcionando. Las integraciones nuevas deben usar los campos de arriba.
<p>Welcome aboard!</p>
<p>[[CRM Welcome List]]</p>Qué hace
La etiqueta se quita del email. "CRM Welcome List" pasa a ser el track y la lista de contactos, con aperturas y clics activados y la baja desactivada.
Usar ambos
Si también envías los nuevos campos, ellos ganan: la etiqueta solo completa lo que dejaste fuera.
Obsoleta
Las cuentas que aún usan la etiqueta reciben un email, como máximo una vez por semana, pidiendo el cambio. Sigue funcionando hasta entonces.
Códigos de referencia antiguos
Un código como [[7CK-JDL-Y1L]] ahora se lee como un track con ese nombre. Los endpoints antiguos de seguimiento se eliminaron — todo está en Analytics.