LinkedIn
Instagram
WhatsApp
Telegramma
Gmail
Prospettiva
Calendario di Google
Partecipare alla comunità Slack5 Prodotti che funzionano con una API e-mail - e Perché
Arricchimento CRM, tracciamento candidati ATS, engagement vendite, caselle di posta helpdesk, assistenti AI: ciascuno di questi prodotti necessita di leggere e inviare e-mail per conto di utenti autenticati. Questa guida mostra esattamente come farlo, con pattern di codice reali, in modo che tu possa creare lo stesso in ore, non in settimane.
const response = await fetch(
`/api/v1/emails?account_id=${accountId}`,
{ headers: {
'X-API-KEY': process.env.UNIPILE_KEY
}}
);
const { email } = await risposta.json();
// Registrazione automatica nella cronologia contatti
RegistraNelCRM(email, contactId);
Cosa puoi costruire con un'API per le email?
Un'API email per la sincronizzazione utente permette al tuo prodotto leggere, sincronizzare e inviare email per conto di utenti autenticati, Accesso alle loro caselle di posta reali tramite OAuth. I cinque casi d'uso principali delle API di posta elettronica sono: Arricchimento del CRM (registra automaticamente ogni email di potenziale cliente), Tracciamento candidati ATS (sincronizzazione thread per candidato), interazione di vendita (rilevamento risposte e invio da casella di posta reale), assistenza clienti (casella di posta unificata multi-mailbox), e Agenti email IA (accesso LLM con ambito per bozza e smistamento). Ognuno di questi si basa sullo stesso schema di base: leggere + sincronizzare + inviare per conto dell'utente autenticato.
| Verticale | Email lavoro | Schema API | Fornitori principali |
|---|---|---|---|
| CRM | Arricchisci contatto, registra automaticamente thread | leggi + sincronizza | Gmail, Outlook, IMAP |
| ATS / Reclutamento | Traccia il thread del candidato, condividi la vista | sincronizza + leggi | Gmail, Outlook, IMAP |
| Coinvolgimento delle vendite | Rilevamento risposte, invia dalla casella di posta del rappresentante | sinconizza + invia | Gmail, Outlook, IMAP |
| Assistenza Clienti | Casella di posta unificata, ticket dal thread | leggere + inviare | Gmail, Outlook, IMAP |
| Agente E-mail AI | Triage, bozza, riassumere per conto di | leggi + invia (scoped) | Gmail, Outlook, IMAP |
Non è quello che stai cercando? Ci sono due categorie di API per le email: transazionale (SendGrid, Mailgun, possiedi il dominio di invio, i destinatari non si sono mai iscritti al tuo prodotto) e sincronizzazione utente (questo articolo). User-sync significa delega OAuth, il tuo prodotto agisce per conto di utenti autenticati che accedono alle proprie caselle di posta. I cinque casi d'uso seguenti appartengono tutti allo user-sync. Se hai bisogno di inviare newsletter in blocco dal tuo dominio, questa non è la tua guida.
API e-mail per CRM
Un CRM che utilizza un'API email può registrare automaticamente ogni email scambiata tra un rappresentante e un potenziale cliente direttamente sul record del contatto, senza alcuna operazione di copia-incolla. L'API email legge la casella di posta dell'utente per conto del rappresentante autenticato, abbina i thread ai contatti esistenti tramite indirizzo email e scrive sulla timeline del CRM in tempo reale.
Il modello dietro API per email per CRM è letto + sincronizzato + inviato - tutto per conto dell'utente autenticato. Il rappresentante collega il proprio account Gmail o Outlook una volta tramite OAuth. Dopodiché, ogni email in entrata e in uscita con un contatto noto viene catturata automaticamente: nessun inoltro BCC, nessuna estensione del browser, nessun salvataggio manuale.
// 1. Recupera le email di un contatto
a nome del rappresentante autenticato
GET /api/v1/email
?account_id={rep_account_id}
&dall_email={indirizzo_email_contatto}
Autorizzazione: X-API-KEY {chiave}
Risposta
{
"oggetto": "ElencoEmailAccount",
"articoli": [
{
"id": "em_01abc",
"soggetto": "Re: Seguito",
"da": "contact@acme.com",
"data": "2026-06-05"
}
]
}API Email per ATS / Software di Recruiting
Un ATS che integra un'API di posta elettronica ottiene una visualizzazione completa e sincronizzata automaticamente di ogni conversazione via email con ogni candidato, tra tutti i recruiter e tutti i provider di posta elettronica. I recruiter collegano i propri account una sola volta; da quel momento in poi, ogni thread di email viene automaticamente associato al profilo del candidato.
Il API e-mail per ATS Il caso d'uso ruota attorno alla sincronizzazione e alla visibilità. I team di recruiting hanno in genere diversi recruiter che lavorano su account email differenti, Gmail per uno, Outlook per un altro. L'API email legge ciascun account collegato per conto del recruiter autenticato e visualizza tutti i thread che coinvolgono l'indirizzo email di un candidato in una singola timeline unificata all'interno dell'ATS.
Il Caso d'uso dell'API email Questo è particolarmente utile per i team composti da più fornitori. I responsabili delle assunzioni nelle grandi aziende utilizzano spesso sia account Gmail che Outlook. Un'API di posta elettronica unificata gestisce entrambi con un'unica integrazione, consentendo allo sviluppatore dell'ATS di scrivere un unico codice, anziché due. Per il modello tecnico completo sulla lettura dei dati della posta in arrivo, consultare il guida API per leggere email. Per schemi di sincronizzazione in tempo reale, vedi la guida API di sincronizzazione email.
Riepilogo del pattern dell'API email ATS: Collega gli account dei reclutatori tramite OAuth (Gmail, Outlook o IMAP). Sincronizza tutte le conversazioni in entrata e in uscita per ogni indirizzo del candidato. Mostra una cronologia unificata nell'interfaccia utente dell'ATS. Se lo desideri, invia email di risposta dall'ATS a nome della casella di posta reale del reclutatore: nessun inoltro in CCN, nessun alias email, nessun "da noreply@yourapp.com".
API e-mail per il coinvolgimento delle vendite
Le piattaforme di sales engagement utilizzano un'API per le email al fine di rilevare quando un potenziale cliente risponde e attivare automaticamente il passaggio successivo di una sequenza: mettere in pausa i follow-up, notificare il venditore, spostare lo stadio della trattativa. Fondamentalmente, le email in uscita vengono inviate dalla casella di posta reale del venditore, non da un dominio di piattaforma condiviso, il che preserva la deliverability e l'identità del mittente.
Il API email per l'engagement nelle vendite Il modello prevede la sincronizzazione e l'invio su base individuale per ciascun utente. Ogni rappresentante collega il proprio account Gmail o Outlook una sola volta. Ogni email in una sequenza attiva viene inviata dall'indirizzo reale di quel rappresentante. Quando arriva una risposta, il motore di sincronizzazione rileva l'ID del thread, lo abbina a una sequenza aperta e attiva l'automazione appropriata. Si tratta di una decisione presa dal cliente: la piattaforma si limita a trasmettere l'azione; la cadenza e il volume rimangono sotto il controllo del team di vendita.
Questo caso d'uso API di email è la spina dorsale di strumenti come piattaforme di outreach e SaaS di automazione delle vendite. Il vantaggio della deliverability è fondamentale: le email inviate da rep@azienda.it tramite la casella di posta Gmail o Outlook effettiva del rep ereditano la reputazione di invio del dominio. Le email inviate da un dominio di piattaforma condiviso non lo fanno. Il modello di invio completo è documentato nel Guida API per l'invio di e-mail.
Perché è importante per la deliverability: L'invio da piattaforma (da sequences@platform.com) separa la reputazione del mittente dal dominio del mittente. L'invio tramite sincronizzazione utente instrada ogni email attraverso la casella di posta effettiva dell'utente autenticato - Gmail SMTP o Outlook Graph - quindi la recapitalità è legata al dominio del mittente, non a quello della piattaforma. Questo è un vantaggio strutturale che nessuna API di email transazionali può replicare.
API per l'assistenza clienti/helpdesk via email
Un helpdesk basato su un'API di posta elettronica raggruppa tutte le caselle di posta dell'assistenza (support@, billing@, enterprise@) in un'unica casella di posta unificata. Le nuove e-mail generano automaticamente dei ticket. Le risposte vengono inviate dall'indirizzo della casella di posta originale. L'operatore dell'assistenza non deve mai uscire dall'interfaccia dell'helpdesk per aprire Outlook o Gmail.
Il API email per il supporto clienti il caso d'uso è prevalentemente lettura + invio, con un forte requisito di threading. La maggior parte degli helpdesk gestisce più indirizzi su più provider: un team utilizza Gmail, un altro Outlook, un terzo potrebbe avere una casella di posta legacy solo IMAP. Un'API email unificata legge tutti gli account collegati come un unico flusso, preservando il contesto dei thread in modo che gli agenti possano rispondere in-thread con la corretta identità del mittente.
Questo Caso d'uso dell'API email è il modo in cui i moderni prodotti SaaS di helpdesk, in particolare quelli che si posizionano contro gli strumenti legacy basati esclusivamente sulle e-mail, si differenziano. La principale differenza è la fedeltà della conversazione: le e-mail fluiscono attraverso il canale SMTP/Graph reale del proprietario della casella di posta, quindi le risposte finiscono nella conversazione corretta lato cliente, non come un messaggio scollegato da un indirizzo generico della piattaforma. Per la guida tecnica completa che copre tutti e tre i provider, consulta il Guida alle API per le e-mail.
Integra la tua casella di supportoAPI email per agenti/assistenti email AI
Gli agenti email basati sull'IA utilizzano un'API email per concedere a un modello linguistico di grandi dimensioni un accesso limitato e per conto di un utente alla sua casella di posta reale, leggendo le conversazioni per redigere risposte, smistare i messaggi, riassumere lunghe catene di email e, opzionalmente, inviare risposte dopo la revisione umana. Il modello non gestisce mai le credenziali OAuth; l'API email astrae la casella di posta come un flusso pulito e strutturato.
Questa è l'ultima novità Caso d'uso dell'API email e il più veloce in crescita nel 2026. Gli assistenti AI integrati in strumenti di produttività, strumenti di vendita e prodotti CRM necessitano tutti delle stesse tre cose: accesso in lettura alla posta in arrivo per il recupero del contesto, dati strutturati delle email per il prompting (oggetto, mittente, corpo, ID thread) e un canale di invio opzionale per bozze confermate. L'API email fornisce tutti e tre in una singola integrazione tra Gmail, Outlook e IMAP, per conto dell'utente autenticato.
Accesso limitato e trattamento dei dati: Gli agenti email AI basati su un'API di sincronizzazione email per utenti accedono solo alla casella di posta dell'utente autenticato, mai oltre tale ambito. L'API email agisce come un intermediario tecnico indipendente, trasmettendo dati strutturati al livello LLM senza memorizzare una copia parallela delle e-mail dell'utente. L'ambito di trattamento dei dati, la conservazione e il consenso rimangono una decisione che spetta al cliente. Questa è l'architettura corretta per gli agenti di IA che operano per conto di utenti reali senza trasformarsi in un data warehouse.
Quando si sviluppano agenti di posta elettronica basati sull'intelligenza artificiale su larga scala, è necessario tenere conto della realtà multi-provider: i tuoi utenti disporranno di account Gmail, Outlook e IMAP. Un'API di posta elettronica unificata normalizza il flusso della posta in arrivo in una struttura coerente — thread_id, oggetto, mittente, destinatario, corpo del messaggio, data — indipendentemente dal provider. Il modello di prompt LLM rimane lo stesso per tutti e tre. Per la guida tecnica completa sul livello di integrazione e-mail per i prodotti di IA, consultare il Guida API Email per sviluppatori. Per l'architettura più ampia di agenti AI multicanale (aggiungendo LinkedIn, WhatsApp e altri canali allo stesso agente), la prossima guida sull'API multicanale per agenti AI copre lo stack completo.
Inizia a costruire il tuo agente email AITransazionale vs. Sincronizzato con l'utente: in quale caso d'uso ti trovi?
Se i cinque casi d'uso delle API di posta elettronica sopra indicati non corrispondono alle tue esigenze, forse ti trovi nella categoria sbagliata. Le API di posta elettronica si dividono in due mercati fondamentalmente diversi, quello transazionale e quello della sincronizzazione degli utenti, che non si sovrappongono. Questa breve sezione ti aiuta a capire a quale categoria appartieni, in modo da smettere di valutare gli strumenti sbagliati.
| Dimensione | API per le email transazionali | API di sincronizzazione e-mail utente (questo articolo) |
|---|---|---|
| Chi possiede il dominio di invio | Tu | L'utente (la sua Gmail / Outlook) |
| Mittenti tipici | noreply@yourapp.com | user@theirdomain.com |
| Richiesto OAuth | No | Sì |
| Leggi / sincronizza casella di posta dell'utente | No | Sì |
| Casi d'uso | Notifiche, ricevute, marketing | CRM, ATS, vendite, supporto, agenti AI |
| Provider di esempio | SendGrid, Mailgun, Resend | Gmail API, MS Graph, IMAP, Unipile |
Se il tuo prodotto invia notifiche, ricevute o email di marketing da un dominio che possiedi, quello è il mercato transazionale e SendGrid, Mailgun o Resend sono gli strumenti giusti. Se il tuo prodotto necessita di accedere alle caselle di posta reali degli utenti per loro conto, leggere le loro email, sincronizzare i loro thread o inviare dal loro indirizzo effettivo, quello è user-sync, e i cinque casi d'uso delle API di posta elettronica sopra sono esattamente ciò che stai costruendo. Per un'analisi più approfondita su quando scegliere ciascun approccio, consulta la guida completa sulle API per le email di sincronizzazione e transazionali.
Dati, privacy e responsabilità della piattaforma
Ogni caso d'uso dell'API email di questo articolo coinvolge l'accesso alle caselle di posta elettronica degli utenti reali tramite OAuth. Prima di iniziare a costruire, capisci come Unipile opera come intermediario, cosa significa la gestione dei dati in pratica e dove risiede la responsabilità della piattaforma.
Unipile non mantiene una copia parallela delle email dei tuoi utenti indipendentemente dalla loro casella di posta. L'accesso è limitato a utente autenticato'account, limitato alla sessione e alle autorizzazioni concesse tramite OAuth. Nessun archivio email viene creato al di fuori del provider dell'utente (Gmail, Outlook, IMAP). L'ambito della gestione dei dati, le politiche di conservazione e i meccanismi di consenso dell'utente rimangono responsabilità del tuo prodotto in qualità di titolare del trattamento dei dati.
Unipile funge da intermediario tecnico indipendente tra il tuo prodotto e il fornitore di posta elettronica. Ogni operazione di posta elettronica: lettura, sincronizzazione, invio - viene eseguita per conto di il proprietario dell'account collegato, utilizzando le proprie credenziali OAuth. Unipile non è affiliata, approvata o sponsorizzata da Google o Microsoft. Nessuna credenziale viene condivisa tra gli utenti. Ogni account collegato è isolato.
Unipile riporta i limiti di frequenza e i controlli di accesso del provider di posta elettronica sottostante (Google, Microsoft, server IMAP). La frequenza delle chiamate API, la cadenza delle sincronizzazioni e il volume di email inviate per account rimangono una decisione lato cliente. Il tuo prodotto è responsabile del rispetto delle quote del fornitore e delle normative applicabili (GDPR, CCPA). Unipile è certificato SOC 2 e conforme al GDPR come livello di infrastruttura.
Unipile non è affiliata, approvata o sponsorizzata da Google o Microsoft Corporation. Gmail e Outlook sono marchi commerciali dei rispettivi proprietari. Google non è affiliata a Unipile. Microsoft non è affiliata a Unipile. L'uso di queste piattaforme tramite l'API di Unipile è soggetto ai termini di servizio e alle politiche di utilizzo accettabile delle rispettive piattaforme.
Casi d'uso dell'API per le email - FAQ
Domande comuni sull'uso delle API email, sull'accesso alla casella di posta tramite OAuth e sulla creazione di API email per la sincronizzazione degli utenti.
Un API email consente ai prodotti software di leggere, sincronizzare e inviare e-mail per conto degli utenti autenticati - accedere alle loro caselle di posta elettronica Gmail, Outlook o IMAP reali tramite OAuth. Core casi d'uso delle API di posta elettronica include arricchimento CRM, tracciamento candidati ATS, automazione sequenze di coinvolgimento delle vendite, caselle di posta unificate per helpdesk e agenti email AI. Questo è distinto dalle API di email transazionali (SendGrid, Mailgun) che inviano messaggi in blocco da un dominio di proprietà della piattaforma e non implicano l'accesso alle caselle di posta tramite OAuth.
Un CRM utilizza un'API di posta elettronica per registrare automaticamente ogni conversazione via email tra un rappresentante e un potenziale cliente sul record di contatto, senza dover copiare e incollare manualmente o inoltrare via BCC. API per email per CRM legge la casella di posta del rappresentante per conto del utente autenticato, abbina i thread agli indirizzi email di contatto e scrive sulla timeline del CRM in tempo reale. Abilita inoltre l'invio di email dal CRM utilizzando la casella di posta elettronica effettiva del rappresentante, in modo che le risposte provengano dal loro vero indirizzo, un elemento fondamentale per i tassi di risposta e la deliverability.
Le piattaforme ATS utilizzano API e-mail per ATS per sincronizzare tutte le conversazioni tra recruiter e candidati. Ogni recruiter collega il proprio account Gmail o Outlook una volta tramite OAuth. L'API legge tutte le email inviate o ricevute dall'indirizzo di ciascun candidato su tutti gli account dei recruiter e le associa al profilo del candidato. Ciò garantisce una visibilità condivisa all'intero team senza che nessuno debba accedere alla casella di posta di un collega. Alcuni prodotti ATS lo associano a un Calendario API analizzare thread di pianificazione di interviste e creare eventi automaticamente.
Sì. È possibile sincronizzare la casella di posta Gmail o Outlook di un utente utilizzando un'API di posta elettronica che supporti la delega OAuth. L'utente si autentica una volta tramite Google o Microsoft OAuth, concedendo alla tua app l'accesso per conto di il loro account. L'API fornisce quindi endpoint per elencare le email, recuperare il contenuto delle conversazioni, sincronizzare nuovi messaggi tramite webhook e inviare dalla casella di posta dell'utente. Un'API email unificata come Unipile copre Gmail, Outlook e IMAP con un'unica integrazione - vedi Guida alle API per le e-mail per la guida tecnica completa.
Gli assistenti email AI accedono alle email tramite un'API email che fornisce accesso alla casella di posta con ambito, per conto di per l'utente autenticato. L'API delle e-mail recupera dati strutturati (oggetto, da, a, corpo, ID thread) e li passa all'LLM come contesto. Il modello genera quindi una bozza di risposta, un riepilogo o un'azione di smistamento. L'API delle e-mail gestisce OAuth e normalizza le differenze tra i provider (Gmail, Outlook, IMAP) in modo che il livello AI riceva un feed strutturato coerente indipendentemente dal provider che l'utente ha. Il modello non gestisce mai credenziali o token OAuth grezzi.
Sì. La lettura della casella di posta di un utente richiede l'autorizzazione OAuth. Per Gmail, ciò significa Google OAuth 2.0 con la configurazione appropriata. scope di Gmail API. Per Outlook, ciò significa Microsoft OAuth con autorizzazioni Microsoft Graph. Per IMAP, XOAUTH2 è lo standard moderno (l'autenticazione di base è stata deprecata dai principali provider, tra cui Google e Microsoft). OAuth garantisce che l'utente acconsenta esplicitamente all'accesso alla posta in arrivo e che l'ambito delle autorizzazioni sia limitato a quanto approvato. Un'API unificata per l'e-mail gestisce questo flusso OAuth per tutti e tre i provider.
Il più Integrazione email per SaaS i prodotti rientrano in uno dei cinque casi d'uso di sincronizzazione utente in questo articolo: CRM (registrazione conversazioni), ATS (monitoraggio candidati), vendite (rilevamento invio/risposta), supporto (casella di posta unificata) o AI (recupero contesto). La decisione architetturale sottostante - se costruire direttamente sull'API di Gmail / Microsoft Graph / IMAP o utilizzare un livello di astrazione unificato - è trattata in dettaglio in Guida all'API email per SaaS, inclusi pattern architetturali, costi nascosti e la decisione "build vs. buy".
No. Unipile non è affiliata, approvata o sponsorizzata da Google o Microsoft. Unipile è un intermediario tecnico indipendente che fornisce uno strato di API unificato su Gmail (Google), Outlook (Microsoft) e IMAP. L'accesso a ciascun provider è regolato dai rispettivi termini di servizio della piattaforma. Unipile è certificato SOC 2 e conforme al GDPR come strato infrastrutturale. Il tuo prodotto rimane responsabile del consenso dell'utente, dell'ambito di gestione dei dati e della conformità alle normative applicabili sulla protezione dei dati.
Hai ancora domande sull'uso delle API email? Il nostro team è qui per aiutarti.
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR