Artykuły

WhatsApp Business API w praktyce: dostęp, szablony, koszty i podłączenie do CRM

WhatsApp Business API to oficjalny sposób Meta na podłączenie numeru do oprogramowania zamiast do telefonu. Oto czego potrzebujesz, ile to kosztuje i co zmienia się w codziennej pracy.

W skrócie: WhatsApp Business API, dziś udostępniane jako Cloud API, to oficjalny interfejs Meta, przez który oprogramowanie wysyła i odbiera wiadomości WhatsApp dla numeru firmy. Potrzebujesz portfolio biznesowego Meta, aplikacji, numeru telefonu z wyświetlaną nazwą i zatwierdzonych szablonów do wszystkiego, co wysyłasz poza 24-godzinnym oknem od ostatniej wiadomości klienta. Meta pobiera opłatę za każdą dostarczoną wiadomość, zależnie od kategorii i kraju; wiadomości od klientów są bezpłatne. NeuroCRM podłącza Cloud API ręcznie, na Twoich własnych tokenach; dostępna jest też bramka GREEN-API.

Czym jest WhatsApp Business API?

To interfejs, a nie aplikacja. Niczego się nie pobiera i nie ma ekranu, do którego można się zalogować. Twoje oprogramowanie (CRM, system helpdesk, własny skrypt) komunikuje się przez niego z WhatsAppem: wiadomości przychodzące trafiają na adres webhooka, a odpowiedzi wychodzą jako wywołania API.

Interfejs, który Meta dziś dokumentuje, to Cloud API, hostowane przez samą Metę. Gdy ktoś wpisuje w wyszukiwarkę „whatsapp api”, „api whatsapp” albo „whatsapp cloud api”, chodzi mu właśnie o nie. „WhatsApp Business Platform” to szersza nazwa całej oferty Meta do komunikacji z klientami; Cloud API jest interfejsem wewnątrz niej.

Co zyskujesz w porównaniu z telefonem: z jednego numeru może odpowiadać kilka osób, wiadomości może wysyłać oprogramowanie, a każdy czat może być powiązany z kontaktem i transakcją. Co musisz przyjąć: zasady dotyczące szablonów, 24-godzinne okno i opłaty za każdą wiadomość — wszystko to opisujemy niżej.

Czym różnią się aplikacja WhatsApp Business, WhatsApp Business Web i API?

  • Aplikacja WhatsApp Business. Aplikacja na telefon, którą WhatsApp opisuje jako stworzoną z myślą o właścicielach małych firm. Jedna firma, zwykle jedna osoba przy klawiaturze.
  • WhatsApp Business Web. Tak w wyszukiwarce nazywa się otwieranie tego samego konta firmowego w przeglądarce. To wciąż okno czatu aplikacji, a nie integracja: nic nie łączy się z transakcjami, zadaniami ani raportami.
  • WhatsApp Business API (Cloud API). Interfejs programistyczny. Numer jest zarejestrowany na platformie, a czaty obsługuje program, nie telefon.

Jeśli odpowiadasz tylko kilku osobom z laptopa, aplikacja z wersją przeglądarkową może wystarczyć. Na API przejdź wtedy, gdy z jednego numeru korzysta kilku pracowników, gdy wiadomości mają wychodzić automatycznie albo gdy rozmowy mają trafiać do CRM.

Kto może uzyskać dostęp i czego potrzebujesz?

Przewodnik Meta na start wymaga konta na Facebooku albo zarządzanego konta Meta, rejestracji jako deweloper i urządzenia z WhatsAppem do wiadomości testowych. W tym samym procesie wybierasz lub tworzysz portfolio biznesowe Meta, tworzysz aplikację z przypadkiem użycia WhatsApp i dodajesz numer telefonu.

Numer musi spełniać kilka warunków z dokumentacji Meta o numerach telefonów:

  • Numeru, który jest już używany w WhatsAppie, nie da się zarejestrować, dopóki nie zostanie najpierw usunięty z WhatsAppa.
  • Musi należeć do Ciebie, mieć numer kierunkowy kraju i strefy oraz odbierać SMS-y lub połączenia głosowe do weryfikacji.
  • Przy rejestracji wymagana jest wyświetlana nazwa. Pojawia się w profilu WhatsApp tego numeru.

