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.
https://g.sendcorex.com/v1command: create_ruleLa 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
namestringobligatorioHasta 80 caracteres.
conditionsobject[]obligatorio[{ field, op, value, header? }]. De 1 a 20 (contando las excepciones).matchstringopcionalall(por defecto) oanyde las condiciones.exceptobject[]opcionalSi alguna de estas coincide, la regla no se ejecuta.
actionsobject[]obligatorio[{ type, value? }]. De 1 a 12. Solo unmove.stopbooleanopcionalNo ejecuta las reglas de abajo cuando esta coincide.
enabledbooleanopcionalPor defecto
true.timezonestringopcionalNombre IANA usado por
received_hour,received_weekdayynext_morning. Por defecto UTC.presetstringopcionalTu 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_totexto: contains, not_contains, is, is_not, starts_with, ends_with, regex, not_regex, in_list, not_in_list, is_empty, not_empty
from_domaindominio: is (también coincide con subdominios), is_not, in_list, not_in_list, contains, not_contains, ends_with, regex, not_regex
to / cc / recipientlista de direcciones (recipient = to + cc). Mismos operadores que texto; coincide cuando coincide cualquier dirección
subject / body / subject_or_bodytexto. El cuerpo se lee hasta los primeros 20.000 caracteres
attachment_name / attachment_typelista. attachment_type es la extensión: pdf, xlsx…
list_idtexto. El List-Id de una lista de correo
headertexto, con el nombre del header en
header(p. ej. x-mailer). Solo se comprueba cuando llega el correoprovideris_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 (en la zona horaria de la regla)
received_hourgt, lt, between, not_between.
22-6cruza la medianochesize_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
Acciones
movevalue: inbox, archive, spam, trash, promotions o custom:<folder-id>. Gana la primera regla que mueve
keep_inboxSiempre Bandeja de entrada: nunca Spam, filtrado (Agents / NotSubscribing) ni Promotions
mark_read / star / importantFlags. Se suman entre reglas
labelvalue: el nombre de la etiqueta (1–50 caracteres). Las etiquetas se suman entre reglas
trust_sender / block_senderGuarda al remitente como de confianza o bloqueado para los próximos correos. block_sender también mueve a Spam
snoozevalue: 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_replyvalue: un id de plantilla. Una respuesta por remitente cada 24 horas
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.
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.
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.
- 401
TOKEN_EXPIREDEl access token expiró. Llama a Refresh Token y repite la solicitud.
- 401
INVALID_TOKENEl token está mal formado, es desconocido o fue revocado.
- 429
RATE_LIMITEDMás de 15 solicitudes/s o 15 en curso para la misma IP + buzón. Espera la cantidad de segundos indicada en Retry-After.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
INVALID_RULELa regla no es válida. El mensaje indica qué condición o acción y por qué.
- CMD
LIMITEl buzón llegó al límite (100 reglas, 200 plantillas o 100 etiquetas).
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.