ChatbotAssistant

Integracja chatbota z Facebook Messenger

Niniejsza instrukcja przeprowadzi Cię przez proces integracji naszego chatbota z Twoją stroną na Facebooku za pomocą Facebook Messenger. Po wykonaniu wszystkich kroków, Twoi klienci będą mogli komunikować się z chatbotem bezpośrednio przez komunikator Facebook Messenger.

Ważne wymagania wstępne: Aby przeprowadzić integrację, potrzebujesz posiadać stronę firmową na Facebooku oraz uprawnienia administratora do tej strony. Potrzebujesz również konta deweloperskiego Facebook, które możesz utworzyć bezpłatnie na stronie Facebook Developers.

Wybierz swój punkt startowy

0

Przegląd procesu integracji

Integracja chatbota z Facebook Messenger to proces, który składa się z kilku głównych etapów:

  1. Utworzenie aplikacji na Facebook Developers - stworzenie nowej aplikacji, która będzie służyć jako most między chatbotem a Facebook Messengerem.
  2. Konfiguracja produktu Messenger - dodanie produktu Messenger do aplikacji i połączenie go z Twoją stroną firmową.
  3. Uzyskanie niezbędnych tokenów - wygenerowanie tokenów dostępu i pobranie sekretu aplikacji, które umożliwią autoryzację komunikacji.
  4. Konfiguracja chatbota na naszej platformie - wprowadzenie tokenów i skonfigurowanie chatbota do pracy z Facebook Messenger.
  5. Skonfigurowanie webhooka - ustawienie adresu zwrotnego, pod którym Facebook będzie mógł komunikować się z chatbotem.
  6. Testowanie i weryfikacja - sprawdzenie poprawności integracji i przygotowanie do publicznego użycia.
Czas realizacji: Cały proces integracji zajmuje zwykle od 20 do 40 minut, w zależności od Twojego doświadczenia z platformą Facebook Developers. Poniższa instrukcja przeprowadzi Cię krok po kroku przez wszystkie etapy.
Wskazówka: Przed rozpoczęciem procesu integracji, upewnij się, że masz dostęp do:
  • Swojego konta na Facebooku z uprawnieniami administratora do strony firmowej
  • Konta na naszej platformie AI Chatbot z aktywną subskrypcją
1

Tworzenie aplikacji na Facebook Developers

Pierwszym krokiem integracji jest utworzenie nowej aplikacji na platformie Facebook Developers. Aplikacja ta będzie służyć jako most między Twoim chatbotem a Facebook Messengerem.

Szczegółowa instrukcja:

  1. Przejdź na stronę https://developers.facebook.com
  2. Zaloguj się na swoje konto Facebook. Jeśli nie masz jeszcze konta deweloperskiego, zostaniesz poproszony o jego utworzenie.
  3. Po zalogowaniu kliknij przycisk My Apps znajdujący się w prawym górnym rogu strony.
  4. Na stronie z listą aplikacji kliknij przycisk Create App znajdujący się również w prawym górnym rogu.
  5. Wyświetli się okno "Create an app", w którym należy wprowadzić podstawowe informacje o aplikacji:
    • App name - wprowadź nazwę swojej aplikacji (np. "Nazwa Firmy Chatbot"). Nazwa ta będzie widoczna w panelu administracyjnym, ale nie dla użytkowników końcowych.
    • App contact email - wprowadź adres e-mail, który będzie służył do komunikacji związanej z aplikacją. Zalecamy użycie adresu firmowego, do którego masz regularny dostęp.
  6. Po wprowadzeniu tych informacji kliknij przycisk Next.
Tworzenie aplikacji na Facebook Developers - formularz
Formularz tworzenia nowej aplikacji Facebook Developers
Wskazówka dotycząca nazwy aplikacji: Wybierz nazwę, która jasno identyfikuje cel aplikacji oraz Twoją firmę. Pomoże to w przyszłości łatwo rozpoznać aplikację w panelu deweloperskim, szczególnie jeśli zarządzasz wieloma aplikacjami.
Uwaga: Facebook może ograniczyć liczbę tworzonych aplikacji dla nowych kont deweloperskich. Jeśli napotkasz problemy z utworzeniem nowej aplikacji, możesz potrzebować weryfikacji konta deweloperskiego.

Często napotykane problemy na tym etapie:

Nie widzę przycisku "Create App"

Jeśli nie widzisz przycisku "Create App", możliwe są następujące przyczyny:

  • Nie jesteś zalogowany na swoje konto Facebook
  • Twoje konto nie ma jeszcze statusu konta deweloperskiego
  • Interfejs Facebook Developers mógł ulec zmianie

Rozwiązanie: Upewnij się, że jesteś zalogowany na swoje konto. Jeśli tak, spróbuj odświeżyć stronę. Jeśli problem nadal występuje, poszukaj w interfejsie innej opcji tworzenia aplikacji lub skontaktuj się z naszym wsparciem technicznym.

Otrzymuję błąd podczas tworzenia aplikacji

Jeśli otrzymujesz błąd podczas próby utworzenia aplikacji, możliwe przyczyny to:

  • Na twoim koncie istnieje już aplikacja o tej nazwie
  • Twoje konto deweloperskie wymaga dodatkowej weryfikacji
  • Osiągnąłeś limit tworzenia aplikacji dla swojego konta

Rozwiązanie: Spróbuj użyć innej nazwy aplikacji. Jeśli to nie pomoże, sprawdź, czy Twoje konto wymaga dodatkowej weryfikacji (Facebook zwykle wyświetla odpowiedni komunikat). W razie potrzeby, postępuj zgodnie z instrukcjami weryfikacji konta.

2

Wybór przypadku użycia i typu aplikacji

Po podaniu nazwy aplikacji i adresu e-mail, musisz określić, do czego będzie ona służyć oraz jaki typ aplikacji chcesz stworzyć. To ważny etap, ponieważ wpływa na dostępne funkcje i sposób weryfikacji aplikacji przez Facebook.

Szczegółowa instrukcja:

  1. Po kliknięciu "Next" w poprzednim kroku, zobaczysz stronę z różnymi przypadkami użycia (use cases). Facebook oferuje wiele predefiniowanych szablonów dla różnych typów aplikacji.
  2. Dla integracji chatbota najlepszym wyborem jest opcja Other, która znajduje się na samym dole listy. Ta opcja pozwala na najbardziej elastyczną konfigurację aplikacji.
  3. Po wybraniu opcji "Other" i kliknięciu "Next", zostaniesz poproszony o wybór typu aplikacji.
  4. Wybierz typ aplikacji Firma (Business).
  5. Kliknij "Next", aby przejść do kolejnego etapu.
