LinkedIn
Instagram
WhatsApp
Telegram
Kalendarz Google
Dołącz do społeczności SlackNadaj swojemu SaaS Dostęp do Skrzynki odbiorcze użytkowników przez API poczty elektronicznej
API e-mail dla SaaS umożliwia Twojemu produktowi odczytywanie, wysyłanie i synchronizowanie wiadomości e-mail bezpośrednio z kont Gmail, Outlook lub IMAP Twoich użytkowników – bez konieczności podawania haseł. Twórz integracje CRM, narzędzia sprzedażowe, helpdeski i asystentów AI w oparciu o ujednoliconą platformę OAuth.
import { UnipileClient } z 'unipile-node-sdk';
const klient = nowy UnipileClient('TWÓJ_DSN', 'TWÓJ_TOKEN');
// Połącz skrzynkę odbiorczą użytkownika
const link = czekać konta klienta.create({
typ: 'Google',
redirect_url: 'https://app.com/cb'
});
// Pobierz najnowsze 50 emaili
const { przedmioty } = czekać client.email.pobierz wszystko({
account_id: 'identyfikator_konta_użytkownika',
limit: 50
});
// Wyślij z adresu użytkownika
czekać client.email.wysyłać({
account_id: 'identyfikator_konta_użytkownika',
do: [{ identyfikator: 'lead@co.com' }],
temat: 'Nawiązując do',
body: 'Cześć, tylko się melduję...'
});
Czym jest API e-mail dla SaaS?
Większość programistów słysząc "API do poczty e-mail" myśli o narzędziach takich jak SendGrid czy Mailgun – usługach do wysyłania transakcyjnych wiadomości e-mail (potwierdzenia, powiadomienia, magiczne linki) z własnej domeny. To zupełnie inny rynek. API do poczty e-mail dla SaaS rozwiązuje fundamentalnie inny problem: zapewnia twojemu produktowi programowy dostęp do kont e-mail twoich użytkowników.
An API do e-mail dla SaaS to zestaw punktów końcowych HTTP, które pozwalają Twojemu produktowi uwierzytelnić się u dostawcy poczty e-mail użytkownika (Gmail, Outlook lub IMAP) za pomocą OAuth, a następnie odczytywać, wysyłać, synchronizować i wyszukiwać wiadomości e-mail w jego imieniu - wszystko za pomocą jednej integracji, bez przechowywania haseł i zarządzania specyficzny mi dla dostawcy cechami.
Wysyła e-maile z twojej domeny dla swoich użytkowników. Używane do resetowania haseł, faktur, powiadomień i kampanii marketingowych. Twojemu produktowi można przypisać adres nadawcy.
Udostępnia twoje oprogramowanie jako usługę (SaaS) do skrzynki odbiorcze użytkowników przez OAuth. Twój produkt odczytuje, wysyła i synchronizuje e-maile w imieniu każdego użytkownika – z jego konta Gmail, Outlook lub IMAP.
Jakie produkty SaaS faktycznie budują za pomocą API e-mail
Każdy produkt, w którym użytkownicy muszą wchodzić w interakcje z e-mailami lub w którym e-maile muszą przepływać do Twojego modelu danych, jest kandydatem do API synchronizacji użytkowników z pocztą e-mail. Oto pięć najczęstszych wzorców, które twórcy wdrażają z Unipile.
Automatyczne przechwytywanie każdej wiadomości e-mail wymienianej między przedstawicielem handlowym a klientem. Bez ręcznego logowania, bez pominiętych kontaktów. Twój CRM pozostaje aktualny bez żadnych działań ze strony użytkownika.
Uruchamiaj wieloetapowe sekwencje outreach z własnego adresu Gmail lub Outlook każdego przedstawiciela – nie ze współdzielonej domeny wysyłkowej. Odpowiedzi trafiają do rzeczywistej skrzynki odbiorczej przedstawiciela i są automatycznie wykrywane.
Przenoszenie e-maili pomocniczych z wielu skrzynek odbiorczych zespołu do ujednoliconej kolejki zgłoszeń. Odpowiedzi wysyłane z interfejsu helpdesku wychodzą przez własne połączone konto agenta, zachowując dostarczalność.
Udostępnij swojemu produktowi AI pełną historię wiadomości e-mail użytkownika. Podsumowuj wątki, szkicuj odpowiedzi, wyodrębniaj punkty do realizacji lub kategoryzuj potencjalnych klientów – wszystko w oparciu o rzeczywiste dane z skrzynki odbiorczej użytkownika.
Zezwól użytkownikom na połączenie ich skrzynki odbiorczej w celu wyzwalania automatyzacji – twórz zadania z e-maili, wyodrębniaj dane faktur, kieruj załączniki do magazynu lub łącz e-maile z platformami Slack, Notion lub własnym mechanizmem przepływu pracy.
Połącz skrzynki odbiorcze rekruterów z Twoim ATS. Automatycznie kojarz wiadomości e-mail kandydatów z aplikacjami o pracę, śledź wskaźniki odpowiedzi i pozwól rekruterom odpowiadać bezpośrednio z ich połączonego konta, nie opuszczając Twojej platformy.
Co musi obsługiwać produkcyjne API e-mail dla SaaS
Budowanie niezawodnej integracji e-mailowej to coś więcej niż wywołanie punktu końcowego REST. Oto sześć możliwości, które powinna obejmować każda poważna integracja z interfejsem API e-mail SaaS – i gdzie w każdej z nich tkwi ukryta złożoność.
Każdy użytkownik łączy swoją skrzynkę odbiorczą za pośrednictwem osobnej zgody OAuth. Twój SaaS działa w imieniu każdy uwierzytelniony użytkownik – nie przez pojedyncze, współdzielone konto usługi. Google i Microsoft wymagają weryfikacji aplikacji przed wystawieniem tokenów OAuth na dużą skalę.
Twoi użytkownicy będą mieli skrzynki Gmail, Outlook (prywatne i Microsoft 365) oraz skrzynki oparte na IMAP. Solidne API poczty e-mail dla SaaS normalizuje tych trzech dostawców do pojedynczy, ujednolicony format odpowiedzi więc logika Twojego produktu pozostaje niezależna od dostawcy.
Regularne ankietowanie co kilka minut jest zawodne i powolne. Produkcja SaaS wymaga powiadomienia webhook kiedy przychodzą nowe e-maile lub zmienia się stan wiadomości. Gmail używa Pub/Sub, Microsoft Graph używa subskrypcji – Twoja warstwa API powinna abstrakcyjnie sprowadzić oba do jednego formatu zdarzeń.
Klienty poczty e-mail grupują wiadomości w wątki. Twoje API poczty e-mail musi udostępniać spójny identyfikator wątku w różnych usługach, dzięki czemu możesz odpowiadać w wątku, zwijać rozmowy i wykrywać, czy sekwencja wysyłana zewnętrznie otrzymała odpowiedź - bez konieczności samodzielnego parsowania surowych nagłówków Message-ID.
Odczytywanie załączników oznacza dekodowanie części MIME, obsługę obrazów wbudowanych i pobieranie binarnych bloków danych za pośrednictwem specyficznych dla dostawcy interfejsów API. Punkt końcowy musi pozwolić ci pobierz załączniki według ID bez ponownego pobierania pełnej treści wiadomości przy każdym żądaniu.
Dane pocztowe są wrażliwe. Twoja integracja musi szyfrowanie tokenów w spoczynku, zakresowe uprawnienia OAuth (żądanie tylko tego, czego potrzebujesz), logi audytowe i udokumentowana ścieżka usuwania danych w celu spełnienia żądań usunięcia danych wynikających z RODO i audytów SOC 2 Type II.
Ukryte koszty tworzenia własnej integracji API poczty e-mail
Biblioteki Gmail API, Microsoft Graph i IMAP są darmowe i dobrze udokumentowane. Dlaczego więc większość zespołów SaaS nie docenia kosztów budowy o 3-5 razy? Ponieważ złożoność nie leży w początkowej integracji – tkwi ona we wszystkim, co następuje później.
Aplikacje żądające zakresów Gmail wykraczających poza podstawowy profil muszą przejść Ocena bezpieczeństwa Google CASA — poziom 2 zanim będą mogli obsłużyć ponad 100 użytkowników testowych. Proces ten obejmuje współpracę z zewnętrznym laboratorium bezpieczeństwa, trwa od 4 do 8 tygodni i kosztuje od 14 000 do 17 500, w zależności od zakresu.
Microsoft wymaga weryfikacja wydawcy dla aplikacji żądających wyższych uprawnień w ramach interfejsu Graph API. Bez tego każdy użytkownik zobaczy czerwony baner ostrzegawczy podczas ekranu zgody OAuth - co znacząco obniża konwersję w procesach onboardingu dla usług B2B SaaS.
Istnieją setki implementacji serwerów IMAP w użyciu. Każda ma swoje dziwactwa: niestandardowe nazwy folderów, wadliwe wsparcie dla IDLE, przypadki brzegowe certyfikatów TLS, sposób obsługi limitów czasowych połączeń i przepływy uwierzytelniania specyficzne dla poszczególnych serwerów. Każdy pozyskany klient korporacyjny może ujawnić nowy przypadek brzegowy co blokuje ich drużynę.
Tokeny OAuth wygasają. Tokeny odświeżania mogą zostać unieważnione przez użytkownika lub zgodnie z polityką dostawcy. Na dużą skalę, zarządzanie cyklem życia tokenów dla tysięcy połączonych kont wielu dostawców wymaga niezawodnego zadania w tle, powiadamiania o błędach i płynnego przepływu użytkownika przy ponownej autoryzacji.
Google i Microsoft deprecjonują i aktualizują powierzchnie API. Uwierzytelnianie podstawowe Gmail zostało usunięte. Microsoft deprecjonował starsze punkty końcowe Exchange. Dotrzymywanie kroku dziennikom zmian trzech dostawców jest ciągłym obciążeniem konserwacyjnym, które spada w całości na Twój zespół inżynieryjny.
Dane e-mail podlegają RODO i SOC 2 Type II. Potrzebne są udokumentowane przepływy danych, szyfrowanie w spoczynku i w tranzycie, zasady przechowywania tokenów oraz weryfikowalny proces usuwania danych. Zbudowanie tego od zera na potrzeby audytu SaaS może zająć tygodnie. i wymaga przeglądu prawnego.
Wbudowane API kontra agregacja poczty e-mail dla SaaS
Oto porównanie Twojej własnej integracji pocztowej obsługującej trzech dostawców z ujednoliconym interfejsem API poczty e-mail dla SaaS pod każdym możliwym względem dla skali produkcyjnej.
| Zdolność | Wbudowany wewnętrznie | Unipile API pocztowe |
|---|---|---|
| Integracja Gmail OAuth | Instrukcja - CASA Tier 2 wymagana |
W zestawie - Certyfikat CASA Tier 2 |
| Outlook / Microsoft 365 OAuth | Instrukcja - wymagane uwierzytelnienie wydawcy |
W zestawie - zweryfikowany wydawca |
| Obsługa IMAP | Zbuduj się samemu – przypadki brzegowe na dużą skalę |
Całkowicie abstrakcyjne - wszystkie dziwactwa serwera obsłużone |
| Ujednolicony format odpowiedzi | 3 oddzielne modele danych do normalizacji |
Pojedynczy schemat dla wszystkich dostawców |
| Webhooki działające w czasie rzeczywistym | Pub/Sub + subskrypcje grafowe - oddzielna konfiguracja dla każdego dostawcy |
Jeden punkt końcowy webhook dla wszystkich dostawców |
| Odświeżenie tokena OAuth | Twoje zadanie w tle - wymagane obsługi błędów |
Zarządzane automatycznie |
| Model wątku i konwersacji | Dostawca-specyficzny - wymagana niestandardowa normalizacja |
Spójne identyfikatory wątków u wszystkich dostawców |
| API załączników | Parsowanie MIME - buduj oddzielnie dla każdego dostawcy |
Pobieraj według identyfikatora załącznika — niezależnie od dostawcy |
| Usuwanie danych RODO | Twoja odpowiedzialność - niestandardowy ślad audytowy |
Udokumentowana ścieżka usuwania - zgodność z RODO |
| Zakres SOC 2 typu II | Zakres własnych kontroli |
Certyfikat SOC 2 typu II |
| Czas do pierwszej synchronizacji poczty | 4-6 miesięcy (wszyscy trzej dostawcy) |
Mniej niż 1 dzień |
| Bieżąca konserwacja | Twój zespół śledzi wszystkie zmiany w API dostawców |
Obsługiwane przez Unipile – zerowa konserwacja dostawcy |
Jak Unipile dostarcza API do obsługi poczty e-mail dla SaaS w jednej integracji
Unipile to ujednolicone API do obsługi poczty e-mail dla SaaS, zaprojektowane specjalnie dla rynku synchronizacji użytkowników. Jeden zestaw punktów końcowych obejmuje Gmail, Outlook i IMAP — z uwzględnieniem OAuth, webhooków, wątkowania, załączników i zgodności z przepisami. Oto, jak wygląda integracja każdego dostawcy "pod maską".
Unipile używa Google OAuth 2.0 aby poprosić o minimalny niezbędny zakres uprawnień. Platforma posiada certyfikat CASA Tier 2, dzięki czemu Twoja aplikacja dziedziczy zweryfikowany status bez konieczności przechodzenia własnej oceny.
Unipile łączy się przez Microsoft Graph API korzystając z platformy Microsoft Identity. Obejmuje to zarówno osobiste konta Outlook, jak i firmowe dzierżawy Microsoft 365 za pośrednictwem jednego przepływu OAuth.
Dla użytkowników Yahoo, Fastmail, niestandardowych serwerów firmowych lub dowolnego innego dostawcy, Unipile łączy się za pomocą IMAP. Wszystkie specyficzne dla serwera dziwactwa, przypadki brzegowe TLS i różnice w nazewnictwie folderów są abstrakcyjne od Twojego kodu.
account_id. Zapisz to w swoim rekordzie użytkownika. Wszystkie kolejne wywołania poczty e-mail będą odwoływać się do tego identyfikatora – bez tokenów ani sekretów w Twojej bazie danych.GET /emails aby wyświetlić wiadomości, POST /maile do wysłania, i POBIERZ /emails/:id/attachments dla plików. Te same punkty końcowe dla wszystkich trzech dostawców.Synchronizacja e-maili użytkowników w Twoim SaaS: kompletny przykład kodu
Trzy języki, jeden wzorzec. Połącz skrzynkę odbiorczą użytkownika, pobierz jego wiadomości e-mail i wysyłaj z jego adresu – wszystko za pośrednictwem ujednoliconego interfejsu API poczty e-mail Unipile. Ten sam kod działa dla kont połączonych z Gmail, Outlook i IMAP.
import { UnipileClient } z 'unipile-node-sdk';
const klient = nowy UnipileClient('TWÓJ_DSN', 'TWÓJ_TOKEN');
// Krok 1: Wygeneruj link OAuth hostowany dla Twojego użytkownika
const authLink = czekać konta klienta.create({
typ: 'Google', // lub 'microsoft' lub 'imap'
redirect_url: 'https://yourapp.com/callback'
});
// Przekieruj użytkownika na adres authLink.url, aby uzyskać zgodę OAuth
// Krok 2: Wylistuj 50 najnowszych wiadomości e-mail dla połączonego konta
const { elementy: wiadomości e-mail } = czekać client.email.pobierz wszystko({
account_id: 'ID_KONTA',
limit: 50
});
e-maile.dla każdego(email => {
konsola.log(temat wiadomości e-mail, identyfikator osoby wysyłającej);
});
// Krok 3: Wyślij z własnego adresu użytkownika
czekać client.email.wysyłać({
account_id: 'ID_KONTA',
do: [{ identyfikator: 'lead@company.com', nazwa_wyświetlana: 'Perspektywa' }],
temat: 'Nawiązując do naszej rozmowy',
body: 'Cześć, chciałem się tylko odezwać...
'
});
// Krok 4: Zarejestruj webhook dla zdarzeń e-mail na żywo
czekać client.webhook.create({
adres url 'https://yourapp.com/webhooks/email',
wydarzenia: ['email.received', 'email.wysłany']
});import żądania
PODSTAWA "https://api9.unipile.com:13234/api/v1"
TOKEN = "TWÓJ_TOKEN"
NAGŁÓWKI = {"X-API-KEY"ŻETON, "Content-Type": "application/json"}
# Krok 1: Utwórz link do uwierzytelniania hostowanego dla swojego użytkownika
resp = requests.stanowisko({BASE}/hosted/accounts/link", json={
"typ": "google",
"przekieruj_adres_url": "https://yourapp.com/callback"
}, nagłówki=NAGŁÓWKI)
auth_url = resp.json()["url"]
# Krok 2: Pobierz 50 najnowszych wiadomości e-mail
emails = wnioski.uzyskać(f"{BAZA}/maile", parametry={
"account_id": "ID_KONTA",
"limit": 50
}, nagłówki=NAGŁÓWKI).json()["przedmioty"]
dla e-mail w e-maile:
print(email"temat"], e-mail["od_uczestnika"]["identyfikator"])
# Krok 3: Wyślij z własnego adresu użytkownika
żądania.stanowisko(f"{BAZA}/maile", json={
"account_id": "ID_KONTA",
"do": [{"identyfikator": "lead@company.com"}],
"temat": "Dalsze działania",
"ciało": "Cześć, chciałem się tylko odezwać...
"
}, nagłówki=NAGŁÓWKI)# Krok 1: Utwórz link do uwierzytelniania w usłudze hostingowej
zwijać się -X POST \
"https://api9.unipile.com:13234/api/v1/hosted/accounts/link" \
-H "X-API-KEY: TWÓJ_TOKEN" \
-H "Typ-Zawartości: application/json" \
-d '{"type":"google","redirect_url":"https://yourapp.com/callback"}'
# Krok 2: Wymień 50 najnowszych wiadomości e-mail
zwijać się -G
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-KEY: TWÓJ_TOKEN" \
--data-urlencode "account_id=IDENTYFIKATOR_KONTA" \
--data-urlencode "limit=50"
# Krok 3: Wyślij z własnego adresu użytkownika
zwijać się -X POST \
"https://api9.unipile.com:13234/api/v1/emails" \
-H "X-API-KEY: TWÓJ_TOKEN" \
-H "Typ-Zawartości: application/json" \
-d '{"account_id":"ACCOUNT_ID","to":[{"identifier":"lead@company.com"}],"subject":"Następne kroki","body":"Cześć...
"}'Unipile generuje adres URL OAuth. Twój użytkownik klika, wyraża zgodę i zostaje przekierowany z powrotem do Twojej aplikacji. Nigdy nie obsługujesz tokenów OAuth bezpośrednio.
GET /emails oraz POST /maile działać identycznie dla Gmail, Outlook i IMAP. Zmień account_id - wszystko inne pozostaje bez zmian.
Zarejestruj pojedynczy adres URL. Unipile normalizuje powiadomienia Gmail Pub/Sub, zdarzenia zmian Microsoft Graph i sygnały IMAP IDLE do jednej ujednoliconej ładunki zdarzenia.
Często zadawane pytania
Najczęściej zadawane pytania przez założycieli i inżynierów SaaS, którzy oceniają interfejs API poczty e-mail do synchronizacji skrzynek odbiorczych użytkowników.
PL 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
TR