Do testów szablony nie są potrzebne: w szybkim starcie Meta sama wysyła gotowy szablon hello_world. Własne zatwierdzone szablony będą Ci potrzebne, gdy zechcesz pisać pierwszy albo odpowiadać po zamknięciu okna.

Jak działa 24-godzinne okno?

Gdy klient do Ciebie napisze albo zadzwoni, otwiera się 24-godzinne okno. Każda nowa wiadomość klienta liczy je od nowa. Dopóki jest otwarte, możesz wysyłać wiadomości o dowolnej treści. Gdy się zamknie, dozwolone są tylko wiadomości z szablonów (tę zasadę podaje strona cennika Meta).

Szablony dzielą się na trzy kategorie: marketingowe, transakcyjne (utility) i uwierzytelniające. Tworzysz je w WhatsApp Manager, a Meta je weryfikuje; zanim nowy szablon zacznie działać, trzeba trochę poczekać.

Jak Meta rozlicza WhatsApp Business API?

Według strony cennika Meta, sprawdzonej 18 listopada 2026:

  • Od 1 lipca 2025 Meta pobiera opłatę za każdą dostarczoną wiadomość, a nie za rozmowę. Cena zależy od kategorii wiadomości i numeru kierunkowego kraju odbiorcy.
  • Wiadomości, które klienci wysyłają do Ciebie, są bezpłatne.
  • Szablony są marketingowe, transakcyjne albo uwierzytelniające; odpowiedzi bez szablonu w oknie to wiadomości serwisowe. Meta wymienia też Meta Business Agent.
  • Każdy firmowy numer telefonu dostaje 1000 bezpłatnych wiadomości serwisowych miesięcznie, a limit odnawia się co miesiąc. Od 1 października 2026 wiadomości serwisowe od 1001. w miesiącu są płatne.
  • Jeśli konto wiadomości nie ma metody płatności, Meta dostarcza wiadomości serwisowe tylko w ramach bezpłatnego limitu.
  • Szablony transakcyjne wysłane w otwartym oknie były bezpłatne do 30 września 2026, a od 1 października 2026 są płatne.
  • Jeśli klient napisze do Ciebie z reklamy Click to WhatsApp w aplikacji mobilnej, a Ty odpowiesz w oknie, otwiera się bezpłatne okno punktu wejścia na maksymalnie 7 dni — dla wiadomości marketingowych, transakcyjnych, uwierzytelniających i serwisowych.

Stawki w dolarach są w plikach cenników, do których Meta linkuje z tej strony, i różnią się w zależności od kraju i kategorii. Zanim zaplanujesz budżet, sprawdź plik dla swoich krajów; tutaj nie podajemy żadnej stawki.

Opłaty Meta trafiają na konto WhatsApp, które podłączasz. Dostawca CRM lub innego oprogramowania pobiera do tego własną opłatę.

Czy można przez nie wysyłać wiadomości marketingowe i używać botów?

Tak, w granicach zasad Meta: szablony marketingowe to osobna kategoria wiadomości z własną ceną, a bot to oprogramowanie, które korzysta z tego samego API i podlega tym samym zasadom okna i szablonów.

Wysłanie wiadomości przez WhatsApp API oznacza w praktyce jeden z dwóch rodzajów wywołań: wiadomość o dowolnej treści w oknie albo wiadomość z szablonu poza nim. O tym, która z nich jest dostępna, decyduje czas ostatniej wiadomości klienta.

Jak NeuroCRM łączy się z WhatsApp Business API?

NeuroCRM obsługuje dwa sposoby podłączenia WhatsAppa. Szersze porównanie obu znajdziesz w artykule WhatsApp CRM: oficjalne API a bramki QR. Tutaj szczegółowo opisujemy stronę API.

Ręczne podłączenie Cloud API

