Recibir correos: Reglas

Crear regla

Crea un filtro que se ejecuta con cada correo nuevo: busca coincidencias por remitente, dominio, proveedor, asunto, cuerpo, adjuntos, hora y más, y luego mueve, etiqueta, marca, pospone o responde.

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

La nueva regla va al final de la lista. Las reglas se ejecutan en orden; stop: true omite las reglas de abajo cuando coincide.

!

Una regla no puede sacar un correo de Spam, confiar en el remitente o bloquearlo, ni responder automáticamente, a menos que el dominio del From haya pasado SPF o DKIM alineado (o DMARC). Cualquiera puede escribir From: boss@yourcompany.com; sin esta comprobación, ese correo se saltaría tus filtros o bloquearía a tu jefe.

Argumentos

  • namestringobligatorio

    Hasta 80 caracteres.

  • conditionsobject[]obligatorio

    [{ field, op, value, header? }]. De 1 a 20 (contando las excepciones).

  • matchstringopcional

    all (por defecto) o any de las condiciones.

  • exceptobject[]opcional

    Si alguna de estas coincide, la regla no se ejecuta.

  • actionsobject[]obligatorio

    [{ type, value? }]. De 1 a 12. Solo un move.

  • stopbooleanopcional

    No ejecuta las reglas de abajo cuando esta coincide.

  • enabledbooleanopcional

    Por defecto true.

  • timezonestringopcional

    Nombre IANA usado por received_hour, received_weekday y next_morning. Por defecto UTC.

  • presetstringopcional

    Tu propia etiqueta para reglas creadas desde una plantilla.

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

Respuesta

{
  "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 y 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

    dominio: is (también coincide con subdominios), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex

  • to / cc / recipient

    lista de direcciones (recipient = to + cc). Mismos operadores que texto; coincide cuando coincide cualquier dirección

  • subject / body / subject_or_body

    texto. El cuerpo se lee hasta los primeros 20.000 caracteres

  • attachment_name / attachment_type

    lista. attachment_type es la extensión: pdf, xlsx…

  • list_id

    texto. El List-Id de una lista de correo

  • header

    texto, con el nombre del header en header (p. ej. x-mailer). Solo se comprueba cuando llega el correo

  • 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 (en la zona horaria de la regla)

  • received_hour

    gt, lt, between, not_between. 22-6 cruza la medianoche

  • 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

Acciones

  • move

    value: inbox, archive, spam, trash, promotions o custom:<folder-id>. Gana la primera regla que mueve

  • keep_inbox

    Siempre Bandeja de entrada: nunca Spam, filtrado (Agents / NotSubscribing) ni Promotions

  • mark_read / star / important

    Flags. Se suman entre reglas

  • label

    value: el nombre de la etiqueta (1–50 caracteres). Las etiquetas se suman entre reglas

  • trust_sender / block_sender

    Guarda al remitente como de confianza o bloqueado para los próximos correos. block_sender también mueve a Spam

  • snooze

    value: horas (1 a 8760) o next_morning (próximas 8:00 en la zona horaria de la regla). Solo para correos que se quedan en la Bandeja de entrada

  • auto_reply

    value: un id de plantilla. Una respuesta por remitente cada 24 horas

i

Cuando coinciden varias reglas: gana el primer move, las etiquetas y los flags se suman, y block_sender prevalece sobre trust_sender.

Lo que una regla no puede anular

!

Una regla no puede sacar un correo de Spam, confiar en el remitente o bloquearlo, ni responder automáticamente, a menos que el dominio del From haya pasado SPF o DKIM alineado (o DMARC). Cualquiera puede escribir From: boss@yourcompany.com; sin esta comprobación, ese correo se saltaría tus filtros o bloquearía a tu jefe.

i

Las etiquetas, leído, destacado y mover a Spam o Papelera siempre se aplican. Los reportes de phishing, la cuarentena DMARC, un remitente que bloqueaste a mano y una lista de la que te diste de baja mantienen el correo en Spam diga lo que diga la regla.

i

provider sale de la ruta de entrega que verificamos: el servidor que se conectó a nosotros (DNS inverso confirmado en sentido directo) y SPF pasando por el rango propio del proveedor. El registro MX nunca se usa: cualquiera puede apuntar el MX a Google y enviar desde su propio servidor.

Valores

in_list acepta una lista separada por comas, punto y coma o saltos de línea. En listas de direcciones, @acme.com coincide con cualquiera de ese dominio. regex usa RE2: sin lookahead, lookbehind ni backreferences, hasta 300 caracteres. Las comparaciones de texto ignoran mayúsculas.

Errores

Los errores a nivel HTTP devuelven type, code y message. Los errores marcados con CMD vuelven dentro del resultado del comando, con HTTP 200.

  • 401TOKEN_EXPIRED

    El access token expiró. Llama a Refresh Token y repite la solicitud.

  • 401INVALID_TOKEN

    El token está mal formado, es desconocido o fue revocado.

  • 429RATE_LIMITED

    Más de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINVALID_RULE

    La regla no es válida. El mensaje indica qué condición o acción y por qué.

  • CMDLIMIT

    El buzón llegó al límite (100 reglas, 200 plantillas o 100 etiquetas).

  • CMDINTERNAL

    Error del servidor. El detalle solo se escribe en el log del servidor.