Interfejs API poczty e-mail dla integracji z programem Microsoft Outlook

Unipile - API do poczty e-mail Outlook (Wersja Lekka)
API Poczty Outlook

Połącz i zsynchronizuj Outlook 365 Skrzynki pocztowe przez API

Wbuduj w swoją aplikację zaawansowane funkcje poczty e-mail za pomocą interfejsu API poczty e-mail Outlook. Przeglądaj, wysyłaj, synchronizuj i reaguj na wiadomości e-mail Outlook i Microsoft 365 za pośrednictwem pojedynczego interfejsu REST obsługiwanego przez Microsoft Graph, bez konieczności samodzielnego zarządzania przepływami OAuth.

outlook-sync.js
const response = czekać fetch( `https://${DSN}/api/v1/emails`, { nagłówki: { 'Klucz API X': klucz API, 'id_konta': identyfikatorKontaOutlook } } ); const e-maile = czekać odzew.json(); // emails.items, tablica wiadomości programu Outlook // działa dla Outlook, Gmail i IMAP
200 OK, skrzynka pocztowa programu Outlook została zsynchronizowana
Obsługuje: Perspektywy Gmail IMAP
Definicja

Czym jest interfejs API poczty e-mail programu Outlook?

The API Poczty Outlook jest interfejsem RESTful, który zapewnia programistom programowy dostęp do danych skrzynek pocztowych Outlook i Microsoft 365. Zbudowany na Microsoft Graph, … umożliwia to Twojej aplikacji odczytywanie, wysyłanie, porządkowanie i synchronizowanie wiadomości e-mail na dowolnym koncie Outlook lub Exchange Online – z wykorzystaniem protokołu OAuth 2.0, który zapewnia bezpieczne uwierzytelnianie w imieniu użytkownika. Programiści integrują interfejs API poczty e-mail Outlooka w celu tworzenia klientów poczty elektronicznej, modułów synchronizacji CRM, narzędzi ATS oraz rozwiązań do automatyzacji działań marketingowych bez ujawniania danych uwierzytelniających użytkowników.

Protokół bazowy
Interfejs API Microsoft Graph (REST/JSON) – jeden punkt dostępu do wszystkich usług Microsoft 365, w tym Outlooka, Teams i Kalendarza.
Model uwierzytelniania
OAuth 2.0 z rejestracją aplikacji w usłudze Azure. Każde połączone konto przechodzi proces uwierzytelniania w imieniu swojego użytkownika – bez wspólnych danych uwierzytelniających i bez przechowywania haseł.
Zakres ubezpieczenia
Konta Outlook osobiste, Microsoft 365 Business, Exchange Online - wszystkie dostępne przez ten sam punkt końcowy API poczty Outlook.
Przypadki użycia

Dlaczego warto zintegrować interfejs API poczty e-mail Outlooka z Twoją aplikacją?

Włączenie interfejsu API poczty e-mail programu Outlook do Twojej aplikacji zapewnia użytkownikom bezpośredni dostęp do skrzynki pocztowej Microsoft 365 w ramach Twojego produktu, bez konieczności przełączania się między kartami i ręcznego kopiowania oraz wklejania. Oto cztery podstawowe funkcje, z których zespoły korzystają najczęściej.

Zarządzanie pocztą e-mail
Bezproblemowo zintegruj komunikację e-mailową z Twoją platformą. Użyj Microsoft Graph, aby wykorzystać potężne operacje odczytu, wysyłania, usuwania i zarządzania folderami, a także zapewnić efektywną synchronizację wszystkich wiadomości Outlook.
Automatyzacja procesów
Wysyłaj e-maile programistycznie, uruchamiaj sekwencje wiadomości-śledzących dla nowych wiadomości i automatyzuj reguły routingu. Interfejs API poczty e-mail programu Outlook pozwala na eliminację ręcznej pracy z każdego przepływu pracy opartego na poczcie e-mail w Twojej aplikacji.
Aktualizacje w czasie rzeczywistym
Subskrypcje webhooków w Microsoft Graph przesyłają zdarzenia dotyczące nowych wiadomości e-mail na Twój serwer natychmiast po ich nadejściu. Nie ma potrzeby odpytywania, Twoja aplikacja reaguje w czasie rzeczywistym na każdą przychodzącą wiadomość Outlook.
Bezpieczeństwo przedsiębiorstwa
OAuth 2.0 z Azure AD sprawia, że aplikacja nigdy nie przechowuje haseł użytkowników. Infrastruktura firmy Microsoft zajmuje się rotacją tokenów, MFA i dostępem warunkowym, podczas gdy Unipile opakowuje cały przepływ na stronie uwierzytelniania z białym etykietowaniem.
Outlook API dla CRM - Unipile
Rozwiązania CRM

Interfejs API Microsoft Outlook dla Twojego rozwiązania CRM

Synchronizuj rozmowy z programu Outlook z procesami sprzedaży i danymi klientów

