LinkedIn
Instagram
WhatsApp
Telegramma
Calendario di Google
Partecipare alla comunità SlackCostruzione di un API email multi-provider l'integrazione che funziona su Gmail, Outlook e IMAP è una delle sfide che richiedono più tempo per i team di sviluppo. Ogni provider implementa il proprio flusso OAuth, limiti di frequenza e modello di dati. API email unificata astragga tutto questo in un'unica interfaccia REST - scrivi un'integrazione e ottieni copertura per ogni casella di posta principale su cui fanno affidamento i tuoi utenti.
Cosa imparerai
Guida completa all'API Email
Scopri come Gmail, Outlook e IMAP lavorano insieme sotto un'unica API REST unificata.
Perché gli sviluppatori hanno bisogno di un'API di email multi-provider
La maggior parte dei prodotti SaaS dovrà prima o poi leggere o inviare e-mail per conto dei propri utenti. Il problema non è il concetto, ma l'esecuzione. Gmail utilizza l'API di Gmail con Google OAuth 2.0. Outlook utilizza Microsoft Graph con il proprio ciclo di vita dei token. Fornitori basati su IMAP si comportano in modo leggermente diverso. Costruire e mantenere tre integrazioni separate prosciuga cicli di ingegneria che dovrebbero essere destinati al tuo prodotto principale. Se hai a che fare specificamente con account IMAP, Guida all'API IMAP copre la complessità aggiuntiva coinvolta. A API email unificata risolve questo collassando tutta la complessità specifica del provider dietro un'unica interfaccia: questa è la promessa fondamentale di un API email multi-provider approccio. Per un riferimento tecnico completo su come API per inviare email chiamate su Gmail, Outlook e IMAP, consulta la nostra guida dedicata.
Il 3 fornitori di email coperto
Un'unica API unificata normalizza Gmail, Outlook e IMAP in un'interfaccia identica. Il tuo codice non cambia mai quando un utente collega un provider diverso.
Connetti qualsiasi account Gmail o Google Workspace tramite Google OAuth 2.0. Invia, leggi, cerca e sincronizza thread in tempo reale tramite il livello Unipile, evitando la necessità di credenziali dirette dell'API Gmail nella tua app.
Supporta account Outlook personali, Microsoft 365 e Exchange Online sotto un'unica gestione provider. Microsoft OAuth è gestito da Unipile: la tua integrazione rimane stabile in tutte le configurazioni tenant.
Qualsiasi casella di posta raggiungibile tramite IMAP - Yahoo, Fastmail, ProtonMail Bridge, server aziendali personalizzati - diventa istantaneamente accessibile tramite la stessa superficie API utilizzata per Gmail e Outlook.
Unipile contro costruirlo da te
Quanto costa realmente fai-da-te API email multi-provider integrazione? Ecco un confronto onesto nelle dimensioni che contano nella produzione. Ecco perché i team scelgono sempre più una API email unificata come Unipile invece di costruire ogni integrazione del provider da zero.
Come la integrazione lavori
Collegare il tuo primo account email con Unipile richiede quattro passaggi. Lo stesso flusso funziona indipendentemente dal fatto che l'utente abbia Gmail, Outlook o Account IMAP - il codice della tua applicazione rimane identico. Questa è la potenza pratica di un'API email unificata: scrivi una volta, copri tutti e tre i provider.
Il tuo backend chiama l'API Unipile per creare un URL di autenticazione ospitato di breve durata. Reindirizza l'utente a quell'URL: Unipile presenta la schermata di selezione del provider e gestisce il flusso OAuth completo per tuo conto.
// POST /api/v1/hosted/accounts/link const ris = await fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', , metodo: 'POST', intestazioni: { 'X-API-KEY': process.env.CHIAVE_API_UNIPILE, 'Content-Type': 'application/json' }, corpo: JSON.stringify({ tipo: 'EMAIL', filtro_fornitori: ['GOOGLE', 'MICROSOFT', 'IMAP'], url_di_reindirizzamento_successo: 'https://tuaapp.com/auth/success' }) }); const { url } = await res.json(); // reindirizza l'utente a `url`
Una volta che l'utente completa l'OAuth, Unipile invia un webhook al tuo endpoint (o aggiunge l'ID dell'account al tuo URL di reindirizzamento). Archivia questo ID dell'account: è il tuo riferimento permanente a quell'account collegato, indipendente dal provider.
{
"evento": "account.connesso",
"account_id": "acc_01XYZ...",
"provider": "GOOGLE",
"email": "alice@gmail.com"
}
Usa l'ID dell'account per elencare, cercare e recuperare le email. Questo è il API email unificata in azione: lo schema di risposta è identico sia che l'account sia Gmail, Outlook o IMAP - la tua logica di parsing non si ramifica mai in base al provider.
// 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`, { intestazioni: { 'X-API-KEY': process.env.CHIAVE_API_UNIPILE } } ).allora(r => r.json()); // Stessa forma di risposta per Gmail, Outlook, IMAP: // { id, oggetto, da, a, data, corpo, allegati }
Un singolo endpoint POST invia email indipendentemente dal provider dietro l'account: questa è la piena potenza di un API email multi-provider. Passa l'ID dell'account, il destinatario, l'oggetto e il corpo - Unipile instrada tramite API Gmail, Microsoft Graph o SMTP in modo appropriato. Questo è il API email unificata nella sua forma più concreta: un endpoint, tre provider, zero diramazioni nel tuo codice.
// POST /api/v1/emails/invia await fetch('https://api5.unipile.com:13515/api/v1/email/invio', , metodo: 'POST', intestazioni: { 'X-API-KEY': process.env.CHIAVE_API_UNIPILE, 'Content-Type': 'application/json' }, corpo: JSON.stringify({ account_id: 'acc_01HXYZ...', a: [{ e-mail: 'bob@example.com' }], soggetto: 'Ciao da Unipile', corpo: 'Funziona con Gmail, Outlook e IMAP.
' }) });
Come astrazione del provider lavori
L'API email unificata si pone tra la tua applicazione e i tre protocolli provider sottostanti, traducendo flussi OAuth divergenti, schemi di dati e modelli di rate-limit in un'unica interfaccia coerente.
Gmail utilizza Google OAuth 2.0 con un ciclo di refresh dei token specifico e restituisce le e-mail in un modello incentrato sui thread con etichette. Outlook utilizza Microsoft Graph con un modello di tenant OAuth diverso e restituisce le e-mail come singoli oggetti messaggio con cartelle. I server IMAP hanno ciascuno i propri parametri di connessione, metodi di autenticazione e set di funzionalità.
Unipile's API email unificata normalizza tutti e tre in una singola interfaccia REST. Il tuo codice chiama /api/v1/email e riceve oggetti di risposta identici in termini di forma - indipendentemente dal fatto che l'account sottostante sia Gmail, Outlook o IMAP. Lo stesso vale per l'invio, la gestione degli allegati, gli eventi webhook e la gestione del ciclo di vita dell'account.
Questo è il principale vantaggio ingegneristico di API email multi-provider la complessità viene assorbita a livello di infrastruttura, non nel codice della tua applicazione. Quando Google cambia i requisiti relativi agli ambiti OAuth o Microsoft aggiorna la paginazione delle API Graph, Unipile gestisce il cambiamento a monte: la tua integrazione rimane intatta.
Sicurezza e conformità
Quando la tua applicazione gestisce le email per conto degli utenti, la sicurezza non è un'opzione. Ecco come il livello API unificato per le email gestisce credenziali, dati e obblighi di conformità.
Unipile memorizza e aggiorna i token OAuth per tuo conto. La tua applicazione non gestisce mai le credenziali grezze, ma lavora solo con ID account opachi. La rotazione dei token, il rilevamento delle scadenze e i flussi di riautenticazione sono gestiti interamente a livello di infrastruttura.
Tutti i dati in transito utilizzano TLS 1.3. Le credenziali archiviate sono crittografate a riposo con AES-256. Il contenuto delle email recuperato tramite l'API di posta elettronica unificata viene elaborato in memoria e non viene mantenuto oltre quanto esplicitamente richiesto dalla tua integrazione.
Unipile è certificata SOC 2 Type II (ottobre 2025). Auditor indipendenti hanno verificato la sicurezza, la disponibilità e la riservatezza della piattaforma. I rapporti di audit sono disponibili su richiesta per i clienti enterprise che stanno valutando l'API di posta elettronica multi-provider per l'uso in produzione.
Gli accordi sulla gestione dei dati sono disponibili per tutti i piani. L'opzione di residenza dei dati nell'UE è offerta ai clienti con requisiti di localizzazione dei dati. Il diritto alla cancellazione è supportato tramite API: l'eliminazione di un account collegato rimuove tutti i token e i dati memorizzati nella cache associati.
Valutazione della sicurezza delle applicazioni Google Cloud. Convalida i controlli di sicurezza per le applicazioni che accedono ai dati degli utenti Google, inclusi gli ambiti OAuth di Gmail. Le app basate su Unipile ereditano questa certificazione.
Lo storico di uptime e incidenti è disponibile pubblicamente su status.unipile.com. Tutte le modifiche all'API seguono una politica di versioning con avvisi di deprecazione. Nessuna modifica radicale silenziosa: la tua integrazione è protetta da un contratto stabile e documentato.
Manipolazione casi limite tra provider
Ogni integrazione di email di produzione incontra casi limite specifici del provider. Ecco un confronto tra un approccio fai-da-te e l'uso di un'API email unificata quando le cose si complicano.
| Scenario | Approccio fai da te | Approccio Unipile |
|---|---|---|
| Limite di frequenza di Gmail 250 unità di quota/quota giornaliera livello gratuito |
Monitoraggio manuale della quota per account; le richieste falliscono silenziosamente se non monitorate | Gestito automaticamente In coda integrata, nessuna richiesta non riuscita è emersa alla tua app |
| Scadenza token OAuth | Implementa una logica di aggiornamento separata per provider; la rotazione dei token differisce tra Google e Microsoft | Aggiornamento automatico Gestione dei token a zero downtime tra tutti i provider |
| Le connessioni IMAP cadono | Logica di riconnessione personalizzata per configurazione server; i timeout variano tra le implementazioni IMAP | Pool di connessioni gestito Connessioni persistenti mantenute dall'infrastruttura Unipile |
| Limiti di dimensione degli allegati Gmail 25MB, Outlook 150MB, IMAP varia |
Codice di ramificazione per provider; deve tenere traccia del limite di ogni provider e aggiornarlo quando cambiano | Validazione unificata Convalida delle dimensioni indipendente dal provider; errori restituiti in uno schema coerente |
| Modifiche API del provider | La tua responsabilità di reperibilità; Google e Microsoft introducono modifiche disruptive con preavviso limitato | Gestito dal team Unipile Modifiche a monte assorbite a livello di infrastruttura; la tua integrazione rimane stabile |
Limite di frequenza di Gmail
250 unità di quota/quota giornaliera livello gratuitoMonitoraggio manuale della quota per account; le richieste falliscono silenziosamente se non monitorate
La guida pilastro copre ogni endpoint della nostra API email unificata approfondimento - flussi di autenticazione, gestione degli allegati, sincronizzazione delle cartelle, filtri di ricerca e impostazione dei webhook. Tutto ciò che ti serve per creare un'integrazione email di livello produttivo.
Comune casi d'uso
A API email unificata è un'infrastruttura fondamentale per un'ampia gamma di categorie di prodotti. Con un API email multi-provider, i team rilasciano funzionalità più velocemente e servono più utenti, indipendentemente dal provider di posta elettronica che utilizzano. Ecco i pattern creati più frequentemente con Unipile.
Recupera automaticamente ogni email del cliente nei record del tuo CRM. I rappresentanti di vendita vedono la cronologia completa della conversazione senza dover mai cambiare scheda o inoltrare manualmente.
Invia sequenze di follow-up personalizzate dalle caselle di posta reali dei tuoi utenti, non da un dominio di invio condiviso, contemporaneamente tramite account Gmail e Outlook.
I recruiter collegano la loro email di lavoro e il tuo ATS registra automaticamente ogni thread di candidati. Rispondi direttamente dall'interfaccia utente dell'ATS, instradata attraverso il loro account Outlook o Gmail reale.
Crea una casella di posta condivisa o un help-desk che consolidi le email da più account del team. Indirizza, assegna e rispondi, tutto tramite un'unica interfaccia supportata da un'unica API.
Alimenta thread di email in un LLM per generare bozze di risposte, riepiloghi o elementi d'azione. Unipile fornisce i dati normalizzati dei thread; il tuo livello AI si occupa del ragionamento.
Attiva flussi di lavoro no-code da nuove email di qualsiasi provider. Un webhook si attiva per ogni messaggio in arrivo: la tua piattaforma di automazione gestisce il resto senza effettuare polling.
Ognuno di questi modelli funziona su Gmail, Outlook e IMAP con zero codice specifico del provider nella tua applicazione. Unipile normalizza le differenze in modo che la logica del tuo prodotto rimanga pulita e i tuoi utenti possano connettere qualsiasi casella di posta preferiscano. Per una guida completa di ogni endpoint, consulta il guida API unificata per email.
Domande frequenti domande
Tutto ciò che gli sviluppatori chiedono prima di integrare un'API email multi-provider.
id, soggetto, from, a, data, e corpo hanno la stessa struttura indipendentemente dal provider. La tua logica di analisi, i modelli di database e l'elaborazione downstream non avranno mai bisogno di ramificarsi in base al tipo di provider.
Collega gli account Gmail, Outlook e IMAP tramite un'unica API. Nessun problema con OAuth, nessuna mappatura dello schema, nessuna infrastruttura di polling da mantenere. Inizia con una prova gratuita di 7 giorni, senza carta di credito.
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR