Konfiguracja Facebook Messenger dla 3CX

Wprowadzenie

Integracja z Facebookiem umożliwia Twoim agentom odpowiadanie na wiadomości z Twojego Fanpage’a bezpośrednio z 3CX, bez konieczności logowania się do Facebook Messenger. Wiadomości mogą być kierowane do kolejki połączeń, grupy dzwonienia lub pojedynczego numeru wewnętrznego. Agenci mogą przejmować wiadomości na własność lub przekazywać je do innego agenta lub grupy.

Wymagane jest zweryfikowane konto Facebook Business.

Poniższy przewodnik jest zgodny z aktualizacją procesu tworzenia aplikacji Meta z 2026 roku, zawierającą uproszczone opcje uprawnień.

Krok 1: Rozpoczęcie konfiguracji w centrali 3CX PBX

  • Zaloguj się do klienta WWW 3CX, przejdź do „Admin” → „Voice & Chat” (Głos i czat) i kliknij „+ Add Messaging” (Dodaj wiadomości) → „Add Facebook” (Dodaj Facebook).
  • Ustaw preferowaną nazwę.
  • Jeśli jesteś Właścicielem systemu (System Owner) lub Administratorem systemu (System Admin), możesz udostępnić integrację w całym systemie lub tylko dla wybranej grupy.

  • Skopiuj „3CX Webhook URL” do edytora tekstu i zachowaj go pod ręką.

Krok 2: Tworzenie aplikacji Facebook

  • Przejdź do „My Apps” (Moje aplikacje).
  • Kliknij „Create App” (Utwórz aplikację).
  • Nadaj aplikacji nazwę wyświetlaną, wprowadź kontaktowy adres e-mail, a następnie kliknij „Next” (Dalej).
  • Wybierz opcję „Business messaging” (Wiadomości biznesowe).

  • Wybierz opcję „Messenger from Meta” (Messenger od Meta), a następnie kliknij „Next” (Dalej).
  • Wybierz portfolio biznesowe, z którym chcesz połączyć tę aplikację; możesz to zrobić również później.
  • Jeśli Meta wymaga spełnienia innych wymogów (Publishing requirements) przed przejściem dalej, zostaną one teraz wyświetlone.
  • Kliknij „Next” (Dalej).

  • Przed utworzeniem aplikacji upewnij się, że nazwa aplikacji, kontaktowy e-mail i inne dane są poprawne; kliknij „Create app” (Utwórz aplikację).
  • Potwierdź hasło, jeśli zostaniesz o to poproszony.

  • Następnym ekranem jest „App Dashboard” (Panel aplikacji):
  • Wyświetli on listę zadań, które należy wykonać przed opublikowaniem.
  • Upewnij się, że wszystkie wymagane zadania zostały zakończone.
  • W przypadku wyjścia z portalu Facebook Developers, możesz wrócić do tego miejsca poprzez menu „Use cases” (Przypadki użycia – ikona ołówka).
  • Wybierz opcję „Customize” (Dostosuj).
  • Wybierz „Messenger API Settings” (Ustawienia API Messengera).

  • Rozwiń „Configure webhooks” (Konfiguruj webhooki):
  • Wprowadź Webhook zapisany w Kroku 1 w polu „Callback URL”.
  • Wprowadź długi ciąg znaków znajdujący się po ostatnim ukośniku „/” (np. aabbccddeeff000000001122334455) na końcu adresu webhook w polu „Verify token”.

  • Przewiń w dół i dodaj wymagane pola Webhook, korzystając z najnowszej dostępnej wersji API:
  • messages
  • message_deliveries
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Kliknij „Verify and save” (Weryfikuj i zapisz).

  • Rozwiń „Generate access tokens” (Generuj tokeny dostępu):
  • Kliknij „Add a Page” (Dodaj stronę).
  • Przejdź przez proces uwierzytelniania i wybierz stronę biznesową, którą chcesz dodać.
  • Po dodaniu strony zanotuj „Facebook Page ID” (ID strony na Facebooku).
  • Wybierz opcję menu „Add Webhook Subscriptions” (Dodaj subskrypcje webhooka) i dodaj:

  • messages
  • message_deliveries
  • messaging_pre_checkouts
  • messaging_customer_information
  • message_reads
  • message_echoes
  • Kliknij „Generate” (Generuj), aby otrzymać token API i zapisz go.
  • Jeśli wrócisz do tej strony, możesz najechać kursorem na „Subscriptions” (Subskrypcje), aby uzyskać opcję „Edit” (Edytuj).
  • Na razie NIE przechodź do „Complete App Review” (Zakończ weryfikację aplikacji).

Krok 3: Kontynuacja konfiguracji w 3CX

  • Przejdź do „Users” (Użytkownicy) i utwórz tymczasowego użytkownika testowego, który zostanie użyty w procesie weryfikacji aplikacji w Kroku 4 poniżej.
  • Wklej swój „Page ID” i „Access token” uzyskane w Kroku 2.
  • Upewnij się, że routing wiadomości jest skonfigurowany do Twojego nowego tymczasowego użytkownika testowego.

Krok 4: Tryb deweloperski

Twoja aplikacja jest teraz skonfigurowana do pracy z 3CX i możesz spróbować wysłać wiadomość do swojej strony na Facebooku.

Na tym etapie aplikacja znajduje się w trybie „Development” (Deweloperskim), co oznacza, że mogą z nią wchodzić w interakcję tylko:

  • użytkownicy mający uprawnienia do zarządzania Twoją stroną,
  • użytkownicy, którzy zostali dodani jako testerzy.

