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
https://g.sendcorex.comCó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
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
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
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
Genera tus tokens
Abre el webmail, ve a Configuración y genera un access token y un refresh token para el remitente.
- 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.
- Tipo
MX - Apunta a
bounce.emailsbit.com
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
4Identidad
1Carpetas y contadores
5Lectura
5Flags y etiquetas
8- CMDEstablecer flagsLeído, destacado, importante
- CMDAñadir etiquetasEtiquetas sin distinguir mayúsculas
- CMDQuitar etiquetasEtiquetas sin distinguir mayúsculas
- CMDMarcar imágenes como cargadasQuita el flag de imágenes externas
- CMDListar etiquetasNombres y colores
- CMDCrear etiquetaNueva etiqueta
- CMDCambiar color de etiquetaCambia el color
- CMDEliminar etiquetaDe todos los mensajes
Organizar
4Envío y confianza
9- CMDEnviar correoMensaje nuevo, guardado en Enviados
- CMDResponderMisma conversación, conserva las etiquetas
- CMDObtener confianzaEstado de confianza de un remitente
- CMDEstablecer confianzaPredeterminado, de confianza o no confiable
- CMDListar confianzaRemitentes con una decisión
- CMDReenviarAdjuntos originales incluidos
- CMDObtener seguimientoAperturas y clics de los correos enviados
- CMDListar actividadQuién abrió, hizo clic o se dio de baja
- CMDContadores de actividadInsignias de las carpetas de Actividad
Adjuntos
4Programación
3Borradores
5Reglas
10- CMDListar reglasEn orden de ejecución, con hits
- CMDObtener reglaUna regla
- CMDCrear reglaFiltros para cada correo nuevo
- CMDActualizar reglaReemplaza la regla
- CMDEliminar reglaQuita una regla
- CMDActivar o desactivar reglaActivada o desactivada
- CMDReordenar reglasOrden de ejecución
- CMDOpciones de reglasCampos, operadores, acciones
- CMDProbar reglaPrueba con correos recientes
- CMDAplicar reglaSe ejecuta en los correos que ya están
Plantillas
6Contacto y seguimiento
5Contactos y público
12- CMDListar contactosPersonas que hablan con este buzón
- CMDContar contactosCuántas personas cumplen un filtro
- CMDVer contacto del buzónUn contacto con contadores y confianza
- CMDActualizar nombre del contactoCambiar el nombre de un contacto
- CMDEtiquetar contactoAñadir o quitar etiquetas
- CMDVer historial del contactoAperturas, clics y correos de un contacto
- CMDListar segmentosSegmentos guardados del buzón
- CMDGuardar segmentoCrear o editar un segmento
- CMDBorrar segmentoBorrar un segmento
- CMDVer públicoTamaño de un público antes de enviar
- CMDComprobar destinatariosQuién se dio de baja, antes de enviar
- CMDVer estado de entregaEntrega por destinatario de un correo enviado