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.

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

A 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ório

    Até 80 caracteres.

  • conditionsobject[]obrigatório

    [{ field, op, value, header? }]. De 1 a 20 (contando as exceções).

  • matchstringopcional

    all (padrão) ou any das condições.

  • exceptobject[]opcional

    Se alguma destas bater, a regra não roda.

  • actionsobject[]obrigatório

    [{ type, value? }]. De 1 a 12. Só um move.

  • stopbooleanopcional

    Não roda as regras abaixo quando esta bater.

  • enabledbooleanopcional

    O padrão é true.

  • timezonestringopcional

    Nome IANA usado por received_hour, received_weekday e next_morning. O padrão é UTC.

  • presetstringopcional

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

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

  • from_domain

    domí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 / recipient

    lista de endereços (recipient = to + cc). Mesmos operadores de texto; bate quando qualquer endereço bate

  • subject / body / subject_or_body

    texto. O corpo é lido até os primeiros 20.000 caracteres

  • attachment_name / attachment_type

    lista. attachment_type é a extensão: pdf, xlsx…

  • list_id

    texto. O List-Id de uma lista de e-mails

  • header

    texto, com o nome do header em header (ex.: x-mailer). Só verificado quando o e-mail chega

  • 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 (no fuso horário da regra)

  • received_hour

    gt, lt, between, not_between. 22-6 atravessa a meia-noite

  • 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

Ações

  • move

    value: inbox, archive, spam, trash, promotions ou custom:<folder-id>. A primeira regra que move vence

  • keep_inbox

    Sempre Caixa de entrada: nunca Spam, triagem (Agents / NotSubscribing) ou Promotions

  • mark_read / star / important

    Flags. Elas se somam entre regras

  • label

    value: o nome do marcador (1–50 caracteres). Os marcadores se somam entre regras

  • trust_sender / block_sender

    Salva o remetente como confiável ou bloqueado para os próximos e-mails. block_sender também move para Spam

  • snooze

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

    value: um id de template. Uma resposta por remetente a cada 24 horas

i

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.

i

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.

i

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.

  • 401TOKEN_EXPIRED

    O access token expirou. Chame Refresh Token e repita a requisição.

  • 401INVALID_TOKEN

    O token está malformado, é desconhecido ou foi revogado.

  • 429RATE_LIMITED

    Mais 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.

  • CMDINVALID_ARGS

    Um argumento obrigatório está ausente ou é inválido.

  • CMDINVALID_RULE

    A regra não é válida. A mensagem diz qual condição ou ação e por quê.

  • CMDLIMIT

    A caixa de correio atingiu o limite (100 regras, 200 templates ou 100 marcadores).

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.