Kompletny przewodnik po API Unipile: LinkedIn, Instagram, WhatsApp, Email i agenci AI

Przewodnik po API Unipile

Jedno API do tworzenia na LinkedIn, Instagram, WhatsApp, Email i Twój Agent AI

Unipile zapewnia Twojej aplikacji lub agentowi AI jedno zintegrowane rozwiązanie do obsługi wiadomości, postów i komentarzy, poczty e-mail oraz kalendarza na platformach LinkedIn, Instagram, WhatsApp, Telegram, Gmail, Outlook, IMAP, Kalendarz Google i Kalendarz Outlook. Jeden model danych, jeden zestaw punktów końcowych, brak konieczności utrzymywania SDK dla poszczególnych dostawców.

Płać w miarę zużycia, od 49 €/miesiąc, wszystkie funkcje w każdej taryfie
reply.js
Odpowiedz do dowolnego połączonego konta, dowolnego dostawcy const forma = nowy DaneFormularza();forma.dołączyć('tekst', 'Zajmę się tym, dzięki!');czekać fetch(`https://${DSN}/api/v1/chats/${chatId}/messages`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU , ciało: forma});
200 OK: wiadomość wysłana
Te same punkty końcowe, każdy dostawca LinkedIn Instagram WhatsApp Telegram Gmail Perspektywy IMAP
Zbudowany dla
Samozatrudnieni i niezależni twórcy Kreatorzy SaaS Edytory oprogramowania z dużą bazą użytkowników Kreatory agentów AI Dostawcy systemów CRM i ATS Agencje no-code i studia automatyzacji
Powierzchnia Produktu

Co faktycznie można zbudować z Unipile

Unipile nie jest widżetem do przesyłania wiadomości przyczepionym do jednego kanału. Jest to pełnoprawne API obejmujące trzy kategorie produktów, z których każda jest powiązana z rzeczywistymi integracjami dostawców: łączenie konta, wysyłanie wiadomości, publikowanie postu, odpowiadanie na komentarz, synchronizowanie skrzynki odbiorczej lub rezerwowanie spotkania. Oto pełny obraz.

Kalendarz
Kalendarz GoogleKalendarz Google Kalendarz programu OutlookKalendarz programu Outlook
Połączenie z kontem3 punkty końcowe
Funkcje kalendarza9 punktów końcowych
Okładki
Lista kalendarzyUtwórz wydarzeniaZaktualizuj / anulujUczestnicy

LinkedIn to najgłębsza powierzchnia w API

34 funkcje specyficzne dla LinkedIn w 6 kategoriach, oprócz podstawowej warstwy wiadomości powyżej: outreach, treści, profile, rekrutacja i wyszukiwanie.

Zasięg11 cech
Wysyłanie wiadomości InMails Pobierz saldo InMail Stwórz sekwencje outreach Zaproś użytkowników Lista oczekujących zaproszeń Usuń oczekujące zaproszenia Wykryj zaakceptowane zaproszenia Obserwuj użytkowników Wyświetl zaproszenia przychodzące Akceptuj / odrzuć zaproszenia Potwierdź umiejętności
Posty i komentarze7 cech
Lista postów użytkownika i firmy Twórz posty Pobierz posty Wysłać uwagi Wyświetl komentarze Dodaj reakcje Lista reakcji
Profile4 cechy
Odwiedź i pobierz profile Lista kontaktów i relacji Uzyskiwanie dostępu do profili firm Zobacz odwiedziny swojego profilu
Ogłoszenie o pracę4 cechy
Twórz i publikuj oferty pracy Lista stanowisk Pobierz kandydatów Pobierz CV kandydatów
Skrzynki odbiorcze4 typy
Klasyczna skrzynka odbiorcza Skrzynka odbiorcza Sales Navigator Rekruter / Rekruter Lite Skrzynka odbiorcza firmowa
Wyszukiwanie4 celowniki
Osoby (Klasyczna / Rekruter / Sales Nav) Firmy (Klasyczne / Sales Nav) Wyszukiwanie postów Szukanie pracy

To tylko część tego, co udostępnia API. Zobacz pełną, aktualną listę funkcji w podziale na dostawców w dokumentacji deweloperskiej.

Zobacz pełną listę funkcji
Kliknij, aby rozwinąć

11 Rzeczy, które deweloperzy faktycznie budują z Unipile

Kliknij dowolny przypadek użycia, aby zobaczyć rzeczywiste punkty końcowe i działający fragment kodu. Są to wzorce zaczerpnięte bezpośrednio z tego, jak klienci Unipile korzystają z API dzisiaj, a nie przykłady teoretyczne.

Potencjalny klient odpowiada na Twoją wiadomość na LinkedIn. Unipile wysyła nową wiadomość do Twojego webhooka w czasie rzeczywistym, wyświetlasz ją we własnym interfejsie skrzynki odbiorczej, a Twój przedstawiciel odpowiada, nawet nie otwierając LinkedIn.

Używane punkty końcowe
GET/api/v1/czaty/{chat_id}/wiadomości POST/api/v1/czaty/{chat_id}/wiadomości
reply.js
// Odpowiedz w istniejącej rozmowie na LinkedIn const formularz nowy DaneFormularza(); forma.dołączyć('tekst', 'Dziękuję za odpowiedź!');czekać fetch(`https://${DSN}/api/v1/chats/${chatId}/messages`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU }, body: formularz // multipart/form-data, nie potrzeba nagłówka JSON});

Przedstawiciel handlowy znajduje dopasowanego potencjalnego klienta za pomocą wyszukiwania w LinkedIn i wysyła prośbę o połączenie bezpośrednio z Twojej aplikacji, z krótką spersonalizowaną notatką zamiast pustego zaproszenia. Unipile zwraca identyfikator zaproszenia (invitation_id), który można sprawdzić na liście oczekujących zaproszeń, lub przechwycić moment, w którym przekształci się ono w zaakceptowane połączenie za pomocą webhooka.

Używane punkty końcowe
POST/api/v1/users/invite GET/api/v1/users/invite/sent
zaproszenie.js
// Wyślij spersonalizowane zaproszenie do nawiązania kontaktu na LinkedIn const zaproszenie czekać fetch(`https://${DSN}/api/v1/users/invite`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ account_id: accountId, provider_id: prospectProviderId, wiadomosc: 'Podobała mi się Twoja prezentacja na temat outbound, chętnie się połączę.'}) }).wtedy(r => r.json());// invite.invitation_id: ankieta GET /users/invite/sent, lub słuchaj webhooka "new_relation"

Przekieruj wiadomości prywatne z Instagrama z połączonego konta firmowego bezpośrednio do swojego narzędzia wsparcia lub systemu CRM. Agenci czytają i odpowiadają z własnego interfejsu, Unipile utrzymuje obie strony rozmowy w synchronizacji.

Używane punkty końcowe
GET/api/v1/chats POST/api/v1/czaty/{chat_id}/wiadomości
inbox.js
// Wyświetl rozmowy na Instagramie dla połączonego konta const res = czekać fetch(`https://${DSN}/api/v1/chats?account_id=${igAccountId}`, , nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU } });const { elementy: rozmowy } = czekać rez.json();// konwersacje są teraz renderowane bezpośrednio w skrzynce odbiorczej CRM

Pobieraj komentarze pod swoimi postami na Instagramie, odpowiadaj publicznie z pulpitu i reaguj, dzięki czemu Twój zespół ds. mediów społecznościowych nigdy nie musi przełączać się do aplikacji Instagram, aby zarządzać zaangażowaniem.

Używane punkty końcowe
GET/api/v1/posts/{post_id}/comments POST/api/v1/posts/{post_id}/comments
komentarze.js
// Pobierz komentarze do posta, a następnie opublikuj odpowiedź const komentarze = czekać fetch(`https://${DSN}/api/v1/posts/${postId}/comments`, , nagłówki: { 'Klucz API X': ACCESS_TOKEN } }).wtedy(r => r.json());czekać fetch(`https://${DSN}/api/v1/posts/${postId}/comments`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ tekst: 'Dzięki! Wysyłam Ci wiadomość prywatną.' }); });

Uruchom wyszukiwanie osób w LinkedIn z tymi samymi filtrami, których używa już Twój zespół, a następnie pobierz wyniki bezpośrednio do swojego CRM lub sekwencji kontaktów, jedno połączone konto, bez ręcznego eksportu.

Używane punkty końcowe
POST/api/v1/linkedin/search
search.js
// Uruchom wyszukiwanie osób na LinkedIn const wyniki = czekać fetch(`https://${DSN}/api/v1/linkedin/search`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ account_id: accountId, kategoria: 'ludzie', słowa kluczowe: 'Dyrektor ds. Sprzedaży, Paryż' }) }).wtedy(r => r.json());

Zaplanuj post z własnego kalendarza treści, pobierz wygenerowane przez niego komentarze i zareaguj na zaangażowanie, a wszystko to bez konieczności logowania się człowieka do LinkedIn w celu publikacji.

Używane punkty końcowe
POST/api/v1/posty GET/api/v1/posty/{id}
publikuj.js
// Opublikuj post na LinkedIn w imieniu połączonego konta czekać fetch(`https://${DSN}/api/v1/posts`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ account_id: accountId, tekst: 'Właśnie wysłaliśmy...' }); });

Twoje połączenie się kończy, a aplikacja wysyła wiadomość na WhatsApp z podsumowaniem i kolejnymi krokami, wysłaną z tego samego numeru, którego Twój zespół już używa do rozmów z tym kontaktem.

Używane punkty końcowe
POST/api/v1/chats
followup.js
Rozpocznij nową konwersację na WhatsApp z podsumowaniem const formularz nowy DaneFormularza(); forma.dołączyć('id_konta', whatsappAccountId); formularz.dołączyć('tekst', 'Świetnie się dziś rozmawialiśmy, oto podsumowanie...'; formularz.dołączyć('attendees_ids', numerTelefonuKontaktu)czekać fetch(`https://${DSN}/api/v1/chats`, metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU }, body: form });

Połącz konto Telegram i traktuj je jak każdą inną skrzynkę odbiorczą: wyświetlaj czaty, otrzymuj nowe wiadomości natychmiastowo przez webhook i odpowiadaj z własnego narzędzia.

Używane punkty końcowe
GET/api/v1/chats POST/api/v1/czaty/{chat_id}/wiadomości
telegram.js
// Lista czatów Telegram dla połączonego konta const czaty = czekać fetch(`https://${DSN}/api/v1/chats?account_id=${tgAccountId}`, , nagłówki: { 'Klucz API X': ACCESS_TOKEN } }).wtedy(r => r.json());

Zintegruj skrzynkę pocztową w swoim produkcie z nienaruszonymi wątkami, niezależnie od tego, z którym z 3 dostawców połączy się Twój użytkownik: Gmail, Outlook lub IMAP. Jeden model danych, bez oddzielnej logiki Gmail vs Outlook w Twojej aplikacji.

Używane punkty końcowe
GET/api/v1/wiadomości POST/api/v1/wiadomości
inbox-sync.js
// Pobierz najnowsze e-maile dla połączonej skrzynki pocztowej, pogrupowane wątkami const skrzynka odbiorcza = czekać fetch(`https://${DSN}/api/v1/mails?account_id=${mailboxId}`, , nagłówki: { 'Klucz API X': ACCESS_TOKEN } }).wtedy(r => r.json());// Ten sam kształt, niezależnie od tego, czy mailboxId wskazuje na Gmail, Outlook czy IMAP

Gdy potencjalny klient zgodzi się na rozmowę w wątku na LinkedIn lub mailu, sprawdź dostępność i utwórz wydarzenie w jego kalendarzu Google lub Outlook, nie opuszczając swojej aplikacji.

Używane punkty końcowe
GET/api/v1/kalendarze/{id}/wydarzenia POST/api/v1/kalendarze/{id}/wydarzenia
książka.js
Utwórz wydarzenie w kalendarzu po potwierdzeniu spotkania czekać fetch(`https://${DSN}/api/v1/calendars/${calendarId}/events`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ tytuł: 'Rozmowa wprowadzająca', start_time: startISO, end_time: endISO, attendees: [email] }) });

Zamiast odpytywania, zasubskrybuj raz i otrzymuj webhook w momencie pojawienia się nowej wiadomości, nowego e-maila lub zmiany statusu konta we wszystkich połączonych dostawcach.

Używane punkty końcowe
POST/api/v1/webhooks
webhook.js
// Subskrybuj zdarzenia nowych wiadomości na wszystkich połączonych kontach czekać fetch(`https://${DSN}/api/v1/webhooks`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ źródło: 'wiadomości', wydarzenie: 'wiadomość_odebrana', url_żądania: 'https://yourapp.com/webhooks/unipile' }); });

To tylko 11 wzorów. Te same punkty końcowe łączą się w cokolwiek, co Twoja aplikacja lub agent AI potrzebuje zrobić.

Zacznij Tworzyć Własny Przypadek Użycia
Szybki start

Twoje pierwsze wywołanie API w trzech krokach

Pobierz swoje dane uwierzytelniające, połącz konto użytkownika, wyślij pierwszą wiadomość. Oto dokładny sposób wraz z uzasadnieniem każdej akcji, a nie tylko kodu.

01

Uzyskaj swój DSN i Token Dostępu

Zapisz się na dashboard.unipile.com/rejestracja. Twoje DSN (Nazwa Źródła Danych) jest hostem Twojej dedykowanej instancji Unipile, pojawia się w każdym adresie URL żądania. Twoje Token dostępu, wygenerowany z strona tokenów dostępu, uwierzytelnia każde wywołanie jako X-API-KEY Nagłówek.

DSN jest unikalny dla Twojego konta, a nie współdzielony adres URL API.
Zachowaj token dostępu po stronie serwera, nigdy w kodzie klienckim.
.env
# – serwer bazowy dla każdego żądaniaUNIPILE_DSN=twój-subdomen.unipile.com:PORT# – wysyłane jako nagłówek X-API-KEY przy każdym wywołaniuUNIPILE_ACCESS_TOKEN=twój-token-dostępu
02

Połącz Konto Użytkownika z Hostowaną Autoryzacją

Jedno wezwanie do POST /api/v1/hosted/accounts/link zwraca link. Przekierowuje tam użytkownika, Unipile uruchamia własny przepływ logowania dostawcy (kod QR, OAuth lub dane uwierzytelniające w zależności od dostawcy), a następnie publikuje nowe account_id do twojego notify_url, dopasowane do nazwa wysłałeś.

link-account.js
// Wygeneruj link uwierzytelniający hostowany dla LinkedIn, Instagram, WhatsApp const res = czekać fetch(`https://${DSN}/api/v1/hosted/accounts/link`, { metoda: 'POST', nagłówki: { 'Klucz API X': TOKEN_DOSTĘPU, 'content-type': 'application/json' }, body: JSON.stringify({ typ: 'stwórz', dostawcy: ['LINKEDIN', 'Instagram', 'WHATSAPP'], api_url: `https://${DSN}`, ważneDo: '31-12-2026', success_redirect_url: 'https://yourapp.com/połączony', notify_url: 'https://yourapp.com/webhooks/unipile', nazwa: wewnętrznyIdUżytkownika // twój własny identyfikator użytkownika, zwracany w webhook}) });const { adres url } = czekać rez.json();// przekieruj użytkownika na `url`
03

Wyślij swoją pierwszą wiadomość

Gdy konto zostanie połączone, chwyć chat_id z GET /api/v1/chats i wyślij. Ciało jest multipart/form-data ponieważ załączniki (do 15 MB) mogą być dodawane w tej samej rozmowie, bez konieczności osobnego przesyłania.

first-call.sh
# Wyślij wiadomość tekstową do istniejącej rozmowycurl --request POST \ --url https://{DSN}/api/v1/chats/{chat_id}/messages \ --header 'X-API-KEY: {ACCESS_TOKEN}' --nagłówek 'accept: application/json' --nagłówek "content-type: multipart/form-data --formularz 'Cześć świecie!'
Nowość: Serwer MCP

Połącz swoje AI z MCP

Twój agent kodujący nie musi zgadywać, jak działa interfejs API Unipile. Wskaż Claude Desktop, Cursor lub Windsurf na serwer Unipile MCP, a uzyskają bezpośredni, uwierzytelniony dostęp do API, a także dokumentacji, dzięki czemu mogą pisać i testować kod integracji z Twoimi rzeczywistymi połączonymi kontami.

Czym jest MCP?

Protokół Kontekstu Modelu to otwarty standard, który umożliwia aplikacjom AI bezpieczny dostęp do zewnętrznych źródeł danych i narzędzi. Serwer Unipile MCP zapewnia Twojemu środowisku deweloperskiemu AI bezpośrednią łączność z interfejsami API Unipile do obsługi wiadomości, poczty e-mail i kalendarza, bez potrzeby ręcznego wyszukiwania dokumentacji.

CD
Pulpit ClaudeDodaj serwer w Ustawienia > Deweloper
Chętnie.
KursorDodaj serwer w ustawieniach MCP
WS
WindsurfingDodaj serwer w konfiguracji MCP
Bezpośredni dostęp do API Unipile z poziomu Twojego IDE
Wbudowane w rozmowę wyszukiwanie dokumentacji, bez przełączania zakładek
Generowanie kodu dla rzeczywistych integracji, testowane na własnych połączonych kontach
mcp.json
{ "mcpSerwery": { "stos niepodzielny": { "url": "https://developer.unipile.com/mcp?branch=v1.0", "nagłówki": { "X-API-KEY": "your-api-key"} } } }
Odpowiedzialne Użycie

Odpowiedzialne Użytkowanie i Zgodność

Zanim zaczniesz budować, warto dokładnie zrozumieć, w jaki sposób Unipile przetwarza dane i gdzie przebiegają linie odpowiedzialności. Oto krótka wersja.

Zgodność z RODO Zgodny z SOC 2
01 · Data

Uwaga dotycząca przetwarzania danych

Unipile nie przechowuje niezależnego repozytorium danych wiadomości, e-maili ani kontaktów użytkowników. Każde zapytanie pobiera dane za pośrednictwem API w imieniu uwierzytelnionego, połączonego konta, ograniczone do tej sesji. Nie istnieje równoległe archiwum ani masowy eksport wykraczający poza to, do czego połączony użytkownik już ma dostęp.

02 · Operacja

Jak Działa Unipile

Unipile działa jako niezależny pośrednik techniczny, a nie partner LinkedIn, Meta, Microsoft, Google ani Telegramu. Każda akcja odbywa się w imieniu uwierzytelnionego użytkownika, który połączył swoje konto, korzystając z jego własnych danych uwierzytelniających i sesji. Unipile nigdy nie udostępnia danych uwierzytelniających między klientami.

03 · Granice

Limity platformy i odpowiedzialne korzystanie

Unipile przekazuje limity szybkości i ograniczenia wykorzystania ustalone przez każdą bazową platformę, lecz ich nie usuwa. Tempo wysyłania wiadomości, liczba połączonych kont i sposób wykorzystania pobranych danych pozostają decyzją klienta, regulowaną przez warunki każdego dostawcy oraz wymogi RODO i SOC 2 dotyczące przechowywania tych danych.

Unipile nie jest powiązany, zatwierdzony ani sponsorowany przez LinkedIn, Meta, Microsoft, Google ani Telegram. Wszystkie nazwy produktów, logo i marki wymienione w tym przewodniku są własnością ich odpowiednich właścicieli.

Przewodnik po API Unipile – Najczęściej zadawane pytania

Najczęstsze pytania programistów przed pierwszą integracją.

