API do wysyłania e-maili: Gmail, Outlook i IMAP z kont użytkowników (2026)

Q: Jak wysłać e-mail z konta Gmail użytkownika za pośrednictwem interfejsu API?

Z Unipile wygeneruj link uwierzytelniający hostowany dla dostawcy GOOGLE. Użytkownik uwierzytelnia się za pomocą standardowego ekranu zgody OAuth2 Google. Po połączeniu otrzymasz identyfikator `account_id` za pośrednictwem webhooka. Wyślij żądanie POST do `/api/v1/emails` z tym identyfikatorem `account_id` i ładunkiem swojej wiadomości. E-mail zostanie wysłany z ich rzeczywistego adresu Gmail.

Q: Czy mogę wysyłać e-maile programowo z programu Outlook?

Tak. Unipile obsługuje wysyłanie wiadomości e-mail programowo z kont Outlook, w tym kont osobistych Outlook, Microsoft 365 i Exchange Online, za pośrednictwem tego samego punktu końcowego API. Uwierzytelnianie odbywa się za pomocą protokołu OAuth2 z uprawnieniem delegowanym Mail.Send.

Q: Jakie zakresy OAuth2 są mi potrzebne do wysyłania wiadomości e-mail za pomocą Gmail API?

W przypadku integracji służącej wyłącznie do wysyłania minimalny wymagany zakres to https://www.googleapis.com/auth/gmail.send. Korzystając z Unipile, nie konfigurujesz tego zakresu samodzielnie; przepływ uwierzytelniania hostowany przez Unipile obsługuje to.

Q: Czym różni się API do obsługi e-maili kont użytkownika od API do obsługi e-maili transakcyjnych?

To są różne rynki dla różnych problemów. Transakcyjne API wysyłają wiadomości z domeny, którą posiadasz. Unipile nie działa na tym rynku: łączy się z prawdziwymi kontami Gmail lub Outlook Twoich użytkowników i wysyła wiadomości w ich imieniu, z ich tożsamością, do zastosowań, w których adres nadawcy ma znaczenie.

Q: Jak sobie radzić z limitami szybkości podczas wysyłania wiadomości e-mail przez API?

Limity dotyczące liczby żądań na poziomie dostawcy. Osobiste konta Gmail pozwalają na wysyłanie około 500 e-maili dziennie. Dobre praktyki: monitoruj liczbę wysłanych wiadomości na połączone konto, wdrażaj algorytm wykładniczego wycofywania się (exponential backoff) dla odpowiedzi 429 i rozkładaj masowe wysyłki w czasie.

Q: Czy istnieje API, które działa z Gmail, Outlook i IMAP z jedną integracją?

Tak. Unipile udostępnia jeden punkt końcowy POST /api/v1/emails, który obsługuje konta Gmail, Outlook i IMAP. Dostawca jest określany przez account_id w ładunku; napisz logikę wysyłania raz, a będzie ona działać dla wszystkich dostawców.

Spis treści

Spis treści 8 sekcji

Fundamenty

01Co to jest?

02Przypadki użycia

Dostawcy

03Gmail, Outlook, IMAP

04Jak wysłać (krok po kroku)Przewodnik

Integracja

05Zunifikowany punkt końcowy API

06Wszystkie punkty końcowe API

07Uwierzytelnianie i bezpieczeństwo

Odniesienie

08Powszechne pułapki

09FAQ

Interfejs API poczty e-mail konta użytkownika

API wysyłania wiadomości e-mail: Wyślij od użytkownika Gmail, Outlook i IMAP Konta

Większość interfejsów API poczty e-mail wysyła wiadomości z współdzielonej domeny, którą posiadasz. Interfejs API wysyłania wiadomości e-mail Unipile działa inaczej: wysyła wiadomości z własnych kont Gmail, Outlook i IMAP Twoich użytkowników, z pełnym protokołem OAuth2, bez przechowywania danych uwierzytelniających i jednym, ujednoliconym punktem końcowym dla każdego dostawcy. Kiedy Twoje oprogramowanie jako usługa (SaaS) musi wysyłać wiadomości e-mail programowo w imieniu prawdziwych ludzi, ta integracja sprawia, że działa.

Połącz OAuth2, brak przechowywania haseł

Jeden ujednolicony punkt końcowy, wszyscy dostawcy

Obsługiwane Gmail, Outlook i IMAP

Infrastruktura zgodna z SOC2

Gmail

Perspektywy

IMAP

Zacznij budować Wyświetl dokumenty

api do wysyłania e-maili - konta użytkowników

Wysłane z powiązanych kont

