Recibir correos: Lectura

Listar hilos

Lista las conversaciones de una carpeta, al estilo de Gmail, con filtros de no leídos, destacados, importantes, adjuntos y fechas.

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

Cada elemento es una conversación. Ábrela con get_thread o get_messages usando su last_message_uid.

Argumentos

  • folderstringopcional

    Carpeta que se lista. Por defecto INBOX.

  • limitnumberopcional

    Tamaño de página, de 1 a 100. Por defecto 25.

  • cursorstringopcional

    El next_cursor de la página anterior.

  • is_readbooleanopcional

    false devuelve solo conversaciones con algún mensaje no leído.

  • is_starredbooleanopcional

    Filtra por destacado.

  • is_importantbooleanopcional

    Filtra por importancia.

  • has_attachmentsbooleanopcional

    Filtra por adjuntos.

  • afterstringopcional

    Solo conversaciones cuyo último mensaje es de esta fecha en adelante (inclusive). RFC 3339, YYYY-MM-DD (UTC) o epoch en milisegundos.

    p. ej. "2026-10-01"

  • beforestringopcional

    Solo conversaciones cuyo último mensaje es anterior a esta fecha (exclusive). Mismos formatos que after.

    p. ej. "2026-10-08T00:00:00+08:00"

Inicio rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1',
  {
    commands: [
      {
        command: "list_threads",
        args: {
          folder: "INBOX",
          is_read: false,
          limit: 20
        }
      }
    ]
  },
  { 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": "list_threads",
      "id": "0",
      "type": "SUCCESS",
      "data": {
        "threads": [
          {
            "thread_id": "thr_9a1c4e72",
            "folder": "INBOX",
            "subject": "Invoice for September",
            "preview": "Hi, attached is the invoice for September…",
            "from_name": "Ana Costa",
            "from_email": "ana@client.com",
            "participants": [
              "ana@client.com",
              "you@yourdomain.com"
            ],
            "last_senders": [
              "ana@client.com"
            ],
            "message_count": 2,
            "thread_message_count": 3,
            "unread_count": 1,
            "has_unread": true,
            "has_starred": false,
            "has_important": false,
            "has_attachments": false,
            "last_message_uid": "Vj0xQUJDMTIz",
            "last_message_at": "2026-10-09T14:21:07Z"
          }
        ],
        "has_more": true,
        "next_cursor": "eyJwIjoyfQ"
      }
    }
  ]
}

Campos de la respuesta

  • threads[].thread_id

    El id de la conversación.

  • threads[].folder

    La carpeta que se lista.

  • threads[].subject

    Asunto de la conversación.

  • threads[].preview

    Vista previa breve del último mensaje.

  • threads[].from_name / from_email

    Remitente del último mensaje.

  • threads[].participants

    Todos los participantes de la conversación.

  • threads[].last_senders

    Quién escribió los últimos mensajes.

  • threads[].message_count

    Mensajes en esta carpeta.

  • threads[].thread_message_count

    Mensajes en toda la conversación.

  • threads[].unread_count / has_unread

    Mensajes no leídos en la conversación.

  • threads[].has_starred / has_important / has_attachments

    Flags de la conversación.

  • threads[].last_message_uid

    El id para abrir la conversación con get_messages o get_thread.

  • threads[].last_message_at

    Fecha del último mensaje.

  • has_more / next_cursor

    Paginación. Envía next_cursor como cursor para obtener la página siguiente.

Filtros y velocidad

is_read: false, is_starred: true e is_important: true usan su propio índice, así que solo se examinan las conversaciones que coinciden, no toda la carpeta. Si los combinas, se usa un índice (destacado, luego importante, luego no leído) y el resto se filtra sobre él. after y before son rangos de claves, así que no se recorre nada fuera del periodo. has_attachments y los valores false de destacado e importante siguen recorriendo la carpeta.

Conversaciones no leídas en un rango de fechas

{
  "commands": [
    {
      "command": "list_threads",
      "args": {
        "is_read": false,
        "after": "2026-10-01",
        "before": "2026-10-08T00:00:00+08:00"
      }
    }
  ]
}

Paginación

Cuando has_more sea true, vuelve a llamar al comando con cursor igual a next_cursor.

Node.js

let cursor;
const threads = [];

do {
  const [result] = await call({
    command: 'list_threads',
    args: { folder: 'INBOX', limit: 100, ...(cursor ? { cursor } : {}) },
  });
  threads.push(...result.data.threads);
  cursor = result.data.has_more ? result.data.next_cursor : null;
} while (cursor);
i

call es cualquier helper que hace POST de { commands: [...] } a /v1 y devuelve results, como en Run Commands.

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_ARGS

    Falta un argumento obligatorio o no es válido.

  • CMDINVALID_CURSOR

    El cursor está mal formado o pertenece a otra cuenta o carpeta.

  • CMDINTERNAL

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