API d'envoi d'e-mail : Envoyer depuis l'utilisateur Gmail, Outlook et IMAP Comptes
La plupart des API d'e-mail envoient depuis un domaine partagé que vous possédez. L'API d'envoi d'e-mails d'Unipile est différente : elle envoie depuis les comptes Gmail, Outlook et IMAP de vos utilisateurs, avec OAuth2 complet, sans stockage de credentials, et un unique point d'extrémité unifié pour chaque fournisseur. Lorsque votre SaaS doit envoyer des e-mails par programme au nom de personnes réelles, c'est l'intégration qui permet que cela fonctionne.
Une API d'envoi d'e-mails qui agit au nom de vos utilisateurs
La plupart des recherches "API d'envoi d'e-mails" mènent à des fournisseurs transactionnels. Ce n'est pas le cas ici. Unipile est une API d'e-mails de comptes utilisateurs : elle se connecte aux vrais comptes Gmail ou Outlook de vos utilisateurs et envoie des e-mails en leur nom, avec leur identité et leur délivrabilité.
Pourquoi les développeurs créent des solutions basées sur une API d'e-mails de compte utilisateur
Lorsque votre produit doit envoyer des e-mails par programmation à partir de vraies personnes (et non d'une adresse noreply@), ce sont ces scénarios qui stimulent l'adoption.
Envoyez des e-mails de suivi depuis le compte Gmail ou Outlook de chaque représentant commercial. Taux de réponse plus élevés, identité d'expéditeur authentique, pas de réchauffement de domaine requis. Les prospects voient un vrai nom, pas un alias générique.
Laissez les agents de support répondre directement depuis leur propre boîte aux lettres. Les clients voient le nom et l'adresse e-mail d'une personne réelle, pas un alias support@. Renforce la confiance, augmente la vitesse de résolution.
Atteignez les candidats avec des e-mails personnalisés depuis le compte réel du recruteur. Pas de domaine d'envoi froid, pas de risque de filtre anti-spam, pas de période de chauffe. L'e-mail arrive dans la boîte de réception comme un message personnel, car il en est un.
Envoyer des e-mails depuis Gmail, Outlook et IMAP : une seule API
L'API d'envoi d'e-mails d'Unipile abstrait complètement la couche du fournisseur. Que le compte de votre utilisateur soit Gmail, Outlook, Microsoft 365, Exchange Online ou toute autre boîte aux lettres compatible IMAP, l'appel API est identique. Vous écrivez l'intégration une seule fois et chaque fournisseur fonctionne.
gmail.envoyer: empreinte de permission minimale Mail.Send: délégué ou au niveau de l'application Comment envoyer des e-mails via une API : Intégration étape par étape
De la liaison de compte à l'envoi de votre premier e-mail par programme, voici le flux complet. Ce guide couvre Gmail et Outlook ; les étapes pour IMAP sont identiques, seul le type de compte diffère.
Inscrivez-vous sur le tableau de bord Unipile. Chaque espace de travail reçoit une clé API. Toutes les requêtes sont authentifiées avec le X-API-KEY En-tête. Aucune configuration OAuth de votre côté : Unipile gère l'authentification du fournisseur pour vous.
Générer un lien d'authentification hébergé via l'API. L'utilisateur clique dessus et passe par l'écran de consentement OAuth2 standard pour son fournisseur. Unipile stocke les jetons en toute sécurité et renvoie un account_id. Vous ne touchez jamais aux identifiants.
"type":"MICROSOFT". Pour l'IMAP, utiliser "type":"IMAP". Le même flux hébergé gère les trois fournisseurs.Après que l'utilisateur a terminé le processus OAuth2, Unipile déclenche un webhook vers votre point de terminaison avec le account_id. Stockez-le dans votre base de données : c'est la clé que vous utiliserez dans chaque appel API d'envoi d'e-mails pour cet utilisateur.
POST à /api/v1/emails avec le account_id. L’e-mail est envoyé depuis la boîte de réception Gmail ou Outlook de l'utilisateur, comme s'il l'avait envoyé lui-même. Le point de terminaison est identique, que le compte lié soit Gmail, Outlook ou IMAP.
"salut", "CCI", "répondre_à", ou encore "pièces jointes" au même payload.Prêt à envoyer des e-mails depuis Gmail, Outlook et IMAP ?
Votre clé d'API vous attend. Commencez à développer en moins de 10 minutes.
Un point de terminaison unifié pour envoyer des e-mails sur tous les fournisseurs
La plus grande friction dans les intégrations multi-fournisseurs est de maintenir des chemins de code distincts pour chaque service de messagerie. Unipile élimine cela. Que le compte lié soit Gmail, Outlook ou IMAP, vous appelez toujours le même point de terminaison avec la même charge utile. La couche d'abstraction gère les protocoles spécifiques au fournisseur, les actualisations de jetons et les différences de limites de débit en coulisses.
Aucune voie de code distincte pour Gmail ou Outlook. Une seule intégration couvre les trois fournisseurs actuels et toutes les futures additions que Unipile pourrait ajouter.
Les jetons d'accès OAuth2 expirent. Unipile les rafraîchit de manière transparente. Votre code ne gère jamais le cycle de vie des jetons ; appelez simplement l'API et envoyez.
Chaque utilisateur associe son propre compte. Vous gérez un account_id par utilisateur ; Unipile s'occupe du reste. Pas de jonglage avec les SDK par fournisseur.
L'API renvoie la même structure JSON quel que soit le fournisseur. Analysez un schéma, créez un gestionnaire d'erreurs, livrez plus rapidement.
Besoin d'envoyer des e-mails au nom de vos utilisateurs à grande échelle ? Lisez le guide complet sur la façon de faire envoyer des e-mails au nom de vos utilisateurs, y compris le modèle de conformité et de consentement qu'Unipile utilise pour que tout soit auditable.
Tous les points de terminaison de l'API d'envoi d'e-mails, organisés
Chaque point d'accès disponible pour connecter des comptes, envoyer et répondre, gérer votre boîte aux lettres et écouter des événements sur Gmail, Outlook et IMAP avec une seule intégration.
Envoyer et répondre
4 points finaux disponibles
Configuration du compte
3 points finaux disponibles
Gérer les e-mails
5 points finaux disponibles
Webhooks
2 événements disponibles
Couvre les flux d'authentification, la configuration des webhooks, la lecture et l'envoi d'e-mails, les pièces jointes, et une comparaison complète des fournisseurs, tout ce dont vous avez besoin pour créer une intégration API d'envoi d'e-mails prête pour la production.
Authentification et sécurité pour l’intégration de votre API d’envoi d’e-mails
La gestion des identifiants d'e-mail des utilisateurs est l'une des parties les plus risquées de toute intégration SaaS. L'architecture d'Unipile est conçue de manière à ce que vous ne stockiez ni ne transmettiez jamais directement les jetons OAuth2 ; la surface de risque reste minimale et la conformité reste gérable.
Unipile génère l'URL de consentement OAuth2, collecte le code d'autorisation et stocke les jetons d'accès et de rafraîchissement dans son propre coffre-fort crypté. Votre backend ne voit jamais qu'un account_id. Aucun jeton brut, aucun mot de passe, aucune dérive d'identification.
Les jetons OAuth2 Gmail expirent après 1 heure. Les jetons Microsoft expirent après 1 heure (accès) ou 90 jours (actualisation). Unipile les actualise automatiquement avant leur expiration. Vos appels d'API d'envoi d'e-mails ne échouent jamais en raison d'un jeton périmé.
Pour une intégration envoi uniquement, Unipile ne demande que les scopes requis : gmail.envoyer pour Gmail et Mail.Send pour Outlook. Cela suit le principe du moindre privilège et réduit la surface d'attaque pour les données de vos utilisateurs.
Chaque webhook qu'Unipile envoie à votre point de terminaison inclut un en-tête de signature que vous pouvez vérifier par rapport à votre secret de webhook. Cela garantit que les charges utiles d'événements ne peuvent pas être falsifiées par des tiers tentant de déclencher des actions dans votre système.
L'infrastructure d'Unipile est certifiée SOC 2 Type II. Les contrôles audités couvrent la gestion des accès, le chiffrement au repos et en transit, la réponse aux incidents et la disponibilité. Cela permet de réussir facilement les revues de sécurité des fournisseurs lorsque vos clients SaaS vous demandent comment vous gérez leurs identifiants de messagerie.
Apprenez-en davantage sur l'API d'e-mail sécuriséUnipile est évalué CASA de niveau 2, la norme de sécurité requise par Google pour les applications accédant aux scopes sensibles de l'API Gmail. L'évaluation est menée par un laboratoire autorisé et couvre la gestion des données, les contrôles d'accès et les pratiques de développement sécurisé. Requis pour maintenir l'accès en production aux scopes d'envoi Gmail.
Couverture complète des fonctionnalités de l'API de messagerie pour tous les fournisseurs
Une seule intégration vous donne accès à toutes les opérations d'e-mail majeures sur les fournisseurs Gmail, Outlook et IMAP. Le même point d'accès, la même structure de charge utile, le même format de réponse, quel que soit le compte connecté par votre utilisateur.
| Fonctionnalité | Gmail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Envoi | |||
| Envoyer un e-mail depuis le compte utilisateur | ✓ | ✓ | ✓ |
| Envoyez avec pièces jointes | ✓ | ✓ | ✓ |
| Répondre dans le fil de discussion existant | ✓ | ✓ | ✓ |
| Destinataires en copie conforme (CC) et en copie carbone invisible (CCI) | ✓ | ✓ | ✓ |
| Contenu du corps HTML | ✓ | ✓ | ✓ |
| Images en ligne (intégration CID) | ✓ | ✓ | ✓ |
| Limite d'envoi quotidienne (env.) | ~500 / jour | ~10 000 / jour | Dépendant du serveur |
| Lecture et synchronisation | |||
| Lister et lire les e-mails | ✓ | ✓ | ✓ |
| Vue de fil / conversation | ✓ | ✓ | ✓ |
| Webhooks en temps réel (nouvel e-mail, lu, envoyé) | ✓ | ✓ | ✓ |
| Synchronisation delta incrémentielle | ✓ | ✓ | ✓ |
| Gestion des étiquettes et des dossiers | ✓Étiquettes | ✓Dossiers | ✓Dossiers |
| Authentification et sécurité | |||
| OAuth2 (pas de stockage de mot de passe) | ✓ | ✓ | Mot de passe d'application |
| Actualisation automatique du jeton | ✓ | ✓ | ✓ |
| SOC 2 Type II / CASA Niveau 2 | ✓ | ✓ | ✓ |
Erreurs courantes lors de la création d'une intégration d'API d'envoi d'e-mails
La plupart des problèmes que les développeurs rencontrent lors de l'intégration d'une API d'envoi d'e-mails pour les comptes utilisateurs entrent dans un petit ensemble de catégories. Voici celles qu'il est bon de connaître avant de commencer à construire.
Les comptes Gmail personnels sont limités à environ 500 e-mails par jour. Les comptes Outlook ont des limites plus élevées, mais peuvent toujours être limités dans des conditions de pic. Excéder ces limites entraîne des erreurs 429 ou une suspension temporaire du compte par le fournisseur.
Les utilisateurs peuvent révoquer l'accès à tout moment dans les paramètres de leur compte Google ou Microsoft. Lorsque cela se produit, Unipile renverra une erreur lors du prochain appel API pour ce compte. Si votre application ne gère pas cela correctement, cela entraînera des échecs silencieux de livraison d'e-mails.
compte.déconnecté événement webhook et invitez l'utilisateur à rétablir le lien de son compte.Même avec un jeton OAuth2 valide, l'envoi d'e-mails à partir du compte d'un utilisateur à son insu viole les politiques d'utilisation de Google et Microsoft, ainsi que les lois sur le spam dans la plupart des juridictions. L'écran de consentement OAuth2 doit expliquer clairement ce que votre application fera.
Si vous stockez vous-même des jetons d'accès et qu'ils sont exposés lors d'une violation de données, un attaquant a un accès complet à tous les comptes de messagerie associés. Ceci représente un risque critique en matière de sécurité et de conformité, en particulier dans le cadre du RGPD.
account_id; Unipile conserve les jetons dans son coffre-fort certifié SOC 2. Votre base de données ne gère jamais de jeton OAuth2 brut.SMTP nécessite un accès direct au serveur, la gestion des identifiants, la configuration TLS et la gestion des rejets. Une API REST d'envoi d'e-mails abstrait tout cela. Combiner les deux approches dans la même base de code ajoute de la complexité sans avantage.
Questions fréquemment posées
Tout ce que vous devez savoir sur l'API d'envoi d'e-mails.
account_id via webhook. Vous publiez ensuite sur /api/v1/emails avec cet account_id et votre message payload. L'e-mail est envoyé depuis leur véritable adresse Gmail. Aucune configuration de clé API Gmail n'est requise de votre côté.Mail.Send permission déléguée. Unipile gère le renouvellement automatique des jetons.https://www.googleapis.com/auth/gmail.send. Cela permet d'envoyer des e-mails mais n'autorise pas la lecture, la modification ou la suppression de messages. Lorsque vous utilisez Unipile, vous ne configurez pas cette portée vous-même ; le flux d'authentification hébergé s'en charge. Pour un cas d'utilisation pure de l'API d'envoi d'e-mails, gmail.envoyer est suffisant.POST /api/v1/emails le point de terminaison gère les comptes Gmail, Outlook et IMAP. Le fournisseur est déterminé par account_id dans la charge utile ; vous n'avez pas besoin de la spécifier. Écrivez votre logique d'envoi une seule fois et elle fonctionnera quel que soit le fournisseur de messagerie auquel votre utilisateur est lié.Vous avez encore des questions ? Notre équipe est là pour vous aider.
Connectez votre premier compte Gmail, Outlook ou IMAP et envoyez votre premier e-mail par programme en moins de 30 minutes. Pas de stockage d'informations d'identification, pas de configuration OAuth2 de votre côté, pas de SDK par fournisseur. Un seul account_id, un seul point d'accès REST, tous les fournisseurs.