Wybór przypadku użycia i typu aplikacji
Wybór "Other" jako przypadek użycia aplikacji
Dlaczego wybieramy "Other"? Opcja "Other" daje największą elastyczność w konfigurowaniu aplikacji. Choć Facebook oferuje predefiniowane szablony dla różnych zastosowań, dla chatbota najlepszym rozwiązaniem jest samodzielna konfiguracja wszystkich niezbędnych elementów.
Wskazówka: Typ aplikacji "Firma" (Business) jest najbardziej odpowiedni dla aplikacji komercyjnych. Zapewnia dostęp do funkcji związanych z obsługą klienta, marketingiem i integracją z produktami biznesowymi Facebooka.

Szczegółowy opis typów aplikacji:

Facebook oferuje dwa główne typy aplikacji:

Firma (Business)

Ten typ aplikacji jest przeznaczony dla firm i organizacji, które chcą korzystać z funkcji biznesowych Facebooka, takich jak:

  • Integracja z Facebook Messenger dla obsługi klienta
  • Tworzenie i zarządzanie kampaniami reklamowymi
  • Analiza danych i statystyk biznesowych
  • Dostęp do API Facebooka w celach komercyjnych

Aplikacje biznesowe podlegają weryfikacji przez Facebook, szczególnie jeśli wymagają dostępu do dodatkowych uprawnień lub danych użytkowników.

Konsument (Consumer)

Ten typ aplikacji jest przeznaczony dla aplikacji skierowanych bezpośrednio do użytkowników indywidualnych, takich jak:

  • Gry i aplikacje rozrywkowe
  • Aplikacje społecznościowe
  • Narzędzia personalizacji i aplikacje lifestyle'owe

Aplikacje konsumenckie również mogą podlegać weryfikacji, szczególnie jeśli wymagają dostępu do danych użytkowników lub korzystają z funkcji logowania przez Facebook.

Ten typ nie jest zalecany dla chatbotów biznesowych, ponieważ może ograniczać dostęp do niektórych funkcji Messenger API.

3

Podłączenie portfolio firmowego

Aby aplikacja mogła działać w trybie Live i była dostępna dla wszystkich użytkowników, konieczne jest połączenie jej z portfolio firmowym (Business Manager). Ten krok jest kluczowy dla prawidłowego funkcjonowania chatbota.

Szczegółowa instrukcja:

  1. Po wybraniu typu aplikacji jako "Firma", zostaniesz poproszony o wprowadzenie dodatkowych informacji, w tym o podłączenie portfolio firmowego (Business Manager).
  2. W sekcji Business portfolio znajdziesz listę rozwijaną z dostępnymi portfoliami firmowymi. Jeśli posiadasz już portfolio firmowe na Facebooku, wybierz je z listy.
  3. Jeśli nie masz jeszcze portfolio firmowego, będziesz musiał je utworzyć przed kontynuowaniem. Facebook wyświetli odpowiedni komunikat z linkiem do utworzenia nowego portfolio.
  4. Po wybraniu portfolio firmowego, przejrzyj pozostałe informacje i kliknij przycisk Create App.
  5. Zostaniesz poproszony o potwierdzenie operacji swoim hasłem do Facebooka. Wprowadź hasło i kliknij "Wyślij".
Podłączenie portfolio firmowego
Wybór portfolio firmowego podczas tworzenia aplikacji
Uwaga: Bez podłączenia portfolio firmowego aplikacja będzie działać wyłącznie w trybie deweloperskim, co oznacza, że chatbot będzie dostępny tylko dla administratorów i testerów aplikacji. Jest to niedopuszczalne dla produkcyjnych wdrożeń chatbotów.
Czym jest portfolio firmowe (Business Manager)? Jest to narzędzie Facebooka do zarządzania zasobami biznesowymi, takimi jak strony, konta reklamowe i aplikacje. Portfolio firmowe zapewnia dodatkowy poziom bezpieczeństwa i kontroli, umożliwiając zarządzanie dostępem dla różnych pracowników i partnerów bez konieczności udostępniania haseł do osobistych kont Facebook.

Jak utworzyć portfolio firmowe (Business Manager)?

Instrukcja tworzenia portfolio firmowego

Jeśli nie posiadasz jeszcze portfolio firmowego, możesz je utworzyć wykonując następujące kroki:

  1. Przejdź do https://business.facebook.com/overview
  2. Kliknij przycisk "Utwórz konto"
  3. Wprowadź nazwę firmy, swoje imię i nazwisko oraz służbowy adres e-mail
  4. Podaj szczegóły firmy, takie jak adres, branża i strona internetowa
  5. Po utworzeniu portfolio, możesz dodać do niego strony firmowe, które posiadasz lub zarządzasz
  6. Po utworzeniu portfolio wróć do procesu tworzenia aplikacji i wybierz nowo utworzone portfolio z listy

Ważne: Portfolio firmowe jest niezbędne dla aplikacji biznesowych, które mają działać w środowisku produkcyjnym. Zapewnia ono dodatkowy poziom bezpieczeństwa i umożliwia zarządzanie dostępem dla różnych pracowników.

Problemy z podłączeniem portfolio firmowego

Jeśli masz problemy z podłączeniem portfolio firmowego, sprawdź następujące elementy:

  • Upewnij się, że masz uprawnienia administratora w portfolio firmowym
  • Sprawdź, czy portfolio firmowe zostało w pełni skonfigurowane i zweryfikowane przez Facebook
  • Jeśli portfolio wymaga weryfikacji, postępuj zgodnie z instrukcjami Facebooka, aby ukończyć proces weryfikacji
  • Jeśli nadal występują problemy, spróbuj odświeżyć stronę lub wyczyścić pamięć podręczną przeglądarki

W przypadku utrzymujących się problemów, warto skontaktować się z pomocą techniczną Facebooka lub naszym zespołem wsparcia, aby uzyskać dodatkową pomoc.

4

Dodanie produktu Messenger do aplikacji

Po pomyślnym utworzeniu aplikacji, kolejnym krokiem jest dodanie do niej produktu Facebook Messenger. Ten produkt umożliwi Twojej aplikacji korzystanie z interfejsu API Messengera, co jest niezbędne do integracji chatbota.

Dla osób z istniejącą aplikacją: Jeśli masz już utworzoną aplikację Facebook, ale nie masz jeszcze skonfigurowanego produktu Messenger, ten krok jest Twoim punktem startowym w procesie integracji.

Szczegółowa instrukcja:

  1. Po utworzeniu aplikacji, zostaniesz przekierowany na pulpit nawigacyjny (dashboard) aplikacji. Będzie on zawierał sekcję "Add products to your app" z różnymi produktami Facebook.
  2. Znajdź kafelek Messenger wśród dostępnych produktów.
  3. Kliknij przycisk Set up znajdujący się w kafelku Messenger.
  4. Po dodaniu produktu, w menu bocznym po lewej stronie pojawi się nowa sekcja "Messenger".
  5. Kliknij na tę sekcję, a następnie rozwiń ją za pomocą strzałki znajdującej się obok.
  6. Z rozwiniętej listy wybierz opcję Messenger API Settings, aby przejść do ustawień API Messengera.
