E-Mails empfangen: Entwürfe

Entwurf speichern

Speichern Sie eine E-Mail unter Entwürfe, ohne sie zu senden. Sie öffnet sich im Webmail wie jeder andere Entwurf, und Sie können sie später mit send_draft senden.

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

Ein Entwurf darf unvollständig sein: Alle Felder sind optional. Was Sie senden, wird geprüft (ein to, das keine E-Mail ist, schlägt fehl), was Sie weglassen, nicht.

!

Um einen Entwurf zu bearbeiten, senden Sie seine draft_id. Weggelassene Felder bleiben erhalten (Inhalt, Empfänger, Betreff, Anhänge, Follow-up). Jedes Speichern liefert eine NEUE draft_id, und die alte funktioniert nicht mehr, behalten Sie also immer die letzte.

i

Wird track_opens oder track_clicks weggelassen, behält der Entwurf seine bisherige Wahl. send_draft und der geplante Versand verwenden diese Wahl.

i

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

Argumente

  • draft_idstringoptional

    Diesen Entwurf bearbeiten, statt einen neuen zu erstellen.

  • modestringoptional

    new (Standard), reply oder forward. Beim Bearbeiten behält der Entwurf seinen Modus.

  • idstringoptional

    Die Originalnachricht, für reply und forward. Der Betreff ist standardmäßig Re: / Fwd: Original.

  • tostring | string[]optional

    Empfänger oder eine Liste mit bis zu 30 für new (kostenpflichtige Tarife). Bei reply ignoriert: geht an den Absender des Originals.

  • ccstring[]optional

    Sichtbare Kopien.

  • bccstring[]optional

    Verdeckte Kopien.

  • subjectstringoptional

    Betreff.

  • htmlstringoptional

    HTML-Inhalt. Oder text oder template_id.

  • textstringoptional

    Klartext-Inhalt, wird in einfaches HTML umgewandelt.

  • template_idstringoptional

    Füllt den Inhalt (und den Betreff) aus einem Template.

  • variablesobjectoptional

    Werte für die Template-Variablen, etwa { "first_name": "Ana" }.

  • followup_after_hoursnumber | nulloptional

    Erinnert Sie, wenn so viele Stunden nach dem Versand niemand antwortet (bis 8760). null entfernt die Erinnerung.

  • attachmentsobject[]optional

    Anzuhängende Dateien: [{ file_name, content, content_type }], content in Base64. Sie werden zu den Dateien hinzugefügt, die der Entwurf bereits hat.

  • compose_uidstringoptional

    Zuvor mit upload_attachment oder Große Datei hochladen hochgeladene Dateien.

  • attachment_idsstring[]optional

    Welche der hochgeladenen Dateien verwendet 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.

  • audiencestringoptional

    Sendet an eine Zielgruppe statt an Adressen: subscribed, opened, clicked, both, seg:<segment_id> oder msg:<message_uid>:opened|clicked|not_opened. to wird optional. Bis zu 5.000 Personen. Der Abmeldelink wird aktiviert und die E-Mail geht als Marketing raus. Kostenpflichtige Tarife.

Schnellstart

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "save_draft",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</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": "save_draft",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "draft_id": "Vj0xRFJBRlQx",
        "thread_id": "thr_9a1c4e72"
      }
    }
  ]
}

Antwortfelder

  • draft_id

    Der Entwurf. Verwenden Sie ihn zum Bearbeiten, Lesen, Senden oder Löschen. Ändert sich bei jedem Speichern.

  • thread_id

    Die Konversation, zu der der Entwurf gehört.

Einen Entwurf bearbeiten

Hier ändert sich nur der Betreff. Inhalt, Empfänger und Anhänge bleiben, wie sie waren.

Request-Body

{
  "commands": [
    {
      "command": "save_draft",
      "args": {
        "draft_id": "Vj0xRFJBRlQx",
        "subject": "Proposal (v2)"
      }
    }
  ]
}

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_AUDIENCE

    Die Zielgruppe ist ungültig: unbekannte Gruppe, Segment eines anderen Postfachs oder eine Nachricht, die dieses Postfach nicht gesendet hat.

  • CMDINVALID_ARGS

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDPAID_PLAN_REQUIRED

    Mehr als eine Adresse in `to` erfordert einen kostenpflichtigen Tarif.

  • CMDTOO_MANY_RECIPIENTS

    `to` enthält mehr als 30 Adressen.

  • CMDDRAFT_NOT_FOUND

    Der Entwurf existiert nicht mehr: Er wurde gesendet, gelöscht oder erneut gespeichert (jedes Speichern liefert eine neue draft_id).

  • CMDMISSING_TARGET

    Reply und forward brauchen die Original-E-Mail, und diese muss noch existieren.

  • CMDINVALID_RECIPIENT

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

  • CMDINVALID_CCADDRESS

    Eine der cc-Adressen ist keine gültige E-Mail.

  • CMDINVALID_BCCADDRESS

    Eine der bcc-Adressen ist keine gültige E-Mail.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

  • CMDINVALID_ATTACHMENT

    Der Inhalt eines Anhangs ist kein gültiges Base64.

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

  • CMDATTACHMENT_MISSING

    Ein hochgeladener Anhang existiert nicht mehr (Uploads, die nicht innerhalb von 48 Stunden gesendet und nicht von einem Entwurf oder einer geplanten E-Mail verwendet werden, werden gelöscht). Laden Sie ihn erneut hoch.

  • CMDINTERNAL

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