Podłączenie leadów z Facebooka/Instagrama do voxCRM przy pomocy Facebook Leads API

Niniejsza instrukcja pokazuje, jak odszukać dane potrzebne do połączenia formularzy kontaktowych Facebooka i Instagrama (Lead Ads) z systemem voxCRM. Wystarczy zebrać cztery dane i przesłać je do naszego działu wsparcia - my konfigurujemy połączenie w ustawieniach systemu, a integracja zaczyna pobierać zgłoszenia (leady). Nie trzeba niczego instalować ani znać się na programowaniu; wszystkie kroki wykonuje się w panelu Facebooka (https://business.facebook.com/business/loginpage), a całość zajmuje około 15 minut.

Spis treści

1. Czego potrzebujemy
2. Nazwa połączenia
3. Page ID - identyfikator strony
4. Page Access Token - dostęp do listy formularzy
   4.1 Przedłużanie ważności Page Access Token
5. System User Token - pobieranie leadów
   1. Otwarcie listy użytkowników systemowych
   2. Jednorazowa akceptacja zasad
   3. Utworzenie użytkownika systemowego
   4. Przypisanie aplikacji i strony
   5. Wygenerowanie tokenu
   6. Zaznaczenie uprawnień
   7. Skopiowanie tokenu
6. Przekazanie danych do działu wsparcia
7. Wskazówki i bezpieczeństwo
8. Kontakt

1. Czego potrzebujemy

Do skonfigurowania integracji potrzebne są cztery dane. Poniższa tabela pokazuje, do czego służy każda z nich.

Poniższe dane można uzyskać logując się do Państwa panelu Facebook - https://business.facebook.com/business/loginpage

2. Nazwa połączenia

To dowolna, wymyślona etykieta - służy tylko do rozpoznania tego połączenia w naszym systemie.

Przykłady: „Facebook - Osiedle Słoneczne” albo „Lead Ads - strona firmowa”. Prosimy po prostu o podanie nazwy, która będzie czytelna i łatwa do rozpoznania.

3. Page ID - identyfikator strony

To numer identyfikacyjny strony na Facebooku. Aby go znaleźć, należy:

1. Wejść na stronę https://business.facebook.com/latest/settings (Ustawienia).

   

2. W menu po lewej stronie wybrać Konta, a następnie Strony.
3. Kliknąć swoją stronę - jej identyfikator (Identyfikator strony / Page ID, ciąg cyfr) wyświetli się pod nazwą. Ten numer należy skopiować.

   

4. Page Access Token - dostęp do listy formularzy

Ten token pozwala nam odczytać listę formularzy kontaktowych. Musi to być token typu „Strona” (Page). Generuje się go w narzędziu Meta dla programistów. (Instrukcja utworzenia konta, jeśli nie istnieje - Utworzenie aplikacji Meta i tokenu dostępu do importu leadów w voxCRM)

1. Wejść na stronę https://developers.facebook.com/tools/explorer/
2. W polu Meta App, wybrać swoją aplikację.
3. Rozwinąć User or Page, kliknąć Get User Access Token i zaznaczyć poniższy zestaw uprawnień (uprawnienie leads_retrieval znajduje się w sekcji Other),
   pages_show_list

   pages_read_engagement

   pages_manage_metadata

   pages_manage_ads

   leads_retrieval

   business_management

   ads_read
4. Kliknąć Generate Access Token - zalogować się i zatwierdzić.
5. Rozwinąć ponownie User or Page i w sekcji Page Access Tokens kliknąć swoją Stronę.
6. W polu Access Token pojawi się token Strony - należy go skopiować. To jest właśnie Page Access Token.

4.1 Przedłużanie ważności Page Access Token

Wygenerowany w ten sposób Page Access Token ma zwykle krótki termin ważności - może wygasnąć już po godzinie. Dlatego przed przesłaniem go do nas warto przedłużyć jego ważność. Robi się to w narzędziu Access Token Debugger:

1. Wejść na stronę https://developers.facebook.com/apps/ - panel, w którym utworzono aplikację - i w górnym menu Tools (Narzędzia) wybrać Access Token Debugger.
   
   
2. W pole wkleić wygenerowany wcześniej token i kliknąć Debug
   
   
   
   
3. Wyświetlą się informacje o tokenie. Warto sprawdzić, czy w polu Type widnieje Page (token jest połączony ze Stroną, z której pobierane są formularze), czy Page ID wskazuje właściwą stronę oraz czy na liście uprawnień (Scopes) znajduje się leads_retrieval. W polu Expires widać, za ile token wygaśnie.
   
   
4. Zjechać na dół strony i kliknąć przycisk Extend Access Token.
   
   
5. Facebook poprosi o ponowne wpisanie hasła Państwa konta Meta - po jego podaniu wyświetli się nowy token o znacznie dłuższej ważności.
   
   
6. Nowy token należy skopiować i przesłać do naszego działu wsparcia - to jest właśnie Page Access Token o przedłużonej ważności.
   

5. System User Token - pobieranie leadów

Ten token pozwala pobierać zgłoszenia (leady) z formularzy - jest potrzebny na wypadek, gdyby wcześniejszy token nie miał wymaganych uprawnień. Generuje się go przez Użytkownika systemowego w Menedżerze firmy. Tak utworzony token nie wygasa - całą operację wykonuje się tylko raz.

Krok 5.1 - Otwarcie listy użytkowników systemowych

W Menedżerze firmy: Ustawienia → Użytkownicy → Użytkownicy systemowi (bezpośredni adres: https://business.facebook.com/settings/system-users).

Krok 5.2 - Jednorazowa akceptacja zasad

Przy pierwszym wejściu Facebook poprosi o akceptację Zasad przeciwdziałania dyskryminacji. To jednorazowa formalność - wystarczy kliknąć Akceptuję.

Krok 5.3 - Utworzenie użytkownika systemowego (jeśli nie istnieje)

Jeśli na liście jest już użytkownik systemowy - można go użyć i przejść od razu do kroku 5.4. Jeśli nie, należy:

1. Kliknąć + Dodaj w prawym górnym rogu.
2. Wpisać dowolną nazwę (np. voxCRM Lead Ads).
3. Wybrać rolę: Admin.
4. Kliknąć Utwórz użytkownika systemowego.

Krok 5.4 - Przypisanie aplikacji i strony do użytkownika

W szczegółach użytkownika należy kliknąć Przypisz zasoby. Należy przypisać DWA zasoby, oba z opcją Pełna kontrola:

• Aplikacje - zaznaczyć swoją aplikację.
• Strony - zaznaczyć swoją stronę (włączyć dostęp do leadów / Zarządzanie leadami).

Następnie kliknąć Przypisz zasoby.

Krok 5.5 - Wygenerowanie tokenu

W prawym górnym rogu szczegółów użytkownika należy kliknąć Wygeneruj token.

Krok 5.6 - Zaznaczenie uprawnień

W oknie generowania tokenu należy ustawić Wygasanie: Nigdy i zaznaczyć cały poniższy zestaw uprawnień:

Krok 5.7 - Skopiowanie tokenu

Facebook pokaże token tylko raz. Należy kliknąć Kopiuj i zapisać go w bezpiecznym miejscu.

6. Przekazanie danych do działu wsparcia

Zebrane dane prosimy przesłać na adres naszego działu wsparcia w jednej wiadomości, w poniższym formacie:

7. Wskazówki i bezpieczeństwo

• Potrzebne są OBA tokeny: Page Access Token do odczytu listy formularzy, System User Token do pobierania z nich leadów.
• Kompletne przypisanie zasobów: przy Użytkowniku systemowym należy przypisać zarówno Aplikację, jak i Stronę (krok 5.4) oraz zaznaczyć komplet uprawnień, zwłaszcza leads_retrieval.
• Ważność tokenów: System User Token nie wygasa. Page Access Token bywa ważny przez ograniczony czas - jeśli synchronizacja formularzy przestanie działać, prosimy o przesłanie nowego.
• Token jak hasło: tokenu nie należy udostępniać w miejscach publicznych. Wysyłka do naszego działu wsparcia jest bezpieczna.
• Właściwa firma i strona: w prawym górnym rogu paneli Facebooka warto upewnić się, że wybrana jest właściwa firma i strona, a nie konto prywatne.
• Nie usuwać aplikacji ani użytkownika systemowego w Mecie - integracja korzysta z nich na bieżąco.

8. Kontakt

W razie pytań lub problemów prosimy o kontakt z działem wsparcia:

• E-mail: kontakt@voxcommerce.pl
• Telefon: 534 571 638