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.
https://g.sendcorex.com/v1command: save_draftUn 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.
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.
Los destinatarios que rechazaron el seguimiento en la página de preferencias nunca se rastrean, incluso con true.
Argumentos
draft_idstringopcionalEdita este borrador en lugar de crear uno nuevo.
modestringopcionalnew(por defecto),replyoforward. Al editar, el borrador conserva su modo.idstringopcionalEl mensaje original, para
replyyforward. El asunto por defecto es Re: / Fwd: original.tostring | string[]opcionalDestinatario, o una lista de hasta 30 para
new(planes de pago). Se ignora enreply: va al remitente del original.ccstring[]opcionalCopias visibles.
bccstring[]opcionalCopias ocultas.
subjectstringopcionalAsunto.
htmlstringopcionalCuerpo HTML. O
text, otemplate_id.textstringopcionalCuerpo en texto plano, convertido a HTML simple.
template_idstringopcionalRellena el cuerpo (y el asunto) desde una plantilla.
variablesobjectopcionalValores para las variables de la plantilla, como
{ "first_name": "Ana" }.followup_after_hoursnumber | nullopcionalTe avisa si nadie responde tantas horas después del envío (hasta 8760).
nulllo elimina.attachmentsobject[]opcionalArchivos para adjuntar:
[{ file_name, content, content_type }],contenten base64. Se añaden a los archivos que ya tiene el borrador.compose_uidstringopcionalArchivos subidos antes con
upload_attachmento Subir archivo grande.attachment_idsstring[]opcionalCuáles de los archivos subidos usar. Sin él, todos.
track_opensbooleanopcionalRegistra cuándo cada destinatario abre el correo (píxel invisible). Por defecto
true.track_clicksbooleanopcionalRegistra los clics en los enlaces (cada enlace pasa por una redirección). Por defecto
true.unsubscribebooleanopcionalAñade un enlace de baja. Pon
[unsubscribe]en el cuerpo (en elhrefde un enlace o como texto) donde debe ir el enlace; sin él, se añade una línea por defecto al final. Por defectofalse.audiencestringopcionalEnvía a un público en lugar de direcciones:
subscribed,opened,clicked,both,seg:<segment_id>omsg:<message_uid>:opened|clicked|not_opened.topasa 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_idEl borrador. Úsalo para editarlo, leerlo, enviarlo o eliminarlo. Cambia en cada guardado.
thread_idLa 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.
- 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_AUDIENCEEl público no es válido: grupo desconocido, segmento de otro buzón o mensaje que este buzón no envió.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
PAID_PLAN_REQUIREDMás de una dirección en `to` requiere un plan de pago.
- CMD
TOO_MANY_RECIPIENTS`to` tiene más de 30 direcciones.
- CMD
DRAFT_NOT_FOUNDEl borrador ya no existe: se envió, se eliminó o se volvió a guardar (cada guardado devuelve un nuevo draft_id).
- CMD
MISSING_TARGETReply y forward necesitan el correo original, y este todavía debe existir.
- CMD
INVALID_RECIPIENTFalta el destinatario o no es un correo válido.
- CMD
INVALID_CCADDRESSUna de las direcciones cc no es un correo válido.
- CMD
INVALID_BCCADDRESSUna de las direcciones bcc no es un correo válido.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 direcciones.
- CMD
INVALID_ATTACHMENTEl contenido de un adjunto no es base64 válido.
- CMD
FILE_BLOCKEDEl análisis de seguridad bloqueó un archivo.
- CMD
ATTACHMENTS_TOO_LARGELos adjuntos del correo suman más de 25 MB, o el buzón ya tiene 500 MB de archivos subidos esperando a enviarse.
- CMD
ATTACHMENT_MISSINGUn 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.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.