Szekla4x4-Telegram — informacje o aplikacji
Strona informacyjna aplikacji korzystającej z Allegro REST API. Spełnia wymóg art. 3.4(c) Regulaminu REST API Allegro dotyczący wiarygodnej i jednoznacznej identyfikacji oprogramowania.
| Nazwa aplikacji | Szekla4x4-Telegram |
| Aktualna wersja | 1.0.0 |
| Nagłówek User-Agent | Szekla4x4-Telegram/1.0.0 (+https://szekla4x4.pl/content/aplikacja-szekla4x4-telegram) |
| Właściciel | Szekla4x4.pl Damian Łaga |
| Konto Allegro | Szekla4x4_pl |
| Kontakt techniczny | biuro (małpa) szekla4x4.pl |
| Charakter aplikacji | Wewnętrzna, na potrzeby własne. Nie jest udostępniana osobom trzecim ani sprzedawana. |
Cel działania aplikacji
Aplikacja łączy Centrum wiadomości Allegro z firmowym komunikatorem Telegram, z którego korzysta obsługa sklepu Szekla4x4.pl. Służy wyłącznie do szybszej obsługi zapytań kupujących.
Działa w dwie strony:
- Odbieranie — nowe wiadomości od kupujących są przekazywane do zamkniętej grupy roboczej na Telegramie, żeby obsługa zobaczyła je bez zaglądania do panelu.
- Odpowiadanie — pracownik odpowiada w Telegramie, a aplikacja przekazuje jego tekst do właściwego wątku na Allegro. Treść odpowiedzi jest zawsze napisana przez człowieka; aplikacja nie generuje, nie modyfikuje ani nie uzupełnia treści wiadomości wysyłanych do kupujących.
Aplikacja nie wystawia ofert, nie zmienia cen, nie obsługuje zamówień i nie prowadzi żadnych działań marketingowych.
Zakres korzystania z API
Uprawnienia
Aplikacja korzysta z jednego zakresu uprawnień: allegro:api:messaging. Nie żąda dostępu do ofert, zamówień, rozliczeń ani danych rozliczeniowych.
Wykorzystywane zasoby
| Metoda i zasób | Przeznaczenie |
|---|---|
GET /messaging/threads | sprawdzenie, czy są wątki bez odpowiedzi |
GET /messaging/threads/{threadId}/messages | odczyt treści nowych wiadomości |
POST /messaging/threads/{threadId}/messages | wysłanie odpowiedzi napisanej przez pracownika |
PUT /messaging/threads/{threadId}/read | oznaczenie wątku jako obsłużonego po wysłaniu odpowiedzi |
GET /me | wyłącznie w diagnostyce, do potwierdzenia konta |
Zasoby /messaging wywoływane są w wersji beta.v1 (nagłówek Accept: application/vnd.allegro.beta.v1+json), zgodnie z komunikatem Allegro o migracji z dnia 7 października 2026.
Częstotliwość zapytań
Aplikacja odpytuje API raz na 5 minut: jedno zapytanie o listę wątków, a następnie — tylko jeśli pojawiły się nowe wiadomości — po jednym zapytaniu na wątek wymagający odpowiedzi, maksymalnie 20 wątków w jednym przebiegu. Wysyłka odpowiedzi następuje wyłącznie w reakcji na działanie pracownika.
Aplikacja nie wykonuje zapytań równoległych ani masowych, nie pobiera danych historycznych i nie buduje kopii katalogu Allegro.
Uwierzytelnianie
Autoryzacja przez OAuth 2.0 w trybie Device Flow, na koncie właściciela sklepu. Tokeny dostępu i odświeżania są przechowywane wyłącznie w pamięci projektu aplikacji, nie są zapisywane w plikach, arkuszach ani logach, i nie są przekazywane żadnemu podmiotowi trzeciemu. W zapisach diagnostycznych są maskowane.
Dane i ich przetwarzanie
Treść wiadomości od kupujących oraz login rozmówcy zapisywane są w arkuszu Google należącym do Szekla4x4.pl, dostępnym wyłącznie dla pracowników obsługi. Służy to prowadzeniu historii obsługi zgłoszeń.
Dane nie są przekazywane podmiotom trzecim, nie są wykorzystywane do profilowania, nie są udostępniane publicznie ani wykorzystywane do celów marketingowych. Grupa na Telegramie, do której przekazywane są wiadomości, jest zamknięta i obejmuje wyłącznie pracowników obsługi sklepu.
Infrastruktura
Aplikacja działa jako skrypt w Google Apps Script, uruchamiany wyzwalaczem czasowym. Nie udostępnia żadnego publicznego punktu dostępowego — nie przyjmuje połączeń z zewnątrz, w tym webhooków.
Historia wersji
| Wersja | Data | Zmiany |
|---|---|---|
| 1.0.0 | październik 2026 | Pierwsza wersja produkcyjna: odbieranie wiadomości z Centrum wiadomości i odpowiadanie na nie. |
Kontakt
W sprawach technicznych dotyczących tej aplikacji, w tym zgłoszeń od administratorów Allegro: biuro (małpa) szekla4x4.pl
Szekla4x4.pl Damian Łaga