W Ustawienia → Integracje wybierasz WhatsApp Business Cloud API i wypełniasz cztery pola:

  1. ID numeru telefonu (Phone Number ID) z ekranu API Setup w Meta.
  2. Stały token dostępu (użytkownik systemowy), wygenerowany w Business Settings → System Users.
  3. Sekret aplikacji (App Secret), który służy do weryfikacji podpisu przychodzących webhooków.
  4. ID konta biznesowego WhatsApp (WABA ID).

Potem kliknij „Zweryfikuj i połącz”. NeuroCRM pokaże adres URL wywołania zwrotnego (Callback URL) i token weryfikacyjny (Verify Token); oba wklejasz w swojej aplikacji Meta w WhatsApp → Configuration → Webhooks i subskrybujesz pole messages. Możesz dodać kilka numerów.

Nie ma jednego przycisku. Aplikację Meta, użytkownika systemowego i token tworzysz sam, więc pierwsze podłączenie zajmie trochę czasu. Zanim zaczniesz, przygotuj wszystko po stronie Meta.

Co widzą konsultanci

Każdy czat z WhatsAppa trafia do tej samej skrzynki co pozostałe kanały, razem z kartą kontaktu. NeuroCRM liczy 24 godziny od najnowszej prawdziwej wiadomości, którą klient wysłał na WhatsAppie, i na wszelki wypadek uznaje okno za zamknięte pięć minut wcześniej.

Gdy okno jest zamknięte, zamiast Twojego tekstu NeuroCRM wysyła zatwierdzony szablon: ten, który wybrałeś, domyślny szablon konta albo zatwierdzony szablon bez zmiennych i multimediów. Twój szkic czeka w polu odpowiedzi, aż klient odpisze. Bez zatwierdzonego szablonu wysyłka zostaje odrzucona, a drugi szablon przed odpowiedzią klienta wyjdzie tylko wtedy, gdy ponownie wybierzesz go z listy.

Reguły, automatyzacje i AI

  • Automatyzacje. Poza oknem automatyzacja nie wysyła wiadomości i nie wybiera szablonu: krok zostaje oznaczony jako niewysłany. Przy zdarzeniach transakcji wiadomość trafia do najwcześniejszej rozmowy kontaktu, niezależnie od kanału.
  • Sekwencje sprzedażowe. Krok WhatsApp wysyła zatwierdzony szablon, który wskażesz w tym kroku.
  • Odpowiedzi AI. Neuro Contact Center to płatny dodatek: 200 USD miesięcznie plus 0,50 USD za każdy udany dialog, na Twoim własnym kluczu AI bez marży (0%) albo przez NeuroCRM z dopłatą 20%. Poza 24-godzinnym oknem nie odpowiada i nie wysyła szablonu. Sam nie umawia wizyt.

Alternatywa: GREEN-API

GREEN-API to nieoficjalna bramka. Łączysz numer osobisty kodem QR w konsoli GREEN-API, a potem wpisujesz w NeuroCRM idInstance i apiTokenInstance. Podpowiedź samej integracji mówi, że bramka pasuje „do przypadków, gdy oficjalne WhatsApp Business API nie jest dostępne”. To nie jest platforma Meta, więc opisane wyżej zasady szablonów i okna jej nie dotyczą.

Czego NeuroCRM nie robi z WhatsApp Business API?

  • Brak podłączenia jednym kliknięciem. Dane dostępowe Meta wpisuje się ręcznie; procesu Embedded Signup od Meta nie ma w postaci przycisku.
  • Brak współistnienia (coexistence). Numer używany jednocześnie w aplikacji WhatsApp Business i w API nie działa przez NeuroCRM.
  • Opłaty Meta za wiadomości nie wchodzą w cenę miejsca i nie ustala ich NeuroCRM; Meta obciąża konto, które podłączasz.
  • Brak automatycznego wyboru szablonu przez automatyzacje czy AI poza 24-godzinnym oknem.

Ile kosztuje WhatsApp w NeuroCRM?

Miejsce kosztuje 13 USD za użytkownika miesięcznie albo 10,40 USD przy płatności za rok; planu darmowego nie ma. 14-dniowy okres próbny obejmuje wszystko i dowolną liczbę użytkowników, a potem konto przechodzi w tryb tylko do odczytu. Zobacz cennik. Neuro Contact Center to opisany wyżej osobny dodatek. Opłaty Meta za wiadomości to trzecia pozycja, rozliczana przez Metę.

