Ingestion et livraison d’e-mails
La fonctionnalité d’ingestion et de livraison d’e-mails définit la manière dont les utilisateurs connectés avec des informations d’identification enregistrées synchronisent les e-mails entrants et mettent en file d’attente les envois sortants. Il vous donne un ordre d’utilisation clair : connectez-vous, définissez les informations d’identification, puis exécutez les opérations IMAP et SMTP.
Pourquoi c’est important
Cette fonctionnalité stocke les données de messagerie du fournisseur sous une forme de compte cohérente afin que les lectures et les écritures restent prévisibles sur les flux IMAP et SMTP. Il sépare la recherche de métadonnées de la récupération complète du corps et des parties, et lie les actions du fournisseur aux tâches et aux travaux pour un comportement clair en matière de nouvelle tentative.
Flux de base
Une fois connecté, le client utilise les informations d’identification enregistrées pour synchroniser les boîtes aux lettres ou les messages depuis IMAP. Inbox Manager stocke les données des messages et des pièces, les clients recherchent et lisent ce dont ils ont besoin, et les envois SMTP sortants sont mis en file d’attente tandis que les résultats sont suivis via des tâches, des tâches et des journaux.
Opérations
| Opération | Point de terminaison | Objectif |
|---|---|---|
| Synchroniser les boîtes aux lettres | POST /api/accounts/:account_id/imap/sync-mailboxes | Synchronisation des boîtes aux lettres en file d’attente |
| Synchroniser les messages | POST /api/accounts/:account_id/imap/sync-messages | Synchronisation des messages en file d’attente |
| Envoyer un message SMTP | POST /api/accounts/:account_id/smtp/messages | Mettre en file d’attente l’envoi des messages sortants |
| Liste des e-mails | GET /api/accounts/:account_id/emails | Répertorier les métadonnées de messagerie du compte |
| Rechercher des e-mails | POST /api/accounts/:account_id/emails/search | Interroger les e-mails par champs indexés |
| Supprimer les e-mails par recherche | POST /api/accounts/:account_id/emails/search-delete | Supprimer en masse les enregistrements d’e-mails correspondants |
| Créer un enregistrement de courrier électronique | POST /api/accounts/:account_id/emails | Créer explicitement un enregistrement de courrier électronique |
| Recevoir un e-mail | GET /api/emails/:email_id | Récupérer un enregistrement d’e-mail |
| Mettre à jour l’e-mail | PATCH /api/emails/:email_id | Mettre à jour les champs d’e-mail mutables |
| Supprimer l’e-mail | DELETE /api/emails/:email_id | Supprimer un enregistrement de courrier électronique |
| Obtenez tout le corps | GET /api/accounts/:account_id/emails/:email_id/body | Récupérer le corps du message analysé |
| Liste des pièces | GET /api/accounts/:account_id/emails/:email_id/parts | Récupérer les métadonnées des parties de message |
| Obtenir le contenu de la pièce | GET /api/accounts/:account_id/emails/:email_id/parts/:part_id/content | Récupérer le contenu décodé pour une partie |
Données clés et état| Article | Objectif | Lié à |
| ---------------------------- | ------------------------------------ | ---------------------------------- |
| email_message | Données de messages entrants/sortants stockées | task, job, informations d’identification du fournisseur |
| email_message_part | Données de pièce pour les pièces jointes et les intégrations | email_message |
| email_message_part_content | Charge utile de la pièce décodée | email_message_part |
| task | Opération du fournisseur demandée | job |
Modes de défaillance et contrôles
Les échecs de synchronisation ou d’envoi du fournisseur sont signalés via l’état des tâches/tâches et les pistes d’audit plutôt que par des suppressions silencieuses. Les routes au niveau du compte rejettent les incompatibilités de compte, la suppression de la recherche reste explicite et limitée, et la récupération du corps ou d’une partie du contenu reste sur des points de terminaison dédiés pour éviter toute récupération excessive accidentelle lors des opérations de liste ou de recherche.
Connexes
[Message e-mail] (/fr/types/email-message), [Partie du message e-mail] (/fr/types/email-message-part), [Contenu de la partie du message e-mail] (/fr/types/email-message-part-content), [Tâche] (/fr/types/task), [Guide de synchronisation IMAP] (/fr/guides/04-imap-sync-mailboxes-and-messages), [Guide de recherche et de lecture] (/fr/guides/05-search-read-body-and-parts), [Guide d’envoi des e-mails sortants] (/fr/guides/06-send-outbound-email).