Automatiza tus alertas de Vinted con webhooks

La mayoría de los servicios de alertas de Vinted te envían una notificación push o un correo. Eso funciona bien cuando compras de vez en cuando unas zapatillas para ti. Pero si te dedicas a la reventa —o incluso si solo sigues una docena de búsquedas en varios mercados—, probablemente quieras algo que alimente directamente el sistema que ya usas.

Eso es lo que hacen los webhooks. En lugar de que tú vayas a mirar las alertas, la alerta llega a tu código.

¿Qué es exactamente un webhook?

Un webhook es una petición HTTP que un servidor envía a tu URL cada vez que ocurre algo. En el caso de Vinotify, ese «algo» es: nuevos artículos coinciden con una de tus alertas de búsqueda.

Cuando el sistema de vigilancia encuentra anuncios nuevos de Vinted que coinciden con los filtros de tu búsqueda, envía una petición POST a la URL que has configurado. El cuerpo es JSON y contiene el nombre de la búsqueda, los títulos, marcas, precios, estados, tallas, enlaces de Vinted y URL de las fotos de los artículos: todo lo que verías en el correo o en la notificación push, pero en un formato que una máquina puede leer.

Este es un ejemplo simplificado del aspecto del 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://..."
    }
  ]
}

Cuando los datos llegan, puedes hacer con ellos lo que quieras: registrarlos, reenviarlos, filtrarlos, actuar sobre ellos.

Cómo funciona en Vinotify

Los webhooks forman parte del plan Pro. Cuando creas una alerta de búsqueda con Pro, Vinotify genera un secreto webhook único para esa búsqueda. Entonces puedes:

1. Consultar el último payload — hay un endpoint GET específico que devuelve los datos de webhook más recientes de tu búsqueda, autenticado con el secreto. No hace falta JWT, así que es fácil de llamar desde una tarea cron o un Google Apps Script.
2. Definir una URL externa — indica a Vinotify tu propio endpoint HTTPS (un webhook de Zapier, la URL de una función de AWS Lambda, un escenario de Make.com, un servidor autoalojado: lo que sea). Vinotify enviará allí por POST los artículos que coincidan cada vez que aparezcan nuevos.

Ambas opciones están disponibles desde la API. Puedes encontrar tu secreto webhook y configurar la URL externa en los ajustes de la búsqueda.

Configuraciones prácticas que funcionan de verdad

Saber que existen los webhooks es una cosa. Saber qué hacer con ellos es otra. Estas son algunas configuraciones que han montado usuarios de Vinotify Pro:

1. Un seguimiento de inventario en Google Sheets

Despliega un Google Apps Script gratuito que acepte peticiones POST y añada cada artículo a una hoja de cálculo. Columnas para título, marca, precio, estado y URL. Obtienes un registro continuo de cada artículo que detectan tus alertas, ordenable y con búsqueda, sin ninguna herramienta de pago.

Probablemente es el punto de partida más sencillo. Escribes unas 20 líneas de JavaScript en Apps Script, lo publicas como aplicación web y pegas la URL en Vinotify.

2. Un bot de Telegram o Discord

Si prefieres recibir las alertas en un chat de grupo en lugar de (o además de) push y correo, monta un pequeño relé. Recibe el webhook, lo convierte en un mensaje con la foto del artículo y un enlace «Comprar ahora», y lo publica en un canal de Telegram mediante la Bot API o en un canal de Discord mediante su URL de webhook. Una sola función serverless se encarga de todo.

3. Un filtro de bajada de precio

Imagina que sigues una búsqueda amplia: «North Face Nuptse» en todas las tallas. Puede mostrar 15 anuncios nuevos al día, pero solo te interesa cuando alguno baja de €80. Tu receptor de webhook comprueba el campo del precio y solo reenvía los artículos por debajo de tu umbral. El resto se registra en silencio.

4. Un panel multi-mercado

Pro admite búsquedas multi-mercado (FR, DE, IT, UK, etc. desde una sola alerta). Los payloads del webhook incluyen el nombre de la búsqueda y las URL de los artículos, que contienen el dominio del mercado. Un panel ligero que recoja los envíos de webhook de varias búsquedas te da una vista única de todos los mercados y categorías, útil si te abasteces a gran escala.

Usar los webhooks como un «autocop seguro»

Algunos revendedores quieren la rapidez de las herramientas de autocop sin el riesgo de entregar sus credenciales o de que los bloqueen. Los webhooks lo hacen posible:

1. Configura en tu búsqueda Pro un webhook que apunte a un pequeño script o a una función serverless.
2. Cuando coinciden artículos nuevos, tu script recibe los datos al instante, incluida la URL directa de Vinted de cada artículo.
3. Tu automatización te envía una notificación instantánea (Telegram, SMS, ventana emergente en el escritorio) con el enlace del artículo listo para abrir.
4. Tocas el enlace y compras a mano, con una cuenta normal, a velocidad humana normal.

Así te enteras casi al instante de los anuncios nuevos sin que ningún bot toque tu cuenta de Vinted. Sin compartir credenciales, sin riesgo de bloqueo y mucho más barato que las suscripciones de autocop dedicadas.

Más información: Herramientas de autocop de Vinted frente a webhooks: por qué las alertas superan a los compradores automáticos →

Consulta o push: cuál elegir

Vinotify ofrece ambos. Si tu caso de uso tolera un pequeño retraso (procesamiento por lotes, hojas de cálculo, analítica), consultar el endpoint GET de forma programada es más sencillo: no hace falta servidor, y puedes hacerlo desde una extensión del navegador, una GitHub Action o una crontab.

Si quieres la entrega en tiempo real en cuanto coincidan artículos, define una URL externa y deja que Vinotify te envíe los datos. Es mejor para bots, paneles en directo y todo aquello donde importan 30 segundos de ventaja.

Algunas cosas que debes tener en cuenta

• Trata tu secreto webhook como una contraseña. Cualquiera que lo tenga puede leer los resultados de tu búsqueda. No lo subas a un repositorio público.
• Las URL externas deben ser HTTPS (o HTTP para desarrollo local). Vinotify no entrega a esquemas que no sean HTTP.
• Los payloads están limitados a 50 artículos por envío. Si una sola comprobación encuentra más coincidencias, el payload contiene las 50 primeras. Así las peticiones mantienen un tamaño razonable para los servicios posteriores.
• El envío es de mejor esfuerzo. Si tu endpoint está caído o devuelve un error, el payload sigue guardado en caché y disponible mediante el endpoint de consulta durante 24 horas. No hay una cola automática de reintentos: mantén fiable tu receptor o usa el endpoint de consulta como respaldo.

Primeros pasos

Si ya tienes el plan Pro, cada búsqueda que crees tiene un secreto webhook. Ve a los ajustes de tu búsqueda, copia el secreto y consulta el endpoint del último payload o define una URL externa.

Si tienes Free, Plus o Premium, los webhooks no están incluidos, pero las notificaciones push y el correo cubren bien la mayoría de los usos personales. Los webhooks tienen sentido cuando quieres hacer algo programático con los datos, no solo verlos.

Crear una alerta →