LinkedIn
Instagram
WhatsApp
Telegram
Google Agenda
Rejoindre la communauté SlackDonnez à votre SaaS l'accès à Boîtes de réception des utilisateurs via API Email
Une API d'e-mails pour SaaS permet à votre produit de lire, envoyer et synchroniser les e-mails directement depuis les comptes Gmail, Outlook ou IMAP de vos utilisateurs, sans toucher aux mots de passe. Développez des intégrations CRM, des outils de vente, des helpdesks et des assistants IA sur une base OAuth unifiée.
import { UnipileClient } from 'unipile-node-sdk';
const client = new UnipileClient('VOTRE_DSN', 'VOTRE_JETON');
// Lier la boîte de réception d'un utilisateur
const lien = await client.compte.create({
type : 'google',
url_redirection : 'https://app.com/cb'
});
// Rechercher les 50 derniers e-mails
const { éléments } = await client.email.toutObtenir({
account_id : 'identifiant_compte_utilisateur',
limite : 50
});
Envoyer depuis l'adresse de l'utilisateur
await client.email.envoyer({
account_id : 'identifiant_compte_utilisateur',
à : [{ identifiant : 'lead@co.com' }],
sujet : 'Suite à',
body: 'Bonjour, juste pour prendre des nouvelles...'
});
Qu'est-ce qu'une API d'email pour un SaaS ?
La plupart des développeurs entendent "API d'e-mail" et pensent à des outils comme SendGrid ou Mailgun – des services pour envoyer des e-mails transactionnels (reçus, notifications, liens magiques) depuis votre propre domaine. C'est un marché entièrement différent. Une API d'e-mail pour SaaS résout un problème fondamentalement différent : donner à votre produit un accès programmatique aux comptes e-mail de vos utilisateurs.
Un API d'e-mail pour SaaS est un ensemble de points d'accès HTTP qui permet à votre produit de s'authentifier auprès du fournisseur d'e-mails d'un utilisateur (Gmail, Outlook ou IMAP) via OAuth, puis de lire, envoyer, synchroniser et rechercher des e-mails en son nom – le tout via une seule intégration, sans stocker de mots de passe ni gérer les particularités spécifiques à chaque fournisseur.
Envoie des courriels de votre domaine à vos utilisateurs. Utilisé pour les réinitialisations de mot de passe, les factures, les notifications et les campagnes marketing. Votre produit contrôle l'adresse de l'expéditeur.
Donne à votre SaaS accès à les boîtes de réception de vos utilisateurs via OAuth. Votre produit lit, envoie et synchronise les e-mails au nom de chaque utilisateur, depuis son compte Gmail, Outlook ou IMAP.
Quels produits SaaS sont réellement construits avec une API d'e-mail
Tout produit dans lequel les utilisateurs doivent agir sur des e-mails – ou dans lequel des e-mails doivent être intégrés à votre modèle de données – est un candidat idéal pour une API de synchronisation des e-mails. Voici les cinq modèles les plus courants que les développeurs mettent en œuvre avec Unipile.
Capturez automatiquement tous les e-mails échangés entre un commercial et un contact. Pas de saisie manuelle, pas de points de contact manqués. Votre CRM reste à jour sans aucune action de l'utilisateur.
Exécutez des séquences de prospection multi-étapes depuis l'adresse Gmail ou Outlook de chaque représentant – pas un domaine d'envoi partagé. Les réponses arrivent dans la boîte de réception réelle du représentant et sont détectées automatiquement.
Extraire les e-mails de support de plusieurs boîtes de réception d'équipe dans une file d'attente de tickets unifiée. Les réponses envoyées depuis votre interface d'aide sortent via le compte lié de l'agent, préservant ainsi la délivrabilité.
Donnez à votre produit IA l'accès à l'historique complet des e-mails d'un utilisateur. Résumez des fils de discussion, rédigez des réponses, extrayez des éléments d'action ou classez des prospects - le tout basé sur les données réelles de la boîte de réception de l'utilisateur.
Permettez aux utilisateurs de connecter leur boîte de réception pour déclencher des automatisations – créez des tâches à partir d'e-mails, extrayez des données de factures, acheminez les pièces jointes vers le stockage, ou connectez l'e-mail à Slack, Notion, ou votre propre moteur de flux de travail.
Connectez les boîtes de réception des recruteurs à votre ATS. Associez automatiquement les e-mails des candidats aux candidatures d'emploi, suivez les taux de réponse et permettez aux recruteurs de répondre directement depuis leur compte lié sans quitter votre plateforme.
Ce qu'une API d'e-mails de production pour SaaS doit prendre en charge
Créer une intégration d'e-mails fiable va au-delà de l'appel d'un point d'accès REST. Voici les six capacités que toute intégration sérieuse d'API d'e-mails SaaS doit couvrir - et où réside la complexité cachée dans chacune d'elles.
Chaque utilisateur relie sa propre boîte de réception via un consentement OAuth distinct. Votre SaaS agit au nom de chaque utilisateur authentifié - et non via un seul compte de service partagé. Google et Microsoft exigent tous deux une vérification d'application avant que vous ne puissiez émettre des jetons OAuth à grande échelle.
Vos utilisateurs auront des boîtes de réception Gmail, Outlook (personnel et Microsoft 365) et basées sur IMAP. Une API d'e-mail robuste pour SaaS normalise ces trois fournisseurs en un format de réponse unique et unifié donc la logique de votre produit reste indépendante du fournisseur.
Interroger toutes les quelques minutes est fragile et lent. SaaS en production nécessite notifications par webhook lorsque de nouveaux e-mails arrivent ou que l'état du message change. Gmail utilise Pub/Sub, Microsoft Graph utilise des abonnements - votre couche d'API devrait abstraire les deux en un seul format d'événement.
Les clients de messagerie regroupent les messages en fils de discussion. Votre API de messagerie doit exposer un identificateur de fil cohérent entre les fournisseurs afin que vous puissiez répondre dans le fil de discussion, réduire les conversations et détecter si une séquence sortante a reçu une réponse, le tout sans avoir à analyser vous-même les en-têtes bruts de Message-ID.
La lecture des pièces jointes signifie décoder les parties MIME, gérer les images intégrées et télécharger des blobs binaires via des API spécifiques au fournisseur. Le point de terminaison doit vous permettre récupérer les pièces jointes par ID sans retélécharger le corps entier du message à chaque requête.
Les données d'e-mail sont sensibles. Votre intégration doit chiffrement de jeton au repos, autorisations OAuth étendues (demander uniquement ce dont vous avez besoin), journaux d'audit et un chemin de suppression de données documenté pour satisfaire les demandes de droit à l'effacement du RGPD et les audits SOC 2 Type II.
Les coûts cachés de la création de votre propre intégration d'API d'e-mail
Les API Gmail, Microsoft Graph et les bibliothèques IMAP sont toutes gratuites et bien documentées. Alors pourquoi la plupart des équipes SaaS sous-estiment-elles le coût de développement de 3 à 5 fois ? Parce que la complexité ne réside pas dans l'intégration initiale, mais dans tout ce qui suit.
Les applications demandant des champs d'application Gmail au-delà du profil de base doivent être approuvées Évaluation de sécurité de niveau 2 CASA de Google avant de pouvoir accueillir plus de 100 utilisateurs testeurs. Ce processus, qui fait intervenir un laboratoire de sécurité tiers, dure entre 4 et 8 semaines et coûte entre 4 000 et 75 000 TP4T, selon l'étendue des travaux.
Microsoft requiert vérification de l'éditeur pour les applications demandant des étendues d'API Graph à privilèges élevés. Sans cela, chaque utilisateur voit une bannière d'avertissement rouge pendant l'écran de consentement OAuth - un obstacle majeur à la conversion pour les flux d'intégration B2B SaaS.
Il existe des centaines d'implémentations de serveurs IMAP dans la nature. Chacune a ses particularités : noms de dossiers non standard, support IDLE défectueux, cas limites des certificats TLS, comportement des délais de connexion et flux d'authentification spécifiques à chaque serveur. Chaque client entreprise que vous intégrez peut faire apparaître un nouveau cas extrême qui bloque leur équipe.
Les jetons OAuth expirent. Les jetons de rafraîchissement peuvent être révoqués par l'utilisateur ou par la politique du fournisseur. À grande échelle, Gestion du cycle de vie des jetons pour des milliers de comptes liés sur trois fournisseurs nécessite un traitement de fond fiable, une alerte en cas d'échec et un flux d'expérience utilisateur de réauthentification élégant.
Google et Microsoft déprécient et mettent à jour les surfaces d'API. L'authentification de base de Gmail a été supprimée. Microsoft a déprécié les anciens points de terminaison Exchange. Tenir le rythme des journaux de modification de trois fournisseurs représente une charge de maintenance continue qui incombe entièrement à votre équipe d'ingénierie.
Les données d'e-mail sont dans le périmètre du RGPD et du SOC 2 Type II. Vous avez besoin de flux de données documentés, de chiffrement au repos et en transit, de politiques de stockage de jetons et d'un processus de suppression vérifiable. La construction de ceci à partir de zéro pour un audit SaaS peut prendre des semaines. et nécessite un examen juridique.
Création interne vs API d'agrégation d'e-mails pour SaaS
Voici comment intégrer votre propre fournisseur de messagerie se compare à l'utilisation d'une API de messagerie unifiée pour les SaaS dans toutes les dimensions qui importent à l'échelle de production.
| Capacité | Construire en interne | API d'e-mail Unipile |
|---|---|---|
| Intégration OAuth de Gmail | Manuel - CASA Niveau 2 requis |
Inclus - certifié CASA Tier 2 |
| Outlook / Microsoft 365 OAuth | Manuel - vérification de l'éditeur requise |
Inclus - éditeur vérifié |
| Prise en charge IMAP | Construisez-vous - cas limites à grande échelle |
Entièrement abstrait - toutes les particularités du serveur sont gérées |
| Format de réponse unifié | 3 modèles de données distincts à normaliser |
Schéma unique pour tous les fournisseurs |
| Webhooks en temps réel | Pub/Sub + abonnements graphiques - configuration séparée par fournisseur |
Un point de terminaison webhook pour tous les fournisseurs |
| Rafraîchissement du jeton OAuth | Gestion des échecs de votre tâche d'arrière-plan requise |
Géré automatiquement |
| Modèle de fil et de conversation | Spécifique au fournisseur - normalisation personnalisée nécessaire |
Des identifiants de thread cohérents sur tous les fournisseurs |
| API de pièces jointes | Analyse MIME - construire séparément par fournisseur |
Récupérer par identifiant de pièce jointe - indépendant du fournisseur |
| Suppression de données RGPD | Votre responsabilité - journal d'audit personnalisé |
Chemin de suppression documenté - Conforme au RGPD |
| Couverture SOC 2 Type II | Portée de vos propres contrôles |
Certification SOC 2 Type II |
| Temps de synchronisation du premier e-mail | 4-6 mois (les trois fournisseurs) |
Moins de 1 jour |
| Maintenance en cours | Votre équipe suit toutes les modifications des API de fournisseurs |
Géré par Unipile - aucun entretien du fournisseur |
Comment Unipile offre une API d'e-mail pour les SaaS en une seule intégration
Unipile est une API d'email unifiée pour les SaaS, spécialement conçue pour le marché de la synchronisation utilisateur. Un seul ensemble de points d'accès couvre Gmail, Outlook et IMAP – avec des fonctionnalités OAuth, des webhooks, le classement des fils de discussion, les pièces jointes et la conformité gérées pour vous. Voici à quoi ressemble chaque intégration de fournisseur dans les coulisses.
Unipile utilise Google OAuth 2.0 pour demander les scopes minimums nécessaires. La plateforme est certifiée CASA Tier 2, ainsi votre application hérite du statut vérifié sans passer par votre propre évaluation.
Unipile se connecte via le Microsoft Graph API en utilisant la plateforme d'identité Microsoft. Cela couvre à la fois les comptes Outlook personnels et les locataires Microsoft 365 d'entreprise via un seul flux OAuth.
Pour les utilisateurs sur Yahoo, Fastmail, des serveurs d'entreprise personnalisés, ou tout autre fournisseur, Unipile se connecte via IMAP. Toutes les particularités propres au serveur, les cas limites TLS et les différences de nommage de dossiers sont abstraits de votre code.
account_id. Stockez-le dans votre enregistrement utilisateur. Tous les appels d'e-mail ultérieurs référencent cet ID - pas de jetons, pas de secrets dans votre base de données.GET /emails lister les messages, POST /emails envoyer, et GET /e-mails/:id/pièces jointes pour les fichiers. Mêmes points d'accès pour les trois fournisseurs.Synchronisez les e-mails de vos utilisateurs dans votre SaaS : Exemple de code complet
Trois langues, une seule approche. Connectez la boîte de réception d'un utilisateur, récupérez ses e-mails et envoyez-les depuis son adresse – le tout via l'API unifiée d'e-mails Unipile. Le même code fonctionne pour les comptes connectés Gmail, Outlook et IMAP.
import { UnipileClient } from 'unipile-node-sdk';
const client = new UnipileClient('VOTRE_DSN', 'VOTRE_JETON');
// Étape 1 : Générer un lien OAuth hébergé pour votre utilisateur
const LienAuth = await client.compte.create({
type : 'google', // ou 'microsoft' ou 'imap'
url_redirection : 'https://yourapp.com/callback'
});
// Redirigez votre utilisateur vers authLink.url pour terminer le consentement OAuth
// Étape 2 : Lister les 50 e-mails les plus récents pour un compte lié
const { items: e-mails } = await client.email.ToutObtenir({
account_id : 'IDENTIFIANT_COMPTE',
limite : 50
});
e-mails.chaque(courriel => {
console.log(email.subject, email.from_attendee.identifier);
});
// Étape 3 : Envoyer depuis l'adresse de l'utilisateur
await client.email.envoyer({
account_id : 'IDENTIFIANT_COMPTE',
à : [{ identifiant : 'lead@company.com', nom_affichage: 'Prospect' }],
sujet : 'Suite à notre appel',
body: 'Bonjour, je voulais juste prendre des nouvelles...
'
});
// Étape 4 : Enregistrer un webhook pour les événements de nouveaux e-mails en temps réel
await client.webhook.create({
url : 'https://votresite.com/webhooks/email',
événements : ['email.reçu', 'email.envoyé']
});import demandes
BASE = "https://api9.unipile.com:13234/api/v1"
JETON = "VOTRE_JETON"
EN-TÊTES = {"X-API-KEY": JETON, "Content-Type": "application/json"}
# Étape 1 : Créer un lien d'authentification hébergé pour votre utilisateur
resp = requests.poste(f"{BASE}/hébergé/comptes/lier", json={
"type": "Google",
"url_redirection": "https://yourapp.com/callback"
}, en-têtes=HEADERS)
auth_url = resp.json()["url"]
# Étape 2 : Récupérer les 50 e-mails les plus récents
e-mails = requêtes.obtenir(f"{BASE}/e-mails", paramètres={
"account_id": "ID_COMPTE",
"limite": 50
}, en-têtes=HEADERS).json()["articles"]
pour l'email en courriels :
print(e-mail["sujet"], courriel["de_participant"]["identifier"])
# Étape 3 : Envoyer depuis l'adresse de l'utilisateur
requêtes.poste(f"{BASE}/e-mails", json={
"account_id": "ID_COMPTE",
"à": [{"identifier": "lead@company.com"}],
"sujet": "Suivi",
"corps": "Bonjour, je voulais juste prendre des nouvelles...
"
}, en-têtes=HEADERS)# Étape 1 : Créer un lien d'authentification hébergé
curl -X POST \
"https://api9.unipile.com:13234/api/v1/hosted/accounts/link" \
-H "X-API-KEY : VOTRE_JETON" \
-H "Content-Type: application/json" \
-d '{"type":"google","redirect_url":"https://yourapp.com/callback"}'
# Étape 2 : Dressez la liste des 50 e-mails les plus récents
curl -G
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-KEY : VOTRE_JETON" \
--encodage-url-de-données "compte_id=ID_DU_COMPTE" \
--encodage-url-de-données "limite=50"
# Étape 3 : Envoyer depuis l'adresse de l'utilisateur
curl -X POST \
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-KEY : VOTRE_JETON" \
-H "Content-Type: application/json" \
-d '{"account_id":"ACCOUNT_ID","to":[{"identifier":"lead@company.com"}],"subject":"Suivi","body":"Salut...
"}'Unipile génère l'URL OAuth. Votre utilisateur clique, consent, et est redirigé vers votre application. Vous ne gérez jamais directement les tokens OAuth.
GET /emails et POST /emails fonctionne de manière identique pour Gmail, Outlook et IMAP. Changez le account_id - tout le reste est inchangé.
Enregistrez une URL unique. Unipile normalise les notifications Gmail Pub/Sub, les événements de modification de Microsoft Graph et les signaux IMAP IDLE en une seule charge d'événement unifiée.
Questions fréquemment posées
Questions fréquentes des fondateurs et ingénieurs de SaaS évaluant une API d'email pour la synchronisation de la boîte de réception utilisateur.
FR 
EN 
ES 
DE 
IT 
BR 
NL 
PL 
TR