Recibir correos: Programación

Programar envío

Escribe el correo ahora y envíalo más tarde. Espera en la carpeta Scheduled hasta la hora que elijas.

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

Todo lo que se puede comprobar se comprueba ahora (destinatario, asunto, correo original, adjuntos), para que te enteres antes de que llegue la hora. Los créditos y el límite diario se comprueban al enviar.

i

Si el envío se rechaza en ese momento (sin créditos, límite diario, spam), no se pierde nada: el correo vuelve a Borradores con el motivo.

i

Los destinatarios que rechazaron el seguimiento en la página de preferencias nunca se rastrean, incluso con true.

i

Los correos enviados desde el buzón no llevan la cabecera List-Unsubscribe ni enlace de baja, salvo que envíes unsubscribe: true, porque son correos personales.

i

Toda persona que recibe un correo del buzón pasa a ser un contacto de la lista “Webmail” de la cuenta y queda como trusted en este buzón: sus respuestas van a la Inbox y la dirección aparece en el autocompletado. Quien el buzón bloqueó sigue bloqueado.

i

Con unsubscribe: true, los destinatarios que ya se dieron de baja de este buzón se rechazan con RECIPIENT_UNSUBSCRIBED, y recipients los lista. Las respuestas nunca se bloquean.

Argumentos

  • send_atstringobligatorio

    RFC 3339, YYYY-MM-DD o epoch ms. Al menos 1 minuto a partir de ahora y hasta 1 año.

  • modestringopcional

    new (por defecto), reply o forward.

  • idstringopcional

    El mensaje original, para reply y forward.

  • tostring | string[]opcional

    Destinatario. Obligatorio en new y forward. En new puede ser una lista de hasta 30 (planes de pago).

  • ccstring[]opcional

    Copias visibles.

  • bccstring[]opcional

    Copias ocultas.

  • subjectstringopcional

    Obligatorio para new. Reply y forward usan por defecto Re: / Fwd: original.

  • htmlstringopcional

    Cuerpo HTML. O text, o template_id.

  • template_idstringopcional

    Rellena el cuerpo (y el asunto de un correo nuevo) desde una plantilla.

  • followup_after_hoursnumberopcional

    Te avisa si nadie responde tantas horas después del envío.

  • scheduled_idstringopcional

    Reprogramar: el correo programado anterior se reemplaza.

  • attachmentsobject[]opcional

    Archivos para adjuntar: [{ file_name, content, content_type }], content en base64. Hasta 20 archivos y 25 MB en total. Se analiza cada archivo; uno peligroso falla con FILE_BLOCKED.

  • compose_uidstringopcional

    Adjuntos que subiste antes con upload_attachment.

  • attachment_idsstring[]opcional

    Cuáles de los adjuntos subidos enviar. Sin él, todos.

  • track_opensbooleanopcional

    Registra cuándo cada destinatario abre el correo (píxel invisible). Por defecto true.

  • track_clicksbooleanopcional

    Registra los clics en los enlaces (cada enlace pasa por una redirección). Por defecto true.

  • unsubscribebooleanopcional

    Añade un enlace de baja. Pon [unsubscribe] en el cuerpo (en el href de un enlace o como texto) donde debe ir el enlace; sin él, se añade una línea por defecto al final. Por defecto false.

  • audiencestringopcional

    Envía a un público en lugar de direcciones: subscribed, opened, clicked, both, seg:<segment_id> o msg:<message_uid>:opened|clicked|not_opened. to pasa a ser opcional. Hasta 5.000 personas. El enlace de baja se activa y el correo sale como marketing. Planes de pago.

  • best_timebooleanopcional

    Envía a cada persona a la hora en que suele abrir o hacer clic, durante el día de send_at. Necesita audience y mode: new. send_at es las 00:00 de ese día en tu zona horaria, en UTC.

  • best_fallback_atstring | numberopcional

    Hora para quienes no tienen historial (RFC 3339 o epoch ms). Debe ser el mismo día que send_at.

Inicio rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "schedule_send",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>",
          send_at: "2026-10-27T09:00:00+08:00"
        }
      }
    ]
  },
  { 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": "schedule_send",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "scheduled_id": "Vj0xQUJDMTIz",
        "thread_id": "thr_9a1c4e72",
        "send_at": "2026-10-27T01:00:00Z"
      }
    }
  ]
}

Campos de la respuesta

  • scheduled_id

    El mensaje en Scheduled. Úsalo para cancelar, reprogramar o enviar ahora.

Listar lo programado

Los correos programados están en la carpeta Scheduled, ordenados por hora de envío.

Body de la solicitud

{
  "commands": [
    {
      "command": "list_messages",
      "args": {
        "folder": "Scheduled"
      }
    }
  ]
}

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_AUDIENCE

    El público no es válido: grupo desconocido, segmento de otro buzón o mensaje que este buzón no envió.

  • CMDAUDIENCE_OVER_LIMIT

    El público tiene más personas de las que puedes enviar (hasta 5.000 por correo y tu límite diario). `total` y `allowed` indican cuántas.

  • CMDEMPTY_AUDIENCE

    No hay nadie en este público ahora.

  • CMDBEST_TIME_NEEDS_AUDIENCE

    `best_time` necesita un `audience` y `mode: new`.

  • CMDRECIPIENT_UNSUBSCRIBED

    Uno o más destinatarios se dieron de baja de este buzón. `recipients` los lista: quítalos o envía de nuevo con `unsubscribe: false`.

  • CMDPAID_PLAN_REQUIRED

    Más de una dirección en `to` requiere un plan de pago.

  • CMDTOO_MANY_RECIPIENTS

    `to` tiene más de 30 direcciones.

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINVALID_TIME

    Falta send_at, faltan menos de 1 minuto o más de 1 año.

  • CMDINVALID_RECIPIENT

    Falta el destinatario o no es un correo válido.

  • CMDMISSING_SUBJECT

    Un correo nuevo necesita asunto.

  • CMDMISSING_TARGET

    Reply y forward necesitan el correo original, y este todavía debe existir.

  • CMDRECIPIENT_LIMIT_EXCEEDED

    to, cc y bcc juntos tienen más de 50 direcciones.

  • CMDFILE_BLOCKED

    El análisis de seguridad bloqueó un archivo.

  • CMDATTACHMENTS_TOO_LARGE

    Los adjuntos del correo suman más de 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.

  • CMDINTERNAL

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