Dodanie produktu Messenger do aplikacji
Wybór produktu Messenger z listy dostępnych produktów
Czym jest produkt Facebook? Produkty Facebook to modułowe komponenty, które możesz dodać do swojej aplikacji, aby rozszerzyć jej funkcjonalność. Każdy produkt udostępnia specyficzny zestaw API i narzędzi. Messenger jest produktem, który umożliwia aplikacji komunikację z użytkownikami poprzez platformę Facebook Messenger.

Nawigacja w panelu Facebook Developers

Panel Facebook Developers może czasami wydawać się nieintuicyjny i skomplikowany. Oto kilka wskazówek dotyczących nawigacji:

Struktura menu bocznego

Menu boczne w panelu Facebook Developers jest podzielone na kilka głównych sekcji:

  • Dashboard - główny pulpit nawigacyjny aplikacji
  • App settings - ustawienia ogólne aplikacji, w tym podstawowe informacje, ustawienia zaawansowane i role użytkowników
  • Sekcje produktów - każdy dodany produkt (jak Messenger) ma swoją sekcję w menu
  • Analytics - statystyki i analizy dotyczące wykorzystania aplikacji
  • Alerts - powiadomienia i alerty związane z aplikacją

W przypadku konfiguracji chatbota, będziesz pracować głównie z sekcją Messenger oraz App settings.

Nie widzę sekcji Messenger w menu

Jeśli nie widzisz sekcji Messenger w menu bocznym po dodaniu produktu, spróbuj wykonać następujące kroki:

  1. Odśwież stronę, czasami zmiany w menu nie są natychmiast widoczne
  2. Sprawdź, czy produkt Messenger został poprawnie dodany - wróć do pulpitu nawigacyjnego i upewnij się, że Messenger jest wymieniony wśród produktów
  3. Jeśli nadal nie widzisz sekcji Messenger, wróć do pulpitu i ponownie kliknij "Set up" przy kafelku Messenger
  4. W skrajnych przypadkach może być konieczne wylogowanie się i ponowne zalogowanie do panelu Facebook Developers lub usunięcie i ponowne utworzenie aplikacji o typie "Other"

Dodatkowe ustawienia Messengera

Po przejściu do ustawień API Messengera, zobaczysz różne opcje konfiguracyjne. Na tym etapie, najważniejsza jest sekcja "Generate access tokens", do której przejdziemy w następnym kroku. Pozostałe opcje zostaną skonfigurowane w późniejszych etapach procesu integracji.

5

Generowanie tokenów dostępu

Tokeny dostępu są niezbędne do ustanowienia bezpiecznej komunikacji między platformą Facebook a Twoim chatbotem. W tym kroku połączysz aplikację z Twoją stroną na Facebooku i wygenerujesz token dostępu do strony (Page Access Token).

Szczegółowa instrukcja:

  1. W ustawieniach API Messengera, znajdź sekcję Generate access tokens. Ta sekcja umożliwia połączenie aplikacji z Twoją stroną na Facebooku.
  2. Kliknij przycisk Połącz (lub Add Page), aby rozpocząć proces łączenia strony.
  3. Wyświetli się okno dialogowe dotyczące połączenia kont. Kliknij Kontynuuj, aby przejść dalej.
  4. W kolejnym oknie zostaniesz poproszony o kontynuowanie jako aktualnie zalogowany użytkownik. Kliknij Kontynuuj jako [Twoja nazwa użytkownika].
  5. Następnie zobaczysz listę stron, którymi zarządzasz. Wybierz stronę firmową, którą chcesz połączyć z chatbotem, i kliknij Kontynuuj.
  6. Facebook zapyta o uprawnienia, jakie aplikacja powinna mieć do wybranej strony. W większości przypadków należy pozostawić wszystkie domyślne uprawnienia zaznaczone.
  7. Na końcu kliknij przycisk Zapisz, aby dodać stronę do produktu Messenger.
  8. Po prawidłowym wykonaniu tych kroków, przy sekcji "Generate access token" pojawi się zielony znaczek potwierdzenia, a Twoja strona zostanie wyświetlona poniżej.
  9. Kliknij przycisk Generate obok nazwy Twojej strony, aby wygenerować token dostępu (Page Access Token).
Generowanie tokenów dostępu
Sekcja generowania tokenów dostępu w ustawieniach Messenger API

Po kliknięciu przycisku Generate, zobaczysz okno z wygenerowanym tokenem dostępu do strony. Aby móc skopiować ten token, musisz najpierw zaznaczyć opcję I Understand, potwierdzając, że rozumiesz znaczenie bezpieczeństwa tokenu.

Token dostępu - okno z wygenerowanym tokenem
Okno z wygenerowanym tokenem dostępu do strony
Bezpieczeństwo tokenu: Wygenerowany token dostępu do strony (Page Access Token) jest poufną informacją, która umożliwia dostęp do Twojej strony na Facebooku. Traktuj go jak hasło i nie udostępniaj go osobom nieupoważnionym. Token zostanie wyświetlony tylko raz, dlatego upewnij się, że go skopiujesz i zachowasz w bezpiecznym miejscu.
Wskazówka: Po skopiowaniu tokenu, zapisz go w bezpiecznym miejscu, na przykład w menedżerze haseł lub w zaszyfrowanym pliku. Będzie on potrzebny w późniejszych krokach integracji. Jeśli zgubisz token, zawsze możesz wygenerować nowy, powtarzając opisany proces.

Rozwiązywanie problemów z tokenami

Nie widzę swojej strony na liście

Jeśli nie widzisz swojej strony na liście podczas próby połączenia, możliwe przyczyny to:

  • Nie masz uprawnień administratora do tej strony
  • Strona nie została jeszcze dodana do Twojego portfolio firmowego
  • Jesteś zalogowany na niewłaściwe konto Facebook

Rozwiązanie: Upewnij się, że masz uprawnienia administratora do strony i że jest ona połączona z Twoim portfolio firmowym. Jeśli problem nadal występuje, spróbuj zalogować się na odpowiednie konto lub dodać stronę do swojego portfolio firmowego.

Otrzymuję błąd podczas generowania tokenu

Jeśli otrzymujesz błąd podczas próby wygenerowania tokenu, możliwe przyczyny to:

  • Problemy z połączeniem internetowym
  • Tymczasowe problemy z platformą Facebook Developers
  • Niewystarczające uprawnienia do strony
  • Aplikacja nie ma wymaganych uprawnień do generowania tokenów