Outlook API dla CRM
Planowanie i koordynacja potoków
Dzięki synchronizacji wiadomości e-mail i kalendarzy Outlook, Twój system CRM umożliwia bezproblemowe planowanie spotkań handlowych i działań follow-up. Aktualizacje z Microsoft Graph w czasie rzeczywistym dzięki webhookom eliminują ryzyko pominiętych spotkań i spowolnienia procesów sprzedażowych.
Zaawansowana analityka i analizy zaangażowania
Integracja danych e-mail z Outlooka z Twoim CRM zapewnia zaawansowaną analitykę interakcji z klientami. Zespoły sprzedaży mogą śledzić wskaźniki zaangażowania, mierzyć skuteczność wiadomości e-mail i dostosowywać strategie komunikacji w oparciu o rzeczywiste sygnały.
Zautomatyzowane przepływy pracy sprzedaży
Dzięki interfejsowi API wiadomości e-mail programu Outlook, Twój system CRM może automatyzować rutynowe zadania sprzedażowe, takie jak e-maile przypominające, powiadomienia i wykrywanie odpowiedzi. Przedstawiciele handlowi skupiają się na sprzedaży o wysokiej wartości, zamiast na powtarzalnym zarządzaniu skrzynką odbiorczą.
Redakcja ATS

Synchronizuj E-maile Outlook z systemami śledzenia kandydatów

Microsoft Graph API dla platform rekrutacyjnych i oprogramowania HR

Outlook API dla ATS
Usprawniona komunikacja z kandydatami
Integracja Microsoft Graph API pozwala systemowi ATS synchronizować e-maile z Outlooka bezpośrednio w platformie. Rekruterzy scentralizują każdą konwersację z kandydatem i przestaną przełączać się między Outlookiem a Twoim oprogramowaniem.
Planowanie i koordynacja rozmów kwalifikacyjnych
Dzięki połączeniu interfejsu API poczty e-mail programu Outlook z synchronizacją kalendarza, Twój ATS oferuje bezproblemowe planowanie rozmów kwalifikacyjnych. Aktualizacje webhook w czasie rzeczywistym zapewniają, że żadne spotkania nie zostaną przegapione, a koordynacja z menedżerami ds. rekrutacji przebiega szybciej.
Poprawione bezpieczeństwo danych i zgodność z przepisami
Przepływ OAuth 2.0 Microsoft Graph z Azure AD chroni poufne dane kandydatów. Twój ATS dziedziczy warunkowy dostęp na poziomie przedsiębiorstwa, uwierzytelnianie wieloskładnikowe i ścieżki audytu, zapewniając zgodność rekrutacji z RODO.
Narzędzia Outreach

Synchronizuj API Outlook z narzędziami Outreach

Zasilaj wielokanałowe platformy angażowania sprzedaży za pomocą Microsoft Graph

Zintegrowanie interfejsu API poczty e-mail Outlook z oprogramowaniem do kontaktu zapewnia zespołom sprzedaży jedno źródło prawdy dla każdej interakcji z potencjalnym klientem. Rozmowy pozostają zsynchronizowane, przypomnienia są wysyłane automatycznie, a dane o zaangażowaniu trafiają bezpośrednio do Twoich pulpitów nawigacyjnych.

Bezproblemowa synchronizacja poczty e-mail i kalendarza dla każdego potencjalnego klienta, z aktualizacjami webhook w czasie rzeczywistym z Microsoft Graph, dzięki czemu handlowcy nigdy nie przegapią odpowiedzi ani spotkania.
Zaawansowana analityka zaangażowania na sygnały otwarć i odpowiedzi, pozwalając zespołom mierzyć skuteczność e-maili i udoskonalać sekwencje w oparciu o dane dotyczące rzeczywistej wydajności.
Zautomatyzowane sekwencje działań następczych wstrzymanie odpowiedzi, rozgałęzienie według zamiaru i kierowanie gorących leadów, wszystko napędzane zdarzeniami z Outlooka przesyłanymi strumieniowo przez API Unipile.
Biała etykieta przepływu OAuth za pośrednictwem Azure AD, dzięki czemu Twoi użytkownicy mogą połączyć swoją skrzynkę pocztową Outlook w kilka sekund, nigdy nie opuszczając Twojej platformy outreach.
Interfejs API programu Outlook dla programu Outreach

Konfiguracja Microsoft OAuth dla API poczty e-mail Outlook

Dokumentacja Microsoft OAuth

Domyślnie Twoja integracja wykorzystuje dane uwierzytelniające OAuth firmy Unipile. Aby uzyskać pełne doświadczenie marki białej etykiety Kiedy użytkownicy końcowi łączą swoje skrzynki pocztowe Outlook lub Microsoft 365, zarejestruj swoją aplikację w Microsoft Entra ID. Postępuj zgodnie z 7 kroków poniżej aby utworzyć rejestrację, skonfigurować uprawnienia i połączyć ją z interfejsem API poczty e-mail Outlook w Twojej przestrzeni roboczej Unipile.

1
2
3
4
5
6
7
01

Utwórz konto Microsoft Entra ID

Jeśli jeszcze go nie masz, utwórz bezpłatne Microsoft Entra ID konto (wcześniej Azure Active Directory). Jest to portal administracyjny, w którym rejestrujesz aplikację OAuth, która obsługuje integrację z interfejsem API poczty e-mail Outlook.

02

Zarejestruj nową aplikację w Azure portal

Zaloguj się do portal.azure.com, otwórz Microsoft Entra ID, i kliknij Nowa rejestracja.

  • Nazwij swoją aplikację: ta nazwa pojawia się na ekranie zgody Microsoft OAuth, wyświetlanym Twoim użytkownikom końcowym.
  • Obsługiwane typy kont: wybierz "Konta w dowolnym katalogu organizacji (Dowolny identyfikator Microsoft Entra, wielodostępny) oraz osobiste konta Microsoft", aby móc połączyć zarówno firmowe skrzynki pocztowe Microsoft 365, jak i osobiste skrzynki pocztowe Outlook.
Otwórz Microsoft Entra ID (Azure Active Directory) w portalu Azure
Zarejestruj nową aplikację w Microsoft Entra ID
03

Dodaj identyfikatory URI przekierowania

Otwórz Uwierzytelnianie panel i kliknij Dodaj URI w sekcji Sieć. Dodaj 2 URLe przekierowania za pomocą Twojego DSN Unipile (dostępnego w Unipile Dashboard, prawy górny róg):

https://{{YOUR_DSN}}/api/v1/hosted/microsoft_auth_request_callback
https://{{YOUR_DSN_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
04

Skonfiguruj uprawnienia Microsoft Graph

Idź do Uprawnienia API > Dodaj uprawnienie > Microsoft Graph, następnie dodaj następujące Uprawnienia delegowane dla interfejsu API poczty e-mail programu Outlook:

Mail.Read
Mail.ReadWrite
Mail.Send

Dla funkcji Kalendarza, dodaj również Calendars.ReadWrite, Calendars.Read, Calendars.Read.Shared i Calendars.ReadWrite.Shared, a następnie włącz je w ustawieniach zakresów swojego Panelu Unipile.

Kliknij Dodaj uprawnienie w panelu uprawnień interfejsu API Microsoft Entra ID
Wybierz Microsoft Graph z listy uprawnień interfejsu API
Dodaj wszystkie wymagane Delegowane uprawnienia do interfejsu API poczty e-mail programu Outlook
05

Utwórz tajny klucz klienta

Otwarty Certyfikaty i sekrety, kliknij Nowy klucz tajny klienta. Podaj opis sekretu i ustaw termin jego wygaśnięcia 730 dni (24 miesiące), następnie kliknij "Dodaj".

Ważne: Skopiuj tajną wartość natychmiast. Microsoft wyświetla ją tylko raz i nie będzie można jej później odzyskać z tej strony. Ustaw przypomnienie w kalendarzu przed datą wygaśnięcia, aby uniknąć przestojów interfejsu API poczty e-mail programu Outlook.
Utwórz nowy sekret klienta w Certyfikatach i sekretach
Nazwa tajnego klienta i ustaw datę wygaśnięcia
Skopiuj wartość klucza tajnego klienta, zanim zostanie ukryta
06

Połącz swoją aplikację z panelem Unipile

Otwórz Unipile Dashboard i przejdź do Ustawienia > Microsoft OAuth.

  • Wklej Identyfikator aplikacji (klienta) ze strony Przegląd platformy Azure.
  • Wklej tajna wartość ze strony Certyfikaty i wpisy tajne.
  • Kliknij Zapisz.
Jesteś teraz gotowy do połączenia kont Outlook i Microsoft 365 za pośrednictwem własnej aplikacji. Użytkownicy końcowi zobaczą Twoje branding na ekranie zgody OAuth zamiast domyślnych ustawień Unipile.
Skonfiguruj swoje dane uwierzytelniające Microsoft OAuth w panelu Unipile.
07

Testuj połączenie

Z poziomu pulpitu Unipile uruchom nowe powiązanie konta Microsoft, aby zweryfikować, czy Twoje niestandardowe dane uwierzytelniające OAuth działają kompleksowo. Powinieneś zobaczyć swoje nazwa aplikacji i branding w ramach okna zgody Microsoft zamiast domyślnych Unipile.

Ekran zgody Microsoft OAuth z marką Twojej aplikacji
Opcjonalnie, dla aplikacji produkcyjnych
8
Zostań zweryfikowanym wydawcą
Zalecane do produkcji - usuwa ostrzeżenie "niezweryfikowane" na ekranie zgody

Dzięki weryfikacji wydawcy znaki wyboru pojawiają się w monicie wyrażenia zgody OAuth. Bez niej konta Microsoft 365 firmowe mogą zobaczyć ostrzeżenie o "niezweryfikowanym wydawcy", które szkodzi konwersji rejestracji.

Krok 1: Dołącz do Microsoft Partner Network

Krok 2: zweryfikuj swoją domenę

Utwórz plik o nazwie microsoft-identity-association.json i udostępnij je na:

https://yourdomain.com/.well-known/microsoft-identity-association.json

Krok 3: powiąż swój identyfikator Partner Global Account (PGA)

  • Znajdź swój identyfikator PGA poprzez Centrum partnerskie.
  • W witrynie Azure Portal, przejdź do Rejestracje aplikacji > Twoja aplikacja > Branding i właściwości, wprowadź identyfikator PGA i zapisz.

Po więcej szczegółów, patrz Dokumentacja weryfikacji Microsoft Publisher.

9
Wymagana jest zgoda administratora"
Kiedy użytkownicy końcowi widzą blok zgody od swojego administratora Microsoft 365

Jeśli użytkownik końcowy zobaczy komunikat "Wymagana zgoda administratora" podczas łączenia swojej skrzynki pocztowej Outlook, wymagana zgoda nie została udzielona na poziomie dzierżawy. Dwie ścieżki rozwiązania:

Metoda 1: żądanie zgody administratora w usłudze Microsoft Entra

Administrator Microsoft 365 przegląda i zatwierdza oczekujące żądanie zgody administratora. Zobacz Dokumentacja Microsoft dotycząca przeglądania próśb o zgodę administratora.

Metoda 2: Logowanie OAuth jako administrator z zgodą całego obszaru dzierżawy

  • Administrator rozpoczyna przepływ logowania OAuth z Twojej aplikacji.
  • Podczas autoryzacji firmy Microsoft administrator musi zaznaczyć "Zgoda w imieniu Państwa organizacji".
  • Wyraża to zgodę dla każdego użytkownika w dzierżawie i zapobiega wyświetlaniu monitu o przyszłe połączenie z interfejsem API poczty e-mail programu Outlook.

Szczegółowe informacje w Przewodnik rozwiązywania problemów z zgodą firmy Microsoft.

API Poczty Outlook - Funkcje
Cechy

Zwiększ produktywność dzięki funkcjom interfejsu API wiadomości e-mail programu Outlook

Zwiększ produktywność swoich użytkowników, wykorzystując funkcje interfejsu API wiadomości e-mail programu Outlook, umożliwiając bezproblemowe zarządzanie pocztą e-mail, automatyzację procesów roboczych i synchronizację w czasie rzeczywistym, dzięki czemu mogą oni skupić się na tym, co naprawdę ważne.

Rozpocznij nową wiadomość e-mail
Łatwo inicjuj nowe wiadomości e-mail za pomocą interfejsu API Outlook Email, automatyzując proces tworzenia wiadomości e-mail. Oszczędza czas dzięki usprawnieniu składania wiadomości i redukuje błędy manualne.
POST/api/v1/emails
POST /api/v1/emails
{
  "account_id": "acc_outlook_...",
  "do": [{"identyfikator": "lead@acme.com"}],
  "temat": "Krótkie wprowadzenie",
  "ciało": "Cześć {{first_name}}..."
}
Lista wszystkich wiadomości e-mail
Pobierz wyczerpującą listę wszystkich wiadomości Outlook, umożliwiającą efektywne zarządzanie i śledzenie. Zapewnia przejrzysty wgląd w korespondencję i usprawnia organizację.
Listuj i pobieraj foldery
Dostęp do folderów i etykiet poczty Outlook oraz zarządzanie nimi, poprawiając kategoryzację. Upraszcza organizację wiadomości e-mail w folderach i zwiększa możliwość szybkiego lokalizowania konkretnych wiadomości.
Inbox 248
Elementy wysłane 86
Wersje robocze 4
Elementy usunięte 12
Spam 3
Archiwum 1,2 tys.
Powiadomienia webhook
Skonfiguruj i zarządzaj webhookami, aby otrzymywać powiadomienia e-mail z Outlooka w czasie rzeczywistym. Zapewnia natychmiastowe alerty dotyczące ważnych zdarzeń e-mailowych oraz skraca czas reakcji i działania następcze.
webhook.otrzymany
// Nowe zdarzenie e-mail dostarczone do Twojego punktu końcowego
{
  "zdarzenie": "otrzymana poczta",
  "account_id": "acc_outlook_...",
  "identyfikator_email": "em_8FdK2...",
  "od": "sarah@acme.com",
  "timestamp": "2026-05-18T09:42:11Z"
}

Porównanie Outlooka, Gmaila i IMAP

Przesuń, aby zobaczyć więcej
Cecha
Perspektywy
Gmail
IMAP
Hosted Auth
Autoryzacja niestandardowa
OAuth
Poświadczenia
Wyślij / Odpowiedz na e-mail
Lista wiadomości e-mail
Utwórz szkic wiadomości e-mail
Usuń wiadomość e-mail
Przenieś e-mail
Lista folderów
Pobierz folder
Nowy e-mail
Śledzenie otwarć i kliknięć
Pełna lista funkcji API programu Outlook
Zacznij budować

Zbuduj integrację z Outlook Email API już dziś

Bezpłatny okres próbny w cenie – nie jest wymagana karta kredytowa. Połącz swoje pierwsze konto Outlook w mniej niż 5 minut.

Buduj z Unipile - za darmo
Przykłady kodu

Przykłady kodu API poczty e-mail programu Outlook: Node.js, Python i cURL

Poniższe przykłady wywołują ujednolicony punkt końcowy API poczty e-mail Outlook firmy Unipile. Jeden klucz API, jeden podstawowy adres URL – działa dla Outlooka, Gmaila i IMAP bez konieczności zmiany kodu. Zamień TWÓJ_DSN oraz TWOJE_KLUCZE_API z wartościami z Twojego Panelu Unipile.

Node.js
Python
cURL
read-outlook-emails.js
// Odczytaj wiadomości e-mail z połączonego konta Outlook za pomocą interfejsu API poczty programu Outlook firmy Unipile const axios = require('axios'); const DSN = 'api1.unipile.com:13211'; const Klucz API = 'TWÓJ_KLUCZ_API'; const ACC_ID = 'IDENTYFIKATOR_KONTA_OUTLOOK'; // z POST /accounts po OAuth async function WyszukajEmaileOutlook() { const res = czekać axios.uzyskać( `https://\${DSN}/api/v1/emails`, { nagłówki: { 'Klucz API X': KLUCZ_API, 'id_konta': ID_AKTÚ } } ); konsola.log(res.data.elementy); // tablica wiadomości Outlook } // Wyślij e-mail za pomocą interfejsu API poczty e-mail programu Outlook async function wyślijEmailOutlook() { czekać axios.stanowisko( `https://\${DSN}/api/v1/emails`, { account_id: ACC_ID, do: [{ display_name: 'Alicja', identyfikator: 'alice@contoso.com' }], podmiot: 'Witaj z API do wiadomości e-mail Outlook', ciało: '

Wysłano za pośrednictwem interfejsu API Unipile Outlook Email.

'
}, { nagłówki: { 'Klucz API X': KLUCZ_API } } ); }
200 OK - pobrano wiadomości e-mail z połączonego konta Outlook
read_outlook_emails.py
# Odbieranie i wysyłanie wiadomości e-mail za pośrednictwem interfejsu API poczty e-mail Unipile Outlook import żądania DSN = "api1.unipile.com:13211" Klucz API = "YOUR_API_KEY" ACC_ID = "OUTLOOK_ACCOUNT_ID" NAGŁÓWKI = { "X-API-KEY": KLUCZ_API, "account_id": ACC_ID, } # – Lista wiadomości e-mail z programu Outlook def list_emails(): r = żądania.uzyskać( https://{DSN}/api/v1/emails", nagłówki=NAGŁÓWKI ) r.podnieś_status() return r.json()["przedmioty"] # Wysyłanie za pośrednictwem interfejsu API poczty e-mail programu Outlook def wyślij_e-mail(to_addr, temat, treść): r = żądania.stanowisko( https://{DSN}/api/v1/emails", nagłówki={"X-API-KEY": KLucy_API_KEY}, json={ "account_id": ACC_ID, "do": [{"identyfikator": adres_docelowy}], "temat"temat, "ciało"ciało } ) r.podnieś_status() return r.json()
200 OK - wiadomości Outlook zwrócone jako lista JSON
outlook-email-api.sh
# Wyświetl listę adresów e-mail z połączonego konta Outlook zwijać się -s -X GET \ "https://api1.unipile.com:13211/api/v1/emails" \ -H "X-API-KEY: TWÓJ_KLUCZ_API" \ -H "identyfikator_konta: IDENTYFIKATOR_KONTA_OUTLOOK" \ | jq '.items[] | {id, subject, from, date}' # Wysyłanie wiadomości e-mail za pośrednictwem interfejsu API poczty e-mail programu Outlook zwijać się -s -X POST \ "https://api1.unipile.com:13211/api/v1/emails" \ -H "X-API-KEY: TWÓJ_KLUCZ_API" \ -H "Typ-Zawartości: application/json" \ -d '{ "account_id": "ID_KONTA_OUTLOOK", "do": [{"identyfikator": "alice@contoso.com"}], "Temat: Witam z interfejsu API poczty Outlook, "ciało"

Wysłano przez Unipile.

"
}'
201 Utworzono - e-mail wysłany przez Outlook
Ten sam kod dla wszystkich dostawców: Interfejs API poczty e-mail Unipile Outlook wykorzystuje dokładnie ten sam punkt końcowy i strukturę ładunku co Gmail i IMAP. Twoja integracja działa ze wszystkimi 3 dostawcami bez zmian w kodzie. Zobacz Przewodnik po API poczty elektronicznej aby uzyskać pełne odniesienie do punktu końcowego.
Unipile - Outlook Graph a Unipile
Tworzenie czy kupowanie

Natywny Microsoft Graph vs Zunifikowane API poczty Outlook (Unipile)

Odkryj jasne korzyści płynące z wykorzystania uproszczonej integracji API Outlook Email firmy Unipile w porównaniu z budowaniem bezpośrednio na Microsoft Graph. Użyj Hosted Auth, aby wzmocnić bezpieczeństwo poprzez udoskonalone zarządzanie danymi uwierzytelniającymi, zapewnić płynną integrację z programem Outlook i innymi platformami poczty e-mail oraz zmniejszyć narzut związany z utrzymaniem przepływów OAuth.

Wymiar Natywny interfejs API Microsoft Graph Unipile API poczty e-mail Outlook
Zakres integracji Tylko Outlook / Exchange Online Outlook + Gmail + IMAP, ten sam kod
Konfiguracja przepływu OAuth Rejestracja aplikacji Azure + zarządzanie tokenami na najemcę Jeden link Hosted Auth, strona OAuth white-label, zero tokenów kodu
Odświeżanie tokena Twój kod musi odświeżać się co 60 minut (czas życia tokena dostępowego) Unipile automatycznie odświeża wszystkie połączone konta
Odnowienie webhooka Subskrypcje wygasają po 4230 minutach, musisz odnowić przed wygaśnięciem Unipile automatycznie odnawia subskrypcje Graph
Obsługa ograniczania przepustowości Trzeba ręcznie zaimplementować logikę ponawiania prób dla błędów 429 i wykładnicze wycofywanie. Wbudowane zarządzanie ponawianiem prób i limitami żądań
Czas do pierwszego e-maila 2-5 dni (konfiguracja Azure + OAuth + logika tokenów + obsługa błędów) Mniej niż 2 godziny (postępuj zgodnie z tym przewodnikiem)
Wycofanie usługi Exchange Online Trzeba przeprowadzić migrację z EWS do Graph przed terminem w październiku 2026 r. Unipile już korzysta z Graph, migracja jest przejrzysta
Wsparcie Dokumentacja Microsoft + fora Na żywo wsparcie techniczne + rozmowa z założycielem na życzenie
Natywny Microsoft Graph
Podręcznik
1 Zarejestruj aplikację w Azure portal
2 Skonfiguruj zakresy OAuth i adres URI przekierowania
3 Przepływ OAuth + przechowywanie tokenów na dzierżawcę
4 Zaimplementuj odświeżanie tokenu co 60 minut
5 Obsłuż throttling (ograniczenie) 429 i wycofanie (backoff).
6 Odnowić subskrypcje webhooków przed wygaśnięciem
Interfejs API Unipile Outlook
Zautomatyzowany
1 Wygeneruj link do uwierzytelniania hostowanego
2 Użytkownik łączy Outlook jednym kliknięciem
3 Odbieraj e-maile za pośrednictwem zunifikowanego webhooka
Tokeny odświeżane automatycznie
Wbudowana obsługa ponawiania prób i limitów zapytań
Webhooki odnowione automatycznie

Uwierzytelnianie za pomocą jednego linku w porównaniu do pełnego przepływu OAuth

Hostowane uwierzytelnianie Unipile automatyzuje wykrywanie dostawców poczty e-mail i obsługuje uwierzytelnianie. Znacząco obniża to złożoność początkowej konfiguracji, przyspieszając harmonogramy rozwoju i redukując koszty utrzymania. Przewodnik po interfejsie API OAuth Email

Konsekwentne aktualizacje i konserwacja

Zachowaj przewagę dzięki regularnym aktualizacjom i starannemu serwisowaniu. Unipile Outlook Email API jest stale ulepszane, aby śledzić zmiany w Microsoft Graph i zapewniać najwyższą wydajność, dzięki czemu Twoja integracja działa nawet wtedy, gdy Microsoft aktualizuje swoje API. Przewodnik po integracji z MS Graph

Nasz zespół wsparcia przeprowadzi Cię przez każdy etap integracji Outlook Email API, od rozpoczęcia po wdrożeniu, bez dodatkowych kosztów. API e-mail dla programistów

Uważaj

Typowe pułapki podczas tworzenia aplikacji z wykorzystaniem API do obsługi poczty e-mail programu Outlook

API Microsoft Outlook jest potężne, ale ma kilka nieoczywistych ograniczeń, które mogą zepsuć Twoją integrację w środowisku produkcyjnym. Oto 6 najczęstszych pułapek – i jak ich unikać.

1
Ważność tokena dostępu (60 minut)
Tokeny dostępu do Microsoft Graph wygasają dokładnie po 1 godzinie. Jeśli Twoja aplikacja buforuje token i go nie odświeża, wywołania API zaczną zwracać błędy 401 w środowisku produkcyjnym – często dopiero po pierwszej rzeczywistej sesji użytkownika.
Napraw Zawsze używaj tokenu odświeżania z zakresem offline_access. Sprawdzaj wygaśnięcie tokenu przed każdym wywołaniem i odświeżaj proaktywnie. Z Unipile odświeżanie tokenu jest obsługiwane automatycznie dla wszystkich połączonych kont.
2
Wygaśnięcie subskrypcji webhooka (4230 minut)
Subskrypcje Microsoft Graph dla zdarzeń poczty e-mail Outlook mają maksymalny czas życia wynoszący 4230 minut (około 70,5 godziny). Po tym czasie nie są już dostarczane nowe webhooki dotyczące wiadomości e-mail i nie otrzymasz błędu — zdarzenia po prostu cicho przestają napływać.
Napraw Zaimplementuj zadanie odnowienia subskrypcji, które będzie uruchamiane co 48 godzin. Wywołaj punkt końcowy PATCH /subscriptions z nową datą wygaśnięcia expirationDateTime przed wygaśnięciem bieżącej.
3
Dławienie (błędy 429 pod obciążeniem)
Microsoft Graph wymusza limity ograniczania żądań na aplikację - około 10 000 żądań na 10 minut na najemcę. Aplikacje wieloużytkownikowe, które rozsyłają żądania podczas szczytowego obciążenia, będą bez ostrzeżenia napotykać błędy 429 Too Many Requests.
Napraw Wprowadź algorytm wykładniczego opóźniania z jitterem przy każdym wywołaniu API. Przestrzegaj wartości nagłówka Retry-After w odpowiedziach 429. Rozważ grupowanie żądań przy użyciu punktu końcowego $batch w Graph.
4
Przepływ zgody administratora dla tenantów przedsiębiorstwa
W środowiskach Microsoft 365 firmy często wymagają zgody administratora dzierżawy, zanim jakikolwiek użytkownik w organizacji będzie mógł udzielić Twojej aplikacji uprawnień. Jeśli testujesz tylko z osobistymi kontami Outlook, ten problem nie ujawni się, dopóki nie dotrzesz do klientów korporacyjnych.
Napraw Zaimplementuj przepływ zgody administratora (endpoint `/adminconsent`) i wyświetlaj jasny komunikat o błędzie użytkownikom, którzy napotkają błędy zgody. Udokumentuj adres URL zgody administratora w swoim przepływie onboardingu. Przewodnik po MS Graph OAuth
5
Przejście na emeryturę usług sieciowych programu Exchange (EWS)
Microsoft wycofuje Exchange Web Services (EWS) dla Exchange Online w październiku 2026 r. Wszelkie integracje nadal korzystające z EWS (powszechne starsze podejście) przestaną działać. Dotyczy to również migracji lokalnych serwerów Exchange do Exchange Online.
Napraw Jeśli Twoja integracja lub jakiekolwiek zależności korzystają z EWS, przejdź na Microsoft Graph przed październikiem 2026 r. Interfejs API poczty e-mail programu Outlook firmy Unipile już w pełni korzysta z programu Graph — nie są wymagane żadne działania z Twojej strony.
6
Zakończenie obsługi uwierzytelniania podstawowego
Microsoft całkowicie wycofał uwierzytelnianie Basic dla Exchange Online dla wszystkich protokołów (SMTP, IMAP, POP). Dowolny kod używający nazwy użytkownika/hasła do bezpośredniego uwierzytelniania w Outlook zakończy się niepowodzeniem. Powoduje to zazwyczaj problemy z implementacjami starszego synchronizowania poczty e-mail.
Napraw Migrować do OAuth 2.0 (przepływ poświadczeń klienta lub przepływ delegowanego uprawnienia). Używaj niestandardowego uwierzytelniania Unipile tylko dla serwerów IMAP, które nadal je obsługują – integracja z interfejsem API poczty e-mail Outlook musi zawsze używać OAuth. Przewodnik po interfejsie API OAuth Email
Termin przejścia na emeryturę z EWS: październik 2026

W październiku 2026 roku usług Exchange Web Services dla Exchange Online przestaną działać. Jeśli Twoja integracja z interfejsem API poczty e-mail Outlook korzysta bezpośrednio lub za pośrednictwem biblioteki z EWS, zaplanuj teraz migrację do Microsoft Graph. Zobacz Przewodnik po Microsoft Graph API ścieżki migracji.

Bezpieczeństwo i zgodność

Bezpieczeństwo i zgodność dla integracji z interfejsem API poczty e-mail programu Outlook

Zapewnij bezpieczeństwo swoich danych dzięki zaawansowanym protokołom bezpieczeństwa. Unipile Outlook Email API gwarantuje, że Twoje wiadomości e-mail i wrażliwe informacje pozostaną chronione – dzięki certyfikatowi SOC 2 Type II i pełnej zgodności z RODO.

Certyfikat SOC 2 typu II
Zgodność z RODO
Tylko OAuth 2.0
Brak przechowywania poświadczeń
Obsługa danych
Brak równoległego przechowywania wiadomości e-mail
Unipile działa jako uwierzytelniony pośrednik w imieniu każdego użytkownika. Dane poczty e-mail nie są przechowywane w równoległej bazie danych ani archiwum. Zakres jest ograniczony do uwierzytelnionej sesji każdego połączonego konta.
Jak Działa Unipile
Niezależny pośrednik techniczny
Unipile jest niezależnym pośrednikiem technicznym działającym w imieniu każdego uwierzytelnionego użytkownika. Nie jest partnerem firmy Microsoft. Poświadczenia nigdy nie są udostępniane między kontami.
Limity platformy
Odpowiedzialne korzystanie z API Outlook
Limity dotyczące szybkości zapytań i ich ograniczanie w Microsoft Graph są przekazywane w sposób przejrzysty. Częstotliwość i liczba wywołań API pozostają decyzją po stronie klienta. Unipile ujawnia limity, ale nie zastępuje zasad egzekwowania ich przez Microsoft.
Zbuduj bezpieczną integrację z API poczty Outlook
Unipile - API poczty e-mail Outlook FAQ
FAQ

Często zadawane pytania

Odpowiedzi na najczęściej zadawane pytania dotyczące integracji API programu Outlook, API firmy Microsoft Outlook i API programu Outlook 365 z Unipile.

