Recevoir des e-mails : Envoi et confiance
Répondre
Répondez dans la même conversation. La réponse est enregistrée dans Envoyés et INBOX, et l'objet devient Re: original.
https://g.sendcorex.com/v1command: replyLe destinataire est le reply_to (ou from) du message d'origine. Si l'id est un message que vous avez envoyé, la réponse va au dernier client qui a écrit dans la conversation, pas à vous. Les libellés de l'original sont conservés.
Les destinataires qui ont refusé le suivi sur la page de préférences ne sont jamais suivis, même avec true.
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.
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.
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
idstringobligatoireLe
message_uiddu message auquel vous répondez.htmlstringfacultatifCorps HTML. Envoyez
htmloutext.textstringfacultatifCorps en texte brut.
reply_allbooleanfacultatifToutes les personnes en To et Cc de l'original sont mises en Cc, sauf vous et la personne à qui vous répondez.
ccstring[]facultatifDestinataires supplémentaires en copie.
bccstring[]facultatifDestinataires supplémentaires en copie cachée.
template_idstringfacultatifRemplit le corps à partir d'un template.
attachmentsobject[]facultatifFichiers en base64, même format que Envoyer un e-mail.
compose_uidstringfacultatifPièces jointes envoyées au préalable avec
upload_attachment.followup_atstringfacultatifVous rappelle si personne ne répond avant cette date. Sans ce paramètre, un rappel déjà défini sur la conversation est supprimé (vous venez de répondre).
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.recipientstringfacultatifUniquement sur les emails envoyés par cette boîte : qui reçoit la relance, dans la même conversation avec « Re: ». La personne doit avoir reçu cet email (sinon
INVALID_RECIPIENT). Sans lui, une réponse à un email envoyé part à son destinataire, jamais vers la boîte.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "reply",
args: {
id: "Vj0xQUJDMTIz",
text: "Received, thank you!",
reply_all: true
}
}
]
},
{ 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": "reply",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"queued": true
}
}
]
}Champs de la réponse
message_uidL'id de la réponse.
thread_idLa même conversation que le message d'origine.
message_idUn Message-ID provisoire, remplacé peu après par le vrai Message-ID SMTP.
queuedtrue= enregistré et en file, pas remis.
Répondre au dernier e-mail d'un expéditeur
Recherchez par expéditeur, puis répondez au résultat le plus récent. La recherche renvoie d'abord le message le plus récent.
Node.js
const [s] = await call({
command: 'search',
args: { query: 'ana@client.com', field: 'from', limit: 5 },
});
const last = s.data.messages[0]; // newest first
if (last) {
const [r] = await call({
command: 'reply',
args: { id: last.message_uid, html: '<p>Hi Ana, received!</p>' },
});
console.log(r.data); // { message_uid, thread_id, message_id, queued: true }
}Répondre à toutes les conversations non lues
Répondez et marquez la conversation comme lue dans la même requête, pour que le polling suivant n'y réponde pas à nouveau.
Node.js
const [l] = await call({ command: 'list_threads', args: { is_read: false, limit: 20 } });
for (const t of l.data.threads) {
await call([
{ command: 'reply', args: { id: t.last_message_uid, text: 'We got your message and will get back to you.' } },
{ command: 'set_flags', args: { id: t.last_message_uid, is_read: true, scope: 'thread' } },
]);
}Vous pouvez aussi enchaîner list_threads et reply dans une même requête avec $ref, en utilisant le last_message_uid de chaque fil.
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_RECIPIENTLe destinataire est manquant ou n'est pas un e-mail valide.
- CMD
RECIPIENT_UNSUBSCRIBEDUn ou plusieurs destinataires se sont désinscrits de cette boîte. `recipients` les liste : retirez-les ou renvoyez avec `unsubscribe: false`.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
NOT_FOUNDLe message, la conversation ou le dossier n'existe pas pour ce token.
- CMD
NO_RECIPIENTLa conversation n'a aucun destinataire à qui répondre.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc et bcc réunis comptent plus de 50 adresses.
- 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
NO_CREDITSLe compte a moins de crédits e-mail que de destinataires (1 crédit par copie).
- CMD
SENDER_NOT_FOUNDL'expéditeur associé au token n'est pas enregistré.
- CMD
SENDER_NO_DOMAINL'expéditeur associé au token n'a pas de domaine.
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.