Rozwiązanie: Odśwież stronę i spróbuj ponownie. Upewnij się, że Twoja aplikacja ma status "Live" (jeśli nie, może działać w trybie deweloperskim, co ogranicza niektóre funkcje). Sprawdź również, czy masz wszystkie niezbędne uprawnienia do zarządzania stroną.

Token wygasł lub przestał działać

Tokeny dostępu do strony mogą wygasnąć z różnych powodów, takich jak:

  • Zmiana hasła do konta Facebook
  • Rewokacja uprawnień aplikacji
  • Zmiany w ustawieniach bezpieczeństwa Facebooka
  • Naturalne wygaśnięcie tokenu po długim okresie

Rozwiązanie: Jeśli token przestał działać, wygeneruj nowy token, powtarzając opisany proces. Następnie zaktualizuj token w konfiguracji chatbota na naszej platformie.

6

Uzyskanie sekretu aplikacji

Oprócz tokenu dostępu do strony, do pełnej integracji chatbota potrzebny jest również sekret aplikacji (App Secret). Jest to unikalny kod identyfikacyjny, który służy do uwierzytelniania żądań między Twoją aplikacją a platformą Facebook.

Szczegółowa instrukcja:

  1. W panelu Facebook Developers, przejdź do ustawień aplikacji, klikając na zakładkę App settings w menu bocznym po lewej stronie.
  2. Z rozwiniętej listy wybierz opcję Basic, aby przejść do podstawowych ustawień aplikacji.
  3. W sekcji ustawień podstawowych, na górze strony, znajdziesz dwie ważne wartości:
    • App ID - identyfikator aplikacji, który jest widoczny publicznie
    • App secret - sekret aplikacji, który jest ukryty i służy do uwierzytelniania
  4. Obok pola "App secret" znajduje się przycisk Show. Kliknij ten przycisk, aby wyświetlić sekret aplikacji.
  5. Zostaniesz poproszony o potwierdzenie tożsamości poprzez wprowadzenie hasła do swojego konta Facebook. Wprowadź hasło i potwierdź.
  6. Po potwierdzeniu, sekret aplikacji zostanie wyświetlony. Skopiuj go i zachowaj w bezpiecznym miejscu, podobnie jak token dostępu do strony.
Uzyskanie sekretu aplikacji
Podstawowe ustawienia aplikacji z App ID i App Secret
Bezpieczeństwo sekretu aplikacji: App Secret jest bardzo wrażliwą informacją, która powinna być traktowana z najwyższą ostrożnością. Nigdy nie udostępniaj tego sekretu publicznie ani nie umieszczaj go w kodzie, który może być dostępny dla innych osób. Wyciek sekretu aplikacji może prowadzić do nieautoryzowanego dostępu do Twojej aplikacji i danych.
Do czego służy sekret aplikacji? App Secret, wraz z App ID, tworzy parę uwierzytelniającą, która pozwala platformie Facebook zweryfikować, że żądania pochodzą rzeczywiście od Twojej aplikacji. Jest to kluczowy element bezpieczeństwa w komunikacji między aplikacjami a platformą Facebook.

Resetowanie sekretu aplikacji

W przypadku podejrzenia, że sekret aplikacji został skompromitowany, możesz go zresetować:

Jak zresetować sekret aplikacji?

Jeśli potrzebujesz zresetować sekret aplikacji, wykonaj następujące kroki:

  1. Przejdź do podstawowych ustawień aplikacji (App settings > Basic)
  2. W sekcji App Secret, kliknij przycisk "Reset" znajdujący się obok przycisku "Show"
  3. Potwierdź operację, wprowadzając hasło do swojego konta Facebook
  4. Facebook wygeneruje nowy sekret aplikacji, który zastąpi poprzedni
  5. Skopiuj nowy sekret i zaktualizuj go we wszystkich miejscach, gdzie był używany poprzedni

Ważne: Resetowanie sekretu aplikacji spowoduje unieważnienie wszystkich istniejących połączeń i tokenów. Będziesz musiał zaktualizować sekret we wszystkich serwisach, które go używają, w tym w konfiguracji chatbota na naszej platformie.

Konsekwencje resetu sekretu aplikacji

Resetowanie sekretu aplikacji ma kilka istotnych konsekwencji:

  • Wszystkie istniejące tokeny dostępu przestaną działać i będą wymagały ponownego wygenerowania
  • Wszystkie integracje wykorzystujące stary sekret aplikacji przestaną działać
  • Konieczne będzie zaktualizowanie sekretu we wszystkich miejscach, gdzie był on używany
  • Użytkownicy mogą doświadczyć tymczasowych przerw w działaniu usług podczas aktualizacji

Ze względu na te konsekwencje, reset sekretu aplikacji powinien być wykonywany tylko w uzasadnionych przypadkach, takich jak podejrzenie wycieku lub kompromitacji.

7

Konfiguracja chatbota na platformie AI Chatbot

Po uzyskaniu niezbędnych tokenów i sekretów z platformy Facebook Developers, kolejnym krokiem jest konfiguracja chatbota na naszej platformie. W tym kroku połączysz chatbota z Twoją stroną na Facebooku za pomocą wcześniej uzyskanych danych uwierzytelniających.

Dla osób z gotowymi tokenami: Jeśli masz już skonfigurowaną aplikację Facebook z produktem Messenger oraz wygenerowane tokeny dostępu, ten krok jest Twoim punktem startowym w procesie integracji.

Szczegółowa instrukcja:

  1. Zaloguj się na swoje konto na platformie ChatBotAssistant.
  2. Przejdź do sekcji Stwórz Chatbota w panelu nawigacyjnym.
  3. Jako platformę dla chatbota wybierz funkcjonalność Facebook Messenger.
  4. Wypełnij formularz tworzenia chatbota, wprowadzając następujące dane:
    • Nazwa chatbota - wprowadź nazwę, która będzie używana wewnętrznie na naszej platformie
    • Opis - opcjonalnie dodaj krótki opis swojego chatbota lub jego funkcji
    • Informacje o firmie - wprowadź szczegółowe informacje o Twojej firmie, produktach, usługach, cenach, godzinach otwarcia itp. Im więcej informacji podasz, tym lepiej chatbot będzie odpowiadał na pytania klientów. Możesz później edytować informacje o swojej firmie
    • Token dostępu do strony (Page Access Token) - wklej token wygenerowany w kroku 5
    • Sekret aplikacji (App Secret) - wklej sekret aplikacji uzyskany w kroku 6
  5. Kliknij przycisk Utwórz Chatbota, aby zapisać konfigurację.
Konfiguracja chatbota na platformie AI Chatbot
Fragment formularza konfiguracji chatbota dla Facebook Messenger

Po utworzeniu chatbota, system automatycznie przekieruje na panel zarządzania chatbotami i wygeneruje dwie ważne informacje, które będą potrzebne w następnym kroku. Aby je uzyskać kliknij przycisk Edytuj znajdujący się przy nowo utworzonym chatbocie:

  • Token weryfikacyjny (Verify Token) - unikalny kod, który służy do weryfikacji webhooka
  • Adres URL webhooka (Webhook URL) - adres, pod którym Facebook będzie komunikował się z chatbotem
Token weryfikacyjny i adres URL webhooka
Wygenerowany token weryfikacyjny i adres URL webhooka
Co to jest webhook? Webhook to sposób, w jaki Facebook Messenger komunikuje się z Twoim chatbotem. Gdy użytkownik wysyła wiadomość do Twojej strony na Facebooku, Facebook przekazuje tę wiadomość do Twojego chatbota za pośrednictwem webhooka. Token weryfikacyjny służy do potwierdzenia, że webhook jest rzeczywiście powiązany z Twoją aplikacją.
Wskazówka: Skopiuj Token weryfikacyjny i Adres URL webhooka do notatnika lub innego bezpiecznego miejsca. Będą one potrzebne w następnym kroku, gdy będziesz konfigurować webhook na platformie Facebook Developers.

Wskazówki dotyczące pola "Informacje o firmie"

Pamiętaj, że im bardziej szczegółowe i wyczerpujące informacje umieścisz w sekcji Informacje o firmie, tym Twój chatbot będzie mógł udzielać trafniejszych, szybszych i bardziej naturalnych odpowiedzi – dzięki temu zyska na użyteczności i zadowoleniu Twoich użytkowników.

Podstawowe dane firmy

Wprowadź kluczowe informacje, które pozwolą chatbotowi szybko zidentyfikować firmę.

  • Nazwa – pełna i skrócona forma (jeśli istnieje).
  • Rok założenia / krótka historia – kluczowe etapy i przełomowe momenty.
  • Misja / wartości – główne cele i zasady działania.
  • Lokalizacja / obszar działania – adresy, regiony, online vs. stacjonarnie.
  • Godziny otwarcia – dni tygodnia, ewentualne przerwy, wyjątki świąteczne.
  • Kanały kontaktu – telefon, e-mail, czat, social media, formularz WWW.
Opis działalności

Opisz, czym firma się zajmuje, dla kogo pracuje i co ją wyróżnia.

  • Branża i specjalizacja – główne obszary działania (produktowe, usługowe).
  • Grupa docelowa – segmenty klientów, ich potrzeby i oczekiwania.
  • Unikalna propozycja wartości (USP) – co wyróżnia firmę na tle konkurencji.
Oferta produktowa lub usługowa

Przedstaw w czytelny sposób dostępne produkty lub usługi.

  • Kategorie główne – główne linie asortymentowe lub pakiety usług.
  • Podkategorie i przykłady – wybrane produkty/usługi z każdej kategorii.
  • Parametry / warianty – specyfikacje techniczne, rozmiary, kolory, poziomy usług.
  • Orientacyjne ceny – widełki cenowe lub przykładowe cenniki.
Obsługa klienta i logistyka

Opisz procedury realizacji zamówień, wsparcie i polityki zwrotów.

  • Dostawa / realizacja usługi – obszar, czas realizacji, koszty.
  • Profesjonalne usługi dodatkowe – montaż, instalacja, szkolenia.
  • Formy płatności – dostępne metody, ewentualne raty lub leasing.
  • Reklamacje / zwroty / gwarancje – warunki, procedura, terminy.
Styl i ton komunikacji

Sformaluj sposób, w jaki chatbot będzie przekazywał informacje zgodnie z marką.

  • Wybór tonu – formalny, nieformalny, ekspercki, przyjazny.
  • Poziom języka – żargon branżowy vs. potoczny, unikanie niezrozumiałych terminów.
  • Unikalne zwroty – charakterystyczne frazy i slogany marki.
  • Spójność – utrzymanie jednolitego stylu w całym opisie.
8

Konfiguracja webhooka na Facebook Developers

Ostatnim kluczowym etapem integracji jest konfiguracja webhooka w aplikacji Facebook. Webhook umożliwia Facebookowi przesyłanie wiadomości i zdarzeń do Twojego chatbota, co jest niezbędne do jego prawidłowego funkcjonowania.

Szczegółowa instrukcja:

  1. Wróć do panelu Facebook Developers i przejdź do aplikacji, którą konfigurujesz.
  2. W menu bocznym wybierz zakładkę Messenger, a następnie Messenger API Settings.
  3. Przewiń stronę w dół do sekcji Configure Webhooks.
  4. Kliknij przycisk Configure Webhooks lub Add Callback URL, zależnie od interfejsu.
  5. W otwartym formularzu wprowadź następujące dane:
    • Callback URL - wklej adres URL webhooka skopiowany z platformy ChatBotAssistant
    • Verify Token - wklej token weryfikacyjny skopiowany z platformy ChatBotAssistant
  6. Zaznacz opcję messages w sekcji "Subscription Fields". To pole jest kluczowe, ponieważ umożliwia otrzymywanie wiadomości od użytkowników.
  7. Kliknij przycisk Verify and Save, aby zapisać konfigurację i zweryfikować webhook.
Konfiguracja webhooka na Facebook Developers
Formularz konfiguracji webhooka w ustawieniach Messenger API

Po zapisaniu konfiguracji webhooka, powinieneś zobaczyć listę dostępnych pól subskrypcji. Konieczne jest aktywowanie subskrypcji dla wiadomości:

  1. Przewiń listę pól webhooka alfabetycznie w dół, aż znajdziesz pole messages.
  2. Kliknij przełącznik obok tego pola, aby zmienić jego status z Unsubscribed na Subscribed.
Aktywacja subskrypcji messages
Aktywacja subskrypcji dla pola messages

Ostatnim krokiem jest konfiguracja subskrypcji dla strony:

  1. Przewiń stronę w dół do sekcji Generate access tokens.
  2. Znajdź swoją stronę na liście i kliknij przycisk Add Subscriptions obok niej.
  3. W otwartym oknie dialogowym zaznacz pole messages.
  4. Kliknij Confirm, aby zapisać zmiany.
Konfiguracja subskrypcji dla strony
Dodawanie subskrypcji messages dla strony
Ważne: Konfiguracja webhooka jest kluczowym elementem integracji. Jeśli webhook nie zostanie poprawnie skonfigurowany lub zweryfikowany, chatbot nie będzie otrzymywał wiadomości od użytkowników i nie będzie mógł na nie odpowiadać.
Weryfikacja webhooka: Podczas zapisywania konfiguracji, Facebook automatycznie wysyła żądanie weryfikacyjne do podanego adresu URL. Jeśli weryfikacja się powiedzie, zobaczysz zielone potwierdzenie. Jeśli nie, sprawdź, czy adres URL i token weryfikacyjny zostały wprowadzone poprawnie.

Rozwiązywanie problemów z webhookiem

