Intégrations

1. 1Écrivez à @BotFather et créez un bot (/newbot), copiez le token.
2. 2Écrivez à @userinfobot pour connaître votre chat_id.
3. 3Dans Intégrations → Telegram, collez le token et le chat_id.
4. 4Envoyez n'importe quoi à votre bot (sinon Telegram ne le laissera pas envoyer le premier message).

Sur votre serveur : Paramètres du canal → Intégrations → Webhooks → Nouveau webhook, copiez l'URL et collez-la dans Intégrations. Les alertes arrivent sous forme de messages dans le canal choisi.

Des notifications système qui fonctionnent même onglet fermé. Chaque appareil (portable, téléphone Android) se connecte séparément via le bouton « Activer sur cet appareil » ; la liste des appareils, avec test et suppression, se trouve dans la même fenêtre.

Vous indiquez votre propre adresse HTTPS et chaque trouvaille de moniteur arrive en POST JSON (Content-Type: application/json). Le body a toujours la même forme — les champs inconnus pour une offre donnée arrivent à null :

{
  "title": "iPhone 13 Pro 256GB",
  "url": "https://vinted.pl/items/123456",
  "marketplace": "vinted",
  "price": "2 000 PLN",
  "image": "https://images.vinted.net/...jpg",
  "hidden": false,
  "monitorId": "8f3c1e2a-…-uuid",
  "seller": {
    "login": "ola_vinted",
    "country": "Polska",
    "countryFlag": "🇵🇱",
    "city": "Warszawa",
    "feedbackCount": 123,
    "feedbackReputation": 0.98,
    "photoUrl": "https://images.vinted.net/avatar.jpg"
  }
}

1. 1title, url, marketplace — toujours présents.
2. 2price — chaîne formatée (par ex. « 2 000 PLN ») ou null.
3. 3image — URL de la miniature ou null.
4. 4hidden — true lorsque l'offre a été trouvée par sondage d'identifiants et peut être invisible dans la recherche publique de la plateforme.
5. 5monitorId — UUID du moniteur qui a capté l'offre (pour le routage de votre côté).
6. 6seller — les données du vendeur ; Vinted uniquement aujourd'hui, null ailleurs. feedbackReputation est une fraction 0–1 (0,98 = 98 %).

Clé de signature facultative : une fois définie, chaque requête porte un en-tête x-snipeit-signature: sha256=<hex>, où hex = HMAC-SHA256(clé, body brut). Calculez la même chose de votre côté et comparez — cela confirme que la requête vient de nous et que le body n'a pas été modifié.

import { createHmac, timingSafeEqual } from "node:crypto";

function verify(rawBody, header, secret) {
  const expected =
    "sha256=" + createHmac("sha256", secret).update(rawBody).digest("hex");
  const a = Buffer.from(header ?? "");
  const b = Buffer.from(expected);
  return a.length === b.length && timingSafeEqual(a, b);
}

E-mail : le canal le plus simple — vous indiquez une adresse et recevez les alertes par e-mail avec un lien vers l'offre.