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.
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 IMAPCzym 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.
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.
Interfejs API Microsoft Outlook dla Twojego rozwiązania CRM
Synchronizuj rozmowy z programu Outlook z procesami sprzedaży i danymi klientów
Synchronizuj E-maile Outlook z systemami śledzenia kandydatów
Microsoft Graph API dla platform rekrutacyjnych i oprogramowania HR
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.
Konfiguracja Microsoft OAuth dla API poczty e-mail Outlook
Dokumentacja Microsoft OAuthDomyś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.
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.
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.


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_less_port}}/api/v1/hosted/microsoft_auth_request_callback/port{{YOUR_PORT}}
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:
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.



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".



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.

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.

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
- Zapisz się na partner.microsoft.com i wybierz Microsoft AI Cloud Partner Program.
- Jeśli potrzebujesz konta służbowego, utwórz nowego najemcę pierwszy.
Krok 2: zweryfikuj swoją domenę
Utwórz plik o nazwie microsoft-identity-association.json i udostępnij je na:
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.
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.
POST /api/v1/emails { "account_id": "acc_outlook_...", "do": [{"identyfikator": "lead@acme.com"}], "temat": "Krótkie wprowadzenie", "ciało": "Cześć {{first_name}}..." }
// 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
| Cecha |
|
|
|
|---|---|---|---|
| Połączenie z kontem | |||
| Hosted Auth | |||
| Autoryzacja niestandardowa | |||
| OAuth | |||
| Poświadczenia | |||
| Wysyłaj / Odbieraj | |||
| Wyślij / Odpowiedz na e-mail | |||
| Lista wiadomości e-mail | |||
| Utwórz szkic wiadomości e-mail | |||
| Organizacja | |||
| Usuń wiadomość e-mail | |||
| Przenieś e-mail | |||
| Lista folderów | |||
| Pobierz folder | |||
| Webhooks | |||
| Nowy e-mail | |||
| Śledzenie otwarć i kliknięć | |||
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.
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.
// 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 } }
);
}# 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()# 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.
"
}'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 |
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
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ć.
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.
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.
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.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.Możesz także polubić
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...
Jak uzyskać interfejs API poczty e-mail dla swojego oprogramowania
Poznaj zalety integracji interfejsu API, ponieważ stanowi on bramę do odblokowania wielu korzyści w płynnym włączaniu wielu usług poczty e-mail do aplikacji. Co to jest API poczty e-mail? API poczty e-mail (interfejs programowania aplikacji) to usługa, która umożliwia programistom integrację...
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...


