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

Uruchom WhatsApp przez własną aplikację Meta i płać bezpośrednio firmie Meta według jej stawek. Your AI Connector 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 Your AI Connector. Zaplanuj na to około 20 minut. Jeśli brzmi to jak zbyt skomplikowane zadanie, zarządzane połączenie WhatsApp Business 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, 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 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 Your AI Connector #

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 — Your AI Connector 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. Your AI Connector 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.

Przełączanie z połączenia zarządzanego #

Możesz rozpocząć od zarządzanego połączenia WhatsApp Business, a później przejść na własną aplikację Meta. Oba rozwiązania działają w ramach tego samego konta, więc niczego nie trzeba budować od nowa.

• Twoje kontakty i historia czatów pozostają. Kontakty, konwersacje, tagi, agenci i baza wiedzy należą do Twojego konta, a nie do połączenia. Usunięcie lub zastąpienie numeru nie powoduje usunięcia żadnych z tych danych, a gdy osoba, która pisała do Ciebie wcześniej, ponownie wyśle wiadomość na ten numer, trafi ona do tej samej konwersacji.
• Numer musi najpierw zostać przeniesiony po stronie Meta. WhatsApp pozwala na przypisanie numeru tylko do jednego miejsca jednocześnie. Poproś wsparcie o zwolnienie numeru z konfiguracji zarządzanej, dodaj go do własnego konta WhatsApp Business w Menedżerze WhatsApp, a następnie wykonaj kroki opisane na tej stronie. Należy się spodziewać, że podczas przenoszenia numer będzie przez krótki czas niedostępny.
• Jeśli planujesz przełączenie, użyj numeru, którego jesteś właścicielem. Numer wynajęty wewnątrz Your AI Connector to linia wirtualna, która należy do konfiguracji zarządzanej i nie może zostać po prostu przeniesiona do Twojej własnej aplikacji Meta, więc przełączenie oznaczałoby konieczność użycia nowego numeru WhatsApp.
• Szablony wymagają ponownego zatwierdzenia. Meta zatwierdza szablony dla każdego konta WhatsApp Business z osobna, więc odtwórz te, których używasz, w ramach własnego konta (zobacz Szablony poniżej).
• Agencje: każde subkonto łączy się z własną aplikacją Meta, dzięki czemu klienci mogą przełączać się pojedynczo.

Warto wiedzieć #

• Obowiązuje 24-godzinne okno czasowe, tak jak w przypadku każdego połączenia WhatsApp Business. Zawsze możesz odpowiedzieć w dowolnej formie 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 — 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, korzystając z metody płatności przypisanej do Twojego konta WhatsApp w Meta. Your AI Connector nie pobiera opłat za wiadomość w ramach tego połączenia; 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ę rozpoczętą przez Twoją firmę — transmisje i wszelkie wiadomości szablonowe — i wyświetla błąd w Menedżerze WhatsApp. W przypadku tego połączenia transmisja nie zostanie uruchomiona, jeśli wystąpi taki problem, a system poprosi o dodanie metody płatności, zamiast zgłaszać błąd przy każdej wiadomości z osobna. Odpowiedzi dla osób, które napisały do Ciebie jako pierwsze, na razie nadal są 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 całkowicie zamilknie w tym dniu. Pełny obraz sytuacji znajduje się w sekcji Koszty WhatsApp i zmiany od października 2026 r..
• Twój szacunkowy koszt wygląda tutaj inaczej. Ponieważ te opłaty nigdy nie obciążają Twoich kredytów, szacunek na etapie przeglądu transmisji pokazuje liczbę kontaktów i podział na kraje z informacją, że Meta obciąża nimi Twoje konto WhatsApp Business, zamiast podawać całkowitą liczbę kredytów.
• Numery testowe są darmowe. Numer testowy, który Meta nadaje 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.

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 informuje, ż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 dla tego samego użytkownika systemowego; stary będzie działał, dopóki go nie unieważnisz, ale widoczny będzie tylko nowy.
• Odpowiedzi kończą się niepowodzeniem z komunikatem „Ta konwersacja dotyczy numeru WhatsApp Business…, który nie jest numerem połączonym” — Twoja aplikacja Meta ma więcej niż jeden numer, a użytkownicy piszą na numer, który nie jest tutaj połączony. Ich wiadomości nadal się pojawiają, ponieważ Meta przesyła wiadomości aplikacji dla każdego numeru, ale odpowiedzi mogą być wysyłane tylko z połączonego numeru, więc sztuczna inteligencja na nie nie odpowiada. Karta WhatsApp na stronie Kanały (Channels) wyświetla ostrzeżenie z nazwą tego numeru, mimo że wiadomości nadal napływają. Wiersz z tym numerem na tej karcie nie ma przycisku Połącz ponownie (tylko Ustaw jako główny i usuń): otwórz ponownie stronę połączenia aplikacji Meta (Połącz WhatsApp na karcie WhatsApp Business API, następnie Użyj numeru, który już masz, a potem Twoja własna aplikacja Meta), naciśnij Połącz ponownie na znajdującej się tam karcie połączenia i wybierz numer, na który faktycznie piszą Twoi klienci. Token użytkownika systemowego musi mieć dostęp do tego konta WhatsApp. Jeśli ten numer w ogóle nie powinien docierać do Your AI Connector, usuń go (lub jego konto WhatsApp) ze swojej aplikacji Meta.
• Wiadomości, które inicjujesz, nie docierają — sprawdź powyższą uwagę dotyczącą okna 24-godzinnego: poza tym oknem dostarczane są tylko wiadomości szablonowe.
• Nic nie dociera — numer prawdopodobnie nie został jeszcze aktywowany dla Cloud API. Numer może znajdować się tylko w jednym miejscu jednocześnie, więc jeśli jest nadal zalogowany w aplikacji WhatsApp Business na telefonie, najpierw usuń go stamtąd, a następnie naciśnij Zweryfikuj połączenie na karcie połączenia. Your AI Connector aktywuje go dla Ciebie i od razu poinformuje, jeśli Meta nadal czegoś wymaga.
• „Ten numer ma już kod PIN weryfikacji dwuetapowej” — numer został wcześniej gdzieś skonfigurowany 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.