E-Mails empfangen: Senden und Vertrauen

Antworten

Antworten Sie innerhalb derselben Konversation. Die Antwort wird unter Gesendet und in der INBOX gespeichert, und der Betreff wird zu Re: Original.

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

Empfänger ist die reply_to- (oder from-) Adresse der Originalnachricht. Ist die id eine Nachricht, die Sie gesendet haben, geht die Antwort an den letzten Kunden, der in der Konversation geschrieben hat, nicht an Sie selbst. Die Labels des Originals bleiben erhalten.

i

Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst, auch nicht mit true.

i

E-Mails aus dem Postfach enthalten keinen List-Unsubscribe-Header und keinen Abmeldelink, außer Sie senden unsubscribe: true, da es persönliche E-Mails sind.

i

Jede Person, die eine E-Mail aus dem Postfach erhält, wird Kontakt in der Liste „Webmail“ des Kontos und gilt in diesem Postfach als trusted: Ihre Antworten landen in der Inbox und die Adresse erscheint in der Autovervollständigung. Vom Postfach blockierte Absender bleiben blockiert.

i

Mit unsubscribe: true werden Empfänger, die sich von diesem Postfach bereits abgemeldet haben, mit RECIPIENT_UNSUBSCRIBED abgelehnt; recipients listet sie auf. Antworten werden nie blockiert.

Argumente

  • idstringerforderlich

    Die message_uid der Nachricht, auf die Sie antworten.

  • htmlstringoptional

    HTML-Inhalt. Senden Sie html oder text.

  • textstringoptional

    Klartext-Inhalt.

  • reply_allbooleanoptional

    Alle in To und Cc des Originals kommen in Cc, außer Ihnen und der Person, der Sie antworten.

  • ccstring[]optional

    Zusätzliche Empfänger in Kopie.

  • bccstring[]optional

    Zusätzliche Empfänger in Blindkopie.

  • template_idstringoptional

    Füllt den Inhalt aus einem Template.

  • attachmentsobject[]optional

    Dateien in Base64, gleiches Format wie bei E-Mail senden.

  • compose_uidstringoptional

    Zuvor mit upload_attachment hochgeladene Anhänge.

  • followup_atstringoptional

    Erinnert Sie, wenn bis zu diesem Datum niemand antwortet. Ohne Angabe wird eine bereits gesetzte Erinnerung der Konversation entfernt (Sie haben ja gerade geantwortet).

  • track_opensbooleanoptional

    Erfasst, wann jeder Empfänger die E-Mail öffnet (unsichtbares Pixel). Standard true.

  • track_clicksbooleanoptional

    Erfasst Klicks auf Links (jeder Link läuft über eine Weiterleitung). Standard true.

  • unsubscribebooleanoptional

    Fügt einen Abmeldelink hinzu. Setzen Sie [unsubscribe] in den Text (als href eines Links oder als Klartext) an die Stelle des Links; fehlt es, wird am Ende eine Standardzeile ergänzt. Standard false.

  • recipientstringoptional

    Nur bei E-Mails, die dieses Postfach gesendet hat: wer das Follow-up erhält, in derselben Konversation mit „Re:“. Die Person muss diese E-Mail erhalten haben (sonst INVALID_RECIPIENT). Ohne den Parameter geht eine Antwort auf eine gesendete E-Mail an deren Empfänger, nie zurück an das Postfach.

Schnellstart

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);

Antwort

{
  "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
      }
    }
  ]
}

Antwortfelder

  • message_uid

    Die ID der Antwort.

  • thread_id

    Dieselbe Konversation wie die Originalnachricht.

  • message_id

    Eine vorläufige Message-ID, die kurz darauf durch die echte SMTP-ID ersetzt wird.

  • queued

    true = gespeichert und eingereiht, nicht zugestellt.

Auf die letzte E-Mail eines Absenders antworten

Suchen Sie nach dem Absender und antworten Sie auf das neueste Ergebnis. Die Suche liefert die neueste Nachricht zuerst.

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 }
}

Auf jede ungelesene Konversation antworten

Antworten Sie und markieren Sie die Konversation in derselben Anfrage als gelesen, damit das nächste Polling sie nicht erneut beantwortet.

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

Sie können list_threads und reply auch mit $ref in einer Anfrage verketten, mit der last_message_uid jedes Threads.

Fehler

Fehler auf HTTP-Ebene liefern type, code und message. Mit CMD markierte Fehler kommen im Befehlsergebnis zurück, mit HTTP 200.

  • 401TOKEN_EXPIRED

    Der Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.

  • 401INVALID_TOKEN

    Der Token ist fehlerhaft, unbekannt oder widerrufen.

  • 429RATE_LIMITED

    Mehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.

  • CMDINVALID_RECIPIENT

    Der Empfänger fehlt oder ist keine gültige E-Mail.

  • CMDRECIPIENT_UNSUBSCRIBED

    Ein oder mehrere Empfänger haben sich von diesem Postfach abgemeldet. `recipients` listet sie auf: Entfernen Sie sie oder senden Sie erneut mit `unsubscribe: false`.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDNOT_FOUND

    Die Nachricht, die Konversation oder der Ordner existiert für diesen Token nicht.

  • CMDNO_RECIPIENT

    Die Konversation hat keinen Empfänger, an den geantwortet werden kann.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc und bcc haben zusammen mehr als 50 Adressen.

  • CMDFILE_BLOCKED

    Eine Datei wurde von der Sicherheitsprüfung blockiert.

  • CMDATTACHMENTS_TOO_LARGE

    Die Anhänge der E-Mail ergeben zusammen mehr als 25 MB, oder das Postfach hat bereits 500 MB an Uploads, die auf den Versand warten.

  • CMDNO_CREDITS

    Das Konto hat weniger E-Mail-Credits als Empfänger (1 Credit pro Kopie).

  • CMDSENDER_NOT_FOUND

    Der Absender hinter dem Token ist nicht registriert.

  • CMDSENDER_NO_DOMAIN

    Der Absender hinter dem Token hat keine Domain.

  • CMDINTERNAL

    Serverfehler. Die Details werden nur ins Server-Log geschrieben.