01
Czym jest interfejs API poczty e-mail Outlook i jak działa?
The API Poczty Outlook jest RESTful API, które zapewnia programistyczny dostęp do danych e-mail programu Outlook. Jest zbudowany na Microsoft Graph, zunifikowanej bramie API dla Microsoft 365. Kiedy wywołujesz Outlook Email API, Twoje żądanie trafia do graph.microsoft.com/v1.0/ja/wiadomości, uwierzytelniony za pomocą tokenu nośnego Azure AD OAuth 2.0. Unipile opakowuje to w prosty, niezależny od dostawcy interfejs, który działa również dla Gmaila i IMAP.
02
Jaka jest różnica między interfejsem API Outlook 365 a interfejsem API Outlook Web?
The API programu Outlook 365 zazwyczaj odnosi się do dostępu do skrzynek pocztowych Microsoft 365 Business lub Enterprise za pośrednictwem Microsoft Graph. "Outlook Web API" to starsze określenie interfejsu API REST, które firma Microsoft wycofała i zastąpiła Microsoft Graph. Obecnie każda nowoczesna integracja interfejsu API poczty e-mail Outlook powinna korzystać z Microsoft Graph. Zarówno osobiste konta Outlook, jak i konta Microsoft 365 Business są dostępne za pośrednictwem tego samego punktu końcowego.
03
Jakie są różnice między interfejsem API Microsoft Outlook a Exchange Web Services (EWS)?
Exchange Web Services (EWS) jest przestarzałym interfejsem API opartym na SOAP, który Microsoft wycofuje dla Exchange Online w październiku 2026 roku. Nowoczesny interfejs API Microsoft Outlook wykorzystuje zamiast tego Microsoft Graph (REST/JSON). Jeśli tworzysz nową integrację lub migrujesz starą, użyj Microsoft Graph za pośrednictwem interfejsu API poczty e-mail Outlook. EWS przestanie działać dla Exchange Online po dacie wycofania. Zobacz nasze Przewodnik po Microsoft Graph API ścieżki migracji.
04
Jak uwierzytelnić użytkowników w interfejsie API poczty e-mail Outlook?
Uwierzytelnianie dla interfejsu API poczty programu Outlook wykorzystuje OAuth 2.0 z Azure AD. musisz: (1) utworzyć rejestrację aplikacji Azure, (2) dodać Mail.ReadWrite, Mail.Send oraz Mail.Read uprawnienia delegowane, (3) zaimplementuj przepływ kodu autoryzacyjnego, aby uzyskać token dostępu. Z Unipile omijasz to wszystko. Użyj Hosted Auth, aby wygenerować dla swoich użytkowników stronę OAuth z jednym linkiem. Zobacz pełny Przewodnik po interfejsie API OAuth Email i Przewodnik OAuth po Microsoft Graph.
05
Czy mogę używać API programu Outlook do odczytywania wiadomości e-mail, a nie tylko ich wysyłania?
Tak. Interfejs API poczty e-mail programu Outlook obsługuje oba. czytanie i wysyłanie e-maile, a także ich organizowanie. Operacje obejmują: wypisz wszystkie wiadomości, pobierz konkretną wiadomość, wyślij nową wiadomość, odpowiedz, przekaż dalej, usuń, przenieś do folderu, oznacz jako przeczytane i wypisz zawartość folderu. Zobacz Przeczytaj przewodnik po API poczty e-mail oraz Przewodnik po API do wysyłania wiadomości e-mail dla specyficznej dokumentacji punktu końcowego.
06
Czy interfejs API poczty programu Outlook działa zarówno dla osobistych kont programu Outlook, jak i dla Microsoft 365 Business?
Tak. Microsoft Graph obsługuje oba Osobiste konta Microsoft (outlook.com, hotmail.com, live.com) oraz Konta Microsoft 365 dla firm (Exchange Online). Punkt końcowy interfejsu API poczty programu Outlook jest taki sam dla obu. Musisz ustawić odbiorców rejestracji aplikacji platformy Azure na "Konta w dowolnym katalogu organizacji i osobiste konta Microsoft", aby obsługiwać oba typy.
07
Dlaczego warto zintegrować API wiadomości e-mail Outlook z moją aplikacją?
Integracja interfejsu API poczty e-mail programu Outlook usprawnia zarządzanie pocztą e-mail, umożliwia automatyzację przepływu pracy i usprawnia Twój produkt dzięki dostępowi do skrzynki odbiorczej w czasie rzeczywistym. Kluczowe korzyści: automatyzacja rutynowych zadań związanych z pocztą e-mail, tworzenie funkcji opartych na poczcie e-mail bez przełączania aplikacji i synchronizacja danych programu Outlook bezpośrednio z platformą CRM, ATS lub platformami outreach. Interfejs API programu Outlook przyspiesza przepływ pracy dzięki zmniejszeniu nakładu pracy ręcznej i zwiększa wskaźnik dostarczalności dzięki wykorzystaniu infrastruktury firmy Microsoft. Zobacz pełną Przewodnik po API poczty elektronicznej dla pełnego obrazu.
08
Czy mogę zintegrować Gmail i IMAP wraz z programem Outlook z aplikacją Unipile?
Tak. Oprócz interfejsu API poczty e-mail Outlook, Unipile obsługuje Gmail i IMAP, trzech głównych dostawców poczty e-mail. Ten sam punkt końcowy API i struktura ładunku działają dla wszystkich trzech dostawców. Twoja integracja działa z Outlookiem, Gmailem i IMAP bez zmian w kodzie. Zobacz Przewodnik po Gmail API oraz Przewodnik po interfejsie API IMAP.
09
Czy jest darmowy poziom do testowania Outlook Email API z Unipile?
Tak. Unipile oferuje bezpłatny okres próbny które pozwala na powiązanie kont Outlook i wykonywanie wywołań API poczty e-mail Outlook bez karty kredytowej. Zobacz Przewodnik po bezpłatnym API e-mail dla limitów próbnych i kroków inicjujących, lub zarejestruj się bezpośrednio w panelu.
Masz jeszcze jakieś pytania? Nasz zespół pomoże Ci zintegrować interfejs API poczty e-mail Outlook z Twoim produktem.
Porozmawiaj z ekspertem

Możesz także polubić

Pobieranie wiadomości e-mail za pomocą interfejsu API Unipile

Pobieranie wiadomości e-mail za pomocą interfejsu API Unipile

Zarządzanie i programowe pobieranie wiadomości e-mail jest kluczową umiejętnością. Niezależnie od tego, czy chodzi o automatyzację biznesu, obsługę klienta czy cele marketingowe, zrozumienie, jak używać interfejsu API poczty e-mail do pobierania wiadomości e-mail, może usprawnić operacje i poprawić wydajność. Ten przewodnik przeprowadzi Cię przez podstawowe...

czytaj dalej
Weryfikacja Google OAuth i poświadczenia interfejsu API Gmail (2026)

Weryfikacja Google OAuth i poświadczenia interfejsu API Gmail (2026)

Ostrzeżenie o niezweryfikowanej aplikacji w Gmail API Ostrzeżenie "Ta aplikacja nie została zweryfikowana", limit 100 użytkowników i zwolnienia Zanim Twoja aplikacja przejdzie weryfikację aplikacji Google OAuth, każdy użytkownik, który spróbuje ją autoryzować, zobaczy ekran ostrzeżenia. Google narzuca również ścisły limit 100 użytkowników na niezweryfikowane aplikacje zewnętrzne. Oto...

czytaj dalej
pl_PLPL