Błąd weryfikacji webhooka

Jeśli otrzymujesz błąd podczas weryfikacji webhooka, możliwe przyczyny to:

  • Niepoprawny adres URL webhooka - upewnij się, że skopiowałeś go dokładnie z platformy AI Chatbot
  • Niepoprawny token weryfikacyjny - sprawdź, czy token został skopiowany bez dodatkowych spacji

Aby rozwiązać te problemy:

  1. Sprawdź dokładnie adres URL i token weryfikacyjny
  2. Spróbuj zresetować token dostępu na platformie Facebook Developers i zaktualizuj go w konfiguracji chatbota
  3. Spróbuj usunąć chatbota na stronie ChatBotAssistant i utworzyć go jeszcze raz
Chatbot nie otrzymuje wiadomości

Jeśli webhook został zweryfikowany, ale chatbot nie otrzymuje wiadomości, możliwe przyczyny to:

  • Brak aktywnej subskrypcji dla pola "messages"
  • Brak subskrypcji dla strony
  • Problemy z uprawnieniami aplikacji
  • Aplikacja jest w trybie deweloperskim

Aby rozwiązać te problemy:

  1. Upewnij się, że pole "messages" jest w stanie "Subscribed" w konfiguracji webhooka
  2. Sprawdź, czy dodałeś subskrypcję "messages" dla swojej strony
  3. Zweryfikuj, czy aplikacja ma wszystkie niezbędne uprawnienia
  4. Upewnij się, że aplikacja jest w trybie live, a nie w trybie deweloperskim

Certyfikat SSL webhooka

Nasza platforma ChatBotAssistant automatycznie zapewnia ważny certyfikat SSL dla wszystkich webhooków, więc jeśli korzystasz z naszego adresu URL, nie powinieneś mieć problemów z certyfikatem SSL.

9

Testowanie integracji

Po skonfigurowaniu wszystkich niezbędnych elementów, czas na przetestowanie integracji i upewnienie się, że chatbot działa zgodnie z oczekiwaniami. Testowanie powinno obejmować weryfikację podstawowych funkcji oraz scenariuszy użycia.

Szczegółowa instrukcja testowania:

  1. Test podstawowej komunikacji:
    • Przejdź do swojej strony na Facebooku
    • Kliknij przycisk "Wyślij wiadomość" lub ikonę Messengera
    • Wyślij prostą wiadomość testową, np. "Cześć"
    • Sprawdź, czy chatbot odpowiada na wiadomość
  2. Test podstawowych funkcji:
    • Wypróbuj różne predefiniowane scenariusze, które skonfigurowałeś w chatbocie
    • Sprawdź, czy chatbot poprawnie rozpoznaje intencje i odpowiada adekwatnie
  3. Test obsługi błędów:
    • Wyślij wiadomość, której chatbot prawdopodobnie nie zrozumie
    • Sprawdź, czy chatbot odpowiada z odpowiednią wiadomością o błędzie lub prośbą o doprecyzowanie
  4. Test w różnych scenariuszach:
    • Przetestuj chatbota zarówno w interfejsie Messengera na komputerze, jak i w aplikacji mobilnej
    • Sprawdź, jak chatbot radzi sobie z dłuższymi konwersacjami
Uwaga: Jeśli Twoja aplikacja Facebook jest w trybie deweloperskim (nie przeszła jeszcze weryfikacji i nie została opublikowana), chatbot będzie dostępny tylko dla administratorów, deweloperów i testerów aplikacji. Inni użytkownicy nie będą mogli wchodzić w interakcję z chatbotem, dopóki aplikacja nie zostanie zweryfikowana i opublikowana.
Wskazówka dotycząca testowania: Warto stworzyć listę kontrolną z różnymi scenariuszami testowymi, aby systematycznie zweryfikować wszystkie funkcje chatbota. Pomoże to wykryć potencjalne problemy przed udostępnieniem chatbota szerszej publiczności.

Monitorowanie i analiza działania chatbota

Po uruchomieniu chatbota, ważne jest monitorowanie jego działania i analizowanie interakcji z użytkownikami:

Analiza rozmów i statystyki

Nasza platforma oferuje rozbudowane narzędzia analityczne, które pozwalają na monitorowanie i optymalizację wydajność chatbota:

  • Statystyki ogólne: całkowita liczba zapytań i sesji, średnia długość konwersacji, średni czas odpowiedzi (z automatycznym porównaniem do poprzedniego okresu)
  • Aktywność użytkowników: interaktywne wykresy (dzień/tydzień/miesiąc) z funkcją przybliżania/oddalania oraz rozkład ruchu według dni tygodnia i godzin
  • Zachowanie użytkowników: długość sesji podzielona na przedziały (1–2, 3–5, 6–10, 10+ wiadomości) oraz współczynnik powrotu
  • Analiza popularnych tematów: Top 5 najczęściej poruszanych zagadnień z procentowym udziałem
  • Sugestie optymalizacyjne: automatycznie generowane rekomendacje na podstawie zgromadzonych danych
  • Eksport danych: możliwość pobrania raportów dla dalszej analizy
Jak uzyskać dostęp do analityki?

Aby uzyskać dostęp do analityki:

  1. Zaloguj się do panelu administracyjnego chatbota
  2. Przejdź do sekcji "Dashboard"
  3. Następnie zjedź w dół do listy twoich chatbotów
  4. Wybierz interesującego Cię chatbota i kliknij przycisk "Analityka"
  5. Przeglądaj szczegółowe dane i statystyki użytkowania Twojego chatbota
10

Weryfikacja aplikacji dla publicznego dostępu

Jeśli chcesz, aby Twój chatbot był dostępny dla wszystkich użytkowników (nie tylko dla administratorów i testerów), Twoja aplikacja Facebook musi przejść proces weryfikacji. Jest to wymagane przez Facebook w celu zapewnienia bezpieczeństwa i zgodności.

Kiedy potrzebna jest weryfikacja aplikacji?

Weryfikacja aplikacji jest wymagana w następujących przypadkach:

  • Chcesz, aby chatbot był dostępny dla wszystkich użytkowników Facebooka, nie tylko dla administratorów i testerów
  • Twoja aplikacja wymaga dostępu do rozszerzonych uprawnień i danych
Informacja: Bez weryfikacji, aplikacja działa w trybie deweloperskim, co oznacza, że chatbot jest dostępny tylko dla osób, które mają rolę administratora, dewelopera lub testera w aplikacji. Dla większości wdrożeń komercyjnych weryfikacja jest niezbędna.

