Receber e-mails: Regras
Criar regra
Crie um filtro que roda em todo e-mail novo: compare por remetente, domínio, provedor, assunto, corpo, anexos, horário e mais, e então mova, marque, sinalize, adie ou responda.
https://g.sendcorex.com/v1command: create_ruleA nova regra vai para o fim da lista. As regras rodam em ordem; stop: true pula as regras abaixo quando ela bate.
Uma regra não pode tirar um e-mail do Spam, confiar no remetente ou bloqueá-lo, nem responder automaticamente, a menos que o domínio do From tenha passado em SPF ou DKIM alinhado (ou DMARC). Qualquer um pode escrever From: boss@yourcompany.com; sem essa verificação, esse e-mail escaparia dos seus filtros ou bloquearia o seu chefe.
Argumentos
namestringobrigatórioAté 80 caracteres.
conditionsobject[]obrigatório[{ field, op, value, header? }]. De 1 a 20 (contando as exceções).matchstringopcionalall(padrão) ouanydas condições.exceptobject[]opcionalSe alguma destas bater, a regra não roda.
actionsobject[]obrigatório[{ type, value? }]. De 1 a 12. Só ummove.stopbooleanopcionalNão roda as regras abaixo quando esta bater.
enabledbooleanopcionalO padrão é
true.timezonestringopcionalNome IANA usado por
received_hour,received_weekdayenext_morning. O padrão é UTC.presetstringopcionalSua própria tag para regras criadas a partir de um template.
Início rápido
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);Resposta
{
"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"
}
}
]
}Campos e operadores
from / from_name / reply_totexto: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty
from_domaindomínio: is (também bate com subdomínios), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex
to / cc / recipientlista de endereços (recipient = to + cc). Mesmos operadores de texto; bate quando qualquer endereço bate
subject / body / subject_or_bodytexto. O corpo é lido até os primeiros 20.000 caracteres
attachment_name / attachment_typelista. attachment_type é a extensão: pdf, xlsx…
list_idtexto. O List-Id de uma lista de e-mails
headertexto, com o nome do header em
header(ex.: x-mailer). Só verificado quando o e-mail chegaprovideris_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 (no fuso horário da regra)
received_hourgt, lt, between, not_between.
22-6atravessa a meia-noitesize_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
Ações
movevalue: inbox, archive, spam, trash, promotions ou custom:<folder-id>. A primeira regra que move vence
keep_inboxSempre Caixa de entrada: nunca Spam, triagem (Agents / NotSubscribing) ou Promotions
mark_read / star / importantFlags. Elas se somam entre regras
labelvalue: o nome do marcador (1–50 caracteres). Os marcadores se somam entre regras
trust_sender / block_senderSalva o remetente como confiável ou bloqueado para os próximos e-mails. block_sender também move para Spam
snoozevalue: horas (1 a 8760) ou next_morning (próximas 8:00 no fuso horário da regra). Só para e-mails que ficam na Caixa de entrada
auto_replyvalue: um id de template. Uma resposta por remetente a cada 24 horas
Quando várias regras batem: o primeiro move vence, marcadores e flags se somam, e block_sender prevalece sobre trust_sender.
O que uma regra não pode sobrescrever
Uma regra não pode tirar um e-mail do Spam, confiar no remetente ou bloqueá-lo, nem responder automaticamente, a menos que o domínio do From tenha passado em SPF ou DKIM alinhado (ou DMARC). Qualquer um pode escrever From: boss@yourcompany.com; sem essa verificação, esse e-mail escaparia dos seus filtros ou bloquearia o seu chefe.
Marcadores, lida, estrela e mover para Spam ou Lixeira sempre se aplicam. Denúncias de phishing, quarentena DMARC, um remetente que você bloqueou manualmente e uma lista da qual você cancelou a inscrição mantêm o e-mail no Spam, diga a regra o que disser.
provider vem do caminho de entrega que nós verificamos: o servidor que se conectou a nós (DNS reverso confirmado no sentido direto) e o SPF passando pela faixa do próprio provedor. O registro MX nunca é usado: qualquer um pode apontar o MX para o Google e enviar do próprio servidor.
Valores
in_list recebe uma lista separada por vírgula, ponto e vírgula ou quebra de linha. Em listas de endereços, @acme.com bate com qualquer pessoa desse domínio. regex usa RE2: sem lookahead, lookbehind ou backreferences, até 300 caracteres. Comparações de texto ignoram maiúsculas e minúsculas.
Erros
Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.
- 401
TOKEN_EXPIREDO access token expirou. Chame Refresh Token e repita a requisição.
- 401
INVALID_TOKENO token está malformado, é desconhecido ou foi revogado.
- 429
RATE_LIMITEDMais de 15 requisições/s ou 15 em andamento para o mesmo IP + caixa de correio. Espere o número de segundos indicado em Retry-After.
- CMD
INVALID_ARGSUm argumento obrigatório está ausente ou é inválido.
- CMD
INVALID_RULEA regra não é válida. A mensagem diz qual condição ou ação e por quê.
- CMD
LIMITA caixa de correio atingiu o limite (100 regras, 200 templates ou 100 marcadores).
- CMD
INTERNALErro no servidor. O detalhe só é gravado no log do servidor.