Facebook i Instagram: katalog Meta, token użytkownika systemowego i synchronizacja

Do czego to służy

Konektor Facebook/Instagram obsługuje katalog produktów Meta (Commerce Manager) przez Graph API. Facebook i Instagram korzystają z tego samego katalogu, więc jeden kanał obejmuje oba. Konektor pobiera listę produktów do zmapowania oraz wysyła stany i ceny.

Czego konektor nie robi: nie pobiera zamówień. Meta wygasiła zakupy w aplikacji, w Polsce checkout nigdy nie działał, a API zarządzania zamówieniami Commerce jest blokowane od wersji Graph API v26.0. Klienci kupują na Twojej stronie, więc zamówienia przyjmuje sklep (podłącz go osobnym kanałem), a katalog Meta służy reklamom i widoczności produktów. Konektor nie tworzy też ani nie usuwa produktów w katalogu.

Gdzie to znaleźć w aplikacji

Sprzedaż i logistyka, „Kanały sprzedaży”, „Dodaj kanał sprzedaży”, rodzaj „Facebook (Katalog)”, a w kanale zakładka „Połączenie”. Pola konektora: „Token użytkownika systemowego” i „Id katalogu”.

Aplikacja oznacza ten rodzaj kanału jako „W przygotowaniu”: zakładka „Połączenie” pokazuje na razie uproszczony szkic formularza (z mniejszą liczbą pól i innymi nazwami), a przycisków „Sprawdź połączenie” i „Start” jeszcze w niej nie ma. Klucze zapisane w tym szkicu mogą nie trafić do pól konektora, więc po udostępnieniu pełnego ekranu wpisz je ponownie.

Skąd wziąć klucze

1. W Meta for Developers (developers.facebook.com) utwórz aplikację typu Biznes i połącz ją ze swoim Business Managerem (Ustawienia firmy, Konta, Aplikacje).
2. W Business Managerze wejdź w Ustawienia firmy, Użytkownicy, Użytkownicy systemowi, dodaj użytkownika systemowego (rola Admin) i przypisz mu swój katalog z pełną kontrolą.
3. Kliknij „Wygeneruj token”, wybierz swoją aplikację i zaznacz uprawnienia catalog_management oraz business_management. Skopiuj token: pokazuje się tylko raz.
4. Id katalogu znajdziesz w Commerce Managerze (Katalog, Ustawienia) albo w Ustawieniach firmy, Źródła danych, Katalogi.
5. Wklej token i id katalogu w zakładce „Połączenie” i użyj „Sprawdź połączenie”. Produkty w katalogu muszą mieć id (retailer_id) zgodne z SKU w Zaksio, inaczej mapowanie nie zadziała.

Dokumentacja wsadów katalogu: developers.facebook.com/docs/marketing-api/catalog-batch. Nazwy w panelach Meta zmieniają się często.

Co synchronizuje

• Oferty: lista produktów katalogu do zmapowania po retailer_id (zwykle SKU), odświeżana co dobę.
• Stany: dostępność (in stock albo out of stock) i ilość. Wysyłanie ilości wyłączysz ustawieniem kanału „sendQuantity” ustawionym na false.
• Ceny: cena brutto w formacie „12.34 PLN”. Meta wymaga zgodności z ceną na stronie sklepu, więc zmieniaj ją w obu miejscach spójnie.
• Technika: wsady po 1000 pozycji, wynik każdego sprawdzany osobnym zapytaniem. Gdy Meta przekroczy limit (kody 80014 i 80009), czekamy i ponawiamy.

Czego jeszcze nie ma

• Ekranu połączenia dla tej platformy w aplikacji: backend konektora istnieje i jest przetestowany na atrapach serwera, ale interfejs jest w przygotowaniu (patrz wyżej).
• Pewności co do feedu: jeśli katalog jest zasilany też cyklicznym feedem, kolejny import może nadpisać zmiany ze Zaksio. Meta nie opisuje pierwszeństwa feedu i wsadu.
• Automatycznego odnowienia tokenu: po jego unieważnieniu (zmiana uprawnień, usunięcie aplikacji) kanał pokaże błąd autoryzacji i trzeba wpisać nowy token.
• Tworzenia produktów, zwrotów, przesyłek i webhooków.
• Weryfikacji na żywym koncie: niepewne są m.in. format ceny przy odczycie, statusy wsadu i wersja Graph API (domyślnie v25.0, zmienia ją ustawienie „graphVersion”). Nie wiemy też, czy Meta wymaga przeglądu aplikacji (App Review) przy dostępie tylko do własnych zasobów.