# Podłącz własną aplikację Meta

Uruchom WhatsApp przez własną aplikację Meta i płać bezpośrednio firmie Meta według jej stawek. <span data-t="appName">Your AI Connector</span> nie dolicza żadnych opłat za wiadomość przy tym połączeniu, a w procesie nie pośredniczy żadne konto Twilio. Ponieważ konto WhatsApp należy do Ciebie, Twoi klienci widzą wyłącznie nazwę Twojej firmy.

Jest to najbardziej techniczna z opcji połączenia z WhatsApp — utworzysz aplikację w witrynie dla programistów Meta i skopiujesz cztery wartości do <span data-t="appName">Your AI Connector</span>. Zaplanuj na to około 20 minut. Jeśli brzmi to jak zbyt skomplikowane zadanie, zarządzane połączenie [WhatsApp Business](whatsapp-business.md) pozostaje najprostszym sposobem na rozpoczęcie pracy.

## Czego potrzebujesz

* Dostępu do swojego konta Meta Business Manager.
* Numeru telefonu, który nie jest jeszcze używany w aplikacji WhatsApp.
* Około 20 minut.

## Część 1 — Skonfiguruj swoją aplikację w Meta

Wykonaj najpierw te kroki po stronie Meta. Po drodze zbierzesz cztery wartości: **App ID** (identyfikator aplikacji), **App secret** (klucz tajny aplikacji), **Access token** (token dostępu) oraz **WhatsApp account ID** (identyfikator konta WhatsApp).

### 1. Utwórz aplikację