sarah@acme.com (Gmail)

W nawiązaniu do naszej rozmowy

Wysłany

mark@corp.io (Outlook)

Podsumowanie Twojego wdrożenia

Wysłany

lisa@startup.co (IMAP)

Witamy na platformie

Wysłany

POST /api/v1/emails

"account_id": "acc_gmail_xyz",

"do": [{ "identyfikator": "sarah@acme.com" }],

"temat": "W nawiązaniu..."

200 OK - email w kolejce

Czym jest API do wysyłania wiadomości e-mail z konta użytkownika?

API do wysyłania wiadomości e-mail działające w imieniu Twoich użytkowników

Większość wyszukiwań "API do wysyłania e-maili" prowadzi do dostawców transakcyjnych. To nie jest to. Unipile to API do obsługi poczty e-mail użytkowników: łączy się z prawdziwymi kontami Gmail lub Outlook Twoich użytkowników i wysyła wiadomości w ich imieniu, z ich tożsamością i ich dostarczalnością.

Kluczowe przypadki użycia

Dlaczego deweloperzy budują na API do obsługi poczty e-mail użytkowników

Kiedy Twój produkt musi wysyłać wiadomości e-mail programowo od prawdziwych osób (nie z adresu noreply@), są to scenariusze, które napędzają adopcję.

CRM i Automatyzacja Sprzedaży

Wysyłaj e-maile weryfikacyjne z własnych kont Gmail lub Outlook każdego przedstawiciela handlowego. Wyższe wskaźniki odpowiedzi, autentyczna tożsamość nadawcy, nie wymaga rozgrzewania domeny. Potencjalni klienci widzą prawdziwe imię, a nie generyczny pseudonim.

Platformy obsługi klienta

Pozwól agentom wsparcia odpowiadać bezpośrednio z ich własnej skrzynki pocztowej. Klienci widzą nazwisko i adres e-mail prawdziwej osoby, a nie alias typu support@. Buduje zaufanie, przyspiesza rozwiązywanie problemów.

Narzędzia ATS i rekrutacyjne

Docieraj do kandydatów dzięki spersonalizowanym e-mailom z rzeczywistego konta rekrutera. Bez zimnej domeny, bez ryzyka filtrów antyspamowych, bez okresu rozgrzewkowego. E-mail trafia do skrzynki odbiorczej jak prywatna wiadomość, ponieważ nią jest.

Obsługiwani dostawcy

Wyślij e-mail z Gmail, Outlook i IMAP: Jedno API

API wysyłki wiadomości e-mail Unipile całkowicie abstrahuje warstwę dostawcy. Niezależnie od tego, czy konto Twojego użytkownika to Gmail, Outlook, Microsoft 365, Exchange Online czy dowolna skrzynka pocztowa zgodna z IMAP, wywołanie API jest identyczne. Piszesz integrację raz i działa ona z każdym dostawcą.

Gmail

Google Workspace w zestawie

Uwierzytelnianie OAuth2, nie jest wymagane hasło

Zakres gmail.wyślijminimalna liczba wymaganych uprawnień

Do 500 wiadomości e-mail dziennie na konto osobiste, wyższe limity dla Workspace

Doskonała dostarczalność: infrastruktura Google, reputacja użytkownika

Gotowy do OAuth2

Przewodnik po integracji z Gmail API

Perspektywy

Obejmuje Microsoft 365 i Exchange Online

OAuth2 przez Microsoft Identity Platform

Zezwolenie Mail.Send:delegowane lub na poziomie aplikacji

Działa dla kont osobistych Outlook, Microsoft 365 i Exchange Online

Do 10 000 odbiorców dziennie dla kont M365

Gotowy do OAuth2

Przewodnik po Microsoft Graph API

IMAP

Uniwersalna alternatywa dla dowolnego dostawcy

Obsługuje IMAP/SMTP z poświadczeniami lub OAuth2 tam, gdzie jest dostępny

Działa z Yahoo, Zoho, Fastmail, niestandardowymi serwerami poczty firmowej

Ten sam punkt końcowy API Unipile, bez dodatkowej pracy integracyjnej

Idealne dla użytkowników B2B z niestandardowymi domenami i firmowym adresem e-mail

Uniwersalny

Przewodnik po integracji API IMAP

Przewodnik Krok po Kroku

Jak wysłać e-mail przez API: Integracja krok po kroku

Od połączenia konta po wysłanie pierwszego programu e-mail, oto kompletny przebieg. Ten przewodnik obejmuje Gmail i Outlook; kroki dla IMAP są identyczne, zmienia się tylko typ konta.

1

Pobierz klucz API Unipile

Zaloguj się w panelu Unipile. Każda przestrzeń robocza otrzymuje klucz API. Wszystkie żądania są uwierzytelniane za pomocą X-API-KEY header. Brak konfiguracji OAuth po Twojej stronie: Unipile obsługuje autoryzację dostawcy za Ciebie.

zwijać się

# Zweryfikuj swój klucz API zwijać się -X GET https://api.unipile.com/api/v1/accounts \ -H "X-API-KEY: {TWÓJ_KLUCZ_API}"

2

Połącz konto użytkownika (Gmail, Outlook lub IMAP)

Wygeneruj link hostowanego uwierzytelniania za pomocą API. Użytkownik klika w niego i przechodzi przez standardowy ekran zgody OAuth2 u swojego dostawcy. Unipile bezpiecznie przechowuje tokeny i zwraca account_id. Nigdy nie dotykasz danych uwierzytelniających.

zwijać się JavaScript Python

# Wygeneruj link uwierzytelniający dla Gmaila z opcją hostingu zwijać się -X POST https://api.unipile.com/api/v1/hosted/accounts/link \ -H "X-API-KEY: {TWÓJ_KLUCZ_API}" -H "Typ-Zawartości: application/json" -d '{"typ":"GOOGLE","api_url":"https://api.unipile.com","expiresOn":"2026-12-31T00:00:00.000Z"}'

// Generuj link autoryzacyjny - Node.js const res = czekać fetch('https://api.unipile.com/api/v1/hosted/accounts/link', { metoda: 'POST', nagłówki: { 'Klucz API X': '{TWOJE_KLUCZ_API}', 'Content-Type': 'application/json'}, body: JSON.stringify({ typ: 'GOOGLE', api_url: 'https://api.unipile.com', ważneDo: '31-12-2026'}) });const { adres url } = czekać res.json();

# Wygeneruj link autoryzacyjny - Python import żądania res = requests.post( 'https://api.unipile.com/api/v1/hosted/accounts/link', nagłówki={'Klucz API X': '{TWOJE_KLUCZ_API}'}, json={ 'typ': 'GOOGLE', 'adres_api': 'https://api.unipile.com', 'wygasa': '31-12-2026'} ) url = res.json()['adres URL']

Do programu Outlook, użyj "typ":"MICROSOFT". Dla IMAP, użyj "typ":"IMAP". Ten sam przepływ hostowany obsługuje wszystkich trzech dostawców.

3

Pobierz identyfikator konta z powiadomienia zwrotnego webhooka

Po tym, jak użytkownik zakończy proces OAuth2, Unipile wyśle webhook do Twojego punktu końcowego z account_id. Zachowaj to w swojej bazie danych: będzie to klucz używany w każdym wywołaniu API wysyłania wiadomości e-mail dla tego użytkownika.

Ładunek JSON

// Przykład ładunku webhook (zdarzenie account.linked){ "zdarzenie": "konto.połączone", "account_id": "acc_gmail_Abc123XYZ", "dostawca": "GOOGLE", "email": "sarah@acme.com"Zamykamy nawias.

4

Wyślij e-mail z połączonego konta

POST do /api/v1/emails z account_id. E-mail jest wysyłany z rzeczywistej skrzynki odbiorczej Gmail lub Outlook użytkownika, tak samo, jakby sam nacisnął przycisk wysyłania. Punkt końcowy jest identyczny bez względu na to, czy połączone konto to Gmail, Outlook, czy IMAP.

zwijać się JavaScript Python

# Wyślij e-mail z połączonego konta Gmail zwijać się -X POST https://api.unipile.com/api/v1/emails \ -H "X-API-KEY: {TWÓJ_KLUCZ_API}" -H "Typ-Zawartości: application/json" -d '{ "account_id": "{ACCOUNT_ID}", "do": [{"display_name": "Jan Kowalski", "identifier": "jan@example.com"}], "temat": "Nawiązanie do naszej rozmowy", "ciało"Cześć Jan,Chciałem/Chciałam tylko się przypomnieć..." }'

// Wyślij e-mail - Node.js const res = czekać fetch('https://api.unipile.com/api/v1/emails', { metoda: 'POST', nagłówki: { 'Klucz API X': '{TWOJE_KLUCZ_API}', 'Content-Type': 'application/json'}, body: JSON.stringify({ account_id: '{ID_KONTA}', do: [{ wyświetlana_nazwa: 'Jan Kowalski', identyfikator: 'john@example.com' }], temat: 'Nawiązując do naszej rozmowy', ciało: 'Cześć Jan,Chciałem/Chciałam tylko się przypomnieć...'}) });const dane = czekać res.json();

# Wysyłanie e-maili - Python import żądania res = requests.post( 'https://api.unipile.com/api/v1/emails', nagłówki={'Klucz API X': '{TWOJE_KLUCZ_API}'}, json={ 'id_konta': '{ID_KONTA}', 'do': [{ 'nazwa_wyświetlana': 'Jan Kowalski', 'identyfikator': 'john@example.com' }, 'temat': 'Nawiązując do naszej rozmowy', 'ciało': 'Cześć Jan,Chciałem/Chciałam tylko się przypomnieć...'} ) print(res.json())

Odpowiedź zawiera identyfikator wiadomości i status dostarczenia. Możesz również dodać "DW", "dw skj", "odpowiedz_do"oraz "załączniki" do tej samej ładunku.

Gotowi do wysyłania e-maili z Gmail, Outlook i IMAP?

Twój klucz API czeka. Zacznij tworzyć w mniej niż 10 minut.

Zacznij budować już teraz Wyświetl dokumenty

Zunifikowany punkt końcowy API

Jednolity Punkt Końcowy do Wysyłania E-maili przez Wszystkich Dostawców

Największą przeszkodą w integracjach z wieloma dostawcami jest utrzymywanie oddzielnych ścieżek kodu dla każdej usługi pocztowej. Unipile eliminuje ten problem. Niezależnie od tego, czy połączone konto to Gmail, Outlook, czy IMAP, zawsze wywołujesz ten sam punkt końcowy z tym samym ładunkiem. Warstwa abstrakcji zajmuje się protokołami specyficznymi dla dostawcy, odświeżaniem tokenów i różnicami w limitach zapytań w tle.

POST /api/v1/emails - identyczne dla wszystkich dostawców Ujednolicony

POST https://api.unipile.com/api/v1/emails X-API-KEY: {TWÓJ_KLUCZ_API}{ "account_id": "{ACCOUNT_ID}", "do": [{ "nazwa_wyświetlana": "Jan Kowalski", "identyfikator": "john@example.com"}], "temat": "Aktualizacja Twojego projektu", "ciało": "Cze\u015b\u0107 John...<\/p>"}// Działa dla Gmail, Outlook i IMAP // id_konta informuje Unipile, którego konta użyć

Gmail

+

Perspektywy

+

IMAP

/api/v1/emails

Poznaj zunifikowane, wielodostawcowe API poczty elektronicznej

Pisz raz, wspieraj każdego dostawcę

Brak oddzielnych ścieżek kodu dla Gmaila i Outlooka. Jedna integracja obejmuje dziś wszystkich trzech dostawców i wszelkich przyszłych dodatków dołączonych przez Unipile.

Odświeżanie tokenu obsługiwane automatycznie

Tokeny dostępu OAuth2 wygasają. Unipile odświeża je w sposób przejrzysty. Twój kod nigdy nie musi obsługiwać cyklu życia tokenu; po prostu wywołuj API i wysyłaj.

Skaluj do tysięcy połączonych kont

Każdy użytkownik łączy swoje własne konto. Ty zarządzasz identyfikatorem konta (account_id) dla każdego użytkownika; Unipile zajmuje się resztą. Bez żonglerki SDK poszczególnych dostawców.

Spójny format odpowiedzi

API zwraca taką samą strukturę JSON niezależnie od dostawcy. Przeanalizuj jeden schemat, zbuduj jeden program obsługi błędów, dostarcz szybciej.

Chcesz wysyłać e-maile w imieniu swoich użytkowników na dużą skalę? Przeczytaj pełny poradnik, jak to zrobić wysyłaj e-maile w imieniu użytkowników, w tym model zgodności i zgody stosowany przez Unipile, aby wszystko było możliwe do audytu.

API Reference

Wszystkie punkty końcowe API wysyłania wiadomości e-mail, zorganizowane

Każdy punkt końcowy dostępny do połączenia kont, wysyłania i odpowiadania, zarządzania skrzynką pocztową oraz nasłuchiwania zdarzeń w Gmailu, Outlooku i IMAP przy użyciu jednej integracji.

Przeglądaj wszystkie punkty końcowe

Wyślij i Odpowiedz

4 dostępne punkty końcowe

Gmail

Perspektywy

IMAP

Wyślij wiadomość e-mail

Odpowiedz na wiadomość e-mail

Prześlij dalej e-mail

Wyślij z załącznikami

Konfiguracja konta

3 dostępne punkty końcowe

