Recibir correos: Borradores

Guardar borrador

Guarda un correo en Borradores sin enviarlo. Se abre en el webmail como cualquier otro borrador, y puedes enviarlo después con send_draft.

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

Un borrador puede estar incompleto: todos los campos son opcionales. Lo que envías se comprueba (un to que no es un correo falla); lo que omites, no.

!

Para editar un borrador, envía su draft_id. Los campos que omitas se conservan (cuerpo, destinatarios, asunto, adjuntos, seguimiento). Cada guardado devuelve un NUEVO draft_id y el anterior deja de funcionar, así que guarda siempre el último.

i

Si se omite track_opens o track_clicks, el borrador mantiene la elección que ya tenía. send_draft y el envío programado usan esa elección.

i

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

Argumentos

  • draft_idstringopcional

    Edita este borrador en lugar de crear uno nuevo.

  • modestringopcional

    new (por defecto), reply o forward. Al editar, el borrador conserva su modo.

  • idstringopcional

    El mensaje original, para reply y forward. El asunto por defecto es Re: / Fwd: original.

  • tostring | string[]opcional

    Destinatario, o una lista de hasta 30 para new (planes de pago). Se ignora en reply: va al remitente del original.

  • ccstring[]opcional

    Copias visibles.

  • bccstring[]opcional

    Copias ocultas.

  • subjectstringopcional

    Asunto.

  • htmlstringopcional

    Cuerpo HTML. O text, o template_id.

  • textstringopcional

    Cuerpo en texto plano, convertido a HTML simple.

  • template_idstringopcional

    Rellena el cuerpo (y el asunto) desde una plantilla.

  • variablesobjectopcional

    Valores para las variables de la plantilla, como { "first_name": "Ana" }.

  • followup_after_hoursnumber | nullopcional

    Te avisa si nadie responde tantas horas después del envío (hasta 8760). null lo elimina.

  • attachmentsobject[]opcional

    Archivos para adjuntar: [{ file_name, content, content_type }], content en base64. Se añaden a los archivos que ya tiene el borrador.

  • compose_uidstringopcional

    Archivos subidos antes con upload_attachment o Subir archivo grande.

  • attachment_idsstring[]opcional

    Cuáles de los archivos subidos usar. 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.

Inicio rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "save_draft",
        args: {
          to: "ana@client.com",
          subject: "Proposal",
          html: "<p>Hi Ana, here is the proposal.</p>"
        }
      }
    ]
  },
  { 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": "save_draft",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "draft_id": "Vj0xRFJBRlQx",
        "thread_id": "thr_9a1c4e72"
      }
    }
  ]
}

Campos de la respuesta

  • draft_id

    El borrador. Úsalo para editarlo, leerlo, enviarlo o eliminarlo. Cambia en cada guardado.

  • thread_id

    La conversación a la que pertenece el borrador.

Editar un borrador

Aquí solo cambia el asunto. El cuerpo, los destinatarios y los adjuntos quedan como estaban.

Body de la solicitud

{
  "commands": [
    {
      "command": "save_draft",
      "args": {
        "draft_id": "Vj0xRFJBRlQx",
        "subject": "Proposal (v2)"
      }
    }
  ]
}

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

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

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

  • CMDDRAFT_NOT_FOUND

    El borrador ya no existe: se envió, se eliminó o se volvió a guardar (cada guardado devuelve un nuevo draft_id).

  • CMDMISSING_TARGET

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

  • CMDINVALID_RECIPIENT

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

  • CMDINVALID_CCADDRESS

    Una de las direcciones cc no es un correo válido.

  • CMDINVALID_BCCADDRESS

    Una de las direcciones bcc no es un correo válido.

  • CMDRECIPIENT_LIMIT_EXCEEDED

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

  • CMDINVALID_ATTACHMENT

    El contenido de un adjunto no es base64 válido.

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

  • CMDATTACHMENT_MISSING

    Un adjunto subido ya no existe (los archivos subidos que no se envían en 48 horas, y que no usa un borrador o correo programado, se eliminan). Vuelve a subirlo.

  • CMDINTERNAL

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