Przejdź do [developers.facebook.com](https://developers.facebook.com), otwórz **Moje aplikacje** i naciśnij **Utwórz aplikację**. Wybierz typ **Biznesowa** i nadaj jej dowolną nazwę — nazwa jest widoczna tylko dla Ciebie.

### 2. Dodaj WhatsApp do aplikacji

Na pulpicie nawigacyjnym aplikacji znajdź **WhatsApp** na liście produktów i naciśnij **Skonfiguruj**. Meta utworzy testowe konto WhatsApp z bezpłatnym numerem testowym, dzięki czemu możesz wypróbować działanie funkcji przed podłączeniem prawdziwego numeru.

### 3. Włącz uprawnienia WhatsApp

To krok, który pomija większość poradników, a jego pominięcie jest najczęstszą przyczyną późniejszych problemów z połączeniem.

W swojej aplikacji otwórz **Przegląd aplikacji**, a następnie **Uprawnienia i funkcje**. Wyszukaj **whatsapp_business_management**. Jeśli widnieje tam **Brak dostępu**, naciśnij **Uzyskaj standardowy dostęp** — Meta poprosi o ponowne wprowadzenie hasła i przyzna go od razu. Nie ma okresu oczekiwania ani przeglądu aplikacji; to tylko jeden przycisk.

`whatsapp_business_messaging` zazwyczaj ma już dostęp standardowy. Oba uprawnienia muszą wskazywać **Dostęp standardowy** przed przejściem do następnego kroku, w przeciwnym razie wygenerowanemu tokenowi będzie brakować jednego z nich.

### 4. Utwórz użytkownika systemowego

W [Ustawieniach biznesowych Meta](https://business.facebook.com/settings) otwórz **Użytkownicy**, a następnie **Użytkownicy systemowi**. Dodaj użytkownika i nadaj mu uprawnienia administratora zarówno do swojej aplikacji, jak i do konta WhatsApp.

### 5. Wygeneruj token dla tego użytkownika

Wybierz użytkownika systemowego i kliknij **Wygeneruj token**. Wybierz swoją aplikację, wybierz token, który **nigdy nie wygasa**, i zaznacz zarówno **whatsapp_business_messaging**, jak i **whatsapp_business_management**. Meta wyświetla token tylko raz — skopiuj go od razu.

### 6. Znajdź identyfikator swojego konta WhatsApp

W Ustawieniach biznesowych otwórz **Konta**, następnie **Konta WhatsApp** i wybierz swoje konto. Długi numer pod jego nazwą to identyfikator (ID).

Twój **Identyfikator aplikacji (App ID)** i **Klucz tajny aplikacji (App secret)** znajdują się w **Ustawieniach aplikacji**, w sekcji **Podstawowe**. Kliknij **Pokaż** obok klucza tajnego aplikacji, aby go wyświetlić.

## Część 2 — Połącz to w <span data-t="appName">Your AI Connector</span>

Otwórz **Ustawienia**, następnie **Kanały**, znajdź kartę **WhatsApp Business API** i naciśnij **Połącz WhatsApp**. Wybierz **Użyj numeru, który już posiadasz**, a następnie **Własna aplikacja Meta**. Kreator otworzy się na krótkim podsumowaniu — naciśnij **Rozpocznij konfigurację**.


1. **Twoje dane.** Ten krok powtarza pięć kroków po stronie Meta z Części 1 obok formularza na Twoje cztery wartości. Wklej identyfikator aplikacji (App ID), klucz tajny aplikacji (App secret), token dostępu (Access token) oraz identyfikator konta WhatsApp (WhatsApp account ID) dokładnie tak, jak pokazuje je Meta, bez dodatkowych spacji, i naciśnij **Sprawdź moje dane**. Nic nie jest zapisywane, dopóki dane nie będą poprawne — <span data-t="appName">Your AI Connector</span> najpierw sprawdza je w Meta.


2. **Wybierz numer do połączenia.** Kreator wyświetla listę wszystkich numerów na Twoim koncie WhatsApp, każdy z oceną jakości Meta. Wybierz ten, z którego ten obszar roboczy ma wysyłać i odbierać wiadomości, a następnie kliknij **Połącz ten numer**.


3. **Aktywacja i dostarczanie.** <span data-t="appName">Your AI Connector</span> automatycznie aktywuje numer dla Cloud API i rejestruje jego webhook w Meta, dzięki czemu przychodzące wiadomości trafiają do Twojej skrzynki odbiorczej — w większości przypadków trafisz bezpośrednio na kartę połączenia z potwierdzeniem „Numer połączony”. Jeśli automatyczny krok nie może zostać ukończony, kreator wyświetli adres URL wywołania zwrotnego (callback URL) oraz token weryfikacyjny wraz z przyciskami kopiowania i przeprowadzi Cię przez proces samodzielnego dodania ich w Meta; te same wartości pozostaną widoczne na karcie połączenia, na wypadek gdyby Meta kiedykolwiek poprosiła o ich ponowne wprowadzenie.
4. **Kreator samodzielnie sprawdza połączenie.** W ostatnim kroku automatycznie weryfikuje konfigurację — nie musisz na nic czekać. Gdy karta pokaże status połączenia, wyślij do siebie wiadomość WhatsApp z innego telefonu i obserwuj, jak pojawia się w Twoich czatach: rozmowy na tym numerze będą teraz napływać tak samo, jak w przypadku każdego innego kanału, a Twoi agenci AI będą mogli na nie odpowiadać. Jeśli podczas sprawdzania okaże się, że Meta nadal czegoś wymaga (na przykład weryfikacji numeru), karta dokładnie poinformuje Cię, czego brakuje, a przycisk **Zweryfikuj połączenie** uruchomi sprawdzanie ponownie, gdy już to naprawisz.


W każdej chwili możesz wrócić na tę samą stronę, aby sprawdzić stan połączenia, **Połączyć ponownie** (Reconnect) przy użyciu nowych danych lub nacisnąć **Rozłącz** (Disconnect) — Twój numer, Twoje konto Meta i rozliczenia pozostają Twoje.

## Warto wiedzieć

* **Obowiązuje 24-godzinne okno, tak jak w każdym połączeniu WhatsApp Business.** Możesz zawsze odpowiadać w dowolny sposób osobom, które napisały do Ciebie w ciągu ostatnich 24 godzin. Poza tym oknem WhatsApp pozwala firmom rozpoczynać rozmowy tylko za pomocą zatwierdzonego [szablonu wiadomości](../templates/whatsapp-templates.md) — zwykła wiadomość tekstowa zostanie zaakceptowana przez Meta, ale nie zostanie dostarczona.
* **Meta obciąża Cię bezpośrednio** za rozmowy według opublikowanych stawek krajowych, przy użyciu metody płatności przypisanej do Twojego konta WhatsApp w Meta. <span data-t="appName">Your AI Connector</span> nie pobiera opłat za wiadomość przy tym połączeniu; korzystanie z AI jest rozliczane w kredytach jak zwykle.
* **Utrzymuj ważną metodę płatności na tym koncie WhatsApp.** Bez niej Meta blokuje każdą rozmowę inicjowaną przez Twoją firmę — transmisje, kampanie i każdą wiadomość szablonową — i wyświetla błąd w Menedżerze WhatsApp (WhatsApp Manager). Przy tym połączeniu transmisja lub kampania nie zostanie uruchomiona, jeśli wystąpi taki problem, a system poinformuje o konieczności dodania metody płatności, zamiast zawodzić przy każdej wiadomości z osobna. Odpowiedzi na wiadomości osób, które napisały jako pierwsze, na razie nadal będą wysyłane, ale od **1 października 2026 r.** Meta zacznie pobierać opłaty również za nie, więc konto bez działającej metody płatności stanie się całkowicie nieaktywne w tym dniu. Pełny obraz sytuacji znajduje się w sekcji [Koszty WhatsApp i zmiana z października 2026 r.](whatsapp-pricing.md).
* **Twój szacunkowy koszt wygląda tutaj inaczej.** Ponieważ te opłaty nigdy nie obciążają Twoich kredytów, szacunek w kroku przeglądu transmisji (i kroku uruchamiania kampanii) pokazuje liczbę kontaktów i podział na kraje z informacją, że Meta obciąża nimi Twoje konto WhatsApp Business, zamiast sumy kredytów.
* **Numery testowe są darmowe.** Numer testowy, który Meta daje każdej nowej aplikacji, może wysyłać wiadomości do maksymalnie pięciu zweryfikowanych odbiorców bez żadnych kosztów — to wygodny sposób na wypróbowanie pełnej konfiguracji przed przypisaniem do niej prawdziwego numeru.

## Szablony

Szablony wiadomości działają w ramach tego połączenia i znajdują się na Twoim własnym koncie WhatsApp Business. Utwórz szablon na stronie **Szablony**, a zostanie on utworzony na tym koncie i sprawdzony przez firmę Meta, po czym wynik (zatwierdzony, oczekujący lub odrzucony) zostanie wyświetlony tutaj. Szablony, które już posiadasz w Menedżerze WhatsApp, pojawią się na liście automatycznie, a przycisk **Synchronizuj z Meta** pobierze wszelkie zmiany, które zostały tam właśnie wprowadzone. Wysyłanie działa tak samo, jak w przypadku każdego innego połączenia WhatsApp — wybierz zatwierdzony szablon, aby rozpocząć rozmowę lub wznowić ją poza 24-godzinnym oknem. Szczegóły znajdują się w artykule [Korzystanie z szablonów z własnym kontem Meta WhatsApp](../templates/whatsapp-templates.md#using-templates-with-your-own-meta-whatsapp-account).

## Jeśli coś nie działa

* **„Nie udało nam się połączyć przy użyciu tych danych”** — skopiuj ponownie każdą wartość; zazwyczaj przyczyną jest zbędna spacja. Komunikat zawiera odpowiedź od Meta, która zazwyczaj wskazuje, która wartość jest błędna.
* **Błąd mówi, że brakuje tokena `whatsapp_business_management`** — Twoja aplikacja nie otrzymała jeszcze tego uprawnienia. Wróć do części 1, kroku 3, naciśnij **Uzyskaj standardowy dostęp (Get standard access)**, a następnie wygeneruj nowy token z zaznaczonymi obydwoma uprawnieniami i ponownie sprawdź swoje dane. Ponowne wygenerowanie tokena bez wykonania tego kroku będzie nadal powodować ten sam błąd.
* **Twój token zniknął** — Meta wyświetla token tylko raz. Wygeneruj nowy z tego samego użytkownika systemowego; stary będzie działał, dopóki go nie unieważnisz, ale widoczny będzie tylko nowy.
* **Wiadomości, które inicjujesz, nie docierają** — sprawdź powyższą uwagę dotyczącą 24-godzinnego okna: poza tym oknem dostarczane są tylko wiadomości szablonowe.
* **Nic nie dociera** — numer prawdopodobnie nie został jeszcze aktywowany dla Cloud API. Numer może być aktywny tylko w jednym miejscu jednocześnie, więc jeśli nadal jest zalogowany w **aplikacji** WhatsApp Business na telefonie, najpierw usuń go stamtąd, a następnie naciśnij **Zweryfikuj połączenie** na karcie połączenia. <span data-t="appName">Your AI Connector</span> aktywuje go dla Ciebie i od razu poinformuje, jeśli Meta nadal czegoś wymaga.
* **„Ten numer ma już kod PIN weryfikacji dwuetapowej”** — numer był wcześniej skonfigurowany gdzie indziej i zachował swój kod PIN. Wyłącz weryfikację dwuetapową dla tego numeru w Menedżerze WhatsApp (WhatsApp Manager), a następnie naciśnij **Połącz ponownie**.
* **„Meta nie zweryfikowała jeszcze tego numeru”** — dokończ weryfikację numeru w Menedżerze WhatsApp (Meta wyśle na niego kod), a następnie naciśnij **Połącz ponownie**.
* **„Ten numer jest hostowany w On-Premises API”** — działa on w starszym, samodzielnie hostowanym produkcie WhatsApp, który nie może współdzielić numeru z Cloud API. Najpierw przeprowadź migrację do Cloud API w Menedżerze WhatsApp.