messenger

Skill do obsługi Facebook Messenger Platform przez bezpośrednie żądania HTTPS. Zawiera przewodniki po konfiguracji aplikacji, walidacji webhooków, wysyłaniu wiadomości i zarządzaniu skrzynką Page'a. Przeznaczony dla developerów, którzy preferują pracę z API zamiast SDK i chcą zbudować bota lub automatyzację na Messengerze. Obejmuje szablony żądań, mapy zdarzeń i wzorce UX rozmów.

1. Przygotuj dane dostępowe: zbierz Facebook App ID, App Secret, Page ID, Page access token oraz URL webhooka i verify token z ustawień aplikacji na Facebooku.

2. Zapoznaj się z dokumentacją referencyjną skill'a — przeczytaj messenger-api-overview.md, aby zrozumieć bazowe adresy URL i strukturę obiektów, a następnie webhooks.md dla procedury weryfikacji i walidacji podpisów.

3. Skonfiguruj webhook: ustaw URL webhooka w ustawieniach aplikacji, wdrażaj logikę weryfikacji tokenu verify token i waliduj podpisy wszystkich przychodzących zdarzeń.

4. Przygotuj przepływ wiadomości — korzystając z szablonów w request-templates.md, zdefiniuj typy wiadomości, które będzie wysyłać bot (tekst, przyciski, menu), i zaplanuj odpowiedzi na zdarzenia z webhook-event-map.md.

5. Wdrażaj bezpieczne operacje: nigdy nie loguj tokenów ani sekretów aplikacji, stosuj uprawnienia z najmniejszym dostępem, obsługuj limity szybkości z backoff'em i wysyłaj potwierdzenia wiadomości szybko.

6. Testuj przepływ end-to-end — wyślij testową wiadomość przez Page'a, sprawdź, czy webhook odbiera zdarzenia, i zweryfikuj, że bot odpowiada zgodnie z zdefiniowanymi wzorcami rozmów z conversation-patterns.md.