LinkedIn
Instagram
Telegram
Google Agenda
Rejoindre la communauté SlackConnecter et synchroniser Outlook 365 Boîtes aux lettres via API
Intégrez de puissantes fonctionnalités de messagerie dans votre application grâce à l'API de messagerie Outlook. Lisez, envoyez, synchronisez et réagissez aux e-mails Outlook et Microsoft 365 via une interface REST unique prise en charge par Microsoft Graph, sans avoir à gérer vous-même les flux OAuth.
const response = await fetch(
https://${DSN}/api/v1/emails,
{
headers : {
'X-API-KEY'clé API,
'identifiant_de_compte': compteOutlookId
}
}
);
const courriels = await réponse.json();
// emails.items, tableau de messages Outlook
// fonctionne pour Outlook, Gmail et IMAP
Qu'est-ce que l'API de messagerie Outlook ?
Le API de messagerie Outlook est une interface RESTful qui donne aux développeurs un accès programmatique aux données de la boîte aux lettres Outlook et Microsoft 365. Construit sur Microsoft Graph, elle permet à votre application de lire, envoyer, organiser et synchroniser les e-mails de n'importe quel compte Outlook ou Exchange Online - en utilisant OAuth 2.0 pour une authentification sécurisée déléguée par l'utilisateur. Les développeurs intègrent l'API d'e-mail Outlook pour créer des clients de messagerie, des moteurs de synchronisation CRM, des outils ATS et des automatisations de prospection sans exposer les identifiants des utilisateurs.
Pourquoi intégrer l'API d'e-mail Outlook dans votre application ?
L'intégration de l'API de messagerie Outlook dans votre application permet à vos utilisateurs d'accéder directement à leur boîte de réception Microsoft 365 à l'intérieur de votre produit, sans changement d'onglet ni copie-coller manuel. Voici les quatre capacités principales que les équipes exploitent le plus souvent.
API Microsoft Outlook pour Votre Solution CRM
Synchroniser les conversations Outlook dans les pipelines de vente et les fiches clients
Synchroniser les e-mails Outlook avec les systèmes de suivi des candidats
Microsoft Graph API pour les plateformes de recrutement et les logiciels RH
Outlook
Synchroniser l'API Outlook avec les outils de prospection
Alimentez des plateformes d'engagement commercial multicanal avec Microsoft Graph
L'intégration de l'API d'e-mails Outlook à votre logiciel de prospection offre aux équipes de vente une source de vérité unique pour chaque interaction avec un prospect. Les conversations restent synchronisées, les suivis sont déclenchés automatiquement et les données d'engagement alimentent directement vos tableaux de bord.
Configuration de l’authentification OAuth Microsoft pour l’API d’e-mails Outlook
Microsoft OAuth DocsPar défaut, votre intégration utilise les identifiants OAuth d'Unipile. Pour obtenir un expérience entièrement en marque blanche Lorsque les utilisateurs finaux connectent leur boîte aux lettres Outlook ou Microsoft 365, enregistrez votre propre application dans Microsoft Entra ID. Suivez le 7 étapes ci-dessous pour créer l'enregistrement, configurer les permissions et le connecter à l'API de messagerie Outlook dans votre espace de travail Unipile.
Créer un compte Microsoft Entra ID
Si vous n'en avez pas déjà un, créez un gratuit Microsoft Entra ID compte (anciennement Azure Active Directory). C'est le portail d'administration où vous enregistrez l'application OAuth qui alimente votre intégration à l'API des e-mails Outlook.
Enregistrer une nouvelle application dans le portail Azure
Se connecter à portal.azure.com, ouvrir Microsoft Entra ID, et cliquez Nouvelle inscription.
- Nommez votre application : Ce nom apparaît sur l'écran de consentement OAuth Microsoft présenté à vos utilisateurs finaux.
- Types de comptes pris en charge : sélectionnez "Comptes dans n'importe quel répertoire organisationnel (Tout Microsoft Entra ID, multilocataire) et comptes Microsoft personnels" afin de pouvoir connecter vos boîtes aux lettres Microsoft 365 professionnelles et personnelles Outlook.
Ajouter des URI de redirection
Ouvrez le Authentification panneau et cliquez Ajouter l'URI sous la section Web. Ajouter 2 URI de redirection en utilisant votre Unipile DSN (disponible dans la tableau de bord Unipile, coin supérieur droit) :
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
Configurer les autorisations Microsoft Graph
Aller à Autorisations de l'API > Ajouter une autorisation > Microsoft Graph, puis ajoutez ce qui suit Autorisations déléguées pour l'API de messagerie Outlook :
Pour les fonctionnalités du calendrier, ajoutez également Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared et Calendars.ReadWrite.Shared, puis activez-les dans les paramètres de portée de votre tableau de bord Unipile.
Créer un secret client
Ouvrir Certificats et secrets, cliquer Nouveau secret client. Donnez une description au secret et définissez une date d'expiration 730 jours (24 mois), puis cliquez sur "Ajouter".
Connectez votre application au tableau de bord Unipile
Ouvrez le tableau de bord Unipile et naviguer vers Paramètres > Microsoft OAuth.
- Copier-coller le ID de l'application (client) depuis la page Vue d'ensemble d'Azure.
- Collez le valeur secrète depuis la page Certificats et secrets.
- Cliquer Économiser.
Tester la connexion
Depuis le tableau de bord Unipile, déclenchez un nouveau lien de compte Microsoft pour vérifier que vos identifiants OAuth personnalisés fonctionnent de bout en bout. Vous devriez voir votre nom de l'application et de la marque à l'intérieur de l'invite de consentement Microsoft au lieu des valeurs par défaut d'Unipile.
8
Devenir un éditeur vérifié
Recommandé pour la production - supprime l'avertissement "non vérifié" sur l'écran de consentement
Avec la vérification de l'éditeur, une coche bleue apparaît dans l'invite de consentement OAuth. Sans elle, les comptes professionnels Microsoft 365 peuvent voir un avertissement "éditeur non vérifié" qui nuit à votre taux de conversion d'inscription.
Étape 1 : rejoignez le Microsoft Partner Network
- Inscription à partenaire.microsoft.com et choisir le Programme Partenaire Microsoft Cloud AI.
- Si vous avez besoin d'un compte professionnel, créer un nouvel locataire d'abord.
Étape 2 : vérifiez votre domaine
Créer un fichier nommé microsoft-identity-association.json et l'héberger à :
Étape 3 : Lier votre identifiant de compte partenaire mondial (PGA)
- Trouvez votre identifiant PGA via Centre partenaires.
- Dans le portail Azure, allez à Enregistrements d'applications > Votre application > Marque et propriétés, entrez l'ID PGA et enregistrez.
Pour plus de détails, consultez le Documentation de vérification Microsoft Publisher.
9
Approbation de l'administrateur requise"
Lorsque les utilisateurs finaux voient un bloc de consentement de leur administrateur Microsoft 365
Si un utilisateur final voit " Approbation de l'administrateur requise " lors de la connexion de sa boîte aux lettres Outlook, le consentement requis n'a pas été accordé au niveau du locataire. Deux voies pour résoudre le problème :
Méthode 1 : Demande de consentement d'administrateur dans Microsoft Entra
Un administrateur Microsoft 365 examine et approuve la demande de consentement d'administrateur en attente. Voir le Documentation Microsoft sur la révision des demandes de consentement administrateur.
Méthode 2 : Connexion OAuth en tant qu'administrateur avec consentement à l'échelle du locataire
- L'administrateur démarre le flux de connexion OAuth à partir de votre application.
- Lors de l'autorisation Microsoft, l'administrateur doit cocher "Consentement au nom de votre organisation".
- Ceci accorde le consentement pour chaque utilisateur dans le locataire et empêche la demande de toute connexion future à l'API de courrier électronique Outlook.
Plein de détails dans le Guide de dépannage du consentement Microsoft.
Boostez la productivité avec les fonctionnalités de l'API d'e-mails Outlook
Améliorez la productivité de vos utilisateurs en exploitant les fonctionnalités de l'API d'e-mails Outlook, permettant une gestion fluide des e-mails, des flux de travail automatisés et une synchronisation en temps réel afin qu'ils puissent se concentrer sur ce qui compte vraiment.
POST /api/v1/emails { "account_id": "acc_outlook_...", "à": [{"identifier": "lead@acme.com"}], "sujet": "Introduction rapide", "corps": "Salut {{first_name}}..." }
Inbox
// Nouvel événement d'email livré à votre point de terminaison { "événement": "mail.reçu", "account_id": "acc_outlook_...", "identifiant_courriel": "em_8FdK2...", "de": "sarah@acme.com", "horodatage": "18-05-2026T09:42:11Z" }
Comparer Outlook avec Gmail et IMAP
| Fonctionnalité |
Outlook |
Gmail |
IMAP |
|---|---|---|---|
| Connexion au compte | |||
| Hosted Auth | |||
| Auth personnalisé | |||
| OAuth | |||
| Indentifications | |||
| Envoyer / Recevoir | |||
| Envoyer / Répondre à un e-mail | |||
| Lister des emails | |||
| Créer un brouillon d'e-mail | |||
| Organiser | |||
| Supprimer un email | |||
| Déplacer un email | |||
| Lister des dossiers | |||
| Récupérer un dossier | |||
| Webhooks | |||
| Nouvel Email | |||
| Suivi ouvert & clics | |||
Intégrez votre API de messagerie Outlook dès aujourd'hui
Essai gratuit inclus - aucune carte de crédit requise. Connectez votre premier compte Outlook en moins de 5 minutes.
Exemples de code d'API de messagerie Outlook : Node.js, Python et cURL
Les exemples ci-dessous appellent le point de terminaison de l'API unifiée Outlook d'Unipile. Une seule clé d'API, une seule URL de base – fonctionne pour Outlook, Gmail et IMAP sans modifier votre code. Remplacez VOTRE_DSN et VOTRE_CLE_API avec les valeurs de votre tableau de bord Unipile.
// Lire les e-mails d'un compte Outlook lié via l'API d'e-mails Outlook Unipile
const axios = require('axios');
const DSN = 'api1.unipile.com:13211';
const CLÉ_API = 'VOTRE_CLÉ_API';
const ID_ACC = 'ID_COMPTE_OUTLOOK'; // depuis POST /accounts après OAuth
async function lister les e-mailsOutlook() {
const res = await axios.obtenir(
https://\${DSN}/api/v1/emails,
{
headers : {
'X-API-KEY': CLÉ_API,
'identifiant_de_compte': ID_ACC
}
}
);
console.log(res.data.items); // tableau de messages Outlook
}
// Envoyer un e-mail via l'API e-mail d'Outlook
async function envoyerEmailOutlook() {
await axios.poste(
https://\${DSN}/api/v1/emails,
{
account_id: ID_ACC,
à: [{ nom_d'affichage: 'Alice', identificateur: 'alice@contoso.com' }],
sujet: 'Bonjour depuis l'API de messagerie Outlook',
corps: 'Envoyé via l'API d'e-mail Unipile Outlook.
'
},
{ en-têtes : { 'X-API-KEY': CLÉ_API } }
);
}# : Lire et envoyer des e-mails via l'API Outlook d'Unipile
import demandes
DSN = "api1.unipile.com:13211"
CLÉ_API = "YOUR_API_KEY"
ID_ACC = "OUTLOOK_ACCOUNT_ID"
EN-TÊTES = {
"X-API-KEY": CLÉ_API,
"account_id": ID_ACC,
}
# : Liste des e-mails Outlook
déf lister_e-mails():
r = requêtes.obtenir(
https://{DSN}/api/v1/emails",
en-têtes=EN-TÊTES
)
r.lancer_statut()
return r.json()["articles"]
# Envoyer via l'API de messagerie Outlook
déf envoyer_email(à_dest, objet, corps):
r = requêtes.poste(
https://{DSN}/api/v1/emails",
en-têtes={"X-API-KEY": {API_KEY},
json={
"account_id": ID_ACC,
"à": [{"identifier": à_addr}],
"sujet": sujet,
"corps": corps
}
)
r.lancer_statut()
return r.json()# : Liste des e-mails du compte Outlook associé
curl -s -X GET \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY : VOTRE_CLE_API" \
-H "account_id: OUTLOOK_ACCOUNT_ID" \
| jq '.items[] | {id, subject, from, date}'
# Envoyer un e-mail via l'API de messagerie Outlook
curl curls -X POST \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY : VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"account_id": "ID_COMPTE_OUTLOOK",
"à": [{"identificateur": "alice@contoso.com"}],
"sujet": "Bonjour depuis l'API d'e-mail Outlook",
"corps"Envoyé via Unipile.
"
}'API Microsoft Graph native vs API de messagerie Outlook unifiée (Unipile)
Découvrez les avantages évidents de tirer parti de l'intégration rationalisée de l'API d'e-mails d'Outlook par Unipile par rapport à la création directe sur Microsoft Graph. Utilisez Hosted Auth pour renforcer la sécurité grâce à une gestion améliorée des informations d'identification, assurer une intégration transparente avec Outlook et d'autres plateformes de messagerie, et réduire la charge liée à la maintenance des flux OAuth.
| Dimension | API Microsoft Graph native | API d'e-mails Outlook d'Unipile |
|---|---|---|
| Portée d'intégration | Outlook / Exchange Online seulement | Outlook + Gmail + IMAP, même code |
| Configuration du flux OAuth | Enregistrement d'application Azure + gestion des jetons par locataire | Un lien d'authentification hébergé, page OAuth en marque blanche, zéro code de jeton |
| Rafraîchissement des jetons | Votre code doit se rafraîchir toutes les 60 minutes (durée de vie du jeton d'accès) | Unipile gère le rafraîchissement automatiquement pour tous les comptes liés |
| Renouvellement de webhook | Les abonnements expirent à 4230 minutes, vous devez renouveler avant expiration | Unipile renouvelle automatiquement les abonnements Graph |
| Gestion de la limitation | Doit implémenter manuellement la logique de réessai 429 et le backoff exponentiel | Gestion intégrée de la réessai et de la limitation du débit |
| Délai avant le premier e-mail | 2-5 jours (configuration Azure + OAuth + logique de jeton + gestion des erreurs) | Moins de 2 heures (suivez ce guide) |
| Retrait d'Exchange Online | Doit migrer d'EWS vers Graph avant la date limite d'octobre 2026 | Unipile utilise déjà Graph, la migration est transparente |
| Support | Documentation Microsoft + forums | Support technique en direct + appel fondateur à la demande |
Authentification unique hébergée (One Link Hosted Auth) vs Flux OAuth complet
La connexion hébergée d'Unipile automatise la détection des fournisseurs de messagerie et gère l'authentification. Cela réduit considérablement la complexité de la configuration initiale, accélère les délais de développement et diminue la maintenance. Guide de l'API OAuth pour les e-mails
Mises à jour et maintenance régulières
Restez en avance grâce à des mises à jour régulières et une maintenance diligente. L'API Unipile Outlook Email est continuellement améliorée pour suivre les changements de Microsoft Graph et offrir des performances optimales, de sorte que votre intégration fonctionne même lorsque Microsoft met à jour son API. Guide d'intégration MS Graph
Notre équipe d'assistance vous guide à travers chaque phase de l'intégration de l'API d'e-mail Outlook, de l'initiation à la post-implémentation, sans frais supplémentaires. API d'e-mail pour les développeurs
Pièges courants lors de la création d’applications avec l’API d’e-mail Outlook
L'API Microsoft Outlook est puissante, mais elle présente plusieurs contraintes subtiles qui peuvent faire échouer votre intégration en production. Voici les 6 écueils les plus courants – et comment les éviter.
Sécurité et conformité pour les intégrations d'API de messagerie Outlook
Assurez la sécurité de vos données grâce à des protocoles de sécurité avancés. L'API d'emails Outlook Unipile garantit que vos e-mails et informations sensibles restent protégés – avec la certification SOC 2 Type II et la conformité totale au RGPD.
Questions fréquemment posées
Réponses aux questions les plus courantes concernant l'API de messagerie Outlook, l'API Microsoft Outlook et l'intégration de l'API Outlook 365 avec Unipile.
graph.microsoft.com/v1.0/moi/messages, authentifié avec un jeton porteur Azure AD OAuth 2.0. Unipile l'encapsule dans une interface simple et indépendante du fournisseur qui fonctionne également pour Gmail et IMAP.Mail.ReadWrite, Mail.Send et Mail.Read autorisations déléguées, (3) mettre en œuvre le flux du code d'autorisation pour obtenir un jeton d'accès. Avec Unipile, vous évitez tout cela. Utilisez l'authentification hébergée pour générer une page OAuth unique pour vos utilisateurs. Voir la page complète Guide de l'API OAuth pour les e-mails et le Guide OAuth de Microsoft Graph.Vous aimerez aussi
Récupérer des emails avec l'API Unipile
La gestion et la récupération des courriels de manière programmatique est une compétence essentielle. Que ce soit pour l'automatisation de l'entreprise, le support client ou le marketing, comprendre comment utiliser une API d'email pour récupérer les emails peut rationaliser les opérations et améliorer l'efficacité. Ce guide vous guidera à travers les éléments essentiels...
Comment obtenir l'API de messagerie pour votre logiciel
Découvrez les avantages de l'intégration d'une API, qui vous permettra de bénéficier de nombreux avantages en incorporant de manière transparente plusieurs services de messagerie électronique dans votre application. Qu'est-ce qu'une API de messagerie ? Une API de messagerie (Application Programming Interface) est un service qui permet aux développeurs d'intégrer...
Vérification Google OAuth et identifiants de l'API Gmail (2026)
Avertissement de l'application non vérifiée de l'API Gmail L'avertissement "Cette application n'est pas vérifiée", la limite de 100 utilisateurs et les exceptions Avant que votre application ne passe la vérification de l'application Google OAuth, chaque utilisateur qui tente de l'autoriser voit un écran d'avertissement. Google applique également une limite stricte de 100 utilisateurs pour les applications externes non vérifiées. Voici...
FR 
EN 
ES 
DE 
IT 
BR 
NL 
PL 
TR