LinkedIn
Instagram
WhatsApp
Telegram
Google Agenda
Word lid van de Slack-gemeenschapWat betekent "Verzenden namens" in E-mail API?
E-mails verzenden namens een gebruiker betekent dat uw toepassing berichten rechtstreeks vanuit de mailbox van de gebruiker verzendt, niet vanuit een gedeelde transactionele afzender. De ontvanger ziet het echte e-mailadres van de gebruiker in het veld "Van". Dit is de basis van elk SaaS-product dat e-mail voor zijn gebruikers afhandelt.
Wat je zult leren
Waarom SaaS-producten e-mails namens gebruikers moeten verzenden
De meeste SaaS-producten die met e-mail te maken krijgen, worden uiteindelijk geconfronteerd met dezelfde vereiste: de gebruiker wil dat berichten afkomstig zijn van hun eigen adres, niet van een generiek platformdomein. Of het nu een CRM, een AI-schrijfassistent of een ondersteuningstool is, op het moment dat uw product e-mails voor gebruikers verzendt, heeft u on-behalf sending nodig. Dit is waarom het ertoe doet - en hoe de drie belangrijkste use cases zich verhouden tot de API.
Vertegenwoordigers verkopen verzenden vanuit hun echte Gmail of Outlook
In een CRM-context is de verkoper degene die de relatie opbouwt. Als je platform herinneringen stuurt vanuit noreply@yourcrm.com, de leverbaarheid daalt en de prospect is verward. Met on-behalf sending roept uw CRM de Unipile API aan via het gekoppelde account van de verkoper. Elke e-mail belandt in de inbox van de prospect met het echte adres van de vertegenwoordiger.
AI stelt concepten op en verzendt ze vanuit de mailbox van de gebruiker
AI-e-mailassistenten - of ze nu antwoorden automatisch opstellen, opvolgingen plannen of threads samenvatten - hebben schrijftoegang nodig tot de mailbox van de gebruiker. Zonder "on-behalf of" verzenden, kan de AI alleen suggesties doen; het kan niet uitvoeren. Met een gekoppeld account via de Unipile API kan uw assistent het goedgekeurde bericht met één API-oproep rechtstreeks vanuit de Gmail of Outlook van de gebruiker verzenden.
Ondersteuningsagenten reageren vanuit een gedeelde ondersteuningsinbox
Klantenserviceplatforms routeren tickets vaak via een gedeelde inbox zoals support@company.com. Die inbox is zelf een mailbox - deze moet als een account worden gekoppeld. Met Unipile kan uw platform die gedeelde Outlook- of IMAP-mailbox verbinden, waardoor elke agent antwoorden kan versturen die rechtstreeks afkomstig lijken te zijn van het officiële ondersteuningsadres, met behoud van de volledige threadcontext.
POST /api/v1/e-mails het eindpunt beheert Gmail-, Outlook- en IMAP-accounts.Hoe de On-Behalf Email API werkt (OAuth 2.0-stroom)
E-mail verzenden namens een gebruiker vereist drie dingen: de toestemming van de gebruiker, een geldig toegangstoken en een send-call via de infrastructuur van de provider. Hier is hoe die stroom in de praktijk werkt, en hoe Unipile dit abstraheert tot één uniforme API. Voor een bredere technische referentie over verzend-eindpunten, parameters en providerverschillen, zie onze complete e-mail versturen API-handleiding.
Gebruiker verleent OAuth-toestemming
De gebruiker klikt op "Verbind uw e-mail" binnen uw SaaS-product. Unipile stuurt hen door naar het OAuth-verificatiescherm van hun provider - Google voor Gmail-gebruikers, Microsoft voor Outlook- en Microsoft 365-gebruikers. De gebruiker logt in en keurt de gevraagde scopes goed, waaronder de mogelijkheid om namens hen e-mail te verzenden. Er wordt nooit een wachtwoord gedeeld met uw applicatie.
Uw app ontvangt een gekoppelde account-ID
Zodra de gebruiker de OAuth-stroom heeft voltooid, slaat Unipile de toegangstoken veilig op en retourneert een account_id naar uw applicatie. Dit is een stabiele identificatie voor de gekoppelde mailbox van de gebruiker. U slaat deze ID op in uw database tegenover het gebruikersrecord. Alle daaropvolgende e-mailbewerkingen voor deze gebruiker verwijzen naar deze account_id - u raakt de ruwe OAuth-token nooit aan.
Verzenden via de infrastructuur van de provider
Wanneer uw applicatie een e-mail moet verzenden, roept deze POST /api/v1/e-mails met de account\_id en berichtinhoud. Unipile stuurt het verzoek via de juiste provider: de Gmail API voor Google-accounts, de Microsoft Graph API voor Outlook en Microsoft 365-accounts, en SMTP voor IMAP-accounts. De e-mail wordt verzonden vanuit het postvak van de gebruiker en verschijnt in hun map Verzonden items.
Code-voorbeelden
importeer verzoekt # account_id opgehaald na succesvolle OAuth-flow van gebruiker UNIPILE_DSN = "https://api1.unipile.com:13301" TOEGANGSSLEUTEL = "UW_TOEGANGSTOKEN" ACCOUNT_ID = "gebruikers_account_id_uit_db" payload = { "account_id": ACCOUNT_ID, "naar": [{ "weergavenaam": "Sarah Connor", "identificatiemiddel": "sarah@acme.com" }], "onderwerp": "Voortbouwend op ons gesprek", "lichaam": "Hallo Sarah, ik kom even bij je terug...
" { response = requests.post( "{UNIPILE_DSN}/api/v1/emails", json=payload, headers={"X-API-SLEUTEL": ACCESS_TOKEN} ) print(response.json()) # {"object": "EmailSent", "email_id": "..."}
// account_id verkregen nadat gebruiker OAuth-flow heeft voltooid const UNIPILE_DSN = "https://api1.unipile.com:13301"; const TOEGANGSTOKEN = "UW_TOEGANGSTOKEN"; const ACCOUNT_ID = "gebruikers_account_id_uit_db"; const payload = { account_id: ACCOUNT_ID, naar: [{ weergavenaam: "Sarah Connor", identificator: "sarah@acme.com" }], onderwerp: "Voortbouwend op ons gesprek", lichaam: "Hallo Sarah, ik kom even bij je terug...
" }; const response = wacht op fetch(`${UNIPILE_DSN}/api/v1/emails`, { methode: "POST", kopteksten: { "X-API-SLEUTEL"TOEGANGSTOKEN, "Content-Type": "application/json" }, lichaam: JSON.rijgen(payload) }); const gegevens = wacht op antwoord.json(); console.log(gegevens); // { object: "EmailVerzonden", email_id: "..." }
On-Behalf vs Transactionele E-mail API: Het Belangrijkste Verschil
Deze twee categorieën van e-mail-API's lossen fundamenteel verschillende problemen op. Ze met elkaar verwarren is de meest voorkomende fout die teams maken bij het specificeren van een e-mailintegratie. Hier is hoe ze zich verhouden over elke dimensie die ertoe doet.
E-mail Verzenden Namens Met Unipile
Unipile biedt één uniforme API die Gmail, Outlook en IMAP abstracteert achter één consistente interface. Je schrijft één integratie - Unipile regelt provider-specifieke OAuth-stromen, token-vernieuwing, SMTP-routering en foutafhandeling voor alle drie. Hier is wat beschikbaar is voor elke provider.
E-mail verzenden namens gebruiker API - Veelgestelde Vragen
Veelgestelde vragen over het verzenden van e-mails namens anderen met Unipile
Ja, op voorwaarde dat de gebruiker hier expliciet toestemming voor geeft. E-mail verzenden namens een gebruiker is gebaseerd op OAuth 2.0 (voor Gmail en Outlook) of het expliciet delen van inloggegevens (voor IMAP). In beide gevallen autoriseert de gebruiker uw applicatie bewust om vanuit hun mailbox te verzenden. Dit is hetzelfde mechanisme dat door elke grote e-mailclient en productiviteitstool wordt gebruikt.
De belangrijkste nalevingsvereisten zijn:
- De gebruiker moet actief toestemming geven voordat u namens hem iets verstuurt
- Je privacybeleid moet vermelden dat je toegang krijgt tot de mailbox van de gebruiker en dat je daarvandaan e-mails verzendt.
- De gebruiker moet op elk moment de toegang kunnen intrekken (OAuth-intrekking of ontkoppeling van het account)
- U mag geen inhoud verzenden die in strijd is met de servicevoorwaarden van de provider (bijv. spam)
Het is niet legaal om te versturen vanaf iemands adres zonder hun toestemming. Unipile's OAuth-gebaseerde koppelingsstroom zorgt ervoor dat u altijd expliciete toestemming van de gebruiker heeft voordat u een verzendoperatie uitvoert.
De ontvanger ziet de eigen domein van de gebruiker in het veld Van - niet het domein van uw platform. Dit is de kernwaardepropositie van verzenden namens anderen. Als bijvoorbeeld een verkoper met het adres john@acme.com heeft hun Gmail-account gekoppeld, zal elke e-mail die via Unipile via uw CRM wordt verzonden Van: john@acme.com.
De e-mail wordt verzonden via de daadwerkelijke e-mailprovider van de gebruiker (Gmail API, Microsoft Graph of SMTP), wat betekent dat:
- SPF-records slagen omdat het verzendende IP wordt geautoriseerd door het domein van de gebruiker
- DKIM-handtekeningen zijn geldig omdat de provider tekent met de domeinsleutel van de gebruiker
- DMARC-uitlijning slaagt om dezelfde redenen
Dit is fundamenteel anders dan een transactionele API waarbij je vanaf een gedeelde infrastructuur verzendt en de ontvanger het domein van jouw platform ziet.
De vereiste scopes zijn afhankelijk van de provider. Unipile handelt het OAuth-toestemmingsscherm automatisch af - uw gebruikers zien een standaard Google- of Microsoft-machtigingsdialoog. De exacte scopes die worden aangevraagd zijn:
- Gmail: de Gmail API-scope die het verzenden van berichten toestaat
https://mail.google.com/of de meer beperktegmail.verzendenbereik als je alleen verzendtoegang nodig hebt) - Outlook / Microsoft 365: Microsoft Graph
Mail.verzendenbereik, plusMail.ReadWriteals je ook de inbox moet lezen of synchroniseren - IMAP: de gebruiker verstrekt de IMAP-hostnaam, poort, gebruikersnaam en ofwel het wachtwoord of een app-specifiek wachtwoord (vereist voor accounts met tweefactorauthenticatie ingeschakeld)
Gebruikers kunnen deze machtigingen op elk moment intrekken via de beveiligingsinstellingen van hun Google- of Microsoft-account, of door het gekoppelde account binnen uw product te ontkoppelen.
Ja. Elk postvak dat geauthenticeerd kan worden via OAuth of IMAP-inloggegevens kan als een Unipile-account worden gekoppeld. Dit omvat:
- Gedeelde postvakken in Microsoft 365 (bijv. support@company.com- gekoppeld via een serviceaccount met de juiste gedelegeerde machtigingen
- Google Workspace gedeelde in-boxen en groepsadressen met "Verzenden als"-machtigingen geconfigureerd
- Elke e-mailalias die wordt beheerd door een IMAP-toegankelijke mailbox
U kunt ook de aanpassen weergavenaam in het veld Van met de van parameter in de API-payload, zonder het onderliggende verzendadres te wijzigen.
Unipile handelt het automatisch vernieuwen van tokens af voor zowel Gmail- als Outlook-accounts. OAuth-toegangstokens verlopen doorgaans na een uur, maar het vernieuwingstoken is langdurig. Wanneer Unipile een verlopen toegangstoken detecteert vóór een verzendoperatie, vraagt het in stilte een nieuwe aan met behulp van het opgeslagen vernieuwingstoken - uw applicatie heeft dit nooit door en de verzendoproep slaagt normaal gesproken.
De enige keer dat je de gebruiker moet vragen om opnieuw te authenticeren, is als ze handmatig ingetrokken toegang vanuit hun Google- of Microsoft-accountinstellingen. Unipile presenteert dit als een wijziging van de accountstatus die je kunt detecteren via een webhook of door het account-eindpunt te pollen.
Heb je nog vragen? Ons team staat klaar om te helpen.
NL 
EN 
FR 
ES 
DE 
IT 
BR 
PL 
TR