Recevoir des e-mails : Règles

Créer une règle

Créez un filtre qui s'exécute sur chaque nouvel e-mail : correspondance par expéditeur, domaine, fournisseur, objet, corps, pièces jointes, heure et plus, puis déplacement, libellé, indicateur, mise en attente ou réponse.

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

La nouvelle règle est ajoutée en fin de liste. Les règles s'exécutent dans l'ordre ; stop: true ignore les règles suivantes quand elle correspond.

!

Une règle ne peut pas sortir un e-mail du Spam, faire confiance à l'expéditeur ou le bloquer, ni répondre automatiquement, sauf si le domaine du From a passé SPF ou DKIM aligné (ou DMARC). N'importe qui peut écrire From: boss@yourcompany.com ; sans cette vérification, cet e-mail contournerait vos filtres ou bloquerait votre patron.

Arguments

  • namestringobligatoire

    Jusqu'à 80 caractères.

  • conditionsobject[]obligatoire

    [{ field, op, value, header? }]. De 1 à 20 (exceptions comprises).

  • matchstringfacultatif

    all (par défaut) ou any des conditions.

  • exceptobject[]facultatif

    Si l'une d'elles correspond, la règle ne s'exécute pas.

  • actionsobject[]obligatoire

    [{ type, value? }]. De 1 à 12. Un seul move.

  • stopbooleanfacultatif

    N'exécute pas les règles suivantes quand celle-ci correspond.

  • enabledbooleanfacultatif

    Par défaut true.

  • timezonestringfacultatif

    Nom IANA utilisé par received_hour, received_weekday et next_morning. Par défaut UTC.

  • presetstringfacultatif

    Votre propre tag pour les règles créées à partir d'un template.

Démarrage rapide

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);

Réponse

{
  "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"
      }
    }
  ]
}

Champs et opérateurs

  • from / from_name / reply_to

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

  • from_domain

    domaine : is (correspond aussi aux sous-domaines), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex

  • to / cc / recipient

    liste d'adresses (recipient = to + cc). Mêmes opérateurs que texte ; correspond dès qu'une adresse correspond

  • subject / body / subject_or_body

    texte. Le corps est lu jusqu'aux 20 000 premiers caractères

  • attachment_name / attachment_type

    liste. attachment_type est l'extension : pdf, xlsx…

  • list_id

    texte. Le List-Id d'une liste de diffusion

  • header

    texte, avec le nom du header dans header (ex. x-mailer). Vérifié uniquement à l'arrivée de l'e-mail

  • 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 (dans le fuseau horaire de la règle)

  • received_hour

    gt, lt, between, not_between. 22-6 passe minuit

  • 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

Actions

  • move

    value : inbox, archive, spam, trash, promotions ou custom:<folder-id>. La première règle qui déplace l'emporte

  • keep_inbox

    Toujours la Boîte de réception : jamais Spam, le tri (Agents / NotSubscribing) ni Promotions

  • mark_read / star / important

    Indicateurs. Ils se cumulent entre les règles

  • label

    value : le nom du libellé (1–50 caractères). Les libellés se cumulent entre les règles

  • trust_sender / block_sender

    Enregistre l'expéditeur comme fiable ou bloqué pour les prochains e-mails. block_sender déplace aussi vers Spam

  • snooze

    value : heures (1 à 8760) ou next_morning (prochain 8:00 dans le fuseau horaire de la règle). Uniquement pour les e-mails qui restent dans la Boîte de réception

  • auto_reply

    value : un id de template. Une réponse par expéditeur toutes les 24 heures

i

Quand plusieurs règles correspondent : le premier move l'emporte, les libellés et indicateurs se cumulent, et block_sender prime sur trust_sender.

Ce qu'une règle ne peut pas outrepasser

!

Une règle ne peut pas sortir un e-mail du Spam, faire confiance à l'expéditeur ou le bloquer, ni répondre automatiquement, sauf si le domaine du From a passé SPF ou DKIM aligné (ou DMARC). N'importe qui peut écrire From: boss@yourcompany.com ; sans cette vérification, cet e-mail contournerait vos filtres ou bloquerait votre patron.

i

Les libellés, lu, étoile et le déplacement vers Spam ou Corbeille s'appliquent toujours. Les signalements de phishing, la quarantaine DMARC, un expéditeur que vous avez bloqué manuellement et une liste dont vous vous êtes désabonné gardent l'e-mail dans Spam, quoi que dise la règle.

i

provider provient du chemin de remise que nous vérifions : le serveur qui s'est connecté à nous (DNS inverse confirmé dans le sens direct) et SPF validé via la plage propre au fournisseur. L'enregistrement MX n'est jamais utilisé : n'importe qui peut pointer son MX vers Google et envoyer depuis son propre serveur.

Valeurs

in_list accepte une liste séparée par des virgules, des points-virgules ou des retours à la ligne. Dans les listes d'adresses, @acme.com correspond à toute personne de ce domaine. regex utilise RE2 : pas de lookahead, lookbehind ni backreferences, jusqu'à 300 caractères. Les comparaisons de texte ignorent la casse.

Erreurs

Les erreurs au niveau HTTP renvoient type, code et message. Les erreurs marquées CMD reviennent dans le résultat de la commande, avec HTTP 200.

  • 401TOKEN_EXPIRED

    L'access token a expiré. Appelez Refresh Token et relancez la requête.

  • 401INVALID_TOKEN

    Le token est mal formé, inconnu ou révoqué.

  • 429RATE_LIMITED

    Plus de 15 requêtes/s ou 15 en cours pour la même IP + boîte aux lettres. Attendez le nombre de secondes indiqué dans Retry-After.

  • CMDINVALID_ARGS

    Un argument obligatoire est manquant ou invalide.

  • CMDINVALID_RULE

    La règle n'est pas valide. Le message indique quelle condition ou action, et pourquoi.

  • CMDLIMIT

    La boîte aux lettres a atteint la limite (100 règles, 200 templates ou 100 libellés).

  • CMDINTERNAL

    Erreur serveur. Le détail est uniquement écrit dans le log du serveur.