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.
https://g.sendcorex.com/v1command: save_draftUn 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.
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.
Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis, même avec true.
Arguments
draft_idstringfacultatifModifie ce brouillon au lieu d'en créer un nouveau.
modestringfacultatifnew(par défaut),replyouforward. Lors d'une modification, le brouillon garde son mode.idstringfacultatifLe message d'origine, pour
replyetforward. L'objet par défaut est Re: / Fwd: original.tostring | string[]facultatifDestinataire, ou une liste de 30 maximum pour
new(offres payantes). Ignoré pourreply: il part à l’expéditeur de l’original.ccstring[]facultatifCopies visibles.
bccstring[]facultatifCopies cachées.
subjectstringfacultatifObjet.
htmlstringfacultatifCorps HTML. Ou
text, outemplate_id.textstringfacultatifCorps en texte brut, transformé en HTML simple.
template_idstringfacultatifRemplit le corps (et l'objet) à partir d'un template.
variablesobjectfacultatifValeurs des variables du template, par exemple
{ "first_name": "Ana" }.followup_after_hoursnumber | nullfacultatifVous rappelle si personne ne répond dans ce nombre d'heures après l'envoi (jusqu'à 8760).
nullle supprime.attachmentsobject[]facultatifFichiers à joindre :
[{ file_name, content, content_type }],contenten base64. Ils s'ajoutent aux fichiers que le brouillon contient déjà.compose_uidstringfacultatifFichiers envoyés au préalable avec
upload_attachmentou Téléverser un gros fichier.attachment_idsstring[]facultatifLesquels des fichiers envoyés utiliser. Sans ce paramètre, tous.
track_opensbooleanfacultatifSuit le moment où chaque destinataire ouvre l’e-mail (pixel invisible). Par défaut
true.track_clicksbooleanfacultatifSuit les clics sur les liens (chaque lien passe par une redirection). Par défaut
true.unsubscribebooleanfacultatifAjoute un lien de désinscription. Placez
[unsubscribe]dans le corps (dans lehrefd’un lien ou en texte) à l’endroit du lien ; sans lui, une ligne par défaut est ajoutée à la fin. Par défautfalse.audiencestringfacultatifEnvoie à une audience au lieu d’adresses :
subscribed,opened,clicked,both,seg:<segment_id>oumsg:<message_uid>:opened|clicked|not_opened.todevient 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_idLe brouillon. Utilisez-le pour le modifier, le lire, l'envoyer ou le supprimer. Change à chaque enregistrement.
thread_idLa 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.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus 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.
- CMD
INVALID_AUDIENCEL’audience n’est pas valide : groupe inconnu, segment d’une autre boîte ou message non envoyé par cette boîte.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
PAID_PLAN_REQUIREDPlusieurs adresses dans `to` nécessitent une offre payante.
- CMD
TOO_MANY_RECIPIENTS`to` contient plus de 30 adresses.
- CMD
DRAFT_NOT_FOUNDLe brouillon n'existe plus : il a été envoyé, supprimé ou réenregistré (chaque enregistrement renvoie un nouveau draft_id).
- CMD
MISSING_TARGETReply et forward ont besoin de l'e-mail d'origine, qui doit encore exister.
- CMD
INVALID_RECIPIENTLe destinataire est manquant ou n'est pas un e-mail valide.
- CMD
INVALID_CCADDRESSL'une des adresses cc n'est pas un e-mail valide.
- CMD
INVALID_BCCADDRESSL'une des adresses bcc n'est pas un e-mail valide.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 adresses.
- CMD
INVALID_ATTACHMENTLe contenu d'une pièce jointe n'est pas du base64 valide.
- CMD
FILE_BLOCKEDUn fichier a été bloqué par l'analyse de sécurité.
- CMD
ATTACHMENTS_TOO_LARGELes 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.
- CMD
ATTACHMENT_MISSINGUne 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.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.