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.