Do połączenia voxCRM z formularzami kontaktowymi Facebooka i Instagrama (Lead Ads) potrzebny jest token dostępu. Facebook pozwala wygenerować taki token wyłącznie wtedy, gdy firma posiada własną aplikację w panelu Meta dla programistów. Niniejsza instrukcja przedstawia krok po kroku, jak taką aplikację utworzyć i jak wygenerować token.
Pozostałe dane potrzebne do uruchomienia integracji (m.in. identyfikator strony) oraz sposób ich przekazania do naszego działu wsparcia opisuje osobna instrukcja: „Podłączenie leadów z Facebooka/Instagrama do voxCRM przy pomocy Facebook Leads API”.
Spis treści
- Konto w Meta dla programistów (jednorazowo)
- Utworzenie aplikacji
- Utworzenie użytkownika systemowego
- Przypisanie osób i zasobów do aplikacji
- Wygenerowanie tokenu
- Kontakt
1. Konto w Meta dla programistów (jednorazowo)
Aplikację tworzy się w panelu Meta dla programistów (Meta for Developers). Przy pierwszym wejściu Meta poprosi o dokończenie krótkiej rejestracji konta dewelopera:
- Wejść na poniższą stronę i zalogować się tym kontem na Facebooku, które ma dostęp do firmy (Menedżera firmy) i strony firmowej.
Sposób logowania zależy od modelu, w jakim firma korzysta ze swojego konta business.facebook.com:
- Kliknąć Get Started / Rozpocznij i przejść krótki kreator rejestracji: akceptacja regulaminu, weryfikacja numerem telefonu (kod SMS), potwierdzenie adresu e-mail i wybór roli.
- Po rejestracji pojawi się pulpit Apps (Moje aplikacje) — na początku pusty:
2. Utworzenie aplikacji
Kreator tworzenia aplikacji ma pięć kroków widocznych na pasku u góry: App details, Use cases, Business, Requirements i Overview. Przechodzi się je po kolei.
Krok 2.1 — Rozpoczęcie
Na pulpicie Apps należy kliknąć zielony przycisk Create App / Utwórz aplikację (widoczny na zrzucie ekranu na końcu sekcji 1). Jeśli pojawi się ekran powitalny z informacją o nowym kreatorze, wystarczy kliknąć Create app.
Krok 2.2 — App details (dane aplikacji)
W pierwszym kroku kreatora uzupełnia się podstawowe dane aplikacji:
| Pole | Sposób uzupełnienia |
| App name | Wpisać nazwę aplikacji, np. „voxCRM Integracja”. |
| App contact email | Sprawdzić adres e-mail (Meta podstawia adres z profilu). |
Po uzupełnieniu danych należy kliknąć Next.
Krok 2.3 — Use cases (zastosowania)
- W filtrze po lewej stronie kliknąć Ads and monetization.
- Zaznaczyć zastosowanie Capture & manage ad leads with Marketing API (pozyskiwanie i obsługa leadów z reklam).
- Kliknąć Next.
Krok 2.4 — Business (portfolio firmowe)
Meta zapyta, z którym portfolio firmowym połączyć aplikację. Należy zaznaczyć swoją firmę (Menedżera firmy, w którym jest strona na Facebooku) i kliknąć Next.
Krok 2.5 — Requirements (wymagania)
Meta wyświetli listę ewentualnych wymagań formalnych. Na tym etapie nie trzeba nic uzupełniać — wystarczy kliknąć Next.
Krok 2.6 — Overview (podsumowanie)
Należy sprawdzić, czy nazwa i e-mail się zgadzają, a w sekcji Business widnieje właściwa firma, po czym kliknąć Create app. Meta może w tym momencie poprosić o ponowne wpisanie hasła do Facebooka — to standardowe zabezpieczenie.
Krok 2.7 — Gotowe
Po utworzeniu aplikacji otworzy się jej pulpit (Dashboard) z sekcją App customization and requirements i dodanym zastosowaniem Capture & manage ad leads with Marketing API.
W tym miejscu należy sprawdzić, czy aplikacja ma dodane i włączone wszystkie możliwe uprawnienia — gdyby któreś były wyłączone, można je włączyć, klikając Add.
3. Utworzenie użytkownika systemowego
Token generuje się dla użytkownika systemowego w Menedżerze firmy.
Krok 3.1 — Otwarcie listy użytkowników systemowych
W Menedżerze firmy należy przejść do: Ustawienia → Użytkownicy → Użytkownicy systemowi. Bezpośredni adres:
Krok 3.2 — Jednorazowa akceptacja zasad
Przy pierwszym wejściu Facebook poprosi o akceptację Zasad przeciwdziałania dyskryminacji. To jednorazowa formalność — wystarczy kliknąć Akceptuję.
Krok 3.3 — Utworzenie użytkownika systemowego (jeśli nie istnieje)
Jeśli użytkownika systemowego jeszcze nie ma, należy:
- Kliknąć + Dodaj w prawym górnym rogu.
- Wpisać dowolną nazwę (np. „voxCRM Lead Ads”).
- Wybrać rolę: Admin.
- Kliknąć Utwórz użytkownika systemowego.
4. Przypisanie osób i zasobów do aplikacji
Utworzoną aplikację trzeba teraz powiązać z osobami i zasobami firmy. W Ustawieniach firmy należy wybrać w menu po lewej: Konta → Aplikacje, a następnie kliknąć swoją aplikację na liście. Bezpośredni adres Ustawień firmy:
Krok 4.1 — Przypisanie osób
- Kliknąć Przypisz osoby.
- Dodać siebie (administratora firmy) oraz użytkownika systemowego z sekcji 3.
- Obu osobom nadać pełne uprawnienia (Pełny dostęp / Zarządzaj aplikacją).
- Zatwierdzić.
Krok 4.2 — Połączenie zasobów
- Kliknąć Połączone zasoby.
- W oknie „Co chcesz połączyć?” wybrać Inne zasoby firmowe i połączyć z aplikacją zasoby, z których korzystają reklamy (np. konto reklamowe).
5. Wygenerowanie tokenu
Token generuje się z poziomu profilu użytkownika systemowego utworzonego w sekcji 3 — wbudowany kreator Facebooka prowadzi przez cały proces.
Krok 5.1 — Przycisk „Wygeneruj token”
Należy wrócić do listy użytkowników systemowych (Ustawienia → Użytkownicy → Użytkownicy systemowi), wybrać użytkownika z sekcji 3 i w prawym górnym rogu kliknąć Wygeneruj token.
Krok 5.2 — Zaznaczenie uprawnień
Kreator tokenu prowadzi przez cztery kroki: Wybierz aplikację → Ustaw datę wygaśnięcia → Przypisz uprawnienia → Gotowe. W kreatorze należy ustawić:
| Ustawienie | Wartość |
| Aplikacja | Aplikacja utworzona w sekcji 2 |
| Wygasanie | Nigdy |
| Uprawnienia | Wszystkie uprawnienia dostępne na liście |
Krok 5.3 — Skopiowanie tokenu
Facebook pokaże token tylko raz. Należy kliknąć Kopiuj i zapisać token w bezpiecznym miejscu.
6. Kontakt
W razie pytań lub problemów prosimy o kontakt z działem wsparcia:
- E-mail: kontakt@voxcommerce.pl
- Telefon: 534 571 638