Unipile oferuje jedną integrację do wysyłania i odbierania wiadomości na LinkedIn, WhatsApp, Instagram i Telegram, publikowania i zarządzania postami oraz komentarzami, pobierania profili, synchronizacji skrzynek pocztowych Gmail, Outlook lub IMAP z pełnym wątkowaniem, a także odczytu lub tworzenia wydarzeń w Google Calendar i Outlook Calendar. Jest to jeden zestaw punktów końcowych i jeden model danych dla każdego połączonego konta, a nie oddzielny zestaw SDK dla każdego dostawcy.

Instagram jest wiodącym dostawcą w Unipile. Oprócz wiadomości prywatnych, możesz pobierać i odpowiadać na komentarze pod postami, reagować na treści oraz pobierać dane profilowe i dotyczące zaangażowania, te same kategorie dostępne dla LinkedIn, za pośrednictwem Social & Messaging API.

Serwer Unipile MCP (https://developer.unipile.com/mcp?branch=v1.0) pozwala narzędziom do tworzenia sztucznej inteligencji, takim jak Claude Desktop, Cursor i Windsurf, na bezpośrednie połączenie z API Unipile przy użyciu Twojego tokena dostępu. Twój agent kodujący może następnie przeszukiwać dokumentację i wywoływać API, aby pomóc Ci w tworzeniu i testowaniu integracji, zamiast ręcznego kopiowania i wklejania dokumentacji do okna czatu.

Każde żądanie wymaga dwóch rzeczy od ciebie Pulpit nawigacyjny Unipile: Twój DSN, który jest podstawowym hostem dla twoich żądań, oraz token dostępu, wysłany jako X-API-KEY nagłówek. Generujesz oba z Panelu API i strona tokenów dostępu.

Najszybszą ścieżką jest Hosted Auth: jedno wywołanie POST /api/v1/hosted/accounts/link zwraca link, na który przekierowujesz użytkownika. Unipile zarządza własnym przepływem logowania dostawcy (kod QR, OAuth lub dane uwierzytelniające w zależności od dostawcy) i powiadamia Twój webhook o nowym account_id po połączonym koncie.

Trzy: Gmail, Perspektywy (które obejmuje również Microsoft 365 i Exchange Online) oraz IMAP jako uniwersalny mechanizm zastępczy dla każdego innego dostawcy skrzynek pocztowych. Wszystkie trzy dzielą ten sam model wątkowania i ten sam zestaw punktów końcowych.

Nie. Czaty, wiadomości i załączniki korzystają z tych samych punktów końcowych w LinkedIn, WhatsApp, Instagramie i Telegramie. Filtrujesz według account_id Aby skierować żądanie do konkretnego połączonego konta i dostawcy, kształt żądania nie ulega zmianie.

Unipile działa jako niezależny pośrednik techniczny i nie przechowuje równoległego magazynu danych, a każde żądanie pobiera dane w imieniu uwierzytelnionego połączonego konta. Unipile jest Zgodność z RODO oraz Zgodny z SOC 2; sposób, w jaki przechowujesz i wykorzystujesz pobrane dane, pozostaje Twoją odpowiedzialnością jako administratora danych.

Cennik działa na zasadzie płatności za wykorzystanie, zaczynając od 49 € / miesiąc za maksymalnie 10 podłączonych kont, a następnie naliczana jest opłata za każde kolejne konto. Każda funkcja opisana w tym przewodniku, wiadomości, posty, e-mail, kalendarz, MCP, jest zawarta na każdym poziomie cenowym, bez ograniczeń funkcjonalności. Pełne zestawienie dostępne jest na strona z cenami.

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

Porozmawiaj z ekspertem

Zacznij budować z Unipile

Połącz swoje pierwsze konto w kilka minut i już dziś wyślij pierwszą wiadomość, opublikuj post, zsynchronizuj e-maile lub dokonaj rezerwacji w kalendarzu.

Płać w miarę postępów, od 49 euro miesięcznie. Każda funkcja w cenie na każdym poziomie.

pl_PLPL