LinkedIn
Instagram
WhatsApp
Telegram
Google Agenda
Word lid van de Slack-gemeenschapGeef uw SaaS toegang tot Gebruikersinboxen via E-mail API
Een e-mail API voor SaaS laat uw product e-mails rechtstreeks lezen, verzenden en synchroniseren vanuit de Gmail-, Outlook- of IMAP-accounts van uw gebruikers - zonder wachtwoorden aan te raken. Bouw CRM-integraties, verkooptrucs, helpdesks en AI-assistenten op een uniforme OAuth-fundering.
importeer { UnipileClient } van 'unipile-node-sdk';
const klant = nieuw UnipileClient('UW_DSN', 'UW_TOKEN');
// Koppel de inbox van een gebruiker
const link = wacht op account van de cliënt.create({
type: 'google',
omleiding_url: 'https://app.com/cb'
});
// Haal de laatste 50 e-mails op
const { items } = wacht op client.e-mail.ophalen({
account_id: 'gebruikersaccount_id',
beperken: 50
});
// Verzenden vanaf het adres van de gebruiker
wacht op client.e-mail.verzenden({
account_id: 'gebruikersaccount_id',
aan: [{ identifier: 'lead@co.com' }],
onderwerp: 'Vervolg',
body: 'Hoi, even contact opnemen...'
});
Wat is een E-mail API voor SaaS?
De meeste ontwikkelaars horen "e-mail API" en denken aan tools zoals SendGrid of Mailgun - services voor het verzenden van transactionele e-mails (bonnen, meldingen, magische links) vanaf hun eigen domein. Dat is een heel andere markt. Een e-mail API voor SaaS lost een fundamenteel ander probleem op: het geven van programmatische toegang tot de e-mailaccounts van uw gebruikers.
Een e-mail API voor SaaS een set HTTP-eindpunten waarmee uw product kan authenticeren met de e-mailprovider van een gebruiker (Gmail, Outlook of IMAP) via OAuth, en vervolgens e-mails namens hen kan lezen, verzenden, synchroniseren en doorzoeken - allemaal via één enkele integratie, zonder wachtwoorden op te slaan of provider-specifieke eigenaardigheden te beheren.
Verstuurt e-mails vanuit uw domein aan uw gebruikers. Gebruikt voor wachtwoordherstel, facturen, meldingen en marketingcampagnes. Uw product beheert het afzenderadres.
Geeft uw SaaS toegang tot de inboxes van uw gebruikers via OAuth. Uw product leest, verzendt en synchroniseert e-mails namens elke gebruiker - vanuit hun Gmail-, Outlook- of IMAP-account.
Welke SaaS-producten bouwen daadwerkelijk met een e-mail-API
Elk product waarbij gebruikers actie moeten ondernemen op e-mails - of waarbij e-mails naar uw datamodel moeten worden gestroomd - is een kandidaat voor een user-sync e-mail API. Hier zijn de vijf meest voorkomende patronen die bouwers inzetten met Unipile.
Leg automatisch elke e-mailwisseling vast tussen een verkoper en een contactpersoon. Geen handmatige registratie, geen gemiste contactmomenten. Je CRM blijft up-to-date zonder enige actie van de gebruiker.
Voer uitingsreeksen met meerdere stappen uit vanuit het eigen Gmail- of Outlook-adres van elke vertegenwoordiger - niet een gedeeld verzenddomein. Antwoorden komen terecht in de echte inbox van de vertegenwoordiger en worden automatisch gedetecteerd.
Ondersteuningsmails van meerdere teaminboxen ophalen in een uniforme ticketwachtrij. Antwoorden die vanuit uw helpdesk-interface worden verzonden, gaan via het eigen gekoppelde account van de medewerker, waardoor de afleverbaarheid behouden blijft.
Geef uw AI-product toegang tot de volledige e-mailgeschiedenis van een gebruiker. Vat gesprekken samen, stel antwoorden op, extraheer actiepunten of classificeer leads – allemaal gebaseerd op de werkelijke inboxgegevens van de gebruiker.
Laat gebruikers hun inbox verbinden om automatiseringen te activeren - maak taken aan vanuit e-mails, extraheer factuurgegevens, routeer bijlagen naar opslag, of koppel e-mail met Slack, Notion, of je eigen workflow-engine.
Koppel recruiters' inboxen aan je ATS. Associeer automatisch e-mails van kandidaten met sollicitaties, volg reactiesnelheden en laat recruiters rechtstreeks antwoorden vanuit hun gekoppelde account, zonder je platform te verlaten.
Wat een Productie-e-mail API voor SaaS moet ondersteunen
Het bouwen van een betrouwbare e-mailintegratie is meer dan het aanroepen van een REST-endpoint. Hier zijn de zes mogelijkheden die elke serieuze SaaS e-mail API-integratie moet bieden - en waar de verborgen complexiteit in elk van deze schuilt.
Elke gebruiker koppelt zijn eigen inbox via een aparte OAuth-goedkeuring. Je SaaS fungeert namens elke geauthenticeerde gebruiker - niet via één gedeelde serviceaccount. Google en Microsoft vereisen beide app-verificatie voordat u OAuth-tokens op schaal kunt uitgeven.
Uw gebruikers zullen Gmail-, Outlook- (persoonlijk en Microsoft 365) en IMAP-gebaseerde inkomende e-mail hebben. Een robuuste e-mail-API voor SaaS normaliseert deze drie providers naar een enkelvoudige uniforme responsindeling zodat uw productlogica provider-agnostisch blijft.
Om de paar minuten peilen is fragiel en traag. Productie SaaS vereist webhook-meldingen wanneer nieuwe e-mails arriveren of de berichtstatus verandert. Gmail gebruikt Pub/Sub, Microsoft Graph gebruikt abonnementen - uw API-laag moet beide abstraheren in één gebeurtenisformaat.
E-mailclients groeperen berichten in threads. Je e-mail-API moet een consistente thread-identifier over providers heen, zodat u kunt antwoorden binnen de thread, gesprekken kunt samenvouwen en kunt detecteren of een uitgaande reeks een antwoord kreeg - zonder zelf ruwe Message-ID-headers te hoeven parsen.
Het lezen van bijlagen betekent het decoderen van MIME-delen, het afhandelen van inline afbeeldingen en het downloaden van binaire blobs via provider-specifieke API's. Het eindpunt moet je laten bijlagen ophalen op ID zonder de volledige berichtinhoud bij elk verzoek opnieuw te downloaden.
E-mailgegevens zijn gevoelig. Uw integratie heeft tokenversleuteling opgeslagen, scope OAuth-machtigingen (vraag alleen wat je nodig hebt), auditlogs en een gedocumenteerd pad voor gegevensverwijdering om te voldoen aan de GDPR-verzoeken tot recht op vergetelheid en SOC 2 Type II-audits.
De verborgen kosten van het bouwen van uw eigen e-mail API-integratie
De Gmail API, Microsoft Graph en IMAP-bibliotheken zijn allemaal gratis en goed gedocumenteerd. Waarom onderschatten de meeste SaaS-teams de bouwkosten dan met 3-5x? Omdat de complexiteit niet in de initiële integratie zit, maar in al hetgeen daarna komt.
Apps die Gmail-scopes aanvragen die verder gaan dan het basisprofiel, moeten slagen Google's CASA Tier 2 veiligheidsbeoordeling voordat ze meer dan 100 testgebruikers kunnen bedienen. Bij dit proces is een extern beveiligingslaboratorium betrokken; het duurt 4 tot 8 weken en kost tussen de 4.000 en 75.000 euro, afhankelijk van de omvang.
Microsoft vereist publicatieverificatie voor apps die Graph API-bereiken met hogere privileges aanvragen. Zonder dit ziet elke gebruiker een rode waarschuwingsbanner op het OAuth-toestemmingsscherm - een belangrijke drempel voor conversie bij B2B SaaS-onboardingstromen.
Er zijn honderden IMAP-serverimplementaties in omloop. Elk heeft eigenaardigheden: niet-standaard mappenamen, kapotte IDLE-ondersteuning, TLS-certificaat randgevallen, gedrag op het gebied van verbindings time-outs, en authenticatiestromen per server. Elke zakelijke klant die u binnenhaalt, kan een nieuwe uitzonderingsgevallen opleveren dat blokkeert hun team.
OAuth-tokens verlopen. Vernieuwingstokens kunnen worden ingetrokken door de gebruiker of door beleid van de provider. Op schaal, Token levenscyclus beheren voor duizenden gekoppelde accounts over drie providers vereist een betrouwbare achtergrondtaak, foutmeldingen en een soepele UX-flow voor herauthenticatie.
Google en Microsoft stellen API-oppervlakken buiten gebruik en werken deze bij. Gmail Basic Auth is verwijderd. Microsoft heeft verouderde Exchange-eindpunten buiten gebruik gesteld. Bijblijven met de wijzigingslogboeken van drie providers is een voortdurende onderhoudslast die volledig bij uw engineeringteam ligt.
E-maildata valt onder de GDPR en SOC 2 Type II. U hebt gedocumenteerde gegevensstromen, encryptie in rust en tijdens transport, beleid voor tokenopslag en een verifieerbaar verwijderingsproces nodig. Het van nul opbouwen hiervan voor een SaaS-audit kan weken duren en wettelijke toetsing vereist.
In-house bouwen vs. API voor e-mailaggregatie voor SaaS
Hier ziet u hoe uw eigen integratie met drie providers zich verhoudt tot het gebruik van een uniforme e-mail-API voor SaaS op alle belangrijke aspecten voor productie-schaal.
| Vermogen | In-house bouwen | Unipile E-mail API |
|---|---|---|
| Gmail OAuth-integratie | Handleiding - CASA Tier 2 vereist |
Inbegrepen - CASA Tier 2 gecertificeerd |
| Outlook / Microsoft 365 OAuth | Handleiding - verificatie door uitgever vereist |
Inbegrepen - geverifieerde uitgever |
| IMAP-ondersteuning | Bouw zelf - randgevallen op schaal |
Volledig geabstraheerd - alle server-eigenaardigheden afgehandeld |
| Geformatteerde respons | 3 afzonderlijke gegevensmodellen om te normaliseren |
Enkel schema voor alle providers |
| Real-time webhooks | Pub/Sub + Graafabonnementen - aparte opzet per provider |
Eén webhook-endpoint voor alle providers |
| OAuth-token vernieuwen | Je achtergrondtaak - foutafhandeling vereist |
Automatisch beheerd |
| Draad en conversatiemodel | Provider-specifiek - aangepaste normalisatie vereist |
Consistente thread-ID's voor alle providers |
| Bijlagen API | MIME-parsing - apart per provider bouwen |
Ophalen op bijlage-ID - provider-agnostisch |
| GDPR-gegevensverwijdering | Uw verantwoordelijkheid - aangepast audit trail |
Gedocumenteerd verwijderpad - GDPR gereed |
| SOC 2 Type II dekking | Uw eigen controles afbakenen |
SOC 2 Type II gecertificeerd |
| Tijd tot eerste e-mailsynchronisatie | 4-6 maanden (alle drie de providers) |
Minder dan 1 dag |
| Lopend onderhoud | Uw team volgt alle wijzigingen in provider-API's |
Afgehandeld door Unipile - geen onderhoud voor providers |
Hoe Unipile een E-mail API voor SaaS levert in Één Integratie
Unipile is een uniforme e-mail-API voor SaaS, speciaal gebouwd voor de user-sync markt. Eén set endpoints dekt Gmail, Outlook en IMAP - met OAuth, webhooks, threading, bijlagen en compliance die voor u worden afgehandeld. Hier ziet u hoe elke providerintegratie onder de motorkap werkt.
Unipile gebruikt Google OAuth 2.0 om de minimaal benodigde scopes aan te vragen. Het platform is CASA Tier 2 gecertificeerd, dus uw app erft geverifieerde status zonder een eigen beoordeling te doorlopen.
Unipile maakt verbinding via de Microsoft Graph API met het Microsoft Identity Platform. Dit omvat zowel persoonlijke Outlook-accounts als zakelijke Microsoft 365-tenants via één OAuth-stroom.
Voor gebruikers van Yahoo, Fastmail, aangepaste bedrijfsservers of een andere provider, maakt Unipile verbinding via IMAP. Alle server-specifieke eigenaardigheden, TLS-randgevallen en verschillen in mapnamen worden geabstraheerd van uw code.
account_id. Sla het op bij je gebruikersgegevens. Alle volgende e-mailaanroepen verwijzen naar deze ID - geen tokens, geen geheimen in je database.GET /emails om berichten te tonen, POST /e-mails om te sturen, en GET /emails/:id/bijlagen voor bestanden. Dezelfde eindpunten voor alle drie de providers.E-mails van gebruikers synchroniseren in je SaaS: Compleet codevoorbeeld
Drie talen, één patroon. Koppel een gebruikersinbox, haal hun e-mails op en verstuur vanuit hun adres - allemaal via de Unipile unified email API. Dezelfde code werkt voor Gmail, Outlook en IMAP-gekoppelde accounts.
importeer { UnipileClient } van 'unipile-node-sdk';
const klant = nieuw UnipileClient('UW_DSN', 'UW_TOKEN');
// Stap 1: Genereer een gehoste OAuth-link voor je gebruiker
const authLink = wacht op account van de cliënt.create({
type: 'google', // of 'microsoft' of 'imap'
omleiding_url: 'https://jouwapp.com/callback'
});
// Leid uw gebruiker om naar authLink.url om de OAuth-goedkeuring te voltooien
// Stap 2: Vermeld de 50 meest recente e-mails voor een gekoppeld account
const { items: e-mails } = wacht op client.e-mail.ophalen({
account_id: 'ACCOUNT_ID',
beperken: 50
});
e-mails.voorElk(e-mail => {
console.log(onderwerp.email, e.mail.afzender.identifier);
});
// Stap 3: Verzenden vanaf het eigen adres van de gebruiker
wacht op client.e-mail.verzenden({
account_id: 'ACCOUNT_ID',
aan: [{ identifier: 'lead@company.com', weergavenaam: 'Vooruitzicht' }],
onderwerp: 'Naar aanleiding van ons telefoongesprek',
body: 'Hallo, ik wilde even informeren...
'
});
// Stap 4: Registreer een webhook voor real-time nieuwe e-mailgebeurtenissen
wacht op client.webhook.create({
url: 'https://jouwapp.com/webhooks/email',
evenementen: ['e-mail.ontvangen', 'e-mail verzonden']
});importeer verzoekt
BASIS = "https://api9.unipile.com:13234/api/v1"
TOKEN = "UW_TOKEN"
HEADERS = {"X-API-SLEUTEL"TOKEN, "Content-Type": "application/json"}
# Stap 1: Maak een gehoste authenticatielink aan voor je gebruiker
resp = verzoeken.post("{BASE}/hosted/accounts/link", json={
"type": "Google",
"omleiden_URL": "https://yourapp.com/callback"
}, headers=HEADERS)
auth_url = resp.json()["url"]
# Stap 2: Haal de 50 meest recente e-mails op
emails = requests.krijgen(f"{BASE}/emails", parameters={
"account_id": "ACCOUNT_ID",
"limiet": 50
}, headers=HEADERS).json()["items"]
voor e-mail in e-mails
print(e-mail["onderwerp", e-mail["van_deelnemer"]["identificatiemiddel"])
# Stap 3: Verzenden vanaf het eigen adres van de gebruiker
verzoeken.post(f"{BASE}/emails", json={
"account_id": "ACCOUNT_ID",
"naar": [{"identificatiemiddel": "lead@company.com"}],
"onderwerp": "Opvolging",
"lichaam": "Hallo, ik wilde even informeren...
"
}, headers=HEADERS)# Stap 1: Maak een gehoste authenticatielink aan
krul -X POST \
"https://api9.unipile.com:13234/api/v1/hosted/accounts/link" \
-H "X-API-SLEUTEL: UW_TOKEN" \
-H "Content-Type: application/json" \
-d '{"type":"google","redirect_url":"https://yourapp.com/callback"}'
# Stap 2: Maak een lijst van de 50 meest recente e-mails
krul -G \
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-SLEUTEL: UW_TOKEN" \
--data-urlencode "account_id=ACCOUNT_ID" \
--data-urlencode "limiet=50"
# Stap 3: Verzenden vanaf het eigen adres van de gebruiker
krul -X POST \
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-SLEUTEL: UW_TOKEN" \
-H "Content-Type: application/json" \
-d '{"account_id":"ACCOUNT_ID","to":[{"identifier":"lead@company.com"}],"onderwerp":"Opvolging","body":"Hallo...
"}'Unipile genereert de OAuth URL. Uw gebruiker klikt, geeft toestemming en wordt teruggestuurd naar uw app. U verwerkt OAuth-tokens nooit direct.
GET /emails en POST /e-mails werkt identiek voor Gmail, Outlook en IMAP. Verander de account_id - al het andere blijft hetzelfde.
Registreer een enkele URL. Unipile normaliseert Gmail Pub/Sub-meldingen, Microsoft Graph-wijzigingsevenementen en IMAP IDLE-signalen naar één uniforme gebeurtenis-payload.
Veelgestelde vragen
Veelgestelde vragen van SaaS-oprichters en engineers die een e-mail-API evalueren voor synchronisatie met de inbox van gebruikers.
NL 
EN 
FR 
ES 
DE 
IT 
BR 
PL 
TR