Gmail

Perspektywy

IMAP

Uwierzytelnianie hostowane: przepływ OAuth z białym znakiem

Użyj własnego ekranu OAuth

Połącz się z danymi uwierzytelniającymi (SMTP)

Zarządzaj e-mailami

5 dostępne punkty końcowe

Gmail

Perspektywy

IMAP

Lista wiadomości e-mail

Pobierz e-mail

Usuń wiadomość e-mail

Przenieś e-mail

Lista folderów

Webhooks

2 dostępne wydarzenia

Gmail

Perspektywy

IMAP

Nowa wiadomość e-mail została odebrana

Śledzenie otwarć i kliknięć

Explore API Reference

Przewodnik po interfejsie API poczty e-mail

Chcesz kompletny przewodnik po integracji API poczty e-mail?

Obejmuje przepływy uwierzytelniania, konfigurację webhooków, czytanie i wysyłanie wiadomości e-mail, załączniki oraz pełne porównanie dostawców — wszystko, czego potrzebujesz, aby stworzyć gotową do produkcji integrację z API do wysyłania wiadomości e-mail.

Przeczytaj Przewodnik po interfejsie API wiadomości e-mail

Uwierzytelnianie i bezpieczeństwo

Uwierzytelnianie i bezpieczeństwo dla Twojej integracji z API do wysyłania e-maili

Obsługa poświadczeń e-mail użytkowników jest jednym z najbardziej ryzykownych elementów każdej integracji SaaS. Architektura Unipile zaprojektowana jest tak, aby nigdy nie przechowywać ani nie przesyłać bezpośrednio tokenów OAuth2; powierzchnia ryzyka pozostaje minimalna, a zgodność pozostaje łatwa do zarządzania.

OAuth2: brak przechowywania danych uwierzytelniających po Twojej stronie

Unipile generuje adres URL zgody OAuth2, zbiera kod autoryzacyjny i przechowuje tokeny dostępu oraz odświeżania we własnym zaszyfrowanym skarbcu. Twój backend widzi jedynie account_id. Brak surowych tokenów, haseł czy dryfu poświadczeń.

Automatyczne odświeżanie tokenu

Tokeny Gmail OAuth2 wygasają po 1 godzinie. Tokeny Microsoftu wygasają po 1 godzinie (dostępu) lub 90 dniach (odświeżania). Unipile odświeża je automatycznie przed wygaśnięciem. Twoje wywołania API do wysyłania wiadomości e-mail nigdy nie kończą się niepowodzeniem z powodu nieaktualnego tokena.

Minimalne zakresy OAuth2

W przypadku integracji typu „tylko wysyłanie” Unipile prosi tylko o wymagane zakresy: gmail.wyślij dla Gmaila i Mail.Send dla programu Outlook. Przestrzega to zasady najmniejszych uprawnień i zmniejsza powierzchnię ataku na dane użytkowników.

Weryfikacja podpisu webhooka

Każdy webhook wysyłany przez Unipile do Twojego punktu końcowego zawiera nagłówek podpisu, który możesz zweryfikować za pomocą swojego sekretu webhooka. Zapewnia to, że ładunki zdarzeń nie mogą zostać sfałszowane przez osoby trzecie próbujące wywołać akcje w Twoim systemie.

SOC 2 Typ II

Infrastruktura Unipile posiada certyfikat SOC 2 typu II. Audytowane kontrole obejmują zarządzanie dostępem, szyfrowanie danych w spoczynku i w tranzycie, reakcję na incydenty oraz dostępność. Dzięki temu łatwo przejść przez oceny bezpieczeństwa dostawców, gdy klienci korzystający z usług SaaS pytają o sposób obsługi poświadczeń e-mail.

Dowiedz się o bezpiecznym API poczty elektronicznej

CASA Poziom 2

Unipile posiada ocenę CASA Tier 2, która jest standardem bezpieczeństwa wymaganym przez Google dla aplikacji uzyskujących dostęp do poufnych zakresów Gmail API. Ocena jest przeprowadzana przez autoryzowane laboratorium i obejmuje obsługę danych, kontrolę dostępu oraz bezpieczne praktyki programistyczne. Wymagane do utrzymania produkcji dostępu do zakresów wysyłania Gmail.

Możliwości API

Pełne pokrycie funkcji API poczty e-mail we wszystkich dostawcach

Jedna integracja daje Ci dostęp do wszystkich głównych operacji e-mail w Gmail, Outlook i u dostawców IMAP. Ten sam punkt końcowy, ta sama struktura ładunku, ten sam format odpowiedzi, niezależnie od tego, które konto połączył Twój użytkownik.

