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.
https://g.sendcorex.com/v1command: replyEmpfä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.
Empfänger, die das Tracking auf der Einstellungsseite abgelehnt haben, werden nie erfasst, auch nicht mit true.
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.
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.
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
idstringerforderlichDie
message_uidder Nachricht, auf die Sie antworten.htmlstringoptionalHTML-Inhalt. Senden Sie
htmlodertext.textstringoptionalKlartext-Inhalt.
reply_allbooleanoptionalAlle in To und Cc des Originals kommen in Cc, außer Ihnen und der Person, der Sie antworten.
ccstring[]optionalZusätzliche Empfänger in Kopie.
bccstring[]optionalZusätzliche Empfänger in Blindkopie.
template_idstringoptionalFüllt den Inhalt aus einem Template.
attachmentsobject[]optionalDateien in Base64, gleiches Format wie bei E-Mail senden.
compose_uidstringoptionalZuvor mit
upload_attachmenthochgeladene Anhänge.followup_atstringoptionalErinnert Sie, wenn bis zu diesem Datum niemand antwortet. Ohne Angabe wird eine bereits gesetzte Erinnerung der Konversation entfernt (Sie haben ja gerade geantwortet).
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.recipientstringoptionalNur 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_uidDie ID der Antwort.
thread_idDieselbe Konversation wie die Originalnachricht.
message_idEine vorläufige Message-ID, die kurz darauf durch die echte SMTP-ID ersetzt wird.
queuedtrue= 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' } },
]);
}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.
- 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_RECIPIENTDer Empfänger fehlt oder ist keine gültige E-Mail.
- CMD
RECIPIENT_UNSUBSCRIBEDEin oder mehrere Empfänger haben sich von diesem Postfach abgemeldet. `recipients` listet sie auf: Entfernen Sie sie oder senden Sie erneut mit `unsubscribe: false`.
- CMD
INVALID_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
NOT_FOUNDDie Nachricht, die Konversation oder der Ordner existiert für diesen Token nicht.
- CMD
NO_RECIPIENTDie Konversation hat keinen Empfänger, an den geantwortet werden kann.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc und bcc haben zusammen mehr als 50 Adressen.
- 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
NO_CREDITSDas Konto hat weniger E-Mail-Credits als Empfänger (1 Credit pro Kopie).
- CMD
SENDER_NOT_FOUNDDer Absender hinter dem Token ist nicht registriert.
- CMD
SENDER_NO_DOMAINDer Absender hinter dem Token hat keine Domain.
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.