Proces weryfikacji aplikacji:

  1. Przygotowanie aplikacji:
    • Upewnij się, że wszystkie wymagane pola w ustawieniach aplikacji są wypełnione (ikona, opis, kategoria)
    • Zaktualizuj informacje o polityce prywatności i warunkach korzystania z usługi
    • Przygotuj instrukcje dla zespołu weryfikacyjnego Facebooka, opisujące, jak testować Twojego chatbota
  2. Złożenie wniosku o weryfikację:
    • W panelu Facebook Developers, przejdź do sekcji "App Review" w menu bocznym
    • Kliknij przycisk "Request approval" dla uprawnień, które wymagają weryfikacji
    • Wypełnij formularz, podając szczegółowe informacje o Twojej aplikacji i jej zastosowaniu
    • Dołącz zrzuty ekranu i filmy demonstracyjne, pokazujące, jak działa Twój chatbot
  3. Oczekiwanie na weryfikację:
    • Proces weryfikacji może trwać od kilku dni do kilku tygodni, zależnie od złożoności aplikacji
    • Facebook może poprosić o dodatkowe informacje lub wyjaśnienia podczas procesu
    • Bądź gotowy na szybką odpowiedź na pytania zespołu weryfikacyjnego
  4. Po zatwierdzeniu:
    • Po pozytywnej weryfikacji, przełącz aplikację z trybu deweloperskiego na tryb "Live"
    • Upewnij się, że wszystkie konfiguracje są gotowe do działania produkcyjnego
    • Monitoruj działanie chatbota po uruchomieniu, aby szybko reagować na potencjalne problemy

Najczęstsze przyczyny odrzucenia weryfikacji:

Niekompletna dokumentacja

Facebook często odrzuca wnioski o weryfikację, gdy dokumentacja jest niekompletna lub nieprecyzyjna:

  • Brakujące lub niepełne instrukcje testowe
  • Niejasny opis funkcjonalności aplikacji
  • Brak wyjaśnienia, do czego będą wykorzystywane żądane uprawnienia
  • Niedostateczne materiały wizualne (zrzuty ekranu, filmy)

Rozwiązanie: Przygotuj szczegółową dokumentację, zawierającą dokładny opis funkcjonalności chatbota, instrukcje krok po kroku dla testerów oraz wyjaśnienie, dlaczego potrzebujesz konkretnych uprawnień. Dołącz wysokiej jakości zrzuty ekranu i filmy demonstracyjne.

Problemy z polityką prywatności

Nieodpowiednia polityka prywatności jest częstą przyczyną odrzucenia:

  • Brak polityki prywatności lub link do niej nie działa
  • Polityka nie wyjaśnia, jakie dane są zbierane i jak są wykorzystywane
  • Brak informacji o ciasteczkach i innych technologiach śledzących
  • Niedostateczne wyjaśnienie praw użytkowników dotyczących ich danych

Rozwiązanie: Upewnij się, że Twoja polityka prywatności jest kompletna, aktualna i zgodna z wymogami RODO oraz innymi przepisami dotyczącymi ochrony danych. Powinna jasno wyjaśniać, jakie dane zbiera chatbot, jak są one wykorzystywane, przechowywane i zabezpieczane.

Nadmierne żądania uprawnień

Facebook odrzuca wnioski, gdy aplikacja prosi o uprawnienia, które nie są niezbędne do jej funkcjonowania:

  • Żądanie dostępu do danych, które nie są wykorzystywane przez chatbota
  • Prośba o zbyt szeroki zakres uprawnień w stosunku do funkcjonalności
  • Brak uzasadnienia dla potrzeby konkretnych uprawnień

Rozwiązanie: Wnioskuj tylko o te uprawnienia, które są bezwzględnie niezbędne do działania Twojego chatbota. Dla każdego wnioskowanego uprawnienia przygotuj jasne uzasadnienie, wyjaśniające, dlaczego jest ono potrzebne i jak będzie wykorzystywane.

11

Rate Limiting

Rate limiting to mechanizm ograniczający liczbę wiadomości, które użytkownik może wysłać do chatbota przez Facebook Messenger w określonym czasie. Chroni to system przed nadmiernym obciążeniem i zapewnia sprawiedliwe wykorzystanie zasobów.

Jak działa Rate Limiting:

  • Limit per użytkownik: Każdy użytkownik ma swój własny limit (nie dzielony z innymi)
  • Okno czasowe: 60 sekund
  • Reset automatyczny: Licznik resetuje się co minutę
  • Konfigurowalny limit: Każdy użytkownik może mieć różny limit ustawiony przez administratora

Co to oznacza dla użytkowników:

Gdy użytkownik osiągnie swój limit wiadomości w ciągu minuty, chatbot wyświetli mu komunikat informujący o konieczności odczekania przed wysłaniem kolejnej wiadomości. Po upływie minuty od pierwszej wiadomości w danym oknie czasowym, licznik automatycznie się resetuje.

Rate limitng a jakość obsługi: Rate limiting nie wpływa na jakość obsługi użytkowników w normalnym użytkowaniu. Standardowe limity są ustawione na poziomie umożliwiającym naturalne rozmowy, chroniąc jednocześnie przed automatycznymi atakami lub nadmiernym użytkowaniem systemu.

Zwiększenie limitów rate limitingu:

Jeśli standardowe limity rate limitingu nie są wystarczające dla Twojego przypadku użycia (np. w przypadku chatbotów o bardzo wysokim ruchu lub specjalistycznych zastosowań), możesz poprosić o ich zwiększenie.

Jak zwiększyć limity: W celu zwiększenia limitów rate limitingu dla Twojego chatbota, skontaktuj się z administracją strony ChatbotAssistant. W wiadomości opisz swój przypadek użycia, oczekiwany ruch oraz uzasadnienie dla wyższych limitów.
12

Rozwiązywanie problemów

Mimo starannego wykonania wszystkich kroków integracji, czasami mogą pojawić się problemy z działaniem chatbota. W tej sekcji przedstawiamy rozwiązania najczęściej występujących problemów.

Typowe problemy i ich rozwiązania:

Chatbot nie odpowiada na wiadomości

Możliwe przyczyny:

  • Webhook nie jest poprawnie skonfigurowany lub zweryfikowany
  • Brak aktywnej subskrypcji dla pola "messages"
  • Token dostępu do strony wygasł lub jest nieprawidłowy
  • Aplikacja jest w trybie deweloperskim, a użytkownik nie jest testerem
  • Problemy z połączeniem sieciowym

Rozwiązanie:

  1. Sprawdź konfigurację webhooka - upewnij się, że adres URL i token weryfikacyjny są poprawne
  2. Zweryfikuj, czy pole "messages" ma status "Subscribed" zarówno w konfiguracji webhooka, jak i w subskrypcjach strony
  3. Wygeneruj nowy token dostępu do strony i zaktualizuj go w konfiguracji chatbota
  4. Jeśli aplikacja jest w trybie deweloperskim, upewnij się, że testujący użytkownik jest dodany jako tester
Błąd weryfikacji webhooka

