Automatizza i tuoi avvisi Vinted con i webhook

La maggior parte dei servizi di avvisi Vinted ti manda una notifica push o un’e-mail. Va benissimo quando compri ogni tanto un paio di sneaker per te. Ma se fai rivendita — o anche solo segui una dozzina di ricerche su più mercati — probabilmente vuoi qualcosa che alimenti direttamente il sistema che usi già.

È quello che fanno i webhook. Invece di andare tu a controllare gli avvisi, è l’avviso che arriva al tuo codice.

Che cos’è, esattamente, un webhook?

Un webhook è una richiesta HTTP che un server invia al tuo URL ogni volta che succede qualcosa. Nel caso di Vinotify, quel «qualcosa» è: nuovi articoli corrispondono a uno dei tuoi avvisi di ricerca.

Quando il sistema di monitoraggio trova nuovi annunci Vinted che corrispondono ai filtri della tua ricerca, invia una richiesta POST all’URL che hai configurato. Il corpo è in JSON e contiene il nome della ricerca, i titoli degli articoli, le marche, i prezzi, le condizioni, le taglie, i link Vinted e gli URL delle foto — tutto ciò che vedresti nell’e-mail o nella notifica push, ma in un formato che una macchina sa leggere.

Ecco un esempio semplificato di come appare il 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://..."
    }
  ]
}

Una volta arrivati, puoi fare quello che vuoi con quei dati: registrarli, inoltrarli, filtrarli, agire di conseguenza.

Come funziona in Vinotify

I webhook fanno parte del piano Pro. Quando crei un avviso di ricerca con Pro, Vinotify genera un segreto webhook unico per quella ricerca. A quel punto puoi:

1. Interrogare l’ultimo payload — c’è un endpoint GET dedicato che restituisce i dati webhook più recenti della tua ricerca, autenticato dal segreto. Non serve alcun JWT, quindi è facile da chiamare da un cron job o da un Google Apps Script.
2. Impostare un URL esterno — indica a Vinotify il tuo endpoint HTTPS (un webhook Zapier, l’URL di una funzione AWS Lambda, uno scenario Make.com, un server self-hosted — qualsiasi cosa). Vinotify vi invierà in POST gli articoli corrispondenti ogni volta che ne compaiono di nuovi.

Entrambe le opzioni sono disponibili tramite l’API. Trovi il tuo segreto webhook e configuri l’URL esterno dalle impostazioni della ricerca.

Configurazioni pratiche che funzionano davvero

Sapere che i webhook esistono è una cosa. Sapere che cosa farne è un’altra. Ecco alcune configurazioni messe insieme dagli utenti Vinotify Pro:

1. Un tracker di magazzino su Google Sheets

Pubblica un Google Apps Script gratuito che accetta richieste POST e aggiunge ogni articolo a un foglio di calcolo. Colonne per titolo, marca, prezzo, condizione, URL. Ottieni un registro continuo di ogni articolo trovato dai tuoi avvisi, ordinabile e ricercabile, senza alcuno strumento a pagamento.

Probabilmente è il punto di partenza più semplice. Scrivi una ventina di righe di JavaScript in Apps Script, lo pubblichi come web app e incolli l’URL in Vinotify.

2. Un bot Telegram o Discord

Se preferisci ricevere gli avvisi in una chat di gruppo al posto di (o insieme a) push ed e-mail, configura un piccolo relay. Riceve il webhook, lo trasforma in un messaggio con la foto dell’articolo e un link «Acquista ora», e lo pubblica in un canale Telegram tramite la Bot API o in un canale Discord tramite il suo URL webhook. Se ne occupa una sola funzione serverless.

3. Un filtro per i cali di prezzo

Supponiamo che tu segua una ricerca ampia — «North Face Nuptse» in tutte le taglie. Potrebbe far emergere 15 nuovi annunci al giorno, ma ti interessa solo quando qualcosa scende sotto gli €80. Il tuo ricevitore webhook controlla il campo del prezzo e inoltra solo gli articoli sotto la tua soglia. Gli altri vengono registrati in silenzio.

4. Una dashboard multi-mercato

Pro supporta le ricerche multi-mercato (FR, DE, IT, UK, ecc. da un solo avviso). I payload dei webhook includono il nome della ricerca e gli URL degli articoli, che contengono il dominio del mercato. Una dashboard leggera che raccoglie le consegne webhook di più ricerche ti dà una vista unica su mercati e categorie — utile se ti approvvigioni su larga scala.

Usare i webhook come «autocop sicuro»

Alcuni rivenditori vogliono la velocità degli strumenti autocop senza il rischio di consegnare le credenziali o di essere bannati. I webhook lo rendono possibile:

1. Configura sulla tua ricerca Pro un webhook che punta a un piccolo script o a una funzione serverless.
2. Quando nuovi articoli corrispondono, il tuo script riceve i dati all’istante — compreso l’URL Vinted diretto di ogni articolo.
3. La tua automazione ti manda una notifica istantanea (Telegram, SMS, popup sul desktop) con il link dell’articolo pronto da aprire.
4. Tocchi il link e compri a mano — con un account normale, a velocità umana normale.

Così sai quasi all’istante dei nuovi annunci senza che alcun bot tocchi il tuo account Vinted. Nessuna credenziale condivisa, nessun rischio di ban e molto più economico degli abbonamenti autocop dedicati.

Leggi anche: Strumenti autocop Vinted e webhook: perché gli avvisi battono gli acquisti automatici →

Interrogazione o push: quale scegliere

Vinotify offre entrambi. Se il tuo caso d’uso tollera un piccolo ritardo (elaborazione in blocco, fogli di calcolo, analisi), interrogare l’endpoint GET a intervalli regolari è più semplice — non serve un server e puoi farlo da un’estensione del browser, una GitHub Action o una crontab.

Se vuoi la consegna in tempo reale nel momento in cui gli articoli corrispondono, imposta un URL esterno e lascia che Vinotify faccia il push verso di te. È meglio per bot, dashboard in tempo reale e tutto ciò per cui contano 30 secondi di vantaggio.

Qualche cosa da tenere a mente

• Tratta il tuo segreto webhook come una password. Chiunque lo abbia può leggere i risultati della tua ricerca. Non caricarlo in un repository pubblico.
• Gli URL esterni devono essere HTTPS (o HTTP per lo sviluppo in locale). Vinotify non consegna a schemi diversi da HTTP.
• I payload sono limitati a 50 articoli per consegna. Se un singolo controllo trova più corrispondenze, il payload contiene i primi 50. Così le richieste restano di dimensioni ragionevoli per i servizi a valle.
• La consegna avviene secondo il criterio del best effort. Se il tuo endpoint è fuori servizio o restituisce un errore, il payload resta comunque in cache e disponibile tramite l’endpoint di interrogazione per 24 ore. Non c’è una coda automatica di nuovi tentativi — mantieni affidabile il tuo ricevitore o usa l’endpoint di interrogazione come ripiego.

Come iniziare

Se hai già il piano Pro, ogni ricerca che crei ha un segreto webhook. Vai nelle impostazioni della ricerca, prendi il segreto e interroga l’endpoint dell’ultimo payload oppure imposta un URL esterno.

Se hai Free, Plus o Premium, i webhook non sono inclusi — ma le notifiche push e l’e-mail coprono bene la maggior parte degli usi personali. I webhook hanno senso quando vuoi fare qualcosa di programmatico con i dati, non solo vederli.

Crea un avviso →