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.
https://g.sendcorex.com/v1command: save_draftEin 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.
Wird track_opens oder track_clicks weggelassen, behält der Entwurf seine bisherige Wahl. send_draft und der geplante Versand verwenden diese Wahl.
Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst, auch nicht mit true.
Argumente
draft_idstringoptionalDiesen Entwurf bearbeiten, statt einen neuen zu erstellen.
modestringoptionalnew(Standard),replyoderforward. Beim Bearbeiten behält der Entwurf seinen Modus.idstringoptionalDie Originalnachricht, für
replyundforward. Der Betreff ist standardmäßig Re: / Fwd: Original.tostring | string[]optionalEmpfänger oder eine Liste mit bis zu 30 für
new(kostenpflichtige Tarife). Beireplyignoriert: geht an den Absender des Originals.ccstring[]optionalSichtbare Kopien.
bccstring[]optionalVerdeckte Kopien.
subjectstringoptionalBetreff.
htmlstringoptionalHTML-Inhalt. Oder
textodertemplate_id.textstringoptionalKlartext-Inhalt, wird in einfaches HTML umgewandelt.
template_idstringoptionalFüllt den Inhalt (und den Betreff) aus einem Template.
variablesobjectoptionalWerte für die Template-Variablen, etwa
{ "first_name": "Ana" }.followup_after_hoursnumber | nulloptionalErinnert Sie, wenn so viele Stunden nach dem Versand niemand antwortet (bis 8760).
nullentfernt die Erinnerung.attachmentsobject[]optionalAnzuhängende Dateien:
[{ file_name, content, content_type }],contentin Base64. Sie werden zu den Dateien hinzugefügt, die der Entwurf bereits hat.compose_uidstringoptionalZuvor mit
upload_attachmentoder Große Datei hochladen hochgeladene Dateien.attachment_idsstring[]optionalWelche der hochgeladenen Dateien verwendet werden. Ohne Angabe alle.
track_opensbooleanoptionalErfasst, wann jeder Empfänger die E-Mail öffnet (unsichtbares Pixel). Standard
true.track_clicksbooleanoptionalErfasst Klicks auf Links (jeder Link läuft über eine Weiterleitung). Standard
true.unsubscribebooleanoptionalFügt einen Abmeldelink hinzu. Setzen Sie
[unsubscribe]in den Text (alshrefeines Links oder als Klartext) an die Stelle des Links; fehlt es, wird am Ende eine Standardzeile ergänzt. Standardfalse.audiencestringoptionalSendet an eine Zielgruppe statt an Adressen:
subscribed,opened,clicked,both,seg:<segment_id>odermsg:<message_uid>:opened|clicked|not_opened.towird 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_idDer Entwurf. Verwenden Sie ihn zum Bearbeiten, Lesen, Senden oder Löschen. Ändert sich bei jedem Speichern.
thread_idDie 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.
- 401
TOKEN_EXPIREDDer Access Token ist abgelaufen. Rufen Sie Refresh Token auf und wiederholen Sie die Anfrage.
- 401
INVALID_TOKENDer Token ist fehlerhaft, unbekannt oder widerrufen.
- 429
RATE_LIMITEDMehr als 15 Anfragen/s oder 15 gleichzeitig laufende Anfragen für dieselbe IP + dasselbe Postfach. Warten Sie die in Retry-After angegebene Anzahl Sekunden.
- CMD
INVALID_AUDIENCEDie Zielgruppe ist ungültig: unbekannte Gruppe, Segment eines anderen Postfachs oder eine Nachricht, die dieses Postfach nicht gesendet hat.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
PAID_PLAN_REQUIREDMehr als eine Adresse in `to` erfordert einen kostenpflichtigen Tarif.
- CMD
TOO_MANY_RECIPIENTS`to` enthält mehr als 30 Adressen.
- CMD
DRAFT_NOT_FOUNDDer Entwurf existiert nicht mehr: Er wurde gesendet, gelöscht oder erneut gespeichert (jedes Speichern liefert eine neue draft_id).
- CMD
MISSING_TARGETReply und forward brauchen die Original-E-Mail, und diese muss noch existieren.
- CMD
INVALID_RECIPIENTDer Empfänger fehlt oder ist keine gültige E-Mail.
- CMD
INVALID_CCADDRESSEine der cc-Adressen ist keine gültige E-Mail.
- CMD
INVALID_BCCADDRESSEine der bcc-Adressen ist keine gültige E-Mail.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 Adressen.
- CMD
INVALID_ATTACHMENTDer Inhalt eines Anhangs ist kein gültiges Base64.
- CMD
FILE_BLOCKEDEine Datei wurde von der Sicherheitsprüfung blockiert.
- CMD
ATTACHMENTS_TOO_LARGEDie 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.
- CMD
ATTACHMENT_MISSINGEin 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.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.