Recevoir des e-mails : Envoi et confiance
Transférer
Transférez un message à quelqu'un d'autre. Les pièces jointes d'origine sont incluses, et l'e-mail est enregistré dans la même conversation dans Envoyés.
https://g.sendcorex.com/v1command: forwardL'objet devient Fwd: original et un bloc Forwarded message contenant l'e-mail d'origine est ajouté sous votre texte. Le transfert ne ramène pas la conversation dans la Boîte de réception.
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 à transférer.tostringobligatoireQui reçoit le transfert.
to_namestringfacultatifNom du destinataire.
ccstring[]facultatifCopies visibles. to + cc + bcc jusqu'à 50 adresses.
bccstring[]facultatifCopies cachées.
htmlstringfacultatifVotre texte au-dessus de l'e-mail transféré. Envoyez
htmloutext.textstringfacultatifVersion texte brut de votre note.
include_attachmentsbooleanfacultatifEnvoie les pièces jointes d'origine. Par défaut
true.quote_originalbooleanfacultatifAjoute le bloc Forwarded message. Par défaut
true.attachmentsobject[]facultatifFichiers à joindre :
[{ file_name, content, content_type }],contenten base64. Jusqu'à 20 fichiers et 25 Mo au total. Chaque fichier est analysé ; un fichier dangereux échoue avecFILE_BLOCKED.compose_uidstringfacultatifPièces jointes que vous avez envoyées au préalable avec
upload_attachment.attachment_idsstring[]facultatifLesquelles des pièces jointes envoyées utiliser. Sans ce paramètre, toutes.
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.
Démarrage rapide
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "forward",
args: {
id: "Vj0xQUJDMTIz",
to: "finance@acme.com",
html: "<p>Can you check this invoice?</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": "forward",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90",
"recipients": 1,
"queued": true
}
}
]
}Champs de la réponse
message_uidL'id du transfert dans Envoyés.
recipientsNombre de copies mises en file (1 crédit chacune).
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
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
INVALID_RECIPIENTLe destinataire est manquant ou n'est pas un e-mail valide.
- 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
FILE_BLOCKEDUn fichier a été bloqué par l'analyse de sécurité.
- 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
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.