Zautomatyzuj alerty Vinted za pomocą webhooków

Większość usług alertów Vinted wysyła Ci powiadomienie push albo e-mail. To wystarcza, gdy od czasu do czasu kupujesz sobie parę butów. Ale jeśli prowadzisz odsprzedaż — a nawet jeśli tylko śledzisz tuzin wyszukiwań na wielu rynkach — pewnie chcesz czegoś, co trafia prosto do systemu, którego już używasz.

Właśnie to robią webhooki. Zamiast sprawdzać alerty, masz alert, który sam trafia do Twojego kodu.

Czym dokładnie jest webhook?

Webhook to żądanie HTTP, które serwer wysyła na Twój adres URL za każdym razem, gdy coś się wydarzy. W przypadku Vinotify to „coś” oznacza: nowe przedmioty pasują do jednego z Twoich alertów wyszukiwania.

Gdy system monitorowania znajdzie nowe ogłoszenia Vinted pasujące do filtrów Twojego wyszukiwania, wyśle żądanie POST na skonfigurowany przez Ciebie adres URL. Treść jest w formacie JSON i zawiera nazwę wyszukiwania oraz tytuły, marki, ceny, stany, rozmiary, linki Vinted i adresy URL zdjęć przedmiotów — wszystko, co zobaczyłbyś w e-mailu lub powiadomieniu push, ale w formacie, który maszyna potrafi odczytać.

Oto uproszczony przykład tego, jak wygląda payload:

{
  "event": "new_items",
  "search_id": 42,
  "search_name": "Nike Dunk Low",
  "item_count": 3,
  "items": [
    {
      "title": "Nike Dunk Low Panda 42",
      "brand": "Nike",
      "size": "42",
      "condition": "Very good",
      "price": "55.00",
      "url": "https://www.vinted.fr/items/...",
      "photo": "https://..."
    }
  ]
}

Gdy dane dotrą, możesz zrobić z nimi, co zechcesz: zapisać je, przekazać dalej, przefiltrować, zareagować.

Jak to działa w Vinotify

Webhooki są częścią planu Pro. Gdy tworzysz alert wyszukiwania w planie Pro, Vinotify generuje dla tego wyszukiwania unikalny sekret webhooka. Następnie możesz:

1. Odpytywać najnowszy payload — dedykowany endpoint GET zwraca najnowsze dane webhooka dla Twojego wyszukiwania, uwierzytelniane sekretem. JWT nie jest potrzebny, więc łatwo go wywołać z zadania cron albo ze skryptu Google Apps Script.
2. Ustawić zewnętrzny adres URL — wskaż Vinotify własny endpoint HTTPS (webhook w Zapier, adres funkcji AWS Lambda, scenariusz Make.com, własny serwer — cokolwiek). Vinotify będzie tam wysyłać metodą POST pasujące przedmioty za każdym razem, gdy pojawią się nowe.

Obie opcje są dostępne przez API. Sekret webhooka znajdziesz i zewnętrzny adres URL skonfigurujesz w ustawieniach wyszukiwania.

Praktyczne konfiguracje, które naprawdę działają

Wiedzieć, że webhooki istnieją, to jedno. Wiedzieć, co z nimi zrobić, to drugie. Oto kilka konfiguracji, które zbudowali użytkownicy Vinotify Pro:

1. Tracker magazynu w Google Sheets

Wdróż darmowy Google Apps Script, który przyjmuje żądania POST i dopisuje każdy przedmiot do arkusza. Kolumny na tytuł, markę, cenę, stan i adres URL. Dostajesz bieżący dziennik każdego przedmiotu, który wychwyciły Twoje alerty — z sortowaniem i wyszukiwaniem, bez żadnych płatnych narzędzi.

To chyba najprostszy punkt wyjścia. Piszesz około 20 linijek JavaScriptu w Apps Script, publikujesz jako aplikację webową i wklejasz adres URL do Vinotify.

2. Bot Telegrama lub Discorda

Jeśli wolisz dostawać alerty na czacie grupowym zamiast (albo obok) push i e-maila, ustaw mały przekaźnik. Odbiera webhook, zamienia go w wiadomość ze zdjęciem przedmiotu i linkiem „Kup teraz”, po czym publikuje ją na kanale Telegrama przez Bot API lub na kanale Discorda przez jego adres URL webhooka. Zajmuje się tym jedna funkcja serverless.

3. Filtr spadku ceny

Powiedzmy, że śledzisz szerokie wyszukiwanie — „North Face Nuptse” we wszystkich rozmiarach. Może to dawać 15 nowych ogłoszeń dziennie, ale interesuje Cię dopiero to, co wyląduje poniżej €80. Twój odbiornik webhooka sprawdza pole ceny i przekazuje dalej tylko przedmioty poniżej Twojego progu. Reszta jest po cichu zapisywana w logu.

4. Panel wielorynkowy

Pro obsługuje wyszukiwania wielorynkowe (FR, DE, IT, UK itd. z jednego alertu). Payloady webhooków zawierają nazwę wyszukiwania i adresy URL przedmiotów, a te zawierają domenę rynku. Lekki panel zbierający dostawy webhooków z kilku wyszukiwań daje jeden widok na wszystkie rynki i kategorie — przydatne, jeśli zaopatrujesz się na dużą skalę.

Webhooki jako „bezpieczny autocop”

Niektórzy odsprzedawcy chcą szybkości narzędzi autocop bez ryzyka, że oddadzą dane logowania albo dostaną bana. Webhooki to umożliwiają:

1. Skonfiguruj w swoim wyszukiwaniu Pro webhook kierujący do małego skryptu lub funkcji serverless.
2. Gdy pojawią się pasujące przedmioty, Twój skrypt dostaje dane natychmiast — razem z bezpośrednim adresem URL Vinted każdego przedmiotu.
3. Twoja automatyzacja wysyła Ci natychmiastowe powiadomienie (Telegram, SMS, okienko na pulpicie) z linkiem do przedmiotu gotowym do otwarcia.
4. Stukasz w link i kupujesz ręcznie — zwykłym kontem, w normalnym, ludzkim tempie.

Dzięki temu dowiadujesz się o nowych ogłoszeniach niemal natychmiast, a żaden bot nie dotyka Twojego konta Vinted. Żadnych udostępnionych danych logowania, żadnego ryzyka bana i znacznie taniej niż dedykowane subskrypcje autocop.

Czytaj więcej: Narzędzia autocop do Vinted a webhooki: dlaczego alerty wygrywają z automatycznymi kupcami →

Odpytywanie czy push: co wybrać

Vinotify oferuje oba sposoby. Jeśli Twój przypadek znosi niewielkie opóźnienie (przetwarzanie wsadowe, arkusze, analityka), prościej jest odpytywać endpoint GET według harmonogramu — nie potrzeba serwera, a zrobisz to z rozszerzenia przeglądarki, GitHub Action albo crontaba.

Jeśli chcesz dostawy w czasie rzeczywistym w chwili, gdy przedmioty pasują, ustaw zewnętrzny adres URL i pozwól Vinotify wysyłać dane do Ciebie. To lepsze dla botów, paneli na żywo i wszystkiego, gdzie liczy się 30 sekund przewagi.

Kilka rzeczy, o których warto pamiętać

• Traktuj sekret webhooka jak hasło. Każdy, kto go ma, może czytać wyniki Twojego wyszukiwania. Nie wrzucaj go do publicznego repozytorium.
• Zewnętrzne adresy URL muszą używać HTTPS (albo HTTP przy lokalnym rozwoju). Vinotify nie dostarcza na schematy inne niż HTTP.
• Payload ma limit 50 przedmiotów na jedną dostawę. Jeśli pojedyncze sprawdzenie znajdzie więcej dopasowań, payload zawiera pierwsze 50. Dzięki temu żądania mają rozsądny rozmiar dla usług dalej w łańcuchu.
• Dostarczanie działa w trybie best effort. Jeśli Twój endpoint nie działa albo zwraca błąd, payload i tak zostaje w pamięci podręcznej i jest dostępny przez endpoint odpytywania przez 24 godziny. Nie ma automatycznej kolejki ponowień — zadbaj o niezawodność odbiornika albo użyj endpointu odpytywania jako rozwiązania zapasowego.

Jak zacząć

Jeśli masz już plan Pro, każde tworzone przez Ciebie wyszukiwanie ma sekret webhooka. Wejdź w ustawienia wyszukiwania, weź sekret i odpytuj endpoint najnowszego payloadu albo ustaw zewnętrzny adres URL.

Jeśli masz Free, Plus lub Premium, webhooki nie są wliczone — ale powiadomienia push i e-mail dobrze pokrywają większość zastosowań osobistych. Webhooki mają sens, gdy chcesz zrobić z danymi coś programistycznego, a nie tylko je zobaczyć.

Utwórz alert →