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.
https://g.sendcorex.com/v1command: create_ruleLa 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
namestringobligatoireJusqu'à 80 caractères.
conditionsobject[]obligatoire[{ field, op, value, header? }]. De 1 à 20 (exceptions comprises).matchstringfacultatifall(par défaut) ouanydes conditions.exceptobject[]facultatifSi l'une d'elles correspond, la règle ne s'exécute pas.
actionsobject[]obligatoire[{ type, value? }]. De 1 à 12. Un seulmove.stopbooleanfacultatifN'exécute pas les règles suivantes quand celle-ci correspond.
enabledbooleanfacultatifPar défaut
true.timezonestringfacultatifNom IANA utilisé par
received_hour,received_weekdayetnext_morning. Par défaut UTC.presetstringfacultatifVotre 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_totexte : contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty
from_domaindomaine : is (correspond aussi aux sous-domaines), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex
to / cc / recipientliste d'adresses (recipient = to + cc). Mêmes opérateurs que texte ; correspond dès qu'une adresse correspond
subject / body / subject_or_bodytexte. Le corps est lu jusqu'aux 20 000 premiers caractères
attachment_name / attachment_typeliste. attachment_type est l'extension : pdf, xlsx…
list_idtexte. Le List-Id d'une liste de diffusion
headertexte, avec le nom du header dans
header(ex. x-mailer). Vérifié uniquement à l'arrivée de l'e-mailprovideris_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 (dans le fuseau horaire de la règle)
received_hourgt, lt, between, not_between.
22-6passe minuitsize_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
Actions
movevalue : inbox, archive, spam, trash, promotions ou custom:<folder-id>. La première règle qui déplace l'emporte
keep_inboxToujours la Boîte de réception : jamais Spam, le tri (Agents / NotSubscribing) ni Promotions
mark_read / star / importantIndicateurs. Ils se cumulent entre les règles
labelvalue : le nom du libellé (1–50 caractères). Les libellés se cumulent entre les règles
trust_sender / block_senderEnregistre l'expéditeur comme fiable ou bloqué pour les prochains e-mails. block_sender déplace aussi vers Spam
snoozevalue : 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_replyvalue : un id de template. Une réponse par expéditeur toutes les 24 heures
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.
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.
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.
- 401
TOKEN_EXPIREDL'access token a expiré. Appelez Refresh Token et relancez la requête.
- 401
INVALID_TOKENLe token est mal formé, inconnu ou révoqué.
- 429
RATE_LIMITEDPlus 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.
- CMD
INVALID_ARGSUn argument obligatoire est manquant ou invalide.
- CMD
INVALID_RULELa règle n'est pas valide. Le message indique quelle condition ou action, et pourquoi.
- CMD
LIMITLa boîte aux lettres a atteint la limite (100 règles, 200 templates ou 100 libellés).
- CMD
INTERNALErreur serveur. Le détail est uniquement écrit dans le log du serveur.