LinkedIn
Instagram
Telegramma
Calendario di Google
Partecipare alla comunità SlackConnetti e sincronizza Outlook 365 Caselle di posta tramite API
Integra potenti funzionalità email nella tua app utilizzando la Outlook Email API. Leggi, invia, sincronizza e reagisci alle email di Outlook e Microsoft 365 tramite un'unica interfaccia REST supportata da Microsoft Graph, senza dover gestire manualmente i flussi OAuth.
const response = await fetch(
`https://${DSN}/api/v1/emails`,
{
intestazioni: {
'X-API-KEY'chiaveAPI,
'ID account': outlookAccountId
}
}
);
const e-mail = await risposta.json();
// emails.items, array di messaggi di Outlook
// funziona per Outlook, Gmail e IMAP
Che cos'è l'API di Outlook Email?
Il API per le email di Outlook è un'interfaccia RESTful che offre agli sviluppatori un accesso programmatico ai dati della casella di posta di Outlook e Microsoft 365. Costruito sopra Microsoft Graph, ti consente di leggere, inviare, organizzare e sincronizzare e-mail in qualsiasi account Outlook o Exchange Online, utilizzando OAuth 2.0 per l'autenticazione sicura delegata dall'utente. Gli sviluppatori integrano l'API E-mail Outlook per creare client di posta elettronica, motori di sincronizzazione CRM, strumenti ATS e automazione di outreach senza esporre le credenziali dell'utente.
Perché integrare l'API di posta elettronica di Outlook nella tua app?
Integrare l'API delle email di Outlook nella tua applicazione offre ai tuoi utenti un accesso diretto alla loro casella di posta Microsoft 365 all'interno del tuo prodotto, senza cambi di scheda né copia-incolla manuale. Ecco le quattro funzionalità principali che i team sbloccano più frequentemente.
API di Microsoft Outlook per la Tua Soluzione CRM
Sincronizza le conversazioni di Outlook nelle pipeline di vendita e nei record dei clienti
Sincronizzazione delle e-mail di Outlook con i sistemi di gestione delle candidature
Microsoft Graph API per piattaforme di recruiting e software HR
Prospettiva
Sincronizzare l'API di Outlook per gli strumenti di outreach
Potenzia le piattaforme di coinvolgimento delle vendite multicanale con Microsoft Graph
Integrare l'API delle e-mail di Outlook nel tuo software di outreach offre ai team di vendita un'unica fonte di verità per ogni interazione con i potenziali clienti. Le conversazioni rimangono sincronizzate, i follow-up vengono attivati automaticamente e i dati di coinvolgimento fluiscono direttamente nei tuoi dashboard.
Configurazione di Microsoft OAuth per l'API di posta elettronica di Outlook
Documentazione OAuth MicrosoftPer impostazione predefinita, la tua integrazione utilizza le credenziali OAuth di Unipile. Per ottenere un esperienza completamente personalizzabile quando gli utenti finali si connettono alla loro casella di posta Outlook o Microsoft 365, registra la tua app in Microsoft Entra ID. Segui il 7 passi qui sotto per creare la registrazione, configurare i permessi e collegarlo all'API di posta elettronica di Outlook nel tuo spazio di lavoro Unipile.
Crea un account Microsoft Entra ID
Se non ne hai già uno, creane uno gratuito Microsoft Entra ID account (precedentemente Azure Active Directory). Questo è il portale di amministrazione dove registri l'applicazione OAuth che alimenta la tua integrazione con l'API di Outlook Email.
Registra una nuova app nel portale di Azure
Accedere a portal.azure.com, Apri Microsoft Entra ID, e clicca Nuova registrazione.
- Dai il nome alla tua app: questo nome appare sulla schermata di consenso OAuth di Microsoft mostrata ai tuoi utenti finali.
- Tipi di account supportati: seleziona "Account in qualsiasi directory organizzativa (qualsiasi Microsoft Entra ID, multitenant) e account personali Microsoft" in modo da poter collegare sia le cassette postali Microsoft 365 aziendali che quelle personali di Outlook.
Aggiungi URI di reindirizzamento
Apri Autenticazione pannello e clicca Aggiungi URI sotto la sezione Web. Aggiungi 2 URI di reindirizzamento utilizzando il tuo DSN Unipile (disponibile nel Cruscotto Unipile, in alto a destra):
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
Configura le autorizzazioni di Microsoft Graph
Vai a Permessi API > Aggiungi un permesso > Microsoft Graph, poi aggiungi quanto segue Permessi delegati per l'API di Outlook Email:
Per le funzionalità del calendario, aggiungi anche Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared e Calendars.ReadWrite.Shared, quindi attivali nelle impostazioni degli ambiti del tuo Pannello di controllo Unipile.
Crea un segreto client
Aperto Certificati e segreti, fare clic Nuovo segreto client. Dai una descrizione al segreto e impostagli una scadenza di 730 giorni (24 mesi), quindi fai clic su "Aggiungi".
Collega la tua app alla Dashboard Unipile
Apri Cruscotto Unipile e naviga verso Impostazioni > Microsoft OAuth.
- Incolla il ID applicazione (client) dalla pagina Panoramica di Azure.
- Incolla il valore segreto dalla pagina Certificati e segreti.
- Fare clic Risparmiare.
Verifica la connessione
Dalla dashboard Unipile, attiva un nuovo collegamento account Microsoft per verificare che le tue credenziali OAuth personalizzate funzionino end-to-end. Dovresti vedere il tuo nome dell'app e il branding all'interno del prompt di consenso di Microsoft anziché le impostazioni predefinite di Unipile.
8
Diventa un editore verificato
Consigliato per la produzione - rimuove l'avviso "non verificato" sulla schermata del consenso
Con la verifica dell'editore, compare un segno di spunta blu nel prompt di consenso OAuth. Senza di essa, gli account aziendali di Microsoft 365 potrebbero visualizzare un avviso "editore non verificato" che danneggia il tasso di conversione delle iscrizioni.
Passaggio 1: iscriviti al Microsoft Partner Network
- Registrati su partner.microsoft.com e scegli il Programma partner Microsoft AI Cloud.
- Se hai bisogno di un account di lavoro, crea un nuovo tenant primo.
Passaggio 2: verifica il tuo dominio
Crea un file chiamato microsoft-identity-association.json e ospitarlo su:
Passaggio 3: collega il tuo ID Partner Global Account (PGA)
- Trova il tuo ID PGA tramite Partner Center.
- Nel portale di Azure, vai su Registrazioni app > La tua app > Branding e proprietà, inserisci l'ID PGA e salva.
Per maggiori dettagli, vedere Documentazione di verifica di Microsoft Publisher.
9
Approvazione dell'amministratore richiesta"
Quando gli utenti finali vedono un blocco di consenso dall'amministratore di Microsoft 365
Se un utente finale visualizza "Richiesta approvazione dell'amministratore" quando connette la propria casella di posta di Outlook, il consenso richiesto non è stato concesso a livello di tenant. Due percorsi per risolverlo:
Metodo 1: richiesta di consenso dell'amministratore all'interno di Microsoft Entra
Un amministratore di Microsoft 365 esamina e approva la richiesta di consenso dell'amministratore in sospeso. Vedere Documentazione Microsoft sulla revisione delle richieste di consenso dell'amministratore.
Metodo 2: accesso OAuth come amministratore con consenso a livello di tenant
- L'amministratore avvia il flusso di accesso OAuth dalla tua app.
- Durante l'autorizzazione di Microsoft, l'amministratore deve selezionare "Consenso per conto della tua organizzazione".
- Ciò concede il consenso per ogni utente nell'tenant e impedisce la richiesta per qualsiasi connessione futura all'API di posta elettronica di Outlook.
Completa i dettagli in Guida alla risoluzione dei problemi di consenso Microsoft.
Aumenta la produttività con le funzionalità dell'API di posta elettronica di Outlook
Aumenta la produttività dei tuoi utenti sfruttando le funzionalità dell'API di Outlook Email, abilitando una gestione email senza interruzioni, flussi di lavoro automatizzati e sincronizzazione in tempo reale, così potranno concentrarsi su ciò che conta veramente.
POSTA /api/v1/email { "account_id": "acc_outlook_...", "a": [{"identificatore": "lead@acme.com"}], "soggetto": "Breve introduzione", "corpo": "Ciao {{first_name}}..." }
Inbox
// Nuovo evento email recapitato al tuo endpoint { "evento": "posta.ricevuta", "account_id": "acc_outlook_...", "email_id": "em_8FdK2...", "da": "sarah@acme.com", "ora": "2026-05-18T09:42:11Z" }
Confronta Outlook con Gmail e IMAP
| Caratteristica |
Prospettiva |
Gmail |
IMAP |
|---|---|---|---|
| Connessione del conto | |||
| Autorizzazione in hosting | |||
| Autorizzazione personalizzata | |||
| OAuth | |||
| Credenziali | |||
| Invia / Ricevi | |||
| Invia / Rispondi Email | |||
| Elenco e-mail | |||
| Boozza un'idea per un'email. | |||
| Organizzare | |||
| Cancellare l'e-mail | |||
| Spostare l'e-mail | |||
| Elenco cartelle | |||
| Prendi la cartella | |||
| Ganci web | |||
| Nuova e-mail | |||
| Tracciamento aperture e clic | |||
Costruisci oggi stesso la tua integrazione API di posta elettronica di Outlook
Prova gratuita inclusa - nessuna carta di credito richiesta. Collega il tuo primo account Outlook in meno di 5 minuti.
Esempi di codice API per email di Outlook: Node.js, Python e cURL
Gli esempi seguenti chiamano l'endpoint API unificato di Outlook di Unipile. Una chiave API, un URL di base: funziona per Outlook, Gmail e IMAP senza cambiare il codice. Sostituisci TUA_DSN e LA_TUA_CHIAVE_API con i valori dalla tua Dashboard Unipile.
// Leggere e-mail da un account Outlook collegato tramite l'API di posta elettronica Unipile Outlook
const axios = require('axios');
const DSN = 'api1.unipile.com:13211';
const CHIAVE_API = 'CHIAVE_API_TUA';
const ACC_ID = 'OUTLOOK_ACCOUNT_ID'; // da POST /accounts dopo OAuth
async function ElencaEmailOutlook() {
const res = await axios.ottenere(
`https://\${DSN}/api/v1/emails`,
{
intestazioni: {
'X-API-KEY': CHIAVE_API,
'ID account'ACC_ID
}
}
);
console.log(res.data.items); // array di messaggi di Outlook
}
// Invia un'email tramite l'API di posta elettronica di Outlook
async function inviaEmailOutlook() {
await axios.posta(
`https://\${DSN}/api/v1/emails`,
{
account_id: ID_ACC,
a: [{ nome_display: 'Alice', identificatore: 'alice@contoso.com' }],
soggetto: 'Ciao dall'API di posta elettronica di Outlook',
corpo: 'Inviato tramite API Unipile Outlook Email.
'
},
{ intestazioni: { 'X-API-KEY': CHIAVE_API } }
);
}# Leggi e invia e-mail tramite l'API e-mail di Unipile per Outlook
import richieste
DSN = "api1.unipile.com:13211"
CHIAVE_API = "TUA_API_KEY"
ACC_ID = "ID_ACCOUNT_OUTLOOK"
INTÈSTAZIONI = {
"X-API-KEY": CHIAVE_API,
"account_id": ID_ACC,
}
#: Elenco delle e-mail di Outlook
def elenco_email():
r = richieste.ottenere(
"https://{DSN}/api/v1/email",
intestazioni=INTÈSTAZIONI
)
r.raise_for_status()
return r.json()["articoli"]
# Invia tramite l'API e-mail di Outlook
def invia_email(all_indirizzi, oggetto, corpo):
r = richieste.posta(
"https://{DSN}/api/v1/email",
intestazioni={"X-API-KEY": API_KEY},
json={
"account_id": ID_ACC,
"a": [{"identificatore": all_addr},
"soggetto"soggetto,
"corpo"corpo
}
)
r.raise_for_status()
return r.json()# Elenco delle e-mail dall'account Outlook collegato
ricciolo -s -X GET \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY: LA_TUA_CHIAVE_API" \
-H "account_id: ID_ACCOUNT_OUTLOOK" \
| jq '.items[] | {id, materia, mittente, data}'
# Invia e-mail tramite l'API di posta elettronica di Outlook
ricciolo -s -X POST \
"https://api1.unipile.com:13211/api/v1/emails" \
-H "X-API-KEY: LA_TUA_CHIAVE_API" \
-H "Content-Type: application/json" \
-d '{
"account_id": "ID_ACCOUNT_OUTLOOK",
"a": [{"identificatore": "alice@contoso.com"}],
"oggetto": "Ciao dall'API email di Outlook",
"corpo"Inviato tramite Unipile.
"
}'Microsoft Graph nativo vs API unificata per le e-mail di Outlook (Unipile)
Scopri i chiari vantaggi di sfruttare l'integrazione semplificata dell'API di posta elettronica di Outlook di Unipile rispetto alla creazione diretta su Microsoft Graph. Utilizza Hosted Auth per rafforzare la sicurezza attraverso una gestione migliorata delle credenziali, garantire un'integrazione fluida con Outlook e altre piattaforme di posta elettronica e ridurre l'overhead della manutenzione dei flussi OAuth.
| Dimensione | API Microsoft Graph nativa | API Email Outlook Unipile |
|---|---|---|
| Ambito di integrazione | Solo Outlook / Exchange Online | Outlook + Gmail + IMAP, stesso codice |
| configurazione del flusso OAuth | Registrazione App di Azure + gestione dei token per tenant | Un link OAuth ospitato, pagina OAuth white-label, zero token di autorizzazione |
| Aggiornamento del gettone | Il tuo codice deve essere aggiornato ogni 60 minuti (durata del token di accesso). | Unipile gestisce automaticamente l'aggiornamento per tutti gli account collegati |
| Rinnovo webhook | Gli abbonamenti scadono a 4.230 minuti, devi rinnovare prima della scadenza. | Unipile rinnova automaticamente gli abbonamenti Graph |
| Gestione del throttling | Devi implementare manualmente la logica di retry 429 e il backoff esponenziale | Gestione integrata dei tentativi e dei limiti di frequenza |
| Tempo per la prima email | 2-5 giorni (configurazione Azure + OAuth + logica token + gestione errori) | Sotto le 2 ore (segui questa guida) |
| Ritiro di Exchange Online | Deve migrare da EWS a Graph prima della scadenza di ottobre 2026 | Unipile usa già Graph, la migrazione è trasparente |
| Supporto | Documentazione Microsoft + forum | Supporto tecnico dal vivo + chiamata on-demand con il fondatore |
One Link Hosted Auth vs Flusso OAuth Completo
L'auth ospitata di Unipile automatizza il rilevamento dei provider di posta elettronica e gestisce l'autenticazione. Ciò riduce significativamente la complessità della configurazione iniziale, accelerando le tempistiche di sviluppo e riducendo la manutenzione. Guida API OAuth per email
Aggiornamenti e manutenzione costanti
Rimani all'avanguardia con aggiornamenti regolari e una manutenzione diligente. L'API Unipile Outlook Email viene continuamente migliorata per monitorare le modifiche a Microsoft Graph e offrire prestazioni ottimali, in modo che la tua integrazione funzioni anche quando Microsoft aggiorna la sua API. Guida all'integrazione di MS Graph
Il nostro team di supporto ti guida attraverso ogni fase dell'integrazione API di Outlook Email, dall'avvio al post-implementazione, senza costi aggiuntivi. API email per sviluppatori
Errori comuni nella creazione con l'API di posta elettronica di Outlook
Le API di Microsoft Outlook sono potenti ma presentano diverse limitazioni non ovvie che possono compromettere la tua integrazione in produzione. Ecco le 6 insidie più comuni e come evitarle.
Sicurezza e conformità per le integrazioni dell'API di posta elettronica di Outlook
Garantisci la sicurezza dei tuoi dati con protocolli di sicurezza avanzati. L'API di posta elettronica Outlook di Unipile garantisce che le tue email e le tue informazioni sensibili rimangano protette, con certificazione SOC 2 di tipo II e piena conformità al GDPR.
Domande frequenti
Risposte alle domande più comuni sull'integrazione delle API di Outlook Email, delle API di Microsoft Outlook e delle API di Outlook 365 con Unipile.
graph.microsoft.com/v1.0/me/messages, autenticato con un token bearer OAuth 2.0 di Azure AD. Unipile lo racchiude in un'interfaccia semplice e indipendente dal provider che funziona anche per Gmail e IMAP.Mail.ReadWrite, Mail.Send e Posta.Leggi permessi delegati, (3) implementare il flusso del codice di autorizzazione per ottenere un token di accesso. Con Unipile, salti tutto questo. Utilizza Hosted Auth per generare una pagina OAuth con un unico link per i tuoi utenti. Vedi il completo Guida API OAuth per email e il Guida OAuth di Microsoft Graph.Ti potrebbe interessare anche
Recuperare le e-mail con Unipile API
Gestire e recuperare le e-mail in modo programmatico è una competenza fondamentale. Che si tratti di automazione aziendale, assistenza clienti o marketing, capire come utilizzare un'API e-mail per recuperare le e-mail può semplificare le operazioni e migliorare l'efficienza. Questa guida vi guiderà attraverso gli elementi essenziali...
Come ottenere l'API e-mail per il vostro software
Esplorate i vantaggi dell'integrazione di un'API, in quanto rappresenta una porta d'accesso per sbloccare numerosi vantaggi nell'incorporare senza soluzione di continuità più servizi di posta elettronica nella vostra applicazione.Cos'è un'API di posta elettronica? Un'API (Application Programming Interface) è un servizio che consente agli sviluppatori di integrare...
Verifica OAuth di Google e credenziali API di Gmail (2026)
Avviso app non verificata API di Gmail L'avviso "Questa app non è verificata", il limite di 100 utenti e le esenzioni Prima che la tua app superi la verifica delle app di Google OAuth, ogni utente che tenta di autorizzarla visualizzerà una schermata di avviso. Google impone anche un limite rigido di 100 utenti alle app esterne non verificate. Ecco...
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR