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.

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

L'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.

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

  • idstringobligatoire

    Le message_uid du message à transférer.

  • tostringobligatoire

    Qui reçoit le transfert.

  • to_namestringfacultatif

    Nom du destinataire.

  • ccstring[]facultatif

    Copies visibles. to + cc + bcc jusqu'à 50 adresses.

  • bccstring[]facultatif

    Copies cachées.

  • htmlstringfacultatif

    Votre texte au-dessus de l'e-mail transféré. Envoyez html ou text.

  • textstringfacultatif

    Version texte brut de votre note.

  • include_attachmentsbooleanfacultatif

    Envoie les pièces jointes d'origine. Par défaut true.

  • quote_originalbooleanfacultatif

    Ajoute le bloc Forwarded message. Par défaut true.

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

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_uid

    L'id du transfert dans Envoyés.

  • recipients

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

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

  • CMDRECIPIENT_UNSUBSCRIBED

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

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDNOT_FOUND

    Le message, la conversation ou le dossier n'existe pas pour ce token.

  • CMDINVALID_RECIPIENT

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

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

  • CMDFILE_BLOCKED

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

  • CMDNO_CREDITS

    Le compte a moins de crédits e-mail que de destinataires (1 crédit par copie).

  • CMDSENDER_NOT_FOUND

    L'expéditeur associé au token n'est pas enregistré.

  • CMDINTERNAL

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