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.
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});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.
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.
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ę funkcji11 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// 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// 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// 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 CRMPobieraj 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// 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// 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// 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ńcoweRozpocznij 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// 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// 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 IMAPGdy 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ńcoweUtwó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// 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życiaTwoje 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.
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.
# – 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ępuPołą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ś.
// 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`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.
# 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!'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.
{ "mcpSerwery": { "stos niepodzielny": { "url": "https://developer.unipile.com/mcp?branch=v1.0", "nagłówki": { "X-API-KEY": "your-api-key"}
}
}
}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.
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.
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.
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ą.
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.