Cecha	Gmail	Outlook / M365	IMAP / SMTP
Wysyłanie
Wyślij e-mail z konta użytkownika	✓	✓	✓
Wyślij z załącznikami	✓	✓	✓
Odpowiedz w istniejącym wątku	✓	✓	✓
Odbiorcy DW i UDW	✓	✓	✓
Treść ciała HTML	✓	✓	✓
Obrazy w linii (osadzanie CID)	✓	✓	✓
Dzienne ograniczenie wysyłki (orientacyjnie)	~500 dziennie	~10 000 / dzień	Zależny od serwera
Czytanie i synchronizacja
Wyświetl i odczytaj e-maile	✓	✓	✓
Widok wątku / rozmowy	✓	✓	✓
Naziemne webhooki w czasie rzeczywistym (nowy e-mail, odczytany, wysłany)	✓	✓	✓
Przyrostowa synchronizacja różnicowa	✓	✓	✓
Zarządzanie etykietami i folderami	✓Etykiety	✓Foldery	✓Foldery
Uwierzytelnianie i bezpieczeństwo
OAuth2 (bez przechowywania haseł)	✓	✓	Hasło aplikacji
Automatyczne odświeżanie tokenu	✓	✓	✓
SOC 2 Typ II / CASA Poziom 2	✓	✓	✓

Powszechne pułapki

Częste błędy przy integracji API do wysyłania e-maili

Większość problemów, z którymi spotykają się deweloperzy podczas integracji API do wysyłania e-maili do kont użytkowników, można podzielić na kilka kategorii. Oto te, o których warto wiedzieć przed rozpoczęciem budowy.

01

Ignorowanie limitów szybkości dostawców

Osobiste konta Gmail są ograniczone do około 500 wiadomości e-mail dziennie. Konta Outlook mają wyższe limity, ale nadal mogą podlegać ograniczeniom w okresach wzmożonego ruchu. Przekroczenie tych limitów powoduje błędy 429 lub tymczasowe zawieszenie konta przez dostawcę.

NaprawŚledź liczbę wysyłek na powiązane konto, zaimplementuj wykładnicze wycofywanie się przy odpowiedziach 429 i rozłóż masowe wysyłki na okresy czasu zamiast wysyłać je w jednym impulsie.

02

Nieobsługiwane odwołanie tokenu

Użytkownicy mogą w każdej chwili cofnąć dostęp w ustawieniach swojego konta Google lub Microsoft. Kiedy to nastąpi, Unipile zwróci błąd przy następnym wywołaniu API dla tego konta. Jeśli Twoja aplikacja nie obsłuży tego w odpowiedni sposób, spowoduje to ciche błędy w dostarczaniu wiadomości e-mail.

NaprawSłuchaj dla account.disconnected zdarzenie webhook i poproś użytkownika o ponowne połączenie konta.

03

Wysyłanie bez wyraźnej zgody użytkownika

Nawet z prawidłowym tokenem OAuth2, wysyłanie e-maili z konta użytkownika bez jego wiedzy narusza zasady użytkowania Google i Microsoft, a także przepisy o spamie w większości jurysdykcji. Ekran zgody OAuth2 musi jasno wyjaśniać, co zrobi Twoja aplikacja.

NaprawUżywaj jasnego języka na ekranie zgody OAuth oraz w opisach aplikacji. Dokumentuj, co uruchamia zautomatyzowaną wysyłkę i daj użytkownikom możliwość jej wyłączenia.

04

Przechowywanie surowych tokenów OAuth2 w bazie danych

Jeśli przechowujesz tokeny dostępu samodzielnie i zostaną one ujawnione podczas naruszenia danych, atakujący będzie miał pełny dostęp do wszystkich powiązanych kont e-mail. Jest to krytyczne ryzyko bezpieczeństwa i zgodności, zwłaszcza w świetle RODO.

NaprawUżyj przepływu uwierzytelniania hostowanego przez Unipile. Przechowujesz tylko account_id; Unipile przechowuje tokeny w swoim certyfikowanym przez SOC 2 skarbcu. Twoja baza danych nigdy nie dotyka surowego tokenu OAuth2.

05

Traktowanie SMTP i interfejsu API REST do wysyłania wiadomości e-mail jako zamiennych

SMTP wymaga bezpośredniego dostępu do serwera, zarządzania poświadczeniami, konfiguracji TLS i obsługi zwrotów. Interfejs API REST do wysyłania wiadomości e-mail abstrahuje to wszystko. Połączenie obu podejść w tym samym kodzie źródłowym dodaje złożoności bez korzyści.

