Co daje ta integracja
Wiadomości z Facebook Messengera, Instagram DM oraz komentarze pod postami na stronie FB trafiają jako tickety do Twojego Helpdesku. Agent odpowiada w tickecie tak samo jak na każdym innym kanale, a odpowiedź wraca do klienta - na Messenger, Instagram lub pod komentarz na Facebooku.
Każda strona FB jest podłączona do wybranego desku Helpdesku, dzięki czemu możesz rozdzielić obsługę sprzedaży, supportu i marketingu na różne zespoły.
Co potrzebujesz
- Konto Facebook z rolą administratora strony firmowej
- Dla Instagrama: konto Instagram Business połączone ze stroną FB (osobiste i Creator nie zadziałają)
- Co najmniej jeden desk w Helpdesku, do którego mają trafiać tickety
Instalacja
- Wejdź w Aplikacje w menu konta (
/account/apps) - Znajdź kafelek Integracja z Meta i kliknij Zainstaluj
- Otwórz zainstalowaną aplikację - dalsza konfiguracja toczy się w niej
Konfiguracja krok po kroku
1. Utwórz konektor
W oknie aplikacji kliknij Konfiguruj integrację z Meta. Pola App ID i App Secret zostaw puste - domyślnie używamy globalnych poświadczeń Intum. Własne wpisuj tylko jeśli korzystasz z dedykowanej aplikacji Meta.
Po utworzeniu konektora system od razu włącza webhook zwrotny. To znaczy, że odpowiedzi agentów będą same lecieć do klienta - nic więcej nie musisz konfigurować po stronie Intum.
2. Webhooki w Meta App Dashboard
W Meta App Dashboard otwórz swoją aplikację i przejdź do sekcji Webhooks. Dodaj dwie subskrypcje:
Facebook Page:
- Callback URL: skopiuj z aplikacji w Intum (przycisk Kopiuj obok URL-a)
- Eventy:
messages(wiadomości Messenger) ifeed(komentarze pod postami)
Instagram:
- Callback URL: drugi URL z aplikacji w Intum
- Event:
messages
Verify token generujemy automatycznie podczas podłączania strony przez OAuth - zobaczysz go w panelu Meta po pierwszym połączeniu.
3. Podłącz strony FB
W sekcji Połącz stronę FB z deskiem wybierz desk Helpdesku i kliknij Połącz stronę FB. Wylądujesz na Facebooku:
- Wybierz stronę firmową, którą chcesz podłączyć
- Nadaj uprawnienia (czytanie wiadomości, odpowiadanie, zarządzanie komentarzami)
- Po powrocie zobaczysz potwierdzenie i strona pojawi się na liście
Powtórz dla każdej strony, którą chcesz podpiąć. Schemat jest prosty: jedna strona FB = jeden desk Helpdesku.
Jak to działa w praktyce
Klient pisze na Messengerze do Twojej strony FB. Po stronie Intum tworzy się nowy ticket w desku przypisanym do tej strony. Imię i nazwisko klienta bierzemy z profilu FB.
Agent odpowiada w tickecie - normalnie, w polu komentarza. Treść od razu leci do klienta jako wiadomość Messenger. Tak samo z Instagramem.
Komentarze pod postami FB działają trochę inaczej. Cały wątek komentarza (główny komentarz plus odpowiedzi) staje się jednym ticketem. Gdy agent odpowie, odpowiedź pojawia się jako reply pod tym komentarzem na FB.
Załączniki (obrazki, pliki) z Messengera trafiają jako załączniki ticketu. Obrazy z komentarzy FB przekazujemy jako załączniki obrazu w odpowiedzi.
Częste problemy
Nie widać przycisku Połącz stronę FB - najpierw musisz utworzyć desk w Helpdesku. Wróć do ustawień Helpdesku i dodaj choć jeden.
Po OAuth nic się nie podłączyło - sprawdź czy Twoje konto FB ma rolę administratora strony. Bez tego Facebook nie pozwoli wygenerować tokenów dostępu dla strony.
Wiadomości z Instagrama nie przychodzą - konto Instagram musi być typu Business i połączone ze stroną FB. Konta osobiste i Creator nie wystawiają wiadomości w API Mety.
Komentarze pojawiają się jako tickety, a chcę tylko DM-y - obie funkcje są włączone razem przy subskrypcji webhooka. Jeśli chcesz wyłączyć komentarze, w Meta App Dashboard usuń subskrypcję feed zostawiając samo messages.
Webhook nie weryfikuje się przy zapisywaniu w Meta - Meta wywołuje GET na callback URL z parametrem hub.verify_token. Verify token jest generowany przy pierwszym OAuth, więc kolejność jest taka: najpierw zapisz subskrypcję z dowolnym tokenem (Meta zwróci błąd weryfikacji), potem zrób OAuth strony, potem wróć do Meta i wpisz token wygenerowany dla tej strony.
Usuwanie integracji
W aplikacji w Intum, w widoku szczegółów konektora, kliknij Usuń integrację. To zrobi:
- Skasuje webhook zwrotny (agenci przestaną wysyłać odpowiedzi na Messengera/Instagrama/FB)
- Usunie konektor wraz z konfiguracją podłączonych stron
- Zostawi nietknięte tickety w Helpdesku - tylko przestają być powiązane z Metą
Uwaga: subskrypcje webhooków w Meta App Dashboard nie kasują się automatycznie. Jeśli już nie planujesz używać integracji, usuń je ręcznie w panelu Meta, żeby nie próbowały wysyłać payloadów na martwy URL.