Ingestión y entrega de correo electrónico
La función de ingesta y entrega de correo electrónico define cómo los usuarios que han iniciado sesión y tienen credenciales guardadas sincronizan el correo electrónico entrante y ponen en cola los envíos salientes. Le brinda un orden de uso claro: inicie sesión, establezca las credenciales y luego ejecute las operaciones IMAP y SMTP.
Por qué esto importa
Esta función almacena los datos de correo electrónico del proveedor en una forma de cuenta consistente para que las lecturas y escrituras sean predecibles en los flujos IMAP y SMTP. Separa la búsqueda de metadatos de la recuperación de partes y cuerpo completo, y vincula las acciones del proveedor con tareas y trabajos para un comportamiento de reintento claro.
Flujo central
Después de iniciar sesión, el cliente utiliza las credenciales guardadas para sincronizar buzones o mensajes de IMAP. Inbox Manager almacena mensajes y datos de piezas, los clientes buscan y leen lo que necesitan y los envíos salientes SMTP se ponen en cola mientras se realiza un seguimiento de los resultados a través de tareas, trabajos y registros.
Operaciones
| Operación | Punto final | Objetivo |
|---|---|---|
| Sincronizar buzones | POST /api/accounts/:account_id/imap/sync-mailboxes | Sincronización de buzones de correo en cola |
| Sincronizar mensajes | POST /api/accounts/:account_id/imap/sync-messages | Sincronización de mensajes en cola |
| Enviar mensaje SMTP | POST /api/accounts/:account_id/smtp/messages | Poner en cola el envío de mensajes salientes |
| Listar correos electrónicos | GET /api/accounts/:account_id/emails | Listar metadatos de correo electrónico de la cuenta |
| Buscar correos electrónicos | POST /api/accounts/:account_id/emails/search | Consultar correos electrónicos por campos indexados |
| Eliminar correos electrónicos mediante búsqueda | POST /api/accounts/:account_id/emails/search-delete | Eliminación masiva de registros de correo electrónico coincidentes |
| Crear registro de correo electrónico | POST /api/accounts/:account_id/emails | Crear registro de correo electrónico explícitamente |
| Obtener correo electrónico | GET /api/emails/:email_id | Recuperar un registro de correo electrónico |
| Actualizar correo electrónico | PATCH /api/emails/:email_id | Actualizar campos de correo electrónico mutables |
| Eliminar correo electrónico | DELETE /api/emails/:email_id | Eliminar un registro de correo electrónico |
| Obtener todo el cuerpo | GET /api/accounts/:account_id/emails/:email_id/body | Recuperar el cuerpo del mensaje analizado |
| Listar partes | GET /api/accounts/:account_id/emails/:email_id/parts | Recuperar metadatos de parte del mensaje |
| Obtener contenido parcial | GET /api/accounts/:account_id/emails/:email_id/parts/:part_id/content | Recuperar contenido decodificado para una parte |
Datos clave y estado
| Artículo | Objetivo | Vinculado a |
|---|---|---|
email_message | Datos de mensajes entrantes/salientes almacenados | task, job, credencial de proveedor |
email_message_part | Datos de piezas para archivos adjuntos e incrustados | email_message |
email_message_part_content | Carga útil de la pieza decodificada | email_message_part |
task | Operación del proveedor solicitado | job |
Modos de falla y controles
Las fallas de sincronización o envío del proveedor se detectan a través del estado de la tarea/trabajo y de los registros de auditoría en lugar de caídas silenciosas. Las rutas con ámbito de cuenta rechazan las discrepancias entre cuentas, la búsqueda y eliminación permanece explícita y con alcance, y la recuperación del contenido del cuerpo o parte permanece en endpoints dedicados para evitar una recuperación excesiva accidental durante las operaciones de lista o búsqueda.
Relacionado
Mensaje de correo electrónico, Parte del mensaje de correo electrónico, Contenido de la parte del mensaje de correo electrónico, Tarea, IMAP Guía de sincronización, Guía de búsqueda y lectura, Enviar guía de correo electrónico saliente.