E-Mails empfangen: Senden und Vertrauen

Weiterleiten

Leiten Sie eine Nachricht an jemand anderen weiter. Die Originalanhänge gehen mit, und die E-Mail wird in derselben Konversation unter Gesendet gespeichert.

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

Der Betreff wird zu Fwd: original und unter Ihrem Text wird ein Forwarded-message-Block mit der Original-E-Mail eingefügt. Die Weiterleitung holt die Konversation nicht in den Posteingang zurück.

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 weiterzuleitenden Nachricht.

  • tostringerforderlich

    Wer die Weiterleitung erhält.

  • to_namestringoptional

    Name des Empfängers.

  • ccstring[]optional

    Sichtbare Kopien. to + cc + bcc bis zu 50 Adressen.

  • bccstring[]optional

    Verdeckte Kopien.

  • htmlstringoptional

    Ihr Text über der weitergeleiteten E-Mail. Senden Sie html oder text.

  • textstringoptional

    Klartext-Version Ihrer Notiz.

  • include_attachmentsbooleanoptional

    Sendet die Originalanhänge mit. Standard ist true.

  • quote_originalbooleanoptional

    Fügt den Forwarded-message-Block hinzu. Standard ist true.

  • attachmentsobject[]optional

    Anzuhängende Dateien: [{ file_name, content, content_type }], content in Base64. Bis zu 20 Dateien und insgesamt 25 MB. Jede Datei wird geprüft; eine gefährliche schlägt mit FILE_BLOCKED fehl.

  • compose_uidstringoptional

    Anhänge, die Sie zuvor mit upload_attachment hochgeladen haben.

  • attachment_idsstring[]optional

    Welche der hochgeladenen Anhänge gesendet werden. Ohne Angabe alle.

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

Schnellstart

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

Antwort

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

Antwortfelder

  • message_uid

    Die ID der Weiterleitung unter Gesendet.

  • recipients

    Wie viele Kopien eingereiht wurden (je 1 Credit).

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.

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

  • CMDINVALID_RECIPIENT

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

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

  • CMDFILE_BLOCKED

    Eine Datei wurde von der Sicherheitsprüfung blockiert.

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

  • CMDINTERNAL

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