Automatisez vos alertes Vinted avec les webhooks

La plupart des services d’alertes Vinted vous envoient une notification push ou un e-mail. C’est très bien quand vous achetez une paire de baskets pour vous. Mais si vous faites de la revente — ou même si vous suivez simplement une douzaine de recherches sur plusieurs marchés — vous voulez probablement quelque chose qui alimente directement le système que vous utilisez déjà.

C’est ce que font les webhooks. Au lieu de venir vérifier vos alertes, c’est l’alerte qui vient à votre code.

Qu’est-ce qu’un webhook, exactement ?

Un webhook est une requête HTTP qu’un serveur envoie à votre URL chaque fois qu’il se passe quelque chose. Dans le cas de Vinotify, ce « quelque chose », c’est : de nouveaux articles correspondent à l’une de vos alertes de recherche.

Quand le système de surveillance trouve de nouvelles annonces Vinted qui correspondent aux filtres de votre recherche, il envoie une requête POST à l’URL que vous avez configurée. Le corps est en JSON et contient le nom de la recherche, les titres, marques, prix, états, tailles, liens Vinted et URL des photos des articles — tout ce que vous verriez dans l’e-mail ou la notification push, mais dans un format qu’une machine sait lire.

Voici un exemple simplifié du 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://..."
    }
  ]
}

Une fois les données arrivées, vous en faites ce que vous voulez : les enregistrer, les transférer, les filtrer, agir dessus.

Comment ça marche dans Vinotify

Les webhooks font partie de la formule Pro. Quand vous créez une alerte de recherche avec Pro, Vinotify génère un secret webhook unique pour cette recherche. Vous pouvez ensuite :

1. Interroger le dernier payload — un endpoint GET dédié renvoie les données webhook les plus récentes de votre recherche, authentifié par le secret. Pas besoin de JWT : il est donc facile à appeler depuis une tâche cron ou un Google Apps Script.
2. Définir une URL externe — indiquez à Vinotify votre propre endpoint HTTPS (un webhook Zapier, une URL de fonction AWS Lambda, un scénario Make.com, un serveur auto-hébergé — n’importe lequel). Vinotify y enverra en POST les articles correspondants dès que de nouveaux apparaissent.

Les deux options sont disponibles via l’API. Vous trouverez votre secret webhook et pourrez configurer l’URL externe dans les paramètres de la recherche.

Des configurations pratiques qui fonctionnent vraiment

Savoir que les webhooks existent, c’est une chose. Savoir quoi en faire, c’en est une autre. Voici quelques configurations montées par des utilisateurs Vinotify Pro :

1. Un suivi d’inventaire dans Google Sheets

Déployez un Google Apps Script gratuit qui accepte les requêtes POST et ajoute chaque article à un tableur. Des colonnes pour le titre, la marque, le prix, l’état et l’URL. Vous obtenez un journal continu de chaque article repéré par vos alertes, triable et consultable, sans aucun outil payant.

C’est probablement le point de départ le plus simple. Vous écrivez une vingtaine de lignes de JavaScript dans Apps Script, vous le publiez en application web et vous collez l’URL dans Vinotify.

2. Un bot Telegram ou Discord

Si vous préférez recevoir les alertes dans une discussion de groupe, à la place de (ou en plus de) la notification push et de l’e-mail, mettez en place un petit relais. Il reçoit le webhook, le transforme en message avec la photo de l’article et un lien « Acheter maintenant », puis le publie dans un canal Telegram via l’API Bot ou dans un canal Discord via son URL de webhook. Une seule fonction serverless s’en charge.

3. Un filtre de baisse de prix

Imaginons que vous suiviez une recherche large — « North Face Nuptse » dans toutes les tailles. Elle peut faire remonter 15 nouvelles annonces par jour, mais ce qui vous intéresse, c’est quand l’une d’elles passe sous €80. Votre récepteur de webhook vérifie le champ du prix et ne transmet que les articles sous votre seuil. Les autres sont simplement consignés sans bruit.

4. Un tableau de bord multi-marchés

Pro prend en charge les recherches multi-marchés (FR, DE, IT, UK, etc. depuis une seule alerte). Les payloads de webhook incluent le nom de la recherche et les URL des articles, qui contiennent le domaine du marché. Un tableau de bord léger qui collecte les envois de webhook de plusieurs recherches vous donne une vue unique de tous les marchés et catégories — utile si vous vous approvisionnez à grande échelle.

Utiliser les webhooks comme un « autocop sans risque »

Certains revendeurs veulent la rapidité des outils d’autocop sans le risque de confier leurs identifiants ou de se faire bannir. Les webhooks rendent cela possible :

1. Configurez sur votre recherche Pro un webhook qui pointe vers un petit script ou une fonction serverless.
2. Quand de nouveaux articles correspondent, votre script reçoit les données instantanément — y compris l’URL Vinted directe de chaque article.
3. Votre automatisation vous envoie une notification instantanée (Telegram, SMS, fenêtre sur le bureau) avec le lien de l’article prêt à ouvrir.
4. Vous touchez le lien et vous achetez à la main — avec un compte normal, à une vitesse humaine normale.

Vous êtes ainsi informé presque instantanément des nouvelles annonces, sans qu’aucun bot ne touche à votre compte Vinted. Aucun identifiant partagé, aucun risque de bannissement, et bien moins cher que les abonnements autocop dédiés.

À lire aussi : Outils d’autocop Vinted ou webhooks : pourquoi les alertes l’emportent sur les achats automatiques →

Interrogation ou push : que choisir ?

Vinotify propose les deux. Si votre cas d’usage tolère un léger délai (traitement par lots, tableurs, analyses), interroger l’endpoint GET à intervalle régulier est plus simple — pas besoin de serveur, et vous pouvez le faire depuis une extension de navigateur, une GitHub Action ou une crontab.

Si vous voulez une livraison en temps réel dès que des articles correspondent, définissez une URL externe et laissez Vinotify vous pousser les données. C’est préférable pour les bots, les tableaux de bord en direct et tout ce pour quoi 30 secondes d’avance comptent.

Quelques points à garder en tête

• Traitez votre secret webhook comme un mot de passe. Toute personne qui le possède peut lire les résultats de votre recherche. Ne le publiez pas dans un dépôt public.
• Les URL externes doivent être en HTTPS (ou en HTTP pour le développement local). Vinotify ne livre pas vers d’autres schémas que HTTP.
• Les payloads sont limités à 50 articles par envoi. Si une même vérification trouve davantage de correspondances, le payload contient les 50 premiers. Cela garde des requêtes de taille raisonnable pour les services en aval.
• L’envoi est fait au mieux. Si votre endpoint est indisponible ou renvoie une erreur, le payload reste mis en cache et accessible via l’endpoint d’interrogation pendant 24 heures. Il n’y a pas de file de nouvelles tentatives automatique — gardez votre récepteur fiable ou utilisez l’endpoint d’interrogation en secours.

Pour commencer

Si vous êtes déjà sur la formule Pro, chaque recherche que vous créez a un secret webhook. Ouvrez les paramètres de votre recherche, récupérez le secret, puis interrogez l’endpoint du dernier payload ou définissez une URL externe.

Si vous êtes sur Free, Plus ou Premium, les webhooks ne sont pas inclus — mais les notifications push et l’e-mail couvrent très bien la plupart des usages personnels. Les webhooks prennent tout leur sens quand vous voulez faire quelque chose de programmatique avec les données, pas seulement les voir.

Créer une alerte →