Recibir correos: Envío y confianza
Responder
Responde dentro de la misma conversación. La respuesta se guarda en Enviados e INBOX, y el asunto pasa a ser Re: original.
https://g.sendcorex.com/v1command: replyEl destinatario es el reply_to (o from) del mensaje original. Si el id es un mensaje que enviaste tú, la respuesta va al último cliente que escribió en la conversación, no a ti. Las etiquetas del original se conservan.
Los destinatarios que rechazaron el seguimiento en la página de preferencias nunca se rastrean, incluso con true.
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.
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.
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
idstringobligatorioEl
message_uiddel mensaje al que respondes.htmlstringopcionalCuerpo HTML. Envía
htmlotext.textstringopcionalCuerpo en texto plano.
reply_allbooleanopcionalTodos los que están en To y Cc del original van en Cc, excepto tú y la persona a la que respondes.
ccstring[]opcionalDestinatarios adicionales en copia.
bccstring[]opcionalDestinatarios adicionales en copia oculta.
template_idstringopcionalRellena el cuerpo desde una plantilla.
attachmentsobject[]opcionalArchivos en base64, mismo formato que Enviar correo.
compose_uidstringopcionalAdjuntos subidos antes con
upload_attachment.followup_atstringopcionalTe avisa si nadie responde antes de esta fecha. Sin él, se elimina un recordatorio que ya estuviera en la conversación (acabas de responder).
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.recipientstringopcionalSolo en correos que este buzón envió: quién recibe el seguimiento, en la misma conversación con “Re:”. La persona debe haber recibido ese correo (si no,
INVALID_RECIPIENT). Sin él, la respuesta a un correo enviado va a su destinatario, nunca de vuelta al buzón.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "reply",
args: {
id: "Vj0xQUJDMTIz",
text: "Received, thank you!",
reply_all: true
}
}
]
},
{ 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": "reply",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "<5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90>",
"queued": true
}
}
]
}Campos de la respuesta
message_uidEl id de la respuesta.
thread_idLa misma conversación que el mensaje original.
message_idUn Message-ID provisional, que el SMTP real reemplaza poco después.
queuedtrue= guardado y en cola, no entregado.
Responder al último correo de un remitente
Busca por remitente y responde al resultado más reciente. La búsqueda devuelve primero el mensaje más reciente.
Node.js
const [s] = await call({
command: 'search',
args: { query: 'ana@client.com', field: 'from', limit: 5 },
});
const last = s.data.messages[0]; // newest first
if (last) {
const [r] = await call({
command: 'reply',
args: { id: last.message_uid, html: '<p>Hi Ana, received!</p>' },
});
console.log(r.data); // { message_uid, thread_id, message_id, queued: true }
}Responder a todas las conversaciones no leídas
Responde y marca la conversación como leída en la misma solicitud, para que el siguiente polling no vuelva a responderla.
Node.js
const [l] = await call({ command: 'list_threads', args: { is_read: false, limit: 20 } });
for (const t of l.data.threads) {
await call([
{ command: 'reply', args: { id: t.last_message_uid, text: 'We got your message and will get back to you.' } },
{ command: 'set_flags', args: { id: t.last_message_uid, is_read: true, scope: 'thread' } },
]);
}También puedes encadenar list_threads y reply en una solicitud con $ref, usando el last_message_uid de cada hilo.
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_RECIPIENTFalta el destinatario o no es un correo válido.
- CMD
RECIPIENT_UNSUBSCRIBEDUno 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`.
- CMD
INVALID_ARGSFalta un argumento obligatorio o no es válido.
- CMD
NOT_FOUNDEl mensaje, la conversación o la carpeta no existe para este token.
- CMD
NO_RECIPIENTLa conversación no tiene destinatario al que responder.
- CMD
RECIPIENT_LIMIT_EXCEEDEDto, cc y bcc juntos tienen más de 50 direcciones.
- 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
NO_CREDITSLa cuenta tiene menos créditos de correo que destinatarios (1 crédito por copia).
- CMD
SENDER_NOT_FOUNDEl remitente del token no está registrado.
- CMD
SENDER_NO_DOMAINEl remitente del token no tiene dominio.
- CMD
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.