Suivi · Email API

Suivez vos e-mails API

Ajoutez quelques champs à l'envoi que vous faites déjà. Vous obtenez les ouvertures, les clics, un désabonnement en un clic et chaque destinataire enregistré comme contact — rien à créer au préalable.

POST mail.sendcorex.com/v3.0/send

Les champs

Tous facultatifs. Ajoutez-les à côté de to, from, subject et body — utilisez uniquement ceux dont vous avez besoin.

trackstring

Le nom sous lequel ces e-mails sont regroupés dans Analytics.

  • Créé au premier envoi — rien à configurer avant.
  • Même nom, même track : la casse et les espaces en trop ne comptent pas ("Welcome Email" = "welcome email").
  • Jusqu'à 100 caractères. Utilisez-en un par type d'e-mail, comme "Welcome" ou "Invoice".
"track": "Weekly Newsletter"
track_opensboolean

Compte qui a ouvert l'e-mail.

  • Ajoute un pixel invisible au HTML.
  • Les ouvertures automatiques (confidentialité d'Apple Mail, scanners de sécurité) sont comptées à part — elles ne gonflent jamais votre taux d'ouverture.
  • Sans track, l'ouverture est quand même enregistrée sur le contact, simplement pas regroupée dans Analytics.
"track_opens": true
track_clicksboolean

Compte qui a cliqué sur chaque lien.

  • Les liens du corps passent par Sendcorex et redirigent instantanément vers votre page.
  • Vous voyez les liens les plus cliqués et quels contacts ont cliqué dessus.
"track_clicks": true
unsubscribeboolean

Utilisez le lien de désabonnement Sendcorex.

  • Placez [unsubscribe] dans le corps (ou [unsubscribe_url], [unsub_url], [opt_out_url]). Chaque destinataire reçoit un lien personnel.
  • Ajoute aussi les en-têtes List-Unsubscribe et one-click exigés par Gmail et Yahoo. Un List-Unsubscribe que vous envoyez vous-même est ignoré.
  • Toute personne qui se désabonne ne reçoit plus d'e-mails de l'ensemble de votre compte : campagnes, API et SMTP.
  • true sans le placeholder renvoie MISSING_UNSUBSCRIBE_PLACEHOLDER et rien n'est envoyé.
"unsubscribe": true
contact_liststring

La liste de contacts où les destinataires sont enregistrés.

  • Créée si elle n'existe pas encore. Sans elle, les destinataires vont dans "API Contacts".
  • Les destinataires ne sont enregistrés que si vous utilisez track, track_opens, track_clicks, unsubscribe ou contact_list. Un envoi simple n'enregistre rien.
  • Une personne déjà dans vos contacts est mise à jour, jamais dupliquée.
"contact_list": "Newsletter"

Exemple

Une newsletter avec tout activé.

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"
}'

Où voir les résultats

Rien à configurer. Le premier e-mail avec un track apparaît déjà dans votre dashboard.

Analytics

Combien ont ouvert et cliqué

Chaque track est une ligne du tableau Sends, à côté de vos campagnes. Ouvrez-le pour le rapport complet : activité par heure, meilleur moment d'envoi, fournisseurs, appareils, pays et liens les plus cliqués.

Ouvrir Analytics

Contacts

Chaque destinataire, enregistré

Les destinataires sont enregistrés dans la liste de contacts de votre choix (ou "API Contacts"). Chaque contact garde son historique : reçu, ouvert, cliqué, rebondi, désinscrit.

Ouvrir Contacts

Personnes

Qui a ouvert, qui a cliqué

Dans Analytics, ouvrez votre track et cliquez sur "Who opened", "Who clicked" ou "Unsubscribed". Vos contacts s’ouvrent déjà filtrés — exportez-les, ajoutez des tags ou mettez-les dans une liste.

Voir qui a ouvert

Réponse

La réponse habituelle de l'envoi, plus ce qu'a fait le suivi.

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

Le nom du track utilisé, après suppression des espaces. Absent lorsque l'e-mail n'a pas de track.

track_id

ID stable du track : le même nom donne toujours le même ID.

contact_list

La liste dans laquelle les destinataires ont été enregistrés. Absent lorsque rien n'est enregistré.

warnings

Ce que nous avons ajusté sans faire échouer l'envoi : ancien [[Name]] détecté, limite de tracks atteinte.

CodeHTTPQuand
MISSING_UNSUBSCRIBE_PLACEHOLDER400unsubscribe vaut true mais le corps ne contient pas [unsubscribe]. Rien n'est envoyé.
UNSUBSCRIBE_UNAVAILABLE503Le désabonnement est temporairement indisponible. Rien n'est envoyé — réessayez dans un instant.

Bon à savoir

N'importe quelle graphie fonctionne

sender_name, senderName et SENDER-NAME sont le même champ : la casse, _ et - ne comptent pas. Les champs oui/non acceptent true, 1 ou "true".

500 tracks par compte

Au-delà de la limite, l'e-mail part quand même, simplement sans track, et la réponse le signale dans warnings.

Plusieurs destinataires

Avec jusqu’à 50 adresses dans to, chacune a son propre suivi et son propre lien de désabonnement.

E-mails programmés

scheduled_at fonctionne avec tous les champs de cette page — le suivi commence quand l'e-mail part.

Ancien

L'ancienne balise [[Name]]

Les e-mails qui contiennent encore la balise continuent de fonctionner. Les nouvelles intégrations doivent utiliser les champs ci-dessus.

N'importe où dans le body
<p>Welcome aboard!</p>
<p>[[CRM Welcome List]]</p>

Ce qu’elle fait

La balise est retirée de l'e-mail. "CRM Welcome List" devient le track et la liste de contacts, avec ouvertures et clics activés et désinscription désactivée.

Combiner les deux

Si vous envoyez aussi les nouveaux champs, ils l'emportent : la balise ne complète que ce que vous avez omis.

Obsolète

Les comptes qui utilisent encore la balise reçoivent un e-mail, au plus une fois par semaine, leur demandant de migrer. Elle fonctionne jusque-là.

Anciens codes de référence

Un code comme [[7CK-JDL-Y1L]] est désormais lu comme un track portant ce nom. Les anciens endpoints de suivi ont été supprimés — tout se trouve dans Analytics.