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.

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

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

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

  • idstringobligatorio

    El message_uid del mensaje al que respondes.

  • htmlstringopcional

    Cuerpo HTML. Envía html o text.

  • textstringopcional

    Cuerpo en texto plano.

  • reply_allbooleanopcional

    Todos los que están en To y Cc del original van en Cc, excepto tú y la persona a la que respondes.

  • ccstring[]opcional

    Destinatarios adicionales en copia.

  • bccstring[]opcional

    Destinatarios adicionales en copia oculta.

  • template_idstringopcional

    Rellena el cuerpo desde una plantilla.

  • attachmentsobject[]opcional

    Archivos en base64, mismo formato que Enviar correo.

  • compose_uidstringopcional

    Adjuntos subidos antes con upload_attachment.

  • followup_atstringopcional

    Te 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_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.

  • recipientstringopcional

    Solo 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_uid

    El id de la respuesta.

  • thread_id

    La misma conversación que el mensaje original.

  • message_id

    Un Message-ID provisional, que el SMTP real reemplaza poco después.

  • queued

    true = 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' } },
  ]);
}
i

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.

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

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

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

  • CMDINVALID_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDNOT_FOUND

    El mensaje, la conversación o la carpeta no existe para este token.

  • CMDNO_RECIPIENT

    La conversación no tiene destinatario al que responder.

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

  • CMDNO_CREDITS

    La cuenta tiene menos créditos de correo que destinatarios (1 crédito por copia).

  • CMDSENDER_NOT_FOUND

    El remitente del token no está registrado.

  • CMDSENDER_NO_DOMAIN

    El remitente del token no tiene dominio.

  • CMDINTERNAL

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