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 aplikacjiSzekla4x4-Telegram
Aktualna wersja1.0.0
Nagłówek User-AgentSzekla4x4-Telegram/1.0.0 (+https://szekla4x4.pl/content/aplikacja-szekla4x4-telegram)
WłaścicielSzekla4x4.pl Damian Łaga
Konto AllegroSzekla4x4_pl
Kontakt technicznybiuro (małpa) szekla4x4.pl
Charakter aplikacjiWewnę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óbPrzeznaczenie
GET /messaging/threadssprawdzenie, czy są wątki bez odpowiedzi
GET /messaging/threads/{threadId}/messagesodczyt treści nowych wiadomości
POST /messaging/threads/{threadId}/messageswysłanie odpowiedzi napisanej przez pracownika
PUT /messaging/threads/{threadId}/readoznaczenie wątku jako obsłużonego po wysłaniu odpowiedzi
GET /mewyłą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

WersjaDataZmiany
1.0.0październik 2026Pierwsza 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

Ładowanie...