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.

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

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

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 auquel vous répondez.

  • htmlstringfacultatif

    Corps HTML. Envoyez html ou text.

  • textstringfacultatif

    Corps en texte brut.

  • reply_allbooleanfacultatif

    Toutes les personnes en To et Cc de l'original sont mises en Cc, sauf vous et la personne à qui vous répondez.

  • ccstring[]facultatif

    Destinataires supplémentaires en copie.

  • bccstring[]facultatif

    Destinataires supplémentaires en copie cachée.

  • template_idstringfacultatif

    Remplit le corps à partir d'un template.

  • attachmentsobject[]facultatif

    Fichiers en base64, même format que Envoyer un e-mail.

  • compose_uidstringfacultatif

    Pièces jointes envoyées au préalable avec upload_attachment.

  • followup_atstringfacultatif

    Vous 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_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.

  • recipientstringfacultatif

    Uniquement 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_uid

    L'id de la réponse.

  • thread_id

    La même conversation que le message d'origine.

  • message_id

    Un Message-ID provisoire, remplacé peu après par le vrai Message-ID SMTP.

  • queued

    true = 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' } },
  ]);
}
i

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.

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

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

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

  • CMDNO_RECIPIENT

    La conversation n'a aucun destinataire à qui répondre.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

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

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

  • CMDSENDER_NO_DOMAIN

    L'expéditeur associé au token n'a pas de domaine.

  • CMDINTERNAL

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