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.

trackstring

El 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_opensboolean

Cuenta 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_clicksboolean

Cuenta 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
unsubscribeboolean

Usa 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_liststring

La 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 Analytics

Contactos

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 Contactos

Personas

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.

200 OK
{
  "success": true,
  "code": "EMAIL_QUEUED_SUCCESS",
  "id": "3f2a1b4c-8e9d-4f7a-b2c3-1a2b3c4d5e6f",
  "recipients": 1,
  "track": "Weekly Newsletter",
  "track_id": "6ad757c8aaf59feb",
  "contact_list": "Newsletter"
}
track

El nombre del track usado, sin los espacios de los extremos. Ausente cuando el email no tiene track.

track_id

ID estable del track: el mismo nombre siempre da el mismo ID.

contact_list

La lista en la que se guardaron los destinatarios. Ausente cuando no se guarda nada.

warnings

Lo que ajustamos sin hacer fallar el envío: [[Name]] heredado encontrado, límite de tracks alcanzado.

CódigoHTTPCuándo
MISSING_UNSUBSCRIBE_PLACEHOLDER400unsubscribe es true pero el cuerpo no tiene [unsubscribe]. No se envía nada.
UNSUBSCRIBE_UNAVAILABLE503La 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.

En cualquier parte del body
<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.