Możliwe przyczyny:

  • Niepoprawny adres URL webhooka
  • Niepoprawny token weryfikacyjny

Rozwiązanie:

  1. Upewnij się, że adres URL webhooka jest poprawny i nie zawiera dodatkowych spacji
  2. Sprawdź, czy token weryfikacyjny jest dokładnie taki sam, jak wygenerowany na platformie ChatBotAssistant
  3. Spróbuj zresetować token dostępu na platformie Facebook Developers i zaktualizuj go w konfiguracji chatbota
  4. Spróbuj usunąć chatbota na stronie ChatBotAssistant i utworzyć go jeszcze raz
Chatbot nie rozpoznaje intencji użytkowników

Możliwe przyczyny:

  • Niewystarczająca ilość danych kontekstowych dla modelu AI (Informacji o firmie)
  • Brak obsługi konkretnych scenariuszy w konfiguracji chatbota

Rozwiązanie:

  1. Rozszerz bazę wiedzy chatbota o dodatkowe scenariusze i przykłady pytań
  2. Dodaj więcej synonimów i wariantów fraz do istniejących intencji
  3. Regularnie analizuj i testuj chatbota na podstawie analityki
Aplikacja nie przechodzi weryfikacji Facebooka

Możliwe przyczyny:

  • Niekompletna dokumentacja lub instrukcje testowe
  • Problemy z polityką prywatności
  • Nadmierne żądania uprawnień bez uzasadnienia

Rozwiązanie:

  1. Dokładnie przeczytaj informacje zwrotne od zespołu weryfikacyjnego Facebooka
  2. Przygotuj kompletną i szczegółową dokumentację, zawierającą instrukcje krok po kroku
  3. Upewnij się, że Twoja polityka prywatności jest kompletna i zgodna z wymogami
  4. Wnioskuj tylko o te uprawnienia, które są bezwzględnie niezbędne, i uzasadnij ich potrzebę
Wsparcie techniczne: Jeśli napotkasz problemy, których nie możesz rozwiązać samodzielnie, skontaktuj się z naszym zespołem wsparcia technicznego. Przygotuj szczegółowy opis problemu, zrzuty ekranu błędów oraz ID Twojego chatbota, aby przyspieszyć proces rozwiązywania problemu.
13

Najczęściej zadawane pytania

W tej sekcji znajdziesz odpowiedzi na najczęściej zadawane pytania dotyczące integracji chatbota z Facebook Messenger.

Czy mogę zintegrować chatbota z kilkoma stronami na Facebooku?

Tak, możesz zintegrować chatbota z wieloma stronami na Facebooku. Istnieją dwa podejścia:

  1. Jedna aplikacja Facebook, wiele stron:
    • W sekcji "Generate access tokens" możesz dodać wiele stron do jednej aplikacji
    • Dla każdej strony musisz wygenerować oddzielny token dostępu
    • Na naszej platformie utwórz oddzielnego chatbota dla każdej strony, używając odpowiedniego tokenu
    • Ta metoda jest zalecana, gdy chatboty mają podobną funkcjonalność
  2. Wiele aplikacji Facebook:
    • Utwórz oddzielną aplikację Facebook dla każdej strony
    • Wykonaj pełny proces integracji dla każdej aplikacji
    • Ta metoda daje większą elastyczność i izolację, ale wymaga więcej pracy administracyjnej
    • Jest zalecana, gdy chatboty mają znacząco różną funkcjonalność lub wymagają różnych uprawnień

Wybór metody zależy od Twoich konkretnych potrzeb i struktury organizacyjnej.

Jak często wygasają tokeny dostępu i jak je odnawiać?

Tokeny dostępu do strony (Page Access Tokens) mogą wygasać z różnych powodów:

  • Standardowe tokeny: Tokeny wygenerowane bezpośrednio z interfejsu Facebook Developers mogą wygasać po około 60 dniach
  • Tokeny długoterminowe: Tokeny wygenerowane z użyciem odpowiedniego procesu mogą być ważne znacznie dłużej, nawet do kilku lat
  • Zdarzenia wymuszające wygaśnięcie: Zmiana hasła administratora, rewokacja uprawnień aplikacji lub zmiany w konfiguracji bezpieczeństwa mogą spowodować wcześniejsze wygaśnięcie tokenu

Jak odnawiać tokeny:

  1. Monitoruj działanie chatbota - jeśli przestanie odpowiadać, może to oznaczać wygaśnięcie tokenu
  2. W panelu Facebook Developers, przejdź do ustawień Messenger API i wygeneruj nowy token dostępu
  3. Zaktualizuj token w konfiguracji chatbota na naszej platformie
  4. Testuj chatbota po aktualizacji tokenu, aby upewnić się, że działa poprawnie
Czy mogę personalizować wygląd chatbota na Messengerze?

Facebook Messenger oferuje ograniczone możliwości personalizacji wizualnej chatbota:

  • Ikona profilowa: Możesz dostosować ikonę profilową chatbota, zmieniając zdjęcie profilowe Twojej strony na Facebooku
  • Nazwa chatbota: Nazwa chatbota będzie taka sama jak nazwa Twojej strony na Facebooku
Jak mogę monitorować interakcje użytkowników z chatbotem?

Istnieje kilka sposobów monitorowania interakcji użytkowników z chatbotem:

  1. Panel analityczny na platformie ChatBotAssistant:
    • Statystyki ogólne: całkowita liczba zapytań i sesji, średnia długość konwersacji, średni czas odpowiedzi (z automatycznym porównaniem do poprzedniego okresu)
    • Aktywność użytkowników: interaktywne wykresy (dzień/tydzień/miesiąc) z funkcją przybliżania/oddalania oraz rozkład ruchu według dni tygodnia i godzin
    • Zachowanie użytkowników: długość sesji podzielona na przedziały (1–2, 3–5, 6–10, 10+ wiadomości) oraz współczynnik powrotu
    • Analiza popularnych tematów: Top 5 najczęściej poruszanych zagadnień z procentowym udziałem
    • Sugestie optymalizacyjne: automatycznie generowane rekomendacje na podstawie zgromadzonych danych
    • Eksport danych: możliwość pobrania raportów dla dalszej analizy
  2. Facebook Page Insights:
    • Łączna liczba wiadomości wysłanych do Twojej strony
    • Dane demograficzne użytkowników korzystających z Messengera
    • Czasy odpowiedzi i wskaźniki zaangażowania
  3. Eksport i analiza danych:
    • Nasza platforma umożliwia eksport danych rozmów do formatów CSV lub JSON
    • Możesz analizować te dane przy użyciu zewnętrznych narzędzi analitycznych
    • Pozwala to na tworzenie niestandardowych raportów i dogłębną analizę

Regularne monitorowanie i analiza tych danych pomogą Ci optymalizować chatbota i lepiej dostosować go do potrzeb użytkowników.