Systemy porównasz w porównaniach NeuroCRM i w przewodniku po alternatywach dla Kommo. O WhatsAppie obok innych kanałów przeczytasz w artykule o wspólnej skrzynce.

Lista kontrolna: zanim podłączysz

  1. Wybierz numer, który należy do Ciebie i na który odbierzesz SMS albo połączenie weryfikacyjne. Jeśli jest już w WhatsAppie, przygotuj się na to, że najpierw trzeba go tam usunąć.
  2. Utwórz portfolio biznesowe Meta, aplikację z przypadkiem użycia WhatsApp i użytkownika systemowego ze stałym tokenem.
  3. Wybierz wyświetlaną nazwę.
  4. Dodaj metodę płatności po stronie Meta — inaczej wiadomości serwisowe ponad bezpłatny limit nie zostaną dostarczone.
  5. Zgłoś w WhatsApp Manager przynajmniej jeden szablon transakcyjny i przed startem poczekaj, aż Meta go zatwierdzi.
  6. Zanotuj Phone Number ID i WABA ID z ekranu API Setup.
  7. Połącz numer w NeuroCRM, skopiuj adres URL wywołania zwrotnego i token weryfikacyjny do Meta i zasubskrybuj messages.
  8. Wyślij sobie wiadomość, odpowiedz na nią, a potem odczekaj, aż okno się zamknie, i przetestuj szablon.

Najczęstsze pytania

Czy WhatsApp Business API jest darmowe?

Nie do końca. Meta pobiera opłatę za każdą dostarczoną wiadomość, z wyjątkiem wiadomości od klientów, pierwszych 1000 wiadomości serwisowych na numer w każdym miesiącu i wiadomości w bezpłatnym oknie punktu wejścia.

Czym różni się WhatsApp API od Cloud API?

Przy nowym wdrożeniu w praktyce to jedno i to samo: Cloud API to wersja, którą Meta hostuje i dokumentuje, i właśnie z niej korzysta integracja WhatsApp Business Cloud API w NeuroCRM.

Czy mogę używać w API numeru z aplikacji WhatsApp Business?

Meta podaje, że numer już używany w WhatsAppie trzeba przed rejestracją usunąć z WhatsAppa. Przez NeuroCRM korzystanie z jednego numeru jednocześnie w aplikacji i w API (coexistence) nie działa.

Dlaczego moja wiadomość nie dotarła do klienta?

Dwie częste przyczyny: 24-godzinne okno było już zamknięte, a wiadomość nie była szablonem, albo po wyczerpaniu bezpłatnych wiadomości serwisowych konto Meta nie miało metody płatności. Przy zamkniętym oknie NeuroCRM nie wysyła Twojego zwykłego tekstu; najpierw wysyła zatwierdzony szablon, a Twój tekst zostaje w polu odpowiedzi.

Czy kilka osób może odpowiadać z jednego numeru API?

Tak. Czaty z jednego numeru trafiają w NeuroCRM do wspólnej skrzynki, a podłączyć możesz kilka numerów.

Źródła

  • Meta, cennik WhatsApp Business Platform — https://developers.facebook.com/docs/whatsapp/pricing (sprawdzono 18 listopada 2026)
  • Meta, Cloud API: pierwsze kroki — https://developers.facebook.com/docs/whatsapp/cloud-api/get-started (sprawdzono 18 listopada 2026)
  • Meta, numery telefonów — https://developers.facebook.com/docs/whatsapp/cloud-api/phone-numbers (sprawdzono 18 listopada 2026)
  • Aplikacja WhatsApp Business — https://whatsappbusiness.com/products/business-app/ (sprawdzono 18 listopada 2026)

Jak powstał ten artykuł: napisał go zespół NeuroCRM z pomocą AI; informacje o produkcie sprawdzono z kodem i dokumentacją pomocy NeuroCRM; ceny pochodzą z opublikowanego cennika na dzień aktualizacji.