Recevoir des e-mails : Programmation

Programmer un envoi

Rédigez l'e-mail maintenant et envoyez-le plus tard. Il attend dans le dossier Scheduled jusqu'à l'heure choisie.

POSThttps://g.sendcorex.com/v1command: schedule_send
i

Tout ce qui peut être vérifié l'est maintenant (destinataire, objet, e-mail d'origine, pièces jointes), pour que vous soyez prévenu avant l'heure. Les crédits et la limite quotidienne sont vérifiés à l'envoi.

i

Si l'envoi est refusé à ce moment-là (pas de crédits, limite quotidienne, spam), rien n'est perdu : l'e-mail retourne dans les Brouillons avec la raison.

i

Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis, même avec true.

i

Les e-mails envoyés depuis la boîte ne contiennent ni en-tête List-Unsubscribe ni lien de désinscription, sauf si vous envoyez unsubscribe: true, car ce sont des e-mails personnels.

i

Toute personne qui reçoit un e-mail de la boîte devient un contact de la liste « Webmail » du compte et devient trusted dans cette boîte : ses réponses arrivent dans l’Inbox et l’adresse apparaît dans l’autocomplétion. Les expéditeurs bloqués par la boîte restent bloqués.

i

Avec unsubscribe: true, les destinataires déjà désinscrits de cette boîte sont refusés avec RECIPIENT_UNSUBSCRIBED, et recipients les liste. Les réponses ne sont jamais bloquées.

Arguments

  • send_atstringobligatoire

    RFC 3339, YYYY-MM-DD ou epoch ms. Au moins 1 minute à partir de maintenant et jusqu'à 1 an.

  • modestringfacultatif

    new (par défaut), reply ou forward.

  • idstringfacultatif

    Le message d'origine, pour reply et forward.

  • tostring | string[]facultatif

    Destinataire. Obligatoire pour new et forward. Pour new, il peut s’agir d’une liste de 30 maximum (offres payantes).

  • ccstring[]facultatif

    Copies visibles.

  • bccstring[]facultatif

    Copies cachées.

  • subjectstringfacultatif

    Obligatoire pour new. Reply et forward utilisent par défaut Re: / Fwd: original.

  • htmlstringfacultatif

    Corps HTML. Ou text, ou template_id.

  • template_idstringfacultatif

    Remplit le corps (et l'objet d'un nouvel e-mail) à partir d'un template.

  • followup_after_hoursnumberfacultatif

    Vous rappelle si personne ne répond dans ce nombre d'heures après l'envoi.

  • scheduled_idstringfacultatif

    Reprogrammer : l'ancien e-mail programmé est remplacé.

  • attachmentsobject[]facultatif

    Fichiers à joindre : [{ file_name, content, content_type }], content en base64. Jusqu'à 20 fichiers et 25 Mo au total. Chaque fichier est analysé ; un fichier dangereux échoue avec FILE_BLOCKED.

  • compose_uidstringfacultatif

    Pièces jointes que vous avez envoyées au préalable avec upload_attachment.

  • attachment_idsstring[]facultatif

    Lesquelles des pièces jointes envoyées utiliser. Sans ce paramètre, toutes.

  • track_opensbooleanfacultatif

    Suit le moment où chaque destinataire ouvre l’e-mail (pixel invisible). Par défaut true.

  • track_clicksbooleanfacultatif

    Suit les clics sur les liens (chaque lien passe par une redirection). Par défaut true.

  • unsubscribebooleanfacultatif

    Ajoute un lien de désinscription. Placez [unsubscribe] dans le corps (dans le href d’un lien ou en texte) à l’endroit du lien ; sans lui, une ligne par défaut est ajoutée à la fin. Par défaut false.

  • audiencestringfacultatif

    Envoie à une audience au lieu d’adresses : subscribed, opened, clicked, both, seg:<segment_id> ou msg:<message_uid>:opened|clicked|not_opened. to devient facultatif. Jusqu’à 5 000 personnes. Le lien de désinscription est activé et l’email part comme marketing. Offres payantes.

  • best_timebooleanfacultatif

    Envoie à chaque personne à l’heure où elle ouvre ou clique habituellement, pendant la journée de send_at. Nécessite audience et mode: new. send_at est 00:00 de ce jour dans votre fuseau, en UTC.

  • best_fallback_atstring | numberfacultatif

    Heure pour les personnes sans historique (RFC 3339 ou epoch ms). Doit être le même jour que send_at.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "schedule_send",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>",
          send_at: "2026-10-27T09:00:00+08:00"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_TOKEN } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Réponse

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "schedule_send",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "scheduled_id": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "send_at": "2026-10-27T01:00:00Z"
      }
    }
  ]
}

Champs de la réponse

  • scheduled_id

    Le message dans Scheduled. Utilisez-le pour annuler, reprogrammer ou envoyer maintenant.

Lister ce qui est programmé

Les e-mails programmés sont dans le dossier Scheduled, triés par heure d'envoi.

Body de la requête

{
  "commands": [
    {
      "command": "list_messages",
      "args": {
        "folder": "Scheduled"
      }
    }
  ]
}

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINVALID_AUDIENCE

    L’audience n’est pas valide : groupe inconnu, segment d’une autre boîte ou message non envoyé par cette boîte.

  • CMDAUDIENCE_OVER_LIMIT

    L’audience compte plus de personnes que vous ne pouvez en envoyer (jusqu’à 5 000 par email et votre limite quotidienne). `total` et `allowed` indiquent combien.

  • CMDEMPTY_AUDIENCE

    Personne dans cette audience pour l’instant.

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` nécessite un `audience` et `mode: new`.

  • CMDRECIPIENT_UNSUBSCRIBED

    Un ou plusieurs destinataires se sont désinscrits de cette boîte. `recipients` les liste : retirez-les ou renvoyez avec `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Plusieurs adresses dans `to` nécessitent une offre payante.

  • CMDTOO_MANY_RECIPIENTS

    `to` contient plus de 30 adresses.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINVALID_TIME

    send_at est manquant, à moins de 1 minute ou à plus de 1 an.

  • CMDINVALID_RECIPIENT

    Le destinataire est manquant ou n'est pas un e-mail valide.

  • CMDMISSING_SUBJECT

    Un nouvel e-mail a besoin d'un objet.

  • CMDMISSING_TARGET

    Reply et forward ont besoin de l'e-mail d'origine, qui doit encore exister.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc et bcc réunis comptent plus de 50 adresses.

  • CMDFILE_BLOCKED

    Un fichier a été bloqué par l'analyse de sécurité.

  • CMDATTACHMENTS_TOO_LARGE

    Les pièces jointes de l'e-mail dépassent 25 Mo au total, ou la boîte aux lettres a déjà 500 Mo de fichiers envoyés en attente d'envoi.

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.