LinkedIn
Instagram
WhatsApp
Telegram
Google Agenda
Rejoindre la communauté SlackConstruction d'un API d'e-mail multi-fournisseur L'intégration qui fonctionne sur Gmail, Outlook et IMAP est l'un des défis les plus longs pour les équipes de développement. Chaque fournisseur propose son propre flux OAuth, ses limites de débit et son modèle de données. API unifiée pour les e-mails résume tout cela en une seule interface REST - vous écrivez donc une seule intégration et bénéficiez d'une couverture pour toutes les boîtes de réception majeures sur lesquelles vos utilisateurs comptent.
Ce que vous apprendrez
Guide complet de l'API d'e-mail
Apprenez comment Gmail, Outlook et IMAP collaborent sous une API REST unifiée.
Pourquoi les développeurs ont-ils besoin d'une API d'e-mail multi-fournisseurs
La plupart des produits SaaS doivent éventuellement lire ou envoyer des e-mails au nom de leurs utilisateurs. Le problème n'est pas le concept, mais l'exécution. Gmail utilise l'API Gmail avec Google OAuth 2.0. Outlook utilise Microsoft Graph avec son propre cycle de vie de jeton. Les fournisseurs basés sur IMAP se comportent chacun différemment. La création et la maintenance de trois intégrations distinctes épuisent les cycles d'ingénierie qui devraient être consacrés à votre produit principal. Si vous traitez spécifiquement des comptes IMAP, le Guide de l'API IMAP couvre la complexité supplémentaire impliquée. A API unifiée pour les e-mails résout cela en effaçant toute la complexité spécifique au fournisseur derrière une seule interface - c'est la promesse fondamentale d'un API d'e-mail multi-fournisseur approche. Pour une référence technique complète sur la façon de API d'envoi d'e-mails appels via Gmail, Outlook et IMAP, consultez notre guide dédié.
Le 3 fournisseurs d'emails couvert
Une API unifiée normalise Gmail, Outlook et IMAP en une interface identique. Votre code ne change jamais lorsqu'un utilisateur connecte un fournisseur différent.
Connectez n'importe quel compte Gmail ou Google Workspace via Google OAuth 2.0. Envoyez, lisez, recherchez et synchronisez les fils de discussion en temps réel via la couche Unipile – aucune information d'identification directe de l'API Gmail requise dans votre application.
Prend en charge les comptes Outlook personnels, Microsoft 365 et Exchange Online sous un seul gestionnaire de fournisseur. Microsoft OAuth est géré par Unipile – votre intégration reste stable quelles que soient les configurations de locataire.
Toute boîte aux lettres accessible via IMAP - Yahoo, Fastmail, ProtonMail Bridge, serveurs d'entreprise personnalisés - devient instantanément accessible via la même surface d'API utilisée pour Gmail et Outlook.
Unipile contre le construire toi-même
Quel est le coût réel d'un projet de bricolage de API d'e-mail multi-fournisseur intégration ? Voici une comparaison honnête des dimensions qui comptent en production. C'est pourquoi les équipes choisissent de plus en plus une API unifiée pour les e-mails comme Unipile au lieu de construire chaque intégration de fournisseur à partir de zéro. Pour une comparaison côte à côte de toutes les options disponibles, consultez notre comparaison de 6 fournisseurs d'API d'e-mail.
Comment la l'intégration travaux
La connexion de votre premier compte e-mail avec Unipile se fait en quatre étapes. Le même flux fonctionne que l'utilisateur ait un compte Gmail, Outlook ou Compte IMAP - votre code d'application reste identique tout au long. C'est la puissance pratique d'une API d'e-mail unifiée : écrivez une fois, couvrez les trois fournisseurs.
Votre backend appelle l'API Unipile pour créer une URL d'authentification hébergée de courte durée. Redirigez l'utilisateur vers cette URL - Unipile présente l'écran de sélection du fournisseur et gère le flux OAuth complet en votre nom.
// POST /api/v1/hébergés/comptes/lier const rés = await fetch('https://api5.unipile.com:13515/api/v1/hébergé/comptes/lien', méthode : POST, en-têtes : { 'X-API-KEY': process.env.CLÉ_API_UNIPILE, 'Content-Type': 'application/json' }, corps: JSON.stringify({ type: 'COURRIEL', filtre_prestataires: ['Google', 'MICROSOFT', 'IMAP'], url_de_redirection_succès: 'https://votreapplication.com/auth/succès' }) }); const { url } = await res.json(); // redirige_utilisateur_vers `url`
Une fois que l'utilisateur a terminé le processus OAuth, Unipile déclenche un webhook vers votre point de terminaison (ou ajoute l'ID du compte à votre URL de redirection). Stockez cet ID de compte – c'est votre référence permanente à ce compte lié, indépendamment du fournisseur.
{
"événement": "compte.connecté",
"account_id": "acc_01HXYZ...",
"fournisseur": "GOOGLE",
"courriel": "alice@gmail.com"
}
Utilisez l'ID du compte pour lister, rechercher et récupérer les e-mails. Ceci est le API unifiée pour les e-mails en action : le schéma de réponse est identique que le compte soit Gmail, Outlook ou IMAP – votre logique d'analyse ne se ramifie jamais en fonction du fournisseur.
// GET /api/v1/emails?account_id=acc_01HXYZ... const emails = await fetch( `https://api5.unipile.com:13515/api/v1/emails?account_id=${accountId}&limite=20`, { en-tête : { 'X-API-KEY': process.env.CLÉ_API_UNIPILE } } ).puis(r => r.json()); // Même forme de réponse pour Gmail, Outlook, IMAP : // { id, sujet, de, à, date, corps, pièces jointes }
Un seul point de terminaison POST envoie des e-mails quel que soit le fournisseur de messagerie, c'est toute la puissance d'un API d'e-mail multi-fournisseur. Transmettez l'identifiant du compte, le destinataire, l'objet et le corps - Unipile transite par l'API Gmail, Microsoft Graph ou le SMTP selon le cas. C'est le API unifiée pour les e-mails sous sa forme la plus concrète : un point de terminaison, trois fournisseurs, zéro branchement dans votre code.
// POST /api/v1/emails/envoyer await fetch('https://api5.unipile.com:13515/api/v1/emails/send', méthode : POST, en-têtes : { 'X-API-KEY': process.env.CLÉ_API_UNIPILE, 'Content-Type': 'application/json' }, corps: JSON.stringify({ account_id: 'acc_01HXYZ...', à: [{ l'email: 'bob@example.com' }], sujet: 'Bonjour de la part d'Unipile', corps: 'Fonctionne avec Gmail, Outlook et IMAP.
' }) });
Comment abstraction de fournisseur travaux
L'API d'e-mail unifiée se situe entre votre application et les trois protocoles fournisseurs sous-jacents, traduisant les flux OAuth, les schémas de données et les modèles de limites de débit divergents en une interface cohérente unique.
Gmail utilise Google OAuth 2.0 avec un cycle de rafraîchissement de jeton spécifique et renvoie les e-mails dans un modèle centré sur les fils de discussion avec des libellés. Outlook utilise Microsoft Graph avec un modèle de locataire OAuth différent et renvoie les e-mails sous forme d'objets de message individuels avec des dossiers. Les serveurs IMAP ont chacun leurs propres paramètres de connexion, méthodes d'authentification et ensembles de capacités.
Unipile's API unifiée pour les e-mails normalise les trois en une seule interface REST. Votre code appelle /api/v1/emails et reçoit des objets de réponse de forme identique, que le compte sous-jacent soit un compte Gmail, Outlook ou IMAP. Il en va de même pour l'envoi, la gestion des pièces jointes, les événements de webhook et la gestion du cycle de vie du compte.
C'est le principal avantage technique du API d'e-mail multi-fournisseur la complexité est absorbée au niveau de l'infrastructure, pas dans votre code d'application. Lorsque Google modifie ses exigences en matière de portée OAuth ou que Microsoft met à jour la pagination de l'API Graph, Unipile gère le changement en amont - votre intégration reste intacte.
Sécurité et conformité
Lorsque votre application gère des courriels pour le compte d'utilisateurs, la sécurité n'est pas une option. Voici comment la couche API unifiée de messagerie gère les identifiants, les données et les obligations de conformité.
Unipile stocke et rafraîchit les jetons OAuth en votre nom. Votre application ne manipule jamais d'identifiants bruts ; vous travaillez uniquement avec des identifiants de compte opaques. La rotation des jetons, la détection d'expiration et les flux de réauthentification sont entièrement gérés au niveau de l'infrastructure.
Toutes les données en transit utilisent TLS 1.3. Les identifiants stockés sont chiffrés au repos avec AES-256. Le contenu des e-mails récupéré via l'API unifiée de messagerie est traité en mémoire et n'est pas conservé au-delà de ce que votre intégration demande explicitement.
Unipile est certifié SOC 2 Type II (octobre 2025). Des auditeurs indépendants ont vérifié la sécurité, la disponibilité et la confidentialité de la plateforme. Les rapports d'audit sont disponibles sur demande pour les clients d'entreprise qui évaluent l'API d'email multi-fournisseurs pour un usage en production.
Des accords de traitement des données sont disponibles pour tous les forfaits. L’option de résidence des données dans l’UE est proposée aux clients ayant des exigences de localisation des données. Le droit à l’effacement est pris en charge via l’API : la suppression d’un compte lié supprime tous les jetons et données mis en cache associés.
Évaluation de la sécurité des applications Google Cloud. Valide les contrôles de sécurité des applications qui accèdent aux données des utilisateurs Google, y compris les champs d'application OAuth Gmail. Les applications construites sur Unipile héritent de cette certification.
L'historique de disponibilité et d'incidents est disponible publiquement sur status.unipile.com. Toutes les modifications de l'API suivent une politique de versionnement avec des notifications de dépréciation. Aucune modification cassante silencieuse : votre intégration est protégée par un contrat stable et documenté.
Manipulation cas limites entre fournisseurs
Chaque intégration d'e-mails de production rencontre des cas limites spécifiques au fournisseur. Voici une comparaison entre une approche « fait maison » (DIY) et l'utilisation d'une API d'e-mails unifiée lorsque les choses se compliquent.
| Scénario | Approche bricolage | Approche Unipile |
|---|---|---|
| Limite de débit Gmail 250 unités de quota par jour, niveau gratuit |
Suivi manuel des quotas par compte ; les requêtes échouent silencieusement si elles ne sont pas surveillées | Géré automatiquement Mise en file d'attente intégrée, aucune requête échouée n'a été signalée à votre application |
| Expiration du jeton OAuth | Implémentez une logique de rafraîchissement distincte par fournisseur ; la rotation des jetons diffère entre Google et Microsoft | Rafraîchissement automatique Gestion des jetons sans interruption sur tous les fournisseurs |
| La connexion IMAP tombe | Logique de reconnexion personnalisée par configuration de serveur ; les délais d'attente varient selon les implémentations IMAP | Pool de connexions géré Connexions persistantes maintenues par l'infrastructure Unipile |
| Limites de taille des pièces jointes Gmail 25 Mo, Outlook 150 Mo, IMAP varie |
Code de branchement par fournisseur ; doit suivre la limite de chaque fournisseur et la mettre à jour lorsqu'elle change | Validation unifiée Validation de taille indépendante du fournisseur ; erreurs renvoyées dans un schéma cohérent |
| Changements de l'API du fournisseur | Votre responsabilité de garde ; Google et Microsoft introduisent des changements perturbateurs avec un préavis limité | Géré par l'équipe Unipile Changements en amont absorbés au niveau de l'infrastructure ; votre intégration reste stable |
Limite de débit Gmail
250 unités de quota par jour, niveau gratuitSuivi manuel des quotas par compte ; les requêtes échouent silencieusement si elles ne sont pas surveillées
Le guide des piliers couvre tous les points de terminaison de notre API unifiée pour les e-mails En profondeur - flux d'authentification, gestion des pièces jointes, synchronisation des dossiers, filtres de recherche et configuration des webhooks. Tout ce dont vous avez besoin pour construire une intégration d'e-mails en production.
Commun cas d'utilisation
Une API unifiée pour les e-mails est une infrastructure fondamentale pour une large gamme de catégories de produits. Avec un API d'e-mail multi-fournisseur, les équipes déploient des fonctionnalités plus rapidement et servent plus d'utilisateurs, quel que soit leur fournisseur de messagerie. Voici les modèles les plus fréquemment créés avec Unipile.
Récupérez automatiquement chaque e-mail client dans vos fiches CRM. Les commerciaux voient l'historique complet des conversations sans jamais avoir à changer d'onglet ou à transférer manuellement.
Envoyez des séquences de suivi personnalisées depuis les boîtes de réception réelles de vos utilisateurs - pas un domaine d'envoi partagé - sur les comptes Gmail et Outlook simultanément.
Les recruteurs associent leur email professionnel et leurs journaux ATS à chaque fil de discussion de candidat automatiquement. Répondez directement depuis l'interface ATS, acheminé via leur vrai compte Outlook ou Gmail.
Créez une boîte de réception partagée ou un centre d'assistance qui consolide les e-mails de plusieurs comptes d'équipe. Routez, attribuez et répondez, le tout via une interface unique prise en charge par une API unique.
Alimentez les fils d'e-mails dans un LLM pour générer des brouillons de réponses, des résumés ou des éléments d'action. Unipile fournit les données normalisées des fils ; votre couche IA s'occupe du raisonnement.
Déclenchez des flux de travail sans code à partir de nouveaux e-mails, quel que soit le fournisseur. Un webhook est déclenché pour chaque message entrant, votre plateforme d'automatisation s'occupe du reste sans interroger.
Chacun de ces modèles fonctionne sur Gmail, Outlook et IMAP avec zéro code spécifique au fournisseur dans votre application. Unipile normalise les différences afin que la logique de votre produit reste claire et que vos utilisateurs puissent se connecter à la boîte de réception de leur choix. Pour une présentation complète de chaque point de terminaison, consultez guide API de messagerie unifié.
Foire aux questions questions
Tout ce que les développeurs demandent avant d'intégrer une API d'e-mail multi-fournisseurs.
id, sujet, from, à, date, ou encore corps ont la même structure quel que soit le fournisseur. Votre logique d'analyse, vos modèles de base de données et votre traitement en aval n'ont jamais besoin de se ramifier en fonction du type de fournisseur.
FR 
EN 
ES 
DE 
IT 
BR 
NL 
PL 
TR