LinkedIn
Instagram
WhatsApp
Telegram
Kalendarz Google
Dołącz do społeczności SlackBudowa API poczty e-mail wielu dostawców integracja działająca w obrębie Gmaila, Outlooka i IMAP jest jednym z najbardziej czasochłonnych wyzwań dla zespołów programistycznych. Każdy dostawca udostępnia własny przepływ OAuth, limity żądań i model danych. ujednolicone API pocztowe abstrakcyjnie to wszystko w jednym interfejsie REST – piszesz jedną integrację i uzyskujesz dostęp do każdej głównej skrzynki odbiorczej, na której polegają Twoi użytkownicy.
Czego się nauczysz
Kompletny przewodnik po API E-mail
Dowiedz się, jak Gmail, Outlook i IMAP współpracują w ramach jednego ujednoliconego REST API.
Dlaczego programiści potrzebują wielodostawcowego API Email
Większość produktów SaaS musi ostatecznie odczytywać lub wysyłać e-maile w imieniu swoich użytkowników. Problem nie leży w koncepcji – tkwi w jej realizacji. Gmail używa Gmail API z Google OAuth 2.0. Outlook używa Microsoft Graph z własnym cyklem życia tokenów. Dostawcy oparci na IMAP zachowują się nieco inaczej. Tworzenie i utrzymywanie trzech oddzielnych integracji pochłania zasoby inżynieryjne, które powinny być przeznaczone na Wasz główny produkt. Jeśli zajmujecie się konkretnie kontami IMAP, Przewodnik po interfejsie API IMAP obejmuje dodatkową złożoność. ujednolicone API pocztowe rozwiązuje to poprzez zredukowanie złożoności specyficznej dla każdego dostawcy za pojedynczym interfejsem – to jest kluczowa obietnica API poczty e-mail wielu dostawców podejście. Aby uzyskać pełne techniczne odniesienie dotyczące tego, jak API do wysyłania e-maili połączeń przez Gmail, Outlook i IMAP, sprawdź nasz dedykowany przewodnik.
The 3 dostawcy poczty e-mail pokryty
Jedno ujednolicone API normalizuje Gmail, Outlook i IMAP do identycznego interfejsu. Twój kod nigdy się nie zmienia, gdy użytkownik podłączy innego dostawcę.
Połącz dowolne konto Gmail lub Google Workspace za pomocą Google OAuth 2.0. Wysyłaj, odczytuj, wyszukuj i synchronizuj wątki w czasie rzeczywistym za pośrednictwem warstwy Unipile – nie są wymagane żadne bezpośrednie dane uwierzytelniające Gmail API w Twojej aplikacji.
Obsługuje prywatne konta Outlook, Microsoft 365 i Exchange Online w ramach jednego dostawcy. Microsoft OAuth jest zarządzany przez Unipile — Twoja integracja pozostaje stabilna niezależnie od konfiguracji dzierżawy.
Każda skrzynka pocztowa dostępna przez IMAP – Yahoo, Fastmail, ProtonMail Bridge, niestandardowe serwery firmowe – staje się natychmiast dostępna przez ten sam interfejs API, który jest używany dla Gmaila i Outlooka.
Unipile vs samodzielne budowanie
Ile faktycznie kosztuje samodzielne wykonanie API poczty e-mail wielu dostawców integrację? Oto szczere porównanie pod kątem wymiarów istotnych w produkcji. Oto dlaczego zespoły coraz częściej wybierają ujednolicone API pocztowe jak Unipile zamiast samodzielnego tworzenia każdej integracji z dostawcą.
Jak integracja dzieła
Podłączenie Twojego pierwszego konta e-mail do Unipile zajmuje cztery kroki. Ten sam proces działa niezależnie od tego, czy użytkownik ma Gmail, Outlook, czy Konto IMAP - kod Twojej aplikacji pozostaje niezmieniony. Oto praktyczna siła jednolitego API poczty e-mail: napisz raz, obejmij wszystkich trzech dostawców.
Twoje zaplecze wywołuje interfejs API Unipile w celu utworzenia krótkotrwałego, hostowanego adresu URL uwierzytelniania. Przekieruj użytkownika na ten adres URL – Unipile wyświetli ekran wyboru dostawcy i zajmie się w Twoim imieniu całym przepływem OAuth.
// POST /api/v1/hosted/accounts/link const res = czekać fetch('https://api5.unipile.com:13515/api/v1/hosted/accounts/link', { metoda: 'POST',nagłówki: { 'Klucz API X': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, ciało: JSON.stringify({ typ: 'E-MAIL', filtry_dostawców: ['GOOGLE', 'MICROSOFT', 'IMAP'], success_redirect_url: 'https://yourapp.com/auth/success' }) }); const { url } = czekać rez.json(); // przekieruj użytkownika do `url`
Po zakończeniu przez użytkownika procesu OAuth, Unipile wysyła webhook do Twojego punktu końcowego (lub dodaje identyfikator konta do Twojego adresu URL przekierowania). Przechowaj ten identyfikator konta - jest to Twoje stałe odniesienie do tego połączonego konta, niezależne od dostawcy.
{
"zdarzenie": "konto.połączone",
"account_id": "acc_01XYZ...",
"dostawca": "GOOGLE",
"email": "alice@gmail.com"
}
Użyj identyfikatora konta, aby listować, wyszukiwać i pobierać wiadomości e-mail. To jest ujednolicone API pocztowe w akcji: schemat odpowiedzi jest identyczny niezależnie od tego, czy konto to Gmail, Outlook, czy IMAP – logika analizy nigdy nie rozgałęzia się w zależności od dostawcy.
// GET /api/v1/emails?account_id=acc_01HXYZ... const emails = czekać fetch( https://api5.unipile.com:13515/api/v1/emails?account_id=${accountId}&limit=20`, { nagłówki: { 'Klucz API X': process.env.UNIPILE_API_KEY } } ).wtedy(r => r.json()); // Taki sam kształt odpowiedzi dla Gmail, Outlook, IMAP: // { id, temat, od, do, data, treść, załączniki }
Pojedynczy punkt końcowy POST wysyła wiadomości e-mail niezależnie od dostawcy konta – to pełna moc API poczty e-mail wielu dostawców. Przekaż identyfikator konta, odbiorcę, temat i treść - Unipile kieruje ruch przez API Gmail, Microsoft Graph lub SMTP w odpowiedni sposób. Jest to ujednolicone API pocztowe w swojej najbardziej konkretnej formie: jeden punkt końcowy, trzech dostawców, zero rozgałęzień w kodzie.
// POST /api/v1/emails/send czekać fetch('https://api5.unipile.com:13515/api/v1/emails/send', { metoda: 'POST',nagłówki: { 'Klucz API X': process.env.UNIPILE_API_KEY, 'Content-Type': 'application/json' }, ciało: JSON.stringify({ account_id: 'acc_01XYZ...', do: [{ e-mail: 'bob@example.com' }], podmiot: 'Cześć z Unipile', ciało: 'Działa z Gmail, Outlook i IMAP.
' }) });
Jak abstrakcja dostawcy dzieła
Zunifikowane API poczty e-mail znajduje się pomiędzy Twoją aplikacją a trzema bazowymi protokołami dostawców, tłumacząc różne przepływy OAuth, schematy danych i modele limitów żądań na jednolity, spójny interfejs.
Gmail używa Google OAuth 2.0 z konkretnym cyklem odświeżania tokenu i zwraca wiadomości w modelu zorientowanym na wątki z etykietami. Outlook używa Microsoft Graph z innym modelem dzierżawy OAuth i zwraca wiadomości jako pojedyncze obiekty komunikatu z folderami. Serwery IMAP mają własne parametry połączenia, metody uwierzytelniania i zestawy możliwości.
Unipile ujednolicone API pocztowe normalizuje wszystkie trzy do jednego interfejsu REST. Twój kod wywołuje /api/v1/emails i otrzymuje obiekty odpowiedzi o identycznym kształcie – niezależnie od tego, czy bazowy adres e-mail to Gmail, Outlook czy konto IMAP. To samo dotyczy wysyłania, obsługi załączników, zdarzeń webhook i zarządzania cyklem życia konta.
To jest główna korzyść inżynieryjna płynąca z API poczty e-mail wielu dostawców złożoność jest wchłaniana na warstwie infrastruktury, a nie w kodzie aplikacji. Gdy Google zmieni swoje wymagania dotyczące zakresu OAuth lub Microsoft zaktualizuje stronicowanie interfejsu Graph API, Unipile zajmuje się zmianami w warstwie nadrzędnej, a Twoja integracja pozostaje nienaruszona.
Bezpieczeństwo i zgodność
Kiedy Twoja aplikacja obsługuje pocztę e-mail w imieniu użytkowników, bezpieczeństwo nie jest opcjonalne. Oto jak ujednolicona warstwa API poczty e-mail zarządza poświadczeniami, danymi i obowiązkami w zakresie zgodności.
Unipile przechowuje i odświeża tokeny OAuth w Twoim imieniu. Twoja aplikacja nigdy nie obsługuje surowych danych uwierzytelniających - pracujesz wyłącznie z nieprzezroczystymi identyfikatorami kont. Rotacja tokenów, wykrywanie wygaśnięcia i przepływy ponownego uwierzytelniania są zarządzane w całości na warstwie infrastruktury.
Wszystkie dane w tranzycie wykorzystują TLS 1.3. Przechowywane dane uwierzytelniające są szyfrowane w spoczynku za pomocą AES-256. Treść wiadomości e-mail pobierana przez ujednolicony interfejs API poczty e-mail jest przetwarzana w pamięci i nie jest utrwalana poza tym, co jest wyraźnie wymagane przez integrację.
Unipile posiada certyfikat SOC 2 Type II (październik 2025). Niezależni audytorzy potwierdzili bezpieczeństwo, dostępność i poufność platformy. Raporty z audytu są dostępne na żądanie dla klientów korporacyjnych oceniających wielodostawcową platformę API poczty e-mail do użytku produkcyjnego.
Umowy dotyczące przetwarzania danych są dostępne dla wszystkich planów. Opcja rezydencji danych w UE jest oferowana klientom posiadającym wymogi dotyczące lokalizacji danych. Prawo do usunięcia jest wspierane przez API: usunięcie połączonego konta usuwa wszystkie powiązane tokeny i dane tymczasowe.
Ocena bezpieczeństwa aplikacji Google Cloud. Waliduje mechanizmy bezpieczeństwa dla aplikacji uzyskujących dostęp do danych użytkowników Google, w tym zakresów OAuth Gmail. Aplikacje zbudowane na Unipile dziedziczą tę certyfikację.
Historia dostępności i incydentów jest publicznie dostępna pod adresem status.unipile.com. Wszystkie zmiany API są zgodne z polityką wersjonowania z powiadomieniami o wycofaniu. Brak cichych zmian łamiących działanie: Twoja integracja jest chroniona stabilną, udokumentowaną umową.
Obsługa przypadki krańcowe wielu dostawców
Każda produkcyjna integracja poczty e-mail napotyka specyficzne dla dostawcy przypadki brzegowe. Oto porównanie podejścia DIY z wykorzystaniem ujednoliconego API poczty e-mail, gdy sytuacja się komplikuje.
| Scenariusz | Podejście "zrób to sam" | Podejście Unipile |
|---|---|---|
| Limit wiadomości Gmail 250 jednostek limitu dziennie w ramach bezpłatnego planu |
Ręczne śledzenie limitów na konto; żądania kończą się niepowodzeniem po cichu, jeśli nie są monitorowane | Obsługiwane automatycznie Kolejkowanie wbudowane, żadne nieudane żądania nie zostały zwrócone do Twojej aplikacji |
| Wygaśnięcie tokenu OAuth | Wdróż oddzielną logikę odświeżania dla każdego dostawcy; rotacja tokenów różni się między Google i Microsoft | Automatyczne odświeżanie Zarządzanie tokenami bez przestojów we wszystkich dostawcach |
| Połączenie IMAP zrywa się | Niestandardowa logika ponownego połączenia na konfigurację serwera; czasy oczekiwania różnią się w zależności od implementacji IMAP | Pula połączeń zarządzana Połączenia utrzymywane przez infrastrukturę Unipile |
| Limity rozmiaru załączników Gmail 25 MB, Outlook 150 MB, IMAP różne |
Kod rozgałęziania dla poszczególnych dostawców; musi śledzić limit każdego dostawcy i aktualizować go po zmianach | Ujednolicona walidacja Niezależne od dostawcy sprawdzanie rozmiaru; błędy zwracane w spójnym schemacie |
| Zmiany w interfejsie API dostawcy | Twoja odpowiedzialność dyżurna; Google i Microsoft wprowadzają niekompatybilne zmiany z krótkim wyprzedzeniem | Zarządzane przez zespół Unipile Zmiany upstream wchłonięte na poziomie infrastruktury; twoja integracja pozostaje stabilna |
Limit wiadomości Gmail
250 jednostek limitu dziennie w ramach bezpłatnego planuRęczne śledzenie limitów na konto; żądania kończą się niepowodzeniem po cichu, jeśli nie są monitorowane
Przewodnik po filarach obejmuje wszystkie punkty końcowe naszego ujednolicone API pocztowe Dogłębnie – przepływy uwierzytelniania, obsługa załączników, synchronizacja folderów, filtry wyszukiwania i konfiguracja webhooków. Wszystko, czego potrzebujesz, aby stworzyć produkcyjną integrację poczty elektronicznej.
Wspólny przypadki użycia
A ujednolicone API pocztowe jest podstawową infrastrukturą dla szerokiego zakresu kategorii produktów. Z API poczty e-mail wielu dostawców, zespoły szybciej dostarczają funkcje i obsługują więcej użytkowników – niezależnie od tego, z jakiego dostawcy usług pocztowych korzystają. Oto wzorce najczęściej tworzone w Unipile.
Automatycznie pobieraj każdy e-mail klienta do rekordów Twojego CRM. Sprzedawcy widzą pełną historię rozmów bez przełączania kart czy ręcznego przekazywania.
Wysyłaj spersonalizowane sekwencje follow-up ze skrzynek odbiorczych użytkowników – nie ze wspólnej domeny wysyłającej – jednocześnie przez konta Gmail i Outlook.
Rekruterzy łączą swój służbowy adres e-mail i logi z systemu ATS automatycznie rejestrują każdy wątek kandydata. Odpowiadaj bezpośrednio z poziomu interfejsu ATS, kierując wiadomości przez swoje rzeczywiste konto Outlook lub Gmail.
Zbuduj współdzieloną skrzynkę odbiorczą lub helpdesk, która agreguje e-maile z wielu kont zespołowych. Kieruj, przypisuj i odpowiadaj – wszystko za pośrednictwem jednego interfejsu wspieranego przez jedno API.
Przekazuj wątki e-maili do LLM w celu generowania wersji roboczych odpowiedzi, podsumowań lub zadań do wykonania. Unipile dostarcza znormalizowane dane dotyczące wątków; twoja warstwa AI zajmuje się analizą.
Uruchamiaj przepływy pracy no-code na podstawie nowych wiadomości e-mail z dowolnego dostawcy. Webhook aktywuje się dla każdej przychodzącej wiadomości – Twoja platforma automatyzacji zajmuje się resztą bez ponawiania żądań.
Każdy z tych wzorców działa we wszystkich aplikacjach: Gmail, Outlook i IMAP z zerowym kodem specyficznym dla dostawcy w Twojej aplikacji. Unipile normalizuje różnice, dzięki czemu logika Twojego produktu pozostaje przejrzysta, a Twoi użytkownicy mogą połączyć dowolną preferowaną skrzynkę odbiorczą. Aby uzyskać kompletny opis każdego punktu końcowego, zapoznaj się z Przewodnik po zunifikowanym API e-mail.
Najczęściej zadawane pytania
Wszystko, o co pytają deweloperzy przed integracją wielodostawcowego API poczty e-mail.
id, podmiot, z, do, dataoraz ciało mają tę samą strukturę niezależnie od dostawcy. Twoja logika parsowania, modele bazy danych i dalsze przetwarzanie nigdy nie muszą rozgałęziać się ze względu na typ dostawcy.
Połącz konta Gmail, Outlook i IMAP za pomocą jednego API. Bez skomplikowanego OAuth, bez mapowania schematów, bez infrastruktury do monitorowania. Zacznij od 7-dniowego bezpłatnego okresu próbnego – nie jest wymagana karta kredytowa.
PL 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
TR