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.

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

Die 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

  • namestringerforderlich

    Bis zu 80 Zeichen.

  • conditionsobject[]erforderlich

    [{ field, op, value, header? }]. 1 bis 20 (einschließlich Ausnahmen).

  • matchstringoptional

    all (Standard) oder any der Bedingungen.

  • exceptobject[]optional

    Wenn eine davon zutrifft, läuft die Regel nicht.

  • actionsobject[]erforderlich

    [{ type, value? }]. 1 bis 12. Nur ein move.

  • stopbooleanoptional

    Die Regeln darunter nicht ausführen, wenn diese zutrifft.

  • enabledbooleanoptional

    Standard ist true.

  • timezonestringoptional

    IANA-Name, der von received_hour, received_weekday und next_morning verwendet wird. Standard ist UTC.

  • presetstringoptional

    Ihr 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_to

    Text: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty

  • from_domain

    Domain: is (trifft auch auf Subdomains zu), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex

  • to / cc / recipient

    Adressliste (recipient = to + cc). Gleiche Operatoren wie Text; trifft zu, wenn irgendeine Adresse zutrifft

  • subject / body / subject_or_body

    Text. Der Inhalt wird bis zu den ersten 20.000 Zeichen gelesen

  • attachment_name / attachment_type

    Liste. attachment_type ist die Dateiendung: pdf, xlsx…

  • list_id

    Text. Die List-Id einer Mailingliste

  • header

    Text, mit dem Header-Namen in header (z. B. x-mailer). Wird nur beim Eingang der E-Mail geprüft

  • provider

    is_any_of / is_none_of: google_workspace, gmail, microsoft_365, outlook, yahoo, icloud, zoho, proton, amazon_ses, sendgrid, mailgun, other

  • received_weekday

    is_any_of / is_none_of: sun, mon, tue, wed, thu, fri, sat (in der Zeitzone der Regel)

  • received_hour

    gt, lt, between, not_between. 22-6 geht über Mitternacht

  • size_kb

    gt, 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_me

    is_true / is_false

Aktionen

  • move

    value: inbox, archive, spam, trash, promotions oder custom:<folder-id>. Die erste Regel, die verschiebt, gewinnt

  • keep_inbox

    Immer Posteingang: nie Spam, Vorsortierung (Agents / NotSubscribing) oder Promotions

  • mark_read / star / important

    Flags. Sie summieren sich über Regeln hinweg

  • label

    value: der Label-Name (1–50 Zeichen). Labels summieren sich über Regeln hinweg

  • trust_sender / block_sender

    Speichert den Absender für die nächsten E-Mails als vertrauenswürdig oder blockiert. block_sender verschiebt außerdem nach Spam

  • snooze

    value: 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_reply

    value: eine Template-ID. Eine Antwort pro Absender alle 24 Stunden

i

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.

i

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.

i

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.

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

    Ein erforderliches Argument fehlt oder ist ungültig.

  • CMDINVALID_RULE

    Die Regel ist ungültig. Die Meldung nennt die Bedingung oder Aktion und den Grund.

  • CMDLIMIT

    Das Postfach hat das Limit erreicht (100 Regeln, 200 Templates oder 100 Labels).

  • CMDINTERNAL

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