LinkedIn
Instagram
WhatsApp
Telegramma
Calendario di Google
Partecipare alla comunità SlackAPI per l'invio di email: Invio da Utente Gmail, Outlook e IMAP Conti
La maggior parte delle API di posta elettronica invia da un dominio condiviso di tua proprietà. L'API di invio email di Unipile è diversa: invia dagli account Gmail, Outlook e IMAP dei tuoi utenti, con OAuth2 completo, nessun archiviazione di credenziali e un singolo endpoint unificato per ogni provider. Quando il tuo SaaS ha bisogno di inviare email programmaticamente per conto di persone reali, questa è l'integrazione che lo rende possibile.
Gmail
Prospettiva
IMAPUna API di invio email che agisce per conto dei tuoi utenti
La maggior parte delle ricerche per "API per l'invio di email" porta a provider transazionali. Non è questo il caso. Unipile è un'API per l'email basata sull'account utente: si collega agli account Gmail o Outlook reali dei tuoi utenti e invia per loro conto, con la loro identità e la loro deliverability.
Perché gli sviluppatori creano soluzioni basate su un'API di email per account utente
Quando il tuo prodotto deve inviare email programmaticamente da persone reali (non un indirizzo noreply@), questi sono gli scenari che guidano l'adozione.
Invia email di follow-up da Gmail o Outlook di ciascun rappresentante di vendita. Tassi di risposta più elevati, autentica identità del mittente, nessun riscaldamento del dominio richiesto. I potenziali clienti vedono un nome reale, non un alias generico.
Consenti agli agenti di supporto di rispondere direttamente dalla propria casella di posta elettronica. I clienti vedono il nome e l'indirizzo email di una persona reale, non un alias di supporto@. Costruisce fiducia, aumenta la velocità di risoluzione.
Raggiungi i candidati con email personalizzate dall'account effettivo del recruiter. Nessun dominio freddo, nessun rischio di filtro antispam, nessun periodo di riscaldamento. L'email arriva nella casella di posta come un messaggio personale, perché lo è.
Invia Email da Gmail, Outlook e IMAP: Un'unica API
L'API di invio email di Unipile astrae completamente il livello del provider. Che l'account del tuo utente sia Gmail, Outlook, Microsoft 365, Exchange Online o qualsiasi casella di posta compatibile IMAP, la chiamata API è identica. Scrivi l'integrazione una volta e ogni provider funzionerà.
gmail.inviaimpronta minima di permessi Mail.Send: delegata o a livello di app Come inviare email tramite API: integrazione passo dopo passo
Dal collegamento dell'account all'invio della tua prima email a livello programmatico, ecco il flusso completo. Questa guida copre Gmail e Outlook; i passaggi per IMAP sono identici, cambia solo il tipo di account.
Registrati sulla dashboard di Unipile. Ogni spazio di lavoro ottiene una chiave API. Tutte le richieste vengono autenticate con la CHIAVE X-API header. Nessuna configurazione OAuth da parte tua: Unipile gestisce l'autenticazione del provider per te.
Genera un link di autenticazione ospitato tramite l'API. L'utente ci fa clic e viene indirizzato tramite la schermata di consenso standard OAuth2 per il proprio provider. Unipile archivia i token in modo sicuro e restituisce una account_id. Non tocchi mai le credenziali.
"tipo":"MICROSOFT". Per IMAP, usa "tipo":"IMAP". Lo stesso flusso ospitato gestisce tutti e tre i provider.Dopo che l'utente completa OAuth2, Unipile invia un webhook al tuo endpoint con il account_id. Memorizzalo nel tuo database: sarà la chiave che utilizzerai in ogni chiamata API di invio email per quell'utente.
POST a /api/v1/email con il account_id. L'email viene inviata dalla casella di posta Gmail o Outlook effettiva dell'utente, proprio come se la inviasse da solo. L'endpoint è identico indipendentemente dal fatto che l'account collegato sia Gmail, Outlook o IMAP.
"cc", "copia carbone nascosta", "rispondi_a", e "allegati" allo stesso payload.Pronto a inviare email da Gmail, Outlook e IMAP?
La tua API key ti sta aspettando. Inizia a costruire in meno di 10 minuti.
Un endpoint unificato per inviare email attraverso tutti i provider
Il maggiore ostacolo nelle integrazioni multi-provider è il mantenimento di percorsi di codice separati per ciascun servizio di posta elettronica. Unipile elimina questo problema. Sia che l'account collegato sia Gmail, Outlook o IMAP, si chiama sempre lo stesso endpoint con lo stesso payload. Il livello di astrazione gestisce i protocolli specifici del provider, i refresh dei token e le differenze nei limiti di frequenza in background.
GmailProspettivaIMAPNessun percorso di codice separato per Gmail vs Outlook. Una singola integrazione copre tutti e tre i provider oggi e qualsiasi aggiunta futura che Unipile apporterà.
I token di accesso OAuth2 scadono. Unipile li aggiorna in modo trasparente. Il tuo codice non gestisce mai il ciclo di vita del token; chiama semplicemente l'API e invia.
Ogni utente collega il proprio account. Gestisci un account_id per utente; Unipile gestisce il resto. Nessuna gestione di SDK per provider.
L'API restituisce la stessa struttura JSON indipendentemente dal provider. Analizza un solo schema, crea un unico gestore degli errori, distribuisci più velocemente.
Hai bisogno di inviare email a nome dei tuoi utenti su larga scala? Leggi la guida completa su come fare inviare email per conto dei tuoi utenti, incluso il modello di conformità e consenso che Unipile utilizza per mantenere tutto verificabile.
Tutti gli endpoint API per l'invio di email, organizzati
Ogni endpoint disponibile per connettere account, inviare e rispondere, gestire la tua casella di posta e ascoltare eventi su Gmail, Outlook e IMAP con una singola integrazione.
Invia e rispondi
4 endpoint disponibili
GmailProspettivaIMAPConfigurazione dell'account
3 endpoint disponibili
GmailProspettivaIMAPGestisci Email
5 endpoint disponibili
GmailProspettivaIMAPGanci web
2 eventi disponibili
GmailProspettivaIMAPCopre i flussi di autenticazione, la configurazione dei webhook, la lettura e l'invio di email, gli allegati e un confronto completo tra i provider, tutto ciò di cui hai bisogno per creare un'integrazione API di invio email pronta per la produzione.
Autenticazione e Sicurezza per la Tua Integrazione API di Invio Email
La gestione delle credenziali email degli utenti è una delle parti a più alto rischio di qualsiasi integrazione SaaS. L'architettura di Unipile è progettata in modo da non memorizzare o trasmettere mai direttamente i token OAuth2; la superficie di rischio rimane minima e la conformità gestibile.
Unipile genera l'URL di consenso OAuth2, raccoglie il codice di autorizzazione e memorizza i token di accesso e di aggiornamento nel proprio vault crittografato. Il tuo backend vede solo un account_id. Nessun token grezzo, nessuna password, nessun deriva dei credenziali.
I token OAuth2 di Gmail scadono dopo 1 ora. I token di Microsoft scadono dopo 1 ora (di accesso) o 90 giorni (di rinnovo). Unipile li rinnova automaticamente prima della scadenza. Le tue chiamate API per l'invio di email non falliscono mai a causa di un token scaduto.
Per un'integrazione di solo invio, Unipile richiede solo gli ambiti necessari: gmail.invia per Gmail e Mail.Send per Outlook. Questo segue il principio del privilegio minimo e riduce la superficie di attacco per i dati dei tuoi utenti.
Ogni webhook che Unipile invia al tuo endpoint include un header di firma che puoi verificare rispetto al tuo segreto per webhook. Questo garantisce che i payload degli eventi non possano essere falsificati da terze parti che tentano di attivare azioni nel tuo sistema.
L'infrastruttura di Unipile è certificata SOC 2 Type II. I controlli verificati coprono la gestione degli accessi, la crittografia a riposo e in transito, la risposta agli incidenti e la disponibilità. Ciò rende semplice superare le revisioni di sicurezza dei fornitori quando i tuoi clienti SaaS ti chiedono come gestisci le loro credenziali email.
Scopri l'API di posta elettronica sicuraUnipile è valutato CASA Tier 2, lo standard di sicurezza richiesto da Google per le applicazioni che accedono a ambiti sensibili dell'API di Gmail. La valutazione viene condotta da un laboratorio autorizzato e copre la gestione dei dati, i controlli di accesso e le pratiche di sviluppo sicuro. Richiesto per mantenere l'accesso in produzione agli ambiti di invio di Gmail.
Copertura completa funzionalità API email per tutti i provider
Un'integrazione ti dà accesso a ogni operazione email principale su provider Gmail, Outlook e IMAP. Lo stesso endpoint, la stessa struttura del payload, lo stesso formato di risposta indipendentemente dall'account che il tuo utente ha collegato.
| Caratteristica | Gmail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Invio | |||
| Invia email dall'account utente | ✓ | ✓ | ✓ |
| Inviare con allegati | ✓ | ✓ | ✓ |
| Rispondi nella discussione esistente | ✓ | ✓ | ✓ |
| Destinatari CC eCCN | ✓ | ✓ | ✓ |
| Corpo HTML | ✓ | ✓ | ✓ |
| Immagini inline (incorporazione CID) | ✓ | ✓ | ✓ |
| Limite di invio giornaliero (circa) | ~500 / giorno | ~10.000 al giorno | Dipendente dal server |
| Lettura e Sincronizzazione | |||
| Elenca e leggi email | ✓ | ✓ | ✓ |
| Visualizzazione thread / conversazione | ✓ | ✓ | ✓ |
| Webhook in tempo reale (nuova email, letta, inviata) | ✓ | ✓ | ✓ |
| Sincronizzazione incrementale delta | ✓ | ✓ | ✓ |
| Gestione etichette e cartelle | ✓Etichette | ✓Cartelle | ✓Cartelle |
| Autenticazione e Sicurezza | |||
| OAuth2 (nessuna memorizzazione password) | ✓ | ✓ | Password dell'app |
| Rinnovo automatico del token | ✓ | ✓ | ✓ |
| SOC 2 Tipo II / CASA Livello 2 | ✓ | ✓ | ✓ |
Errori comuni nella creazione di un'integrazione API per l'invio di email
La maggior parte dei problemi che gli sviluppatori incontrano nell'integrare un'API per l'invio di email di account utente rientrano in un piccolo insieme di categorie. Ecco quelle degne di nota prima di iniziare la creazione.
Gli account Gmail personali sono limitati a circa 500 email al giorno. Gli account Outlook hanno limiti più elevati ma possono comunque subire rallentamenti in condizioni di picco. Il superamento di questi limiti comporta errori 429 o la sospensione temporanea dell'account da parte del provider.
Gli utenti possono revocare l'accesso in qualsiasi momento dalle impostazioni del proprio account Google o Microsoft. Quando ciò accade, Unipile restituirà un errore alla successiva chiamata API per quell'account. Se la tua applicazione non gestisce questo scenario in modo appropriato, ne deriveranno errori silenziosi nell'invio delle email.
account.disconnesso evento webhook e chiedi all'utente di ricollegare il proprio account.Anche con un token OAuth2 valido, l'invio di email dall'account di un utente a sua insaputa viola le norme di utilizzo di Google e Microsoft e le leggi antispam più diffuse. La schermata di consenso OAuth2 deve spiegare chiaramente cosa farà la tua applicazione.
Se memorizzi i token di accesso da solo e questi vengono esposti in una violazione dei dati, un aggressore ha pieno accesso a tutti gli account email collegati. Questo rappresenta un rischio critico per la sicurezza e la conformità, specialmente ai sensi del GDPR.
account_id; Unipile detiene i token nel suo vault certificato SOC 2. Il tuo database non entra mai in contatto con un token OAuth2 grezzo.SMTP richiede accesso diretto al server, gestione delle credenziali, configurazione TLS e gestione dei rimbalzi. Una API REST di invio email astrae tutto ciò. Combinare entrambi gli approcci nello stesso codebase aggiunge complessità senza benefici.
Domande frequenti
Tutto quello che devi sapere sull'API per l'invio di email.
account_id tramite webhook. Quindi invii tramite POST a /api/v1/email Con quell'account_id e il tuo messaggio payload. L'email viene inviata dal loro effettivo indirizzo Gmail. Nessuna configurazione della chiave API di Gmail è richiesta da parte tua.Mail.Send permesso delegato. Unipile gestisce automaticamente l'aggiornamento dei token.https://www.googleapis.com/auth/gmail.send. Ciò consente l'invio di email ma non concede l'accesso per leggere, modificare o eliminare messaggi. Quando si utilizza Unipile, non si configura questo ambito da soli; il flusso di autenticazione ospitato se ne occupa. Per un caso d'uso di API di invio email puro, gmail.invia è sufficiente.POST /api/v1/email l'endpoint gestisce account Gmail, Outlook e IMAP. Il provider è determinato da account_id nel payload; non è necessario specificarlo. Scrivi la tua logica di invio una sola volta e funzionerà indipendentemente dal provider di posta elettronica collegato dal tuo utente.Avete ancora domande? Il nostro team è qui per aiutarvi.
Collega il tuo primo account Gmail, Outlook o IMAP e invia la tua prima email in modo programmatico in meno di 30 minuti. Nessuna memorizzazione di credenziali, nessuna configurazione OAuth2 da parte tua, nessun SDK per ogni provider. Un account_id, un endpoint REST, tutti i provider.
IT 
EN 
FR 
ES 
DE 
BR 
NL 
PL 
TR