LinkedIn
Dołącz do społeczności Slack Spis treści
Podstawy
Kategorie i prędkość
WhatsApp API
WhatsApp API Dostawcy: Cloud API, BSP lub Konto Połączone
Interfejs API WhatsApp On-Premises firmy Meta przestał dostarczać wiadomości dnia 23 października 2025. Jedynymi dostępnymi w 2026 roku ścieżkami są bezpośrednie API chmurowe Meta, odsprzedający je dostawca rozwiązania biznesowego (BSP) lub API konta połączonego, które uwierzytelnia istniejący numer WhatsApp. Ten przewodnik porównuje czas konfiguracji, weryfikację Meta, koszty i limity wszystkich trzech rozwiązań dla deweloperów integrujących WhatsApp z własnym produktem.
Budowanie z Unipile Zobacz dokumentację API WhatsApp
# – połącz z istniejącym kontem WhatsAppcurl -X POST ""https://.unipile.com:/api/v1/accounts” -H "X-API-KEY: " -F dostawca=WHATSAPP
// odpowiedź: skanuj lub sparuj, bez kroku Meta Business
{
"obiekt": "Punkt kontrolny",
"kodQrTekst": "2@AbC..."),
"account_id": "ACo_9F21"
}Połączone w mniej niż minutę, bez weryfikacji Meta Business
Definicja
Czym jest dostawca API WhatsApp?
Dostawca API WhatsApp to dowolny podmiot, który zapewnia Twojemu oprogramowaniu programowy dostęp do wiadomości WhatsApp. W 2026 roku oznacza to jedną z trzech kategorii: samo Meta poprzez Cloud API, zatwierdzonego przez Meta Dostawcę Rozwiązań Biznesowych (BSP) odsprzedającego to samo Cloud API lub API konta połączonego, które uwierzytelnia już aktywny numer WhatsApp w imieniu jego właściciela.
W skrócieA Dostawca API WhatsApp cokolwiek znajduje się między Twoim produktem a WhatsAppem: własne Cloud API Meta, odsprzedający je BSP lub API połączonego konta, które łączy istniejący numer zamiast tworzyć nową tożsamość biznesową.
Te trzy kategorie nie są zamienne, a ich mylenie jest częstą przyczyną wstrzymanych integracji z WhatsAppem. Cloud API od Meta przypisuje firmowy numer telefonu do konta WhatsApp Business Account (WABA), którego właścicielami są firmy, przy czym Meta nalicza opłaty bezpośrednio za każdą wiadomość. BSP odsprzedaje to samo Cloud API, dodając wsparcie wdrożeniowe, narzędzia oraz własną marżę lub subskrypcję. API połączonego konta całkowicie pomija ścieżkę WABA: uwierzytelnia numer WhatsApp, który jest już aktywny, w taki sam sposób, jak robi to WhatsApp Web, bez tworzenia nowej tożsamości biznesowej na platformie Meta.
Dla zespołu marketingowego kupującego jedno narzędzie do WhatsAppa różnica zazwyczaj pojawia się jako pozycja na fakturze. Dla dewelopera wdrażającego WhatsAppa jako funkcję wewnątrz produktu SaaS zmienia to proces wdrażania, który klient musi przejść przed wysłaniem pierwszej wiadomości – na to pytanie odpowiada reszta tego przewodnika dla każdego z trzech typów dostawców API WhatsApp. Niektóre zespoły szukają Dostawca API do konwersacji na WhatsAppie zamiast tego: to te same trzy kategorie pod inną nazwą, ponieważ każda integracja z WhatsAppiem jest w gruncie rzeczy sposobem na wysyłanie i odbieranie konwersacji.
Pejzaż roku 2026
Jakie są trzy sposoby uzyskania dostępu do API WhatsApp w 2026 roku?
Odkąd Meta wyłączyła lokalne API (On-Premises API), pozostały tylko trzy ścieżki dostępu: bezpośrednie korzystanie z Cloud API od Meta, odsprzedaż Cloud API przez partnera BSP lub API konta powiązanego. Wybór nie dotyczy już hostingu w chmurze a lokalnego (on-premise), lecz tego, do kogo należy konto WhatsApp Business Account i jak szybko można wysłać pierwszą wiadomość.
Dlaczego "Cloud API kontra Business API" to teraz błędnie postawione pytanie
9 sty 2024 Nowe funkcje WhatsApp są wprowadzane wyłącznie w Cloud API. Klient On-Premises otrzymuje jedynie poprawki błędów, nic więcej.
1 lip 2024 Nowe numery telefonów firmowych można rejestrować wyłącznie w interfejsie Cloud API.
23 paź 2025 Wygasa ważność ostatniej wersji On-Premises (v2.63). Wiadomości wysyłane do numerów, które nadal z niej korzystają, nie są już dostarczane.
Źródło: Meta, wygaszenie interfejsu WhatsApp On-Premises API, dostęp: 6 sierpnia 2026.
Kryterium
Bezpośrednie API w chmurze
BSP
Powiązane konto
Kto jest właścicielem WABA
Ty
BSP, w większości przypadków
Brak WABA
Weryfikacja firm w Meta
Wymagany
Wymagane, obsługiwane przez BSP
Niewymagane
Czas do pierwszej wiadomości
Od dni do tygodni
Godziny na dni
Protokół
Szablony wiadomości
Wymagane poza oknem serwisowym
Wymagany
Nie dotyczy
Fakturowanie
Meta, za wiadomość
Przekazanie kosztów w Meta, plus marża lub subskrypcja
Ceny dostawcy
Wiadomości grupowe
Tylko Oficjalne Konto Firmowe, limit 8 uczestników
To samo wymaganie Meta zostaje przekazane dalej
Zintegrowany, bez osobnej nasadki
Historia połączeń przychodzących
Tylko webhook, z połączenia
Tylko webhook
Dostępne istniejące konwersacje
Najlepszy dla
Zespoły, które potrzebują oficjalnej tożsamości marki
Zespoły, które chcą, aby wdrożenie było obsłużone
Produkty zawierające własne konto użytkownika
Wiadomości grupowe działają inaczej na wszystkich trzech ścieżkach, a limit uczestników przysparza problemów większej liczbie integracji niż jakikolwiek inny wiersz w tej tabeli. Pełne zestawienie można zobaczyć w Wiadomości grupowe na WhatsAppie.
Zbuduj ścieżkę powiązanego konta Opcjonalna warstwa
Czy potrzebujesz BSP, aby korzystać z API WhatsApp?
Nie. Odkąd Cloud API stało się ogólnodostępne w 2022 roku, firma może zarejestrować się bezpośrednio w Meta bez przechodzenia przez Dostawcę Rozwiązań Biznesowych (BSP). BSP jest opcjonalny i zapewnia wsparcie przy wdrażaniu, narzędzia oraz często marżę doliczaną do ceny Meta za wiadomość.
Bezpośrednie działanie oznacza korzystanie z własnej konsoli deweloperskiej Meta, konfigurację WABA oraz weryfikację biznesową bez ustrukturyzowanego procesu, co jest odpowiednikiem dla zespołu posiadającego czas inżynieryjny na zbudowanie własnego zarządzania szablonami i obsługi webhooków. BSP istnieje po to, aby usunąć te trudności: wstępnie wypełnia większość dokumentacji weryfikacyjnej, dostarcza pulpit nawigacyjny działający na surowym API oraz często zapewnia wsparcie w pakiecie. Zatwierdzony przez Meta BSP jest czasami nazywany oficjalny dostawca API WhatsApp, ponieważ działa w ramach własnego programu Business Solution Provider firmy Meta, zamiast nieformalnie odsprzedawać dostęp. Nic z tego nie zmienia leżącego u podstaw Cloud API, rozliczania za wiadomość ani wymogu weryfikacji ze strony Meta: BSP obsługuje ten proces, a nie go zastępuje.
Co zazwyczaj dodaje BSP
Wprowadzenie z przewodnikiem do utworzenia WABA i weryfikacji firmy
Panel sterowania ponad surowymi punktami końcowymi Cloud API
Zarządzanie szablonami narzędzia i śledzenie zatwierdzeń
Wsparcie i zarządzanie kontem, fakturowane jako subskrypcja lub marża od ceny Meta
Co pozostaje bez zmian w obu przypadkach: konto WABA, leżący u jego podstaw cennik Meta za wiadomość oraz weryfikacja firmy dla tego numeru.
Kategoria, która ma znaczenie
Czym jest zewnętrze API WhatsApp i na których z nich można bezpiecznie budować?
Zewnętrzne API WhatsAppa obejmuje dwie bardzo różne rzeczy. Autoryzowane przez Metę firmy BSP oraz API połączonych kont działają zgodnie z warunkami korzystania z usługi WhatsAppa. Biblioteki inżynierii wstecznej, które emulują klienta WhatsAppa, już nie, i narażają powiązany numer telefonu na zablokowanie. Wyszukiwanie nieoficjalnego API WhatsAppa zazwyczaj oznacza jedną z tych trzech kategorii, rzadko wszystkie naraz.
Zgodność
Zatwierdzony przez Meta BSP
Odsprzedaje oficjalne API Cloud w ramach programu Meta Business Solution Provider. Wciąż wymagana jest weryfikacja WABA oraz Meta Business, BSP jedynie zarządza tym procesem i dodaje dodatkową warstwę narzędzi.
Zgodność
API powiązanego konta
Uwierzytelnia istniejące konto WhatsApp za pomocą kodu QR lub kodu parowania, w imieniu uwierzytelnionego użytkownika. Bez WABA, bez weryfikacji Meta Business. W tej kategorii działa Unipile. Wyszukiwania "nieoficjalnego API WhatsApp" zazwyczaj dotyczą tej kategorii, mimo że uwierzytelnia ono tego samego klienta, którego używa WhatsApp Web, zamiast omijać własne systemy WhatsApp.
Wysokie ryzyko
Biblioteki zinżynierowane wstecz
Projekty o otwartym kodzie źródłowym, które implementują protokół WhatsApp bez udziału firmy Meta lub WhatsApp. Często przestają działać po aktualizacjach klienta, są porzucone i naruszają Regulamin usługi WhatsApp, co naraża powiązany numer na ryzyko zablokowania. Nie są linkowane w tym przewodniku.
Dla dewelopera decydującego się, gdzie budować, praktyczny test dla każdego zewnętrznego API WhatsApp jest prosty: czy dostawca uwierzytelnia się poprzez zachowanie własnego klienta WhatsApp (kod QR, kod parowania, Cloud API od Meta), czy też wdraża protokół WhatsApp niezależnie? Dwie pierwsze kategorie odpowiadają twierdząco i mieszczą się w warunkach korzystania z WhatsApp. Trzecia tego nie robi i żadna zgodność funkcji pod względem ich liczby nie zrekompensuje numeru, który może zostać zablokowany bez uprzedzenia.
Zbuduj integrację połączonego konta Porównanie prędkości
Ile czasu zajmuje każdemu typowi dostawcy dotarcie do pierwszej wiadomości?
Bezpośrednie wdrażanie interfejsu Cloud API trwa od dni do tygodni, ponieważ weryfikacja firmy w Meta odbywa się równolegle z konfiguracją konta WABA (WhatsApp Business Account). Partner biznesowy (BSP) skraca ten czas do godzin lub dni, wstępnie wypełniając większość dokumentów. Interfejs API kont połączonych pozwala na wysłanie pierwszej wiadomości w ciągu kilku minut, ponieważ nie trzeba tworzyć konta WABA ani przechodzić weryfikacji.
Dni-tygodnie
Bezpośrednie API w chmurze
Godziny-dni
BSP
Protokół
Powiązane konto
Luka wynika całkowicie z tego, co musi się wydarzyć przed wysłaniem pierwszej wiadomości, a nie z jakichkolwiek ograniczeń technicznych. Pełną listę wymagań, których Meta wymaga przed wysłaniem czegokolwiek z numeru Cloud API, znajdziesz w Wymagania dostępu do API WhatsApp.
Wycena
Ile kosztuje API WhatsApp w przypadku każdego typu dostawcy?
Meta nalicza opłaty za wiadomość od 1 lipca 2025 r., według kategorii szablonu: marketingowe, transakcyjne lub uwierzytelniające. 24-godzinne okno obsługi klienta nadal istnieje, ale obecnie określa ono, które wiadomości są darmowe, zamiast tego, co podlega opłacie. Partner biznesowy (BSP) dolicza abonament lub marżę do ceny za wiadomość.
Obie ścieżki Cloud API – bezpośrednia oraz przez BSP – znajdują się w tym samym cenniku Meta: BSP nie może sprawić, że koszt ponoszony przez Meta za wiadomość zniknie, może jedynie dodać własną opłatę za wdrożenie i narzędzia lub wliczyć jej część w stały abonament. API konta połączonego działa na zupełnie innych zasadach. Nie ma tu konta WABA ani wymogu dotyczącego szablonów, więc Meta nie ma za co naliczać opłat za wiadomość: wycena pochodzi od samego dostawcy, zazwyczaj w formie stałego abonamentu zamiast opłaty za każdą wiadomość.
Źródło: Cennik platformy Meta WhatsApp Business, dostęp: 6 sierpnia 2026.
Pełne zestawienie kategorii szablonów, bezpłatnych okien i cennika Meta można znaleźć w Cennik interfejsu API WhatsApp Business.
Nakład pracy integracyjnej
Który dostawca API WhatsApp jest najprostszy w integracji?
Nakład pracy na integrację wynika z czterech czynników: modelu uwierzytelniania, tego, czy webhooki działają bez dodatkowej konfiguracji, obecności środowiska testowego oraz liczby kanałów obsługiwanych przez to samo API. Spośród trzech ścieżek, API z połączonym kontem jest Najłatwiej zintegrowalny dostawca WhatsApp API do przesyłania wiadomości i weryfikacji, ponieważ uwierzytelnianie odbywa się za pomocą kodu QR lub kodu parowania, a nie procesu weryfikacji Meta.
1Wyślij pierwszą wiadomość
# — rozpocznij rozmowę i wyślij wiadomość tekstową w ramach jednej rozmowycurl -X POST ""https://.unipile.com:/api/v1/chats” -H "X-API-KEY: " -F account_id=<ACCOUNT_ID> -F attendees_ids=<ATTENDEE_ID> -F tekst="Witaj, to moja pierwsza wiadomość"
// 201 Utworzono
{
"obiekt": "CzatRozpoczęty",
"chat_id": "cWh_18a2",
"id_wiadomości": "mWh_77e0"
}2Odbierz to jako webhook
// POST na zarejestrowany adres URL webhooka
{
"zdarzenie": "odebrano_wiadomość",
"account_id": "ACo_9F21",
"typ_konta": "WHATSAPP",
"chat_id": "cWh_18a2",
"id_wiadomości": "mWh_77e2",
"timestamp": "2026-08-06T10:32:04Z",
"wiadomość": "Już jedzie, 10 minut",
"nadawca": { "name": "..." }
}Oba wywołania są wykonywane na tym samym koncie po jego powiązaniu: brak osobnego kroku subskrypcji webhooka, brak szablonu do przesłania do zatwierdzenia, brak numeru w środowisku testowym (sandbox), z którego trzeba migrować. O ile bezpośrednia integracja z Cloud API oznacza rejestrację aplikacji deweloperskiej Meta, utworzenie WABA, przesłanie dokumentów do weryfikacji firmy i zbudowanie odbiornika webhooka, zanim będzie można wysłać pierwszą wiadomość szablonową, o tyle integracja z połączonym kontem to dwa wywołania: uwierzytelnienie konta, a następnie wysłanie.
Pełne odwołanie do żądania i odpowiedzi: wysyłaj wiadomości WhatsApp przez API i Dokumentacja API WhatsApp.
Zacznij budować w kilka minut Kryteria oceny
Jak ocenić dostawcę API WhatsApp jako programista?
Oceń dostawcę API WhatsApp według siedmiu kryteriów: model uwierzytelniania, wymagania weryfikacyjne, czas do pierwszej wiadomości, niezawodność webhooków, obsługa typów wiadomości, przejrzystość rozliczeń oraz to, czy to samo API obsługuje również inne Twoje kanały.
Nie ma jednego najlepszego dostawcy API WhatsApp dla każdego produktu. To, czy jest on nazywany dostawcą API WhatsApp, czy dostawcą wiadomości WhatsApp, zależy od tego, kto pyta, a nie od tego, co robi, a poniższe siedem kryteriów ma zastosowanie w obu przypadkach. Większość list najlepszych dostawców API WhatsApp klasyfikuje narzędzia dla zespołu marketingowego wybierającego chatbot, a nie API dla dewelopera do budowania, dlatego rzadko kiedy są tu pomocne.
1
Model uwierzytelniania
Kod QR, kod parowania lub pełna procedura weryfikacji Meta Business, zanim cokolwiek będzie można przetestować.
2
Wymagania weryfikacyjne
Czy weryfikacja WABA i Meta Business jest obowiązkowa przed wysłaniem pierwszej wiadomości, czy też nie jest wymagana w ogóle.
3
Czas do pierwszej wiadomości
Minuty, godziny lub tygodnie, przetestowane od początku do końca zamiast mierzonych od "przyznania dostępu do API".
4
Niezawodność webhooków
Dostarczanie w czasie rzeczywistym wiadomości przychodzących i zmian statusu, bez konieczności wcześniejszego konfigurowania oddzielnego etapu subskrypcji.
5
Pokrycie typów komunikatów
Tekst, multimedia, szablony, wiadomości głosowe i grupy, jeśli produkt ich potrzebuje.
6
Przejrzystość rozliczeń
Za wiadomość, stały abonament lub marża doliczana do własnej ceny Meta, ujawniane z góry zamiast odkrycia ich przy pierwszej fakturze.
7
Zasięg wielokanałowy
Czy to samo konto i API obsługują również LinkedIn, Instagram, Telegram lub e-mail, dzięki czemu WhatsApp nie jest jednorazową integracją wymagającą osobnego utrzymania.
Powiązane konto
Czy możesz połączyć istniejące konto WhatsApp zamiast tworzyć WABA?
Tak. API powiązanego konta uwierzytelnia istniejące konto WhatsApp za pomocą kodu QR lub kodu parowania, w imieniu uwierzytelnionego użytkownika. Nie utworzono konta WhatsApp Business ani nie jest wymagana weryfikacja Meta Business.
W ten sposób API WhatsApp Unipile działa tak: pełni funkcję niezależnego pośrednika technicznego między produktem a WhatsAppem, a każde wywołanie jest wykonywane w imieniu właściciela konta, który autoryzował połączenie, a nie jako stała integracja biznesowa z Meta. Po powiązaniu istniejące czaty i grupy stają się dostępne za pośrednictwem tego samego ujednoliconego interfejsu API wiadomości, który jest używany dla LinkedIna, Instagrama, Telegrama i poczty e-mail, dzięki czemu WhatsApp nie wymaga osobnej ścieżki integracji w porównaniu do pozostałych kanałów przesyłania wiadomości produktu.
Obsługa danych
Dane pobrane za pośrednictwem połączonego konta WhatsApp nie są przechowywane w systemie równoległym ani zachowywane jako niezależne archiwum. Dostęp pozostaje ograniczony do sesji uwierzytelnionego użytkownika, który powiązał konto.
Limity platformy
Unipile przekazuje własne, natywne limity prędkości WhatsAppa, zamiast narzucać własne. Częstotliwość wysyłania wiadomości przez konto pozostaje decyzją klienta, podejmowaną w ramach własnych limitów WhatsAppa dla tego numeru.
To jest inna ścieżka niż w przypadku numeru Cloud API: zobacz używanie interfejsu API WhatsApp z istniejącym kontem za to, jak przewodnik po filarach przedstawia obie opcje obok siebie.
Zbuduj to z Unipile Według przypadku użycia
Który dostawca WhatsApp API pasuje do Twojego zastosowania?
Jeśli WhatsApp jest jednym z kilku kanałów, pojedyncze API obejmujące WhatsApp, LinkedIn, Instagram, Telegram, Gmail, Outlook i IMAP eliminuje potrzebę utrzymywania osobnej integracji dla każdego dostawcy.
CRM i narzędzia sprzedaży
Rejestruj konwersacje z WhatsAppa obok wiadomości z LinkedIna i wątków e-mailowych na tej samej osi czasu kontaktu, zamiast trzymać WhatsAppa w odizolowanej silosowej strukturze doklejonej do CRM.
Helpdesk i wsparcie
Skieruj konwersacje z WhatsAppa, Instagrama i Telegrama do jednej wspólnej skrzynki odbiorczej, z tym samym modelem zgłoszeń i odpowiedzi we wszystkich trzech kanałach.
Agenci AI
Daj agentowi jedno API do odczytywania i odpowiadania we wszystkich kanałach zamiast osobnego SDK dla każdego dostawcy, od WhatsAppa po skrzynki pocztowe IMAP.
ATS i rekrutacja
Docieraj do kandydatów przez WhatsAppa lub LinkedIn, a następnie synchronizuj potwierdzone rozmowy kwalifikacyjne bezpośrednio z Kalendarzem Google lub Kalendarzem Outlook.
Dostawcy API WhatsApp, często zadawane pytania
Weryfikacja Meta, cennik, wiadomości grupowe oraz miejsce Unipile pomiędzy ścieżkami Cloud API, BSP i kont połączonych.
Nie, nie do celów biznesowych. Meta obciążyła rachunkiem Cloud API za wiadomość od 1 lipca 2025 r., według kategorii szablonu: marketing, powiadomienie (utility) lub uwierzytelnianie. Wiadomości wysłane w ciągu 24-godzinnego okna obsługi klienta są bezpłatne, podobnie jak okna bezpłatnego punktu wejścia otwarte z reklam lub przycisków na stronie. API połączonego konta jest wyceniane oddzielnie przez dostawcę, zazwyczaj w formie stałej subskrypcji, a nie opłaty za wiadomość od Meta.
Tylko w przypadku ścieżki Cloud API, bezpośrednio lub przez BSP: obie wymagają konta WhatsApp Business oraz weryfikacji Meta Business przed wysłaniem pierwszej wiadomości. API powiązanego konta (connected-account) jest inne, uwierzytelnia ono istniejące konto WhatsApp w imieniu uwierzytelnionego użytkownika za pomocą kodu QR lub kodu parowania, bez żadnej weryfikacji Meta Business.
Tak, na dwa sposoby. Firma może dokonać wdrożenia bezpośrednio przy użyciu interfejsu Cloud API od Meta, bez udziału dostawcy rozwiązania biznesowego (BSP), ponieważ stał się on ogólnodostępny w 2022 roku. Interfejs API dla połączonego konta całkowicie pomija zarówno BSP, jak i WABA, uwierzytelniając zamiast tego istniejący numer WhatsApp.
Meta zakończyła jego wsparcie. Nowe funkcje przestano do niego wysyłać 9 stycznia 2024, nowe firmowe numery telefonów nie mogły już się na nim rejestrować od 1 lipca 2024, a wersja ostateczna, v2.63, wygasła 23 października 2025wiadomości wymieniane z numerem, który nadal z niej korzysta, nie są już dostarczane. Własna dokumentacja Meta zaleca migrację do Cloud API. Źródło: Meta, wygaszenie interfejsu WhatsApp On-Premises API.
To zależy od ścieżki. Interfejs API grup interfejsu Cloud API wymaga Oficjalne konto biznesowe i grupy czapek w 8 uczestników, bez punktu końcowego umożliwiającego bezpośrednie dodanie uczestnika. Powiązane konto postępuje zgodnie z natywną mechaniką grup WhatsApp, bez osobnego limitu uczestników.
Nie. Unipile to niezależny pośrednik techniczny, który łączy istniejące konto WhatsApp w imieniu uwierzytelnionego użytkownika za pomocą kodu QR lub kodu parowania. Unipile jest niepowiązany z, popierany przez ani sponsorowany przez Meta czy WhatsApp.
Masz jeszcze jakieś pytania? Nasz zespół służy pomocą.
Rozpocznij budowanie
Buduj z dostawcą API WhatsApp, który pasuje do Twojego produktu
Połącz istniejące konto WhatsApp za pomocą kodu QR lub kodu parowania w imieniu uwierzytelnionego użytkownika i wyślij pierwszą wiadomość przez to samo API, które obsługuje LinkedIn, Instagram, Telegram, Gmail, Outlook i IMAP.
Budowanie z Unipile Przeczytaj dokumentację API WhatsApp
PL 
EN 
FR 
ES 
DE 
IT 
BR 
NL 
TR