Recevoir des e-mails : Brouillons

Enregistrer un brouillon

Enregistrez un e-mail dans les Brouillons sans l'envoyer. Il s'ouvre dans le webmail comme n'importe quel brouillon, et vous pouvez l'envoyer plus tard avec send_draft.

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

Un brouillon peut être incomplet : tous les champs sont facultatifs. Ce que vous envoyez est vérifié (un to qui n'est pas un e-mail échoue), ce que vous omettez ne l'est pas.

!

Pour modifier un brouillon, envoyez son draft_id. Les champs omis sont conservés (corps, destinataires, objet, pièces jointes, relance). Chaque enregistrement renvoie un NOUVEAU draft_id et l'ancien cesse de fonctionner : gardez toujours le dernier.

i

Si track_opens ou track_clicks est omis, le brouillon garde le choix qu’il avait déjà. send_draft et l’envoi programmé utilisent ce choix.

i

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

Arguments

  • draft_idstringfacultatif

    Modifie ce brouillon au lieu d'en créer un nouveau.

  • modestringfacultatif

    new (par défaut), reply ou forward. Lors d'une modification, le brouillon garde son mode.

  • idstringfacultatif

    Le message d'origine, pour reply et forward. L'objet par défaut est Re: / Fwd: original.

  • tostring | string[]facultatif

    Destinataire, ou une liste de 30 maximum pour new (offres payantes). Ignoré pour reply : il part à l’expéditeur de l’original.

  • ccstring[]facultatif

    Copies visibles.

  • bccstring[]facultatif

    Copies cachées.

  • subjectstringfacultatif

    Objet.

  • htmlstringfacultatif

    Corps HTML. Ou text, ou template_id.

  • textstringfacultatif

    Corps en texte brut, transformé en HTML simple.

  • template_idstringfacultatif

    Remplit le corps (et l'objet) à partir d'un template.

  • variablesobjectfacultatif

    Valeurs des variables du template, par exemple { "first_name": "Ana" }.

  • followup_after_hoursnumber | nullfacultatif

    Vous rappelle si personne ne répond dans ce nombre d'heures après l'envoi (jusqu'à 8760). null le supprime.

  • attachmentsobject[]facultatif

    Fichiers à joindre : [{ file_name, content, content_type }], content en base64. Ils s'ajoutent aux fichiers que le brouillon contient déjà.

  • compose_uidstringfacultatif

    Fichiers envoyés au préalable avec upload_attachment ou Téléverser un gros fichier.

  • attachment_idsstring[]facultatif

    Lesquels des fichiers envoyés utiliser. Sans ce paramètre, tous.

  • 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.

Démarrage rapide

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "save_draft",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>"
        }
      }
    ]
  },
  { 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": "save_draft",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "draft_id": "Vj0xRFJBRlQx",
        "thread_id": "thr_9a1c4e72"
      }
    }
  ]
}

Champs de la réponse

  • draft_id

    Le brouillon. Utilisez-le pour le modifier, le lire, l'envoyer ou le supprimer. Change à chaque enregistrement.

  • thread_id

    La conversation à laquelle appartient le brouillon.

Modifier un brouillon

Seul l'objet change ici. Le corps, les destinataires et les pièces jointes restent tels quels.

Body de la requête

{
  "commands": [
    {
      "command": "save_draft",
      "args": {
        "draft_id": "Vj0xRFJBRlQx",
        "subject": "Proposal (v2)"
      }
    }
  ]
}

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.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDPAID_PLAN_REQUIRED

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

  • CMDTOO_MANY_RECIPIENTS

    `to` contient plus de 30 adresses.

  • CMDDRAFT_NOT_FOUND

    Le brouillon n'existe plus : il a été envoyé, supprimé ou réenregistré (chaque enregistrement renvoie un nouveau draft_id).

  • CMDMISSING_TARGET

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

  • CMDINVALID_RECIPIENT

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

  • CMDINVALID_CCADDRESS

    L'une des adresses cc n'est pas un e-mail valide.

  • CMDINVALID_BCCADDRESS

    L'une des adresses bcc n'est pas un e-mail valide.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

  • CMDINVALID_ATTACHMENT

    Le contenu d'une pièce jointe n'est pas du base64 valide.

  • 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.

  • CMDATTACHMENT_MISSING

    Une pièce jointe envoyée n'existe plus (les fichiers non envoyés sous 48 heures, et non utilisés par un brouillon ou un e-mail programmé, sont supprimés). Envoyez-la à nouveau.

  • CMDINTERNAL

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