E-Mail-API senden: Senden vom Benutzer Gmail, Outlook & IMAP Konten
Die meisten E-Mail-APIs senden von einer gemeinsamen Domain, die Ihnen gehört. Die Send-Email-API von Unipile ist anders: Sie sendet von den eigenen Gmail-, Outlook- und IMAP-Konten Ihrer Nutzer, mit voller OAuth2-Unterstützung, keiner Speicherung von Anmeldedaten und einem einzigen, einheitlichen Endpunkt für jeden Anbieter. Wenn Ihre SaaS-Anwendung programmgesteuert E-Mails im Namen echter Personen senden muss, ist dies die Integration, die dies ermöglicht.
Eine API zum Senden von E-Mails, die im Namen Ihrer Benutzer handelt
Die meisten Suchen nach "E-Mail-API senden" führen zu transaktionalen Anbietern. Das ist hier nicht der Fall. Unipile ist eine E-Mail-API für Benutzerkonten: Sie verbindet sich mit den echten Gmail- oder Outlook-Konten Ihrer Nutzer und sendet in deren Namen, mit deren Identität und deren Zustellbarkeit.
Warum Entwickler auf einer E-Mail-API für Benutzerkonten aufbauen
Wenn Ihr Produkt E-Mails programmatisch von echten Personen (nicht von einer noreply@-Adresse) senden muss, sind dies die Szenarien, die die Einführung vorantreiben.
Senden Sie Follow-up-E-Mails von jedem Vertriebsmitarbeiter aus dessen eigenem Gmail- oder Outlook-Konto. Höhere Antwortraten, authentische Absenderidentität, kein Domain-Warming erforderlich. Interessenten sehen einen echten Namen, keine generische Alias-Adresse.
Lassen Sie Support-Mitarbeiter direkt von ihrem eigenen Postfach antworten. Kunden sehen den Namen und die E-Mail-Adresse einer echten Person, nicht eine Support@-Alias. Baut Vertrauen auf, erhöht die Lösungsgeschwindigkeit.
Erreichen Sie Kandidaten mit personalisierten E-Mails vom tatsächlichen Konto des Recruiters. Keine kalte Domain, kein Risiko durch Spamfilter, keine Aufwärmphase. Die E-Mail kommt im Posteingang an wie eine persönliche Nachricht, weil sie eine ist.
E-Mail von Gmail, Outlook und IMAP senden: Eine API
Die Send-E-Mail-API von Unipile abstrahiert die Anbieter-Schicht vollständig. Ob das Konto Ihres Benutzers Gmail, Outlook, Microsoft 365, Exchange Online oder ein beliebiger IMAP-kompatibler Posteingang ist, der API-Aufruf ist identisch. Sie schreiben die Integration einmal und jeder Anbieter funktioniert einfach.
Gmail sendenminimaler Berechtigungs-Footprint
Mail.Sendendelegiert oder App-Ebene
So senden Sie E-Mails über die API: Schrittweise Integration
Vom Verknüpfen von Konten bis zum programmatischen Versenden Ihrer ersten E-Mail, hier ist der vollständige Ablauf. Diese Anleitung behandelt Gmail und Outlook; die Schritte für IMAP sind identisch, nur der Kontotyp unterscheidet sich.
Registrieren Sie sich im Unipile-Dashboard. Jeder Arbeitsbereich erhält einen API-Schlüssel. Alle Anfragen werden authentifiziert mit dem X-API-KEY header. Kein OAuth-Setup auf Ihrer Seite: Unipile übernimmt die Anbieterauthentifizierung für Sie.
Erzeuge einen gehosteten Auth-Link über die API. Der Benutzer klickt darauf und durchläuft den Standard-OAuth2-Einwilligungsbildschirm seines Anbieters. Unipile speichert die Tokens sicher und gibt eine account_id. Sie fassen nie Anmeldeinformationen an.
"Typ":"MICROSOFT". Für IMAP, verwenden Sie "Typ":"IMAP". derselbe gehostete Flow verarbeitet alle drei Anbieter.Nachdem der Benutzer OAuth2 abgeschlossen hat, sendet Unipile einen Webhook an Ihren Endpunkt mit den account_id. Speichern Sie es in Ihrer Datenbank: Es ist der Schlüssel, den Sie bei jedem API-Aufruf zum Senden von E-Mails für diesen Benutzer verwenden werden.
POST an /api/v1/emails mit dem account_id. Die E-Mail wird aus dem tatsächlichen Gmail- oder Outlook-Posteingang des Benutzers gesendet, genauso als ob er sie selbst gesendet hätte. Der Endpunkt ist identisch, unabhängig davon, ob das verknüpfte Konto Gmail, Outlook oder IMAP ist.
Hallo John,
Ich wollte nur nachhaken...
" }'Hallo John,
Ich wollte nur nachhaken...
' }) }); const Daten = await res.json();Hallo John,
Ich wollte nur nachhaken...
' ) print(res.json())"Kopie", "BCC", "antworten_an"und "Anhänge" zum selben Nutzlast.Bereit, E-Mails von Gmail, Outlook und IMAP zu versenden?
Ihr API-Schlüssel wartet. Starten Sie in unter 10 Minuten mit der Entwicklung.
Ein einheitlicher Endpunkt zum Versenden von E-Mails über alle Anbieter hinweg
Die größte Reibung bei Multi-Provider-Integrationen ist die Wartung separater Code-Pfade für jeden E-Mail-Dienst. Unipile eliminiert dies. Ob das verknüpfte Konto Gmail, Outlook oder IMAP ist, Sie rufen immer denselben Endpunkt mit demselben Payload auf. Die Abstraktionsschicht kümmert sich im Hintergrund um anbieterspezifische Protokolle, Token-Aktualisierungen und Unterschiede bei Ratenbegrenzungen.
Hallo John...
" } // Funktioniert für Gmail, Outlook und IMAP // account_id teilt Unipile mit, welches Konto verwendet werden sollKeine separaten Code-Pfade für Gmail vs. Outlook. Eine Integration deckt heute alle drei Anbieter und alle zukünftigen Ergänzungen ab, die Unipile hinzufügt.
OAuth2-Zugriffstoken laufen ab. Unipile aktualisiert sie transparent. Ihr Code muss den Token-Lebenszyklus nie behandeln; rufen Sie einfach die API auf und senden Sie.
Jeder Benutzer verknüpft sein eigenes Konto. Sie verwalten eine account_id pro Benutzer; Unipile kümmert sich um den Rest. Kein SDK-Gewechel zwischen den Anbietern.
Die API gibt unabhängig vom Anbieter dieselbe JSON-Struktur zurück. Parsen Sie ein Schema, erstellen Sie einen Fehlerbehandler, liefern Sie schneller.
E-Mails im Auftrag Ihrer Benutzer in großem Maßstab senden? Lesen Sie den vollständigen Leitfaden, wie das geht. E-Mails im Namen Ihrer Benutzer senden, einschließlich des Compliance- und Einwilligungsmodells, das Unipile verwendet, um alles nachvollziehbar zu halten.
Alle E-Mail-Send-API-Endpunkte, organisiert
Jeder Endpunkt, der zum Verbinden von Konten, zum Senden und Antworten, zum Verwalten Ihres Postfachs und zum Abhören von Ereignissen in Gmail, Outlook und IMAP mit einer einzigen Integration verfügbar ist.
Senden & Antworten
4 Endpunkte verfügbar
Konto-Einrichtung
3 Endpunkte verfügbar
E-Mails verwalten
5 Endpunkte verfügbar
Webhaken
2 Veranstaltungen verfügbar
Behandelt Authentifizierungsabläufe, Webhook-Einrichtung, das Lesen und Senden von E-Mails, Anhänge und einen vollständigen Anbietervergleich – alles, was Sie für die Erstellung einer produktionsreifen API-Integration zum Senden von E-Mails benötigen.
Authentifizierung und Sicherheit für Ihre Send Email API-Integration
Die Handhabung von Benutzer-E-Mail-Zugangsdaten ist einer der risikoreichsten Teile jeder SaaS-Integration. Die Architektur von Unipile ist so konzipiert, dass OAuth2-Token niemals direkt gespeichert oder übertragen werden; die Angriffsfläche bleibt minimal und die Compliance überschaubar.
Unipile generiert die OAuth2-Zustimmungs-URL, erfasst den Autorisierungscode und speichert die Zugangs- und Aktualisierungstoken in seinem eigenen verschlüsselten Tresor. Ihr Backend sieht nur einen account_id. Kein Roh-Token, kein Passwort, kein Berechtigungs-Drift.
Gmail OAuth2-Token laufen nach 1 Stunde ab. Microsoft-Token laufen nach 1 Stunde (Zugriff) oder 90 Tagen (Aktualisierung) ab. Unipile aktualisiert sie automatisch vor Ablauf. Ihre E-Mail-API-Aufrufe schlagen aufgrund eines abgelaufenen Tokens nie fehl.
Für eine reine Sendeintegration fordert Unipile nur die erforderlichen Scopes an: Gmail senden für Gmail und Mail.Senden für Outlook. Dies folgt dem Prinzip der geringsten Rechtevergabe und verringert die Angriffsfläche für Daten Ihrer Benutzer.
Jeder Webhook, den Unipile an Ihren Endpunkt sendet, enthält einen Signatur-Header, den Sie mit Ihrem Webhook-Geheimnis überprüfen können. Dies stellt sicher, dass Ereignis-Payloads nicht von Dritten gefälscht werden können, die versuchen, Aktionen in Ihrem System auszulösen.
Die Infrastruktur von Unipile ist SOC 2 Typ II zertifiziert. Geprüfte Kontrollen umfassen Zugriffsmanagement, Verschlüsselung im Ruhezustand und während der Übertragung, Incident Response und Verfügbarkeit. Dies erleichtert das Bestehen von Anbieter-Sicherheitsüberprüfungen, wenn Ihre SaaS-Kunden fragen, wie Sie mit ihren E-Mail-Zugangsdaten umgehen.
Erfahren Sie mehr über die sichere E-Mail-APIUnipile ist CASA Tier 2-zertifiziert, dem Sicherheitsstandard, den Google für Anwendungen voraussetzt, die auf sensible Gmail API-Bereiche zugreifen. Die Prüfung wird von einem autorisierten Labor durchgeführt und umfasst Datenverarbeitung, Zugriffskontrollen und sichere Entwicklungspraktiken. Erforderlich zur Aufrechterhaltung des Produktionszugriffs auf die Gmail-Versandbereiche.
Umfassende E-Mail-API-Funktionsabdeckung bei allen Anbietern
Eine Integration gibt Ihnen Zugriff auf alle wichtigen E-Mail-Operationen für Gmail, Outlook und IMAP-Anbieter. Derselbe Endpunkt, dieselbe Payload-Struktur, dasselbe Antwortformat, unabhängig davon, welches Konto Ihr Benutzer verbunden hat.
| Merkmal | Google Mail | Outlook / M365 | IMAP / SMTP |
|---|---|---|---|
| Senden | |||
| E-Mail vom Benutzerkonto senden | ✓ | ✓ | ✓ |
| Senden mit Anhängen | ✓ | ✓ | ✓ |
| Im bestehenden Thread antworten | ✓ | ✓ | ✓ |
| CC- und BCC-Empfänger | ✓ | ✓ | ✓ |
| HTML-Inhalt des Bodys | ✓ | ✓ | ✓ |
| Inline-Bilder (CID-Einbettung) | ✓ | ✓ | ✓ |
| Tägliches Sendelimit (ca.) | ~500 / Tag | ~10.000 / Tag | Serverabhängig |
| Lesen & Synchronisieren | |||
| E-Mails auflisten und lesen | ✓ | ✓ | ✓ |
| Thread / Konversationsansicht | ✓ | ✓ | ✓ |
| Echtzeit-Webhooks (neue E-Mail, gelesen, gesendet) | ✓ | ✓ | ✓ |
| Inkrementeller Delta-Sync | ✓ | ✓ | ✓ |
| Label- und Ordnerverwaltung | ✓Etiketten | ✓Ordner | ✓Ordner |
| Authentifizierung & Sicherheit | |||
| OAuth2 (keine Passwortspeicherung) | ✓ | ✓ | App-Passwort |
| Automatische Token-Aktualisierung | ✓ | ✓ | ✓ |
| SOC 2 Typ II / CASA Stufe 2 | ✓ | ✓ | ✓ |
Häufige Fehler beim Aufbau einer E-Mail-API-Integration
Die meisten Probleme, auf die Entwickler bei der Integration einer E-Mail-API für Benutzerkonten stoßen, lassen sich in eine kleine Anzahl von Kategorien einteilen. Hier sind die, die es wert sind, vor dem Beginn des Aufbaus zu kennen.
Persönliche Gmail-Konten sind auf etwa 500 E-Mails pro Tag beschränkt. Outlook-Konten haben höhere Limits, können aber unter Spitzenlastbedingungen trotzdem gedrosselt werden. Das Überschreiten dieser Limits führt zu 429-Fehlern oder einer temporären Kontosperrung durch den Anbieter.
Benutzer können den Zugriff jederzeit über die Einstellungen ihres Google- oder Microsoft-Kontos widerrufen. Wenn dies geschieht, gibt Unipile bei der nächsten API-Anforderung für dieses Konto einen Fehler zurück. Wenn Ihre Anwendung dies nicht ordnungsgemäß behandelt, führt dies zu unbemerkten Fehlern bei der E-Mail-Zustellung.
account.disconnected Webhook-Ereignis und den Benutzer auffordern, sein Konto erneut zu verknüpfen.Selbst mit einem gültigen OAuth2-Token verstößt das Senden von E-Mails aus dem Konto eines Benutzers, ohne dessen Wissen, gegen die Nutzungsrichtlinien von Google und Microsoft sowie gegen die Spam-Gesetze der meisten Gerichtsbarkeiten. Der OAuth2-Zustimmungsbildschirm muss klar erklären, was Ihre Anwendung tun wird.
Wenn Sie Zugriffstoken selbst speichern und diese bei einer Datenpanne offengelegt werden, erhält ein Angreifer vollen Zugriff auf alle verknüpften E-Mail-Konten. Dies stellt insbesondere unter der DSGVO ein erhebliches Sicherheits- und Compliance-Risiko dar.
account_id; Unipile verwahrt die Token in seinem SOC 2-zertifizierten Tresor. Ihre Datenbank kommt nie mit einem rohen OAuth2-Token in Berührung.SMTP erfordert direkten Serverzugriff, die Verwaltung von Anmeldedaten, TLS-Konfiguration und die Verarbeitung von Bounces. Eine REST-API zum Versenden von E-Mails abstrahiert all dies. Die Kombination beider Ansätze im selben Codebase erhöht die Komplexität ohne Vorteile.
Häufig gestellte Fragen
Alles, was Sie über die E-Mail-Sende-API wissen müssen.
account_id über Webhook. Sie POSTen dann an /api/v1/emails mit dieser account_id und Ihrer Nachrichtennutzlast. Die E-Mail wird von ihrer tatsächlichen Gmail-Adresse gesendet. Kein Einrichten eines Gmail API-Schlüssels auf Ihrer Seite erforderlich.Mail.Senden delegierte Berechtigung. Unipile behandelt die Token-Aktualisierung automatisch.https://www.googleapis.com/auth/gmail.send. Dies ermöglicht das Senden von E-Mails, gewährt aber keinen Zugriff zum Lesen, Ändern oder Löschen von Nachrichten. Bei der Verwendung von Unipile konfigurieren Sie diesen Umfang nicht selbst; der gehostete Authentifizierungsfluss kümmert sich darum. Für einen reinen E-Mail-Versand-API-Anwendungsfall, Gmail senden ist ausreichend.POST /api/v1/emails Der Endpunkt verarbeitet Gmail-, Outlook- und IMAP-Konten. Der Anbieter wird durch die account_id in der Nutzlast; Sie müssen sie nicht angeben. Schreiben Sie Ihre Versandlogik einmal, und sie funktioniert unabhängig davon, welchen E-Mail-Anbieter Ihr Benutzer verknüpft hat. Sehen Sie sich die detaillierte Aufschlüsselung der 6 wichtigsten E-Mail-API-Anbieter.Haben Sie noch Fragen? Unser Team ist für Sie da.