Możesz dodać więcej użytkowników testowych poprzez „App Dashboard” > „Roles” (Role) > „App roles” (Role w aplikacji) > „Add People” (Dodaj osoby).

W trybie deweloperskim w 3CX widoczny będzie tylko identyfikator numeryczny użytkownika Facebooka. Widoczność pełnego imienia i nazwiska użytkownika wymaga przełączenia w tryb „Live” (Produkcyjny).

Aby przełączyć się w tryb „Live”, musisz poprosić o dodatkowe uprawnienia i przeprowadzić weryfikację aplikacji – szczegóły w punkcie „Weryfikacja aplikacji”.

Krok 5: Weryfikacja aplikacji

  • W „Meta App Dashboard” przejdź do „App Settings” (Ustawienia aplikacji) > „Basic” (Podstawowe).

  • Wypełnij wymagane dane:
  • „Privacy policy URL” (URL polityki prywatności)
  • „User data deletion URL” (URL usuwania danych użytkownika – może być taki sam jak polityka prywatności)
  • „Category” (Kategoria – wybierz „Messaging” lub „Business”)
  • „App icon” (Prześlij ikonę aplikacji)
  • W zależności od regionu i rodzaju działalności, może być konieczne wypełnienie sekcji RODO (GDPR) poniżej ustawień głównych.
  • Kliknij „+ Add platform” (Dodaj platformę) na dole strony.
  • Wprowadź swój „Website URL” i kliknij „Next” (Dalej).

  • Wprowadź adres URL swojej centrali 3CX PBX, np. https://mypbx.3cx-example.com.
  • Kliknij „Save Changes” (Zapisz zmiany).
  • Z menu bocznego kliknij „Use cases” (Przypadki użycia – ikona ołówka).
  • Kliknij „Customize” (Dostosuj) i dodaj uprawnienie dostępu „Business Asset User Profile access”.
  • Kliknij „Messenger API Settings” (Ustawienia API Messengera).
  • Kliknij „Customize use case” (Dostosuj przypadek użycia).
  • W sekcji „Permissions and features” (Uprawnienia i funkcje) dodaj „Business Asset User Profile Access”.

  • Kliknij przycisk „Request permission” (Poproś o uprawnienie).

  • Wybierz opcje „pages_show_list” oraz „pages_manage_metadata”; kliknij przycisk „Request permission”. Przekieruje Cię to do strony „Submit for App Review” (Prześlij do weryfikacji aplikacji).
  • Otwórz swoją centralę 3CX i zaloguj się jako (lub podszyj się pod) użytkownika testowego; przejdź do „Chat” (Czat) w kliencie WWW.
  • Otwórz swoją połączoną stronę na Facebooku, korzystając z konta z uprawnieniami testera dla tej aplikacji.
  • Ustaw dwa okna obok siebie i rozpocznij nagrywanie ekranu; jest to niezbędne do weryfikacji przez Facebooka.
  • Przeprowadź krótką rozmowę tekstową i zapisz wideo.
  • Wróć do strony Facebook „Submit for App Review” i kliknij „Next” (Dalej).

  • Wykonaj wszystkie kroki, wypełniając wszystkie szczegóły, aż dojdziesz do „Reviewer instructions” (Instrukcje dla weryfikatora). Musisz mieć zweryfikowane konto, aby przejść dalej.

  • Na stronie instrukcji dla weryfikatora (Reviewer instructions):
  • Potwierdź swój „Site URL”.
  • Wypełnij pola pytań w następujący sposób:
  • (instructions-web-2) Provide instructions for accessing the app so we may complete our review.

This Facebook App is used to integrate a 3CX Phone System (https://3cx.com) with Facebook Messenger chats. Each 3CX customer has their own 3CX instance and therefore will need to create their own App to integrate a Facebook Page. pages_messaging is required to receive and send messages started by a Facebook Page visitor.

Step 1. Log in to the 3CX WebClient with the following credentials:

  • PBX Web client URL: https://example-pbx.3cx.com/

Step 2. Write and send a test message on the Facebook Page.

Step 3. Receive and reply to the message in your 3CX Web Client.

  • (accesscode-web-1) If payment or membership is required to access the full functionality of this app:
  • Extension (Numer wewnętrzny): ________
  • Password (Hasło): ________
  • (documents-web-1) Include supporting documentation:
  • Prześlij swoje wcześniej nagrane wideo.
  • Kliknij „Next” (Dalej).
  • Po wypełnieniu wszystkich sekcji możesz przesłać aplikację do weryfikacji.

Aplikację można opublikować za pomocą przycisku „Publish” (Opublikuj) w menu bocznym. Jeśli opublikujesz ją przed zatwierdzeniem, możesz otrzymywać wiadomości, ale bez nazwy nadawcy i innych szczegółów.

Gdy Twoja aplikacja zostanie zatwierdzona, będziesz otrzymywać wiadomości od użytkowników Facebooka z widocznym imieniem i nazwiskiem nadawcy. Pamiętaj, aby usunąć tymczasowego użytkownika testowego utworzonego na potrzeby weryfikacji i zaktualizować routing wiadomości do docelowego miejsca.

Zobacz również


Ostatnia aktualizacja
Ten dokument został ostatnio zaktualizowany 6 sierpnia 2026 r.
https://www.3cx.pl/docs/administrator/facebook/