E-Mails empfangen: Regeln
Regel erstellen
Erstellen Sie einen Filter, der bei jeder neuen E-Mail läuft: Abgleich nach Absender, Domain, Provider, Betreff, Inhalt, Anhängen, Uhrzeit und mehr, dann verschieben, labeln, markieren, zurückstellen oder antworten.
https://g.sendcorex.com/v1command: create_ruleDie neue Regel kommt ans Ende der Liste. Regeln laufen der Reihe nach; stop: true überspringt bei einem Treffer die Regeln darunter.
Eine Regel kann eine E-Mail nicht aus dem Spam holen, dem Absender vertrauen oder ihn blockieren und nicht automatisch antworten, es sei denn, die From-Domain hat SPF oder DKIM aligned (oder DMARC) bestanden. Jeder kann From: boss@yourcompany.com schreiben; ohne diese Prüfung würde diese E-Mail Ihre Filter umgehen oder Ihren Chef blockieren.
Argumente
namestringerforderlichBis zu 80 Zeichen.
conditionsobject[]erforderlich[{ field, op, value, header? }]. 1 bis 20 (einschließlich Ausnahmen).matchstringoptionalall(Standard) oderanyder Bedingungen.exceptobject[]optionalWenn eine davon zutrifft, läuft die Regel nicht.
actionsobject[]erforderlich[{ type, value? }]. 1 bis 12. Nur einmove.stopbooleanoptionalDie Regeln darunter nicht ausführen, wenn diese zutrifft.
enabledbooleanoptionalStandard ist
true.timezonestringoptionalIANA-Name, der von
received_hour,received_weekdayundnext_morningverwendet wird. Standard ist UTC.presetstringoptionalIhr eigenes Tag für Regeln, die aus einem Template erstellt wurden.
Schnellstart
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "create_rule",
args: {
name: "Clients always in Inbox",
match: "all",
conditions: [
{
field: "from_domain",
op: "in_list",
value: "acme.com, globex.com"
},
{
field: "provider",
op: "is_any_of",
value: [
"microsoft_365",
"google_workspace"
]
}
],
except: [
{
field: "subject",
op: "contains",
value: "newsletter"
}
],
actions: [
{
type: "keep_inbox"
},
{
type: "label",
value: "Clients"
},
{
type: "star"
}
],
stop: false,
timezone: "Asia/Kuala_Lumpur"
}
}
]
},
{ 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": "create_rule",
"id": "0",
"type": "SUCCESS",
"data": {
"id": "Vj0xUlVMRTAx",
"rule_id": "Vj0xUlVMRTAx",
"name": "Clients always in Inbox",
"match": "all",
"conditions": [
{
"field": "from_domain",
"op": "in_list",
"value": "acme.com, globex.com"
},
{
"field": "provider",
"op": "is_any_of",
"value": [
"microsoft_365",
"google_workspace"
]
}
],
"except": [
{
"field": "subject",
"op": "contains",
"value": "newsletter"
}
],
"actions": [
{
"type": "keep_inbox"
},
{
"type": "label",
"value": "Clients"
},
{
"type": "star"
}
],
"stop": false,
"timezone": "Asia/Kuala_Lumpur",
"enabled": true,
"position": 0,
"hits": 128,
"last_hit_at": "2026-10-25T09:12:44Z",
"created_at": "2026-10-01T02:00:00Z",
"updated_at": "2026-10-20T08:30:00Z"
}
}
]
}Felder und Operatoren
from / from_name / reply_toText: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty
from_domainDomain: is (trifft auch auf Subdomains zu), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex
to / cc / recipientAdressliste (recipient = to + cc). Gleiche Operatoren wie Text; trifft zu, wenn irgendeine Adresse zutrifft
subject / body / subject_or_bodyText. Der Inhalt wird bis zu den ersten 20.000 Zeichen gelesen
attachment_name / attachment_typeListe. attachment_type ist die Dateiendung: pdf, xlsx…
list_idText. Die List-Id einer Mailingliste
headerText, mit dem Header-Namen in
header(z. B. x-mailer). Wird nur beim Eingang der E-Mail geprüftprovideris_any_of / is_none_of: google_workspace, gmail, microsoft_365, outlook, yahoo, icloud, zoho, proton, amazon_ses, sendgrid, mailgun, other
received_weekdayis_any_of / is_none_of: sun, mon, tue, wed, thu, fri, sat (in der Zeitzone der Regel)
received_hourgt, lt, between, not_between.
22-6geht über Mitternachtsize_kbgt, lt, between, not_between
has_attachment, is_mailing_list, is_reply, is_auto_reply, is_calendar_invite, authenticated, trusted_sender, first_time_sender, only_to_meis_true / is_false
Aktionen
movevalue: inbox, archive, spam, trash, promotions oder custom:<folder-id>. Die erste Regel, die verschiebt, gewinnt
keep_inboxImmer Posteingang: nie Spam, Vorsortierung (Agents / NotSubscribing) oder Promotions
mark_read / star / importantFlags. Sie summieren sich über Regeln hinweg
labelvalue: der Label-Name (1–50 Zeichen). Labels summieren sich über Regeln hinweg
trust_sender / block_senderSpeichert den Absender für die nächsten E-Mails als vertrauenswürdig oder blockiert. block_sender verschiebt außerdem nach Spam
snoozevalue: Stunden (1 bis 8760) oder next_morning (nächstes 8:00 Uhr in der Zeitzone der Regel). Nur für E-Mails, die im Posteingang bleiben
auto_replyvalue: eine Template-ID. Eine Antwort pro Absender alle 24 Stunden
Wenn mehrere Regeln zutreffen: Das erste move gewinnt, Labels und Flags summieren sich, und block_sender hat Vorrang vor trust_sender.
Was eine Regel nicht überschreiben kann
Eine Regel kann eine E-Mail nicht aus dem Spam holen, dem Absender vertrauen oder ihn blockieren und nicht automatisch antworten, es sei denn, die From-Domain hat SPF oder DKIM aligned (oder DMARC) bestanden. Jeder kann From: boss@yourcompany.com schreiben; ohne diese Prüfung würde diese E-Mail Ihre Filter umgehen oder Ihren Chef blockieren.
Labels, gelesen, Stern und das Verschieben nach Spam oder Papierkorb gelten immer. Phishing-Meldungen, DMARC-Quarantäne, ein Absender, den Sie manuell blockiert haben, und eine Liste, von der Sie sich abgemeldet haben, halten die E-Mail im Spam, egal was die Regel sagt.
provider stammt aus dem Zustellweg, den wir verifizieren: dem Server, der sich mit uns verbunden hat (Reverse-DNS, in Vorwärtsrichtung bestätigt), und SPF, das über den eigenen Adressbereich des Providers besteht. Der MX-Eintrag wird nie verwendet: Jeder kann MX auf Google zeigen lassen und von seinem eigenen Server senden.
Werte
in_list akzeptiert eine durch Komma, Semikolon oder Zeilenumbruch getrennte Liste. In Adresslisten trifft @acme.com auf jeden mit dieser Domain zu. regex verwendet RE2: kein Lookahead, Lookbehind oder Backreferences, bis zu 300 Zeichen. Textvergleiche ignorieren Groß-/Kleinschreibung.
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_ARGSEin erforderliches Argument fehlt oder ist ungültig.
- CMD
INVALID_RULEDie Regel ist ungültig. Die Meldung nennt die Bedingung oder Aktion und den Grund.
- CMD
LIMITDas Postfach hat das Limit erreicht (100 Regeln, 200 Templates oder 100 Labels).
- CMD
INTERNALServerfehler. Die Details werden nur ins Server-Log geschrieben.