NaprawDo wysyłania z konta użytkownika używaj wyłącznie interfejsu API REST. SMTP ma znaczenie tylko wtedy, gdy zarządzasz własną infrastrukturą pocztową lub masz dostawcę, który nie obsługuje OAuth2.

Często zadawane pytania

Wszystko, co musisz wiedzieć o API do wysyłania wiadomości e-mail.

01 Co to jest API do wysyłania wiadomości e-mail?

API do wysyłania wiadomości e-mail to interfejs REST, który umożliwia aplikacji programowe wysyłanie wiadomości e-mail bez otwierania klienta poczty. API do wysyłania wiadomości e-mail Unipile wysyła wiadomości specyficznie z kont należących do użytkownika (Gmail, Outlook, IMAP), co oznacza, że wiadomość e-mail dociera z prawdziwego adresu użytkownika, a nie z ogólnej domeny noreply@ kontrolowanej przez Ciebie.

02 Jak wysłać e-mail z konta Gmail użytkownika za pośrednictwem interfejsu API?

Dzięki Unipile generujesz hostowany link uwierzytelniający dla dostawcy GOOGLE. Użytkownik uwierzytelnia się za pomocą standardowego ekranu zgody OAuth2 Google. Po połączeniu otrzymasz account_id przez webhook. Następnie wysyłasz POST do /api/v1/emails z tym account_id i Twoim ładunkiem wiadomości. E-mail wysyłany jest z ich rzeczywistego adresu Gmail. Nie jest wymagane żadne ustawienie klucza Gmail API po Twojej stronie.

03 Czy mogę wysyłać e-maile programowo z programu Outlook?

Tak. Unipile obsługuje programowe wysyłanie wiadomości e-mail z kont Outlook, w tym osobistego Outlook, Microsoft 365 i Exchange Online, wszystko za pośrednictwem tego samego punktu końcowego API. Konto łączysz za pomocą typu dostawcy MICROSOFT. Uwierzytelnianie odbywa się za pomocą protokołu OAuth2 z Mail.Send upoważnienie delegowane. Unipile automatycznie obsługuje odświeżanie tokenów.

04 Jakie zakresy OAuth2 są mi potrzebne do wysyłania wiadomości e-mail za pomocą Gmail API?

Dla integracji typu „tylko wysyłanie” minimalny wymagany zakres to https://www.googleapis.com/auth/gmail.send. Pozwala to na wysyłanie wiadomości e-mail, ale nie daje dostępu do odczytu, modyfikacji ani usuwania wiadomości. Korzystając z Unipile, nie konfigurujesz tego zakresu samodzielnie; przepływ uwierzytelniania hostowanego się tym zajmuje. W przypadku czystego przypadku użycia interfejsu API do wysyłania wiadomości e-mail, gmail.wyślij jest wystarczający.

05 Czym różni się API do obsługi e-maili kont użytkownika od API do obsługi e-maili transakcyjnych?

To są różne rynki dla różnych problemów. API transakcyjne wysyłają z domeny, którą posiadasz i kontrolujesz. Unipile nie działa na tym rynku. Unipile łączy się z prawdziwymi kontami Gmail lub Outlook Twoich użytkowników i wysyła w ich imieniu, z ich tożsamością, do zastosowań, w których liczy się adres nadawcy: sekwencje CRM, odpowiedzi wsparcia, outreach.

06 Jak sobie radzić z limitami szybkości podczas wysyłania wiadomości e-mail przez API?

Limity wysyłki obowiązują na poziomie dostawcy, a nie Unipile. Osobiste konta Gmail zezwalają na wysłanie około 500 e-maili dziennie. Konta Outlook i Microsoft 365 mają wyższe limity, ale mogą zostać spowolnione przy dużej liczbie wysyłek w krótkim czasie. Zalecana praktyka: śledź liczbę wysłanych wiadomości dla każdego połączonego konta we własnej bazie danych, wdrażaj wykładnicze wycofywanie (exponential backoff) po otrzymaniu odpowiedzi 429 i rozkładaj masowe wysyłki w czasie. Unipile zwraca kod błędu dostawcy, dzięki czemu możesz odróżnić błąd limitu wysyłki od błędu uwierzytelnienia.

07 Czy istnieje API, które działa z Gmail, Outlook i IMAP z jedną integracją?

Tak: to jest dokładnie to, co zapewnia Unipile. Jedna POST /api/v1/emaile endpoint obsługuje konta Gmail, Outlook i IMAP. Dostawca jest określany przez account_id w ładunku; nie musisz tego określać. Zapisz logikę wysyłania raz, a będzie ona działać niezależnie od tego, z którego dostawcy poczty e-mail korzysta Twój użytkownik.

08 Unipile zapewnia zgodność podczas uzyskiwania dostępu do kont e-mail użytkowników poprzez wdrożenie rygorystycznych środków bezpieczeństwa i protokołów zgodności. Obejmuje to: * **Minimalizacja danych**: Unipile odzyskuje tylko te informacje z konta e-mail, które są niezbędne do świadczenia jego usług. Oznacza to, że nie uzyskują dostępu ani nie przechowują zbędnych danych osobowych. * **Szyfrowanie**: Dane, zarówno podczas przesyłania, jak i w spoczynku, są szyfrowane przy użyciu silnych algorytmów. Zapewnia to, że nawet jeśli dane zostaną przechwycone, będą one nieczytelne dla nieautoryzowanych stron. * **Zarządzanie zgodami i kontrola użytkownika**: Unipile zawsze uzyskuje wyraźną zgodę użytkownika przed uzyskaniem dostępu do ich konta e-mail. Użytkownicy zachowują kontrolę i mogą w każdej chwili wycofać dostęp. * **Szanowanie zasad platform e-mail**: Unipile ściśle przestrzega zasad dostawców usług e-mail (np. Gmail, Outlook) dotyczących dostępu do danych i integruje się z nimi w bezpieczny i zgodny sposób, zazwyczaj za pomocą oficjalnych API. * **Audyt i monitorowanie**: Działania związane z dostępem do danych są regularnie audytowane i monitorowane, aby zapewnić zgodność z wewnętrznymi politykami i zewnętrznymi przepisami. * **Zgodność z przepisami o ochronie danych**: Unipile przestrzega odpowiednich przepisów o ochronie danych, takich jak RODO (GDPR), co oznacza, że mają ustanowione procesy dotyczące gromadzenia, przetwarzania i przechowywania danych użytkowników w sposób legalny i sprawiedliwy. * **Bezpieczna infrastruktura**: Infrastruktura, na której działa Unipile, jest zaprojektowana z myślą o bezpieczeństwie, z kontrolami dostępu, regularnymi aktualizacjami i środkami zapobiegającymi naruszeniom. Poprzez te środki Unipile stara się zapewnić, że uzyskiwanie dostępu do kont e-mail użytkowników odbywa się w sposób odpowiedzialny, bezpieczny i zgodny z obowiązującymi przepisami i wytycznymi branżowymi.

Unipile korzysta wyłącznie z OAuth2; nie przechowujemy haseł. Użytkownicy przechodzą standardowy ekran zgody dostawcy i mogą cofnąć dostęp w dowolnym momencie z ustawień swojego konta Google lub Microsoft. Unipile posiada certyfikat SOC 2 Type II, co oznacza, że mechanizmy bezpieczeństwa, w tym zarządzanie dostępem, szyfrowanie i reagowanie na incydenty, są niezależnie audytowane. Tokeny OAuth2 są przechowywane w zaszyfrowanym sejfie i nigdy nie są udostępniane Twojej aplikacji.

Masz jeszcze jakieś pytania? Nasz zespół służy pomocą.

Zacznij budować już dziś

Twoje API do wysyłania e-maili, gotowe w kilka minut

Połącz swoje pierwsze konto Gmail, Outlook lub IMAP i wyślij pierwszy e-mail programowo w mniej niż 30 minut. Bez przechowywania danych uwierzytelniających, bez konfiguracji OAuth2 po Twojej stronie, bez SDK dla poszczególnych dostawców. Jedno `account_id`, jeden punkt końcowy REST, wszyscy dostawcy.

Rozpocznij bezpłatny okres próbny Przeczytaj dokumentację deweloperską

Certyfikat SOC 2 typu II

Karta kredytowa nie jest wymagana

Obsługiwane Gmail, Outlook i IMAP

API do wysyłania wiadomości e-mail: Gmail, Outlook i IMAP z kont użytkowników (2026)

API wysyłania wiadomości e-mail: Wyślij od użytkownika Gmail, Outlook i IMAP Konta

API do wysyłania wiadomości e-mail działające w imieniu Twoich użytkowników

Dlaczego deweloperzy budują na API do obsługi poczty e-mail użytkowników

Wyślij e-mail z Gmail, Outlook i IMAP: Jedno API

Jak wysłać e-mail przez API: Integracja krok po kroku

Jednolity Punkt Końcowy do Wysyłania E-maili przez Wszystkich Dostawców