Recibir correos

Lee correos con la API

Lee los correos que llegan a tu dominio desde tu propio código. Lista conversaciones, abre mensajes, busca, etiqueta, organiza, envía y responde, todo a través de un solo endpoint.

  • REST
  • JSON
  • Hilos y búsqueda
  • Etiquetas y carpetas
  • Enviar y responder
Hosthttps://g.sendcorex.com

Cómo funciona

Un token, un buzón

Tu token pertenece a un remitente, y un remitente es un buzón. Ningún argumento elige de quién son los correos que lees: lo decide el token.

Un endpoint para todo

Listar, leer, buscar, marcar, mover, enviar y responder son comandos que se envían a POST /v1. Envía hasta 20 por solicitud.

Tokens de corta duración

El access token dura 1 hora y el refresh token 15 días. El refresh token rota cada vez que lo usas.

Configura tu buzón

Haz esto una vez. Después, cada solicitud solo necesita tu token.

  1. 1

    Añade un dominio o usa uno compartido

    Verifica tu propio dominio, o sáltate la configuración de DNS y usa un dominio compartido.

  2. 2

    Crea un remitente

    Un remitente es un buzón. Crea uno en tu dominio verificado o en un dominio compartido: en un dominio compartido, crear el remitente crea el buzón.

    Si registraste tu propio dominio y ya enviaste un correo, el remitente se creó automáticamente.

  3. 3

    Apunta tu registro MX

    Solo es necesario si quieres recibir correo en tu propio dominio. Apunta el registro MX al host de entrada de Sendcorex.

  4. 4

    Genera tus tokens

    Abre el webmail, ve a Configuración y genera un access token y un refresh token para el remitente.

  5. 5

    Llama a la API

    Envía tu token en el header Authorization y tu primer comando a POST /v1.

Registro MX

Para recibir correo en tu propio dominio, su registro MX debe apuntar al host de entrada de Sendcorex. Añade este registro en tu proveedor de DNS.

  • TipoMX
  • Apunta abounce.emailsbit.com
i

El registro MX solo sirve para recibir en tu propio dominio. Sin él, igual puedes enviar y leer los rebotes y las quejas que vuelven a tu buzón.

Qué llega al buzón

Correos normales

Todo lo que se envía a la dirección de tu remitente, como en cualquier buzón.

Mensajes del return path

Los rebotes y otros mensajes que vuelven al return path también se guardan en el buzón, así que puedes leerlos con la API.

Quejas

Las quejas de spam también se guardan en el buzón. Solo llegan de Microsoft 365 y de los servicios de Microsoft en general.

Tu primera solicitud

Lista las conversaciones no leídas de tu INBOX. Reemplaza SENDCOREX_TOKEN por el access token de la configuración del webmail.

curl -X POST 'https://g.sendcorex.com/v1' \
  -H "Authorization: $SENDCOREX_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "commands": [
    { "command": "list_threads", "args": { "folder": "INBOX", "is_read": false, "limit": 10 } }
  ]
}'

Cada hilo tiene un last_message_uid. Pásalo a Obtener mensajes para leer el correo, o a Responder para responderlo.

Referencia completa

Todo lo marcado como CMD es un comando enviado por POST /v1, hasta 20 por solicitud. Las rutas usan sus propias rutas.

Rutas

4

Identidad

1

Carpetas y contadores

5

Lectura

5

Flags y etiquetas

8

Organizar

4

Envío y confianza

9

Adjuntos

4

Programación

3

Borradores

5

Reglas

10

Plantillas

6

Contacto y seguimiento

5

Contactos y público

12

Newsletters

4