Recibir correos: Envío y confianza
Reenviar
Reenvía un mensaje a otra persona. Los adjuntos originales van con él, y el correo se guarda en la misma conversación en Enviados.
https://g.sendcorex.com/v1command: forwardEl asunto pasa a ser Fwd: original y se añade debajo de tu texto un bloque Forwarded message con el correo original. El reenvío no devuelve la conversación a la Bandeja de entrada.
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 que se reenvía.tostringobligatorioQuién recibe el reenvío.
to_namestringopcionalNombre del destinatario.
ccstring[]opcionalCopias visibles. to + cc + bcc hasta 50 direcciones.
bccstring[]opcionalCopias ocultas.
htmlstringopcionalTu texto encima del correo reenviado. Envía
htmlotext.textstringopcionalVersión en texto plano de tu nota.
include_attachmentsbooleanopcionalEnvía los adjuntos originales. Por defecto
true.quote_originalbooleanopcionalAñade el bloque Forwarded message. Por defecto
true.attachmentsobject[]opcionalArchivos para adjuntar:
[{ file_name, content, content_type }],contenten base64. Hasta 20 archivos y 25 MB en total. Se analiza cada archivo; uno peligroso falla conFILE_BLOCKED.compose_uidstringopcionalAdjuntos que subiste antes con
upload_attachment.attachment_idsstring[]opcionalCuáles de los adjuntos subidos enviar. 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.
Inicio rápido
import axios from 'axios';
const response = await axios.post(
'https://g.sendcorex.com/v1',
{
commands: [
{
command: "forward",
args: {
id: "Vj0xQUJDMTIz",
to: "finance@acme.com",
html: "<p>Can you check this invoice?</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": "forward",
"id": "0",
"type": "SUCCESS",
"data": {
"message_uid": "Vj0xQUJDMTIz",
"thread_id": "thr_9a1c4e72",
"message_id": "5e0b9c1a-3d7f-4a21-9a6e-2f1c8d4b7e90",
"recipients": 1,
"queued": true
}
}
]
}Campos de la respuesta
message_uidEl id del reenvío en Enviados.
recipientsCuántas copias se pusieron en cola (1 crédito cada una).
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
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
INVALID_RECIPIENTFalta el destinatario o no es un correo válido.
- 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
FILE_BLOCKEDEl análisis de seguridad bloqueó un archivo.
- 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
INTERNALError del servidor. El detalle solo se escribe en el log del servidor.