Automatize os seus alertas da Vinted com webhooks

A maioria dos serviços de alertas da Vinted envia-lhe uma notificação push ou um e-mail. Isso funciona bem quando compra de vez em quando uns ténis para si. Mas se faz revenda — ou mesmo se só acompanha uma dúzia de pesquisas em vários mercados — provavelmente quer algo que alimente diretamente o sistema que já usa.

É isso que os webhooks fazem. Em vez de ser você a verificar os alertas, o alerta chega ao seu código.

O que é, afinal, um webhook?

Um webhook é um pedido HTTP que um servidor envia para o seu URL sempre que acontece alguma coisa. No caso do Vinotify, esse «alguma coisa» é: novos artigos correspondem a um dos seus alertas de pesquisa.

Quando o sistema de monitorização encontra novos anúncios da Vinted que correspondem aos filtros da sua pesquisa, envia um pedido POST para o URL que configurou. O corpo é JSON e contém o nome da pesquisa, os títulos, marcas, preços, estados, tamanhos, ligações da Vinted e URL das fotos dos artigos — tudo o que veria no e-mail ou na notificação push, mas num formato que uma máquina consegue ler.

Eis um exemplo simplificado do aspeto do 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://..."
    }
  ]
}

Depois de os dados chegarem, pode fazer o que quiser com eles: registá-los, reencaminhá-los, filtrá-los, agir com base neles.

Como funciona no Vinotify

Os webhooks fazem parte do plano Pro. Quando cria um alerta de pesquisa com o Pro, o Vinotify gera um segredo de webhook único para essa pesquisa. Depois pode:

1. Consultar o último payload — existe um endpoint GET dedicado que devolve os dados de webhook mais recentes da sua pesquisa, autenticado pelo segredo. Não é preciso JWT, por isso é fácil de chamar a partir de uma tarefa cron ou de um Google Apps Script.
2. Definir um URL externo — aponte o Vinotify para o seu próprio endpoint HTTPS (um webhook do Zapier, o URL de uma função AWS Lambda, um cenário do Make.com, um servidor próprio — o que for). O Vinotify enviará para lá, por POST, os artigos correspondentes sempre que surgirem novos.

Ambas as opções estão disponíveis através da API. Encontra o seu segredo de webhook e configura o URL externo nas definições da pesquisa.

Configurações práticas que funcionam mesmo

Saber que os webhooks existem é uma coisa. Saber o que fazer com eles é outra. Eis algumas configurações montadas por utilizadores do Vinotify Pro:

1. Um registo de inventário no Google Sheets

Publique um Google Apps Script gratuito que aceite pedidos POST e acrescente cada artigo a uma folha de cálculo. Colunas para título, marca, preço, estado e URL. Fica com um registo contínuo de cada artigo que os seus alertas apanham, ordenável e pesquisável, sem qualquer ferramenta paga.

Este é provavelmente o ponto de partida mais simples. Escreve cerca de 20 linhas de JavaScript no Apps Script, publica-o como aplicação web e cola o URL no Vinotify.

2. Um bot do Telegram ou do Discord

Se preferir receber os alertas num chat de grupo em vez de (ou além de) push e e-mail, monte um pequeno relé. Recebe o webhook, transforma-o numa mensagem com a foto do artigo e uma ligação «Comprar agora», e publica-a num canal do Telegram através da Bot API ou num canal do Discord através do respetivo URL de webhook. Uma única função serverless trata disto.

3. Um filtro de descida de preço

Imagine que acompanha uma pesquisa ampla — «North Face Nuptse» em todos os tamanhos. Pode fazer surgir 15 anúncios novos por dia, mas só lhe interessa quando algum cair abaixo de €80. O seu recetor de webhook verifica o campo do preço e só reencaminha os artigos abaixo do seu limite. Os restantes ficam registados em silêncio.

4. Um painel multi-mercado

O Pro suporta pesquisas multi-mercado (FR, DE, IT, UK, etc. a partir de um único alerta). Os payloads dos webhooks incluem o nome da pesquisa e os URL dos artigos, que contêm o domínio do mercado. Um painel leve que recolha as entregas de webhook de várias pesquisas dá-lhe uma vista única de todos os mercados e categorias — útil se se abastece em grande escala.

Usar os webhooks como um «autocop seguro»

Alguns revendedores querem a rapidez das ferramentas de autocop sem o risco de entregar os dados de acesso ou de serem banidos. Os webhooks tornam isso possível:

1. Configure na sua pesquisa Pro um webhook que aponte para um pequeno script ou para uma função serverless.
2. Quando surgem artigos novos correspondentes, o seu script recebe os dados instantaneamente — incluindo o URL direto da Vinted de cada artigo.
3. A sua automatização envia-lhe uma notificação instantânea (Telegram, SMS, janela no ambiente de trabalho) com a ligação do artigo pronta a abrir.
4. Toca na ligação e compra à mão — com uma conta normal, a uma velocidade humana normal.

Assim, fica a saber quase instantaneamente dos novos anúncios sem que nenhum bot toque na sua conta da Vinted. Sem partilhar dados de acesso, sem risco de banimento e muito mais barato do que as subscrições de autocop dedicadas.

Saiba mais: Ferramentas de autocop da Vinted vs webhooks: porque é que os alertas vencem os compradores automáticos →

Consulta ou push: qual escolher

O Vinotify oferece ambos. Se o seu caso de utilização tolera um pequeno atraso (processamento em lote, folhas de cálculo, análises), consultar o endpoint GET de forma agendada é mais simples — não precisa de servidor e pode fazê-lo a partir de uma extensão do navegador, de uma GitHub Action ou de uma crontab.

Se quer a entrega em tempo real no momento em que os artigos correspondem, defina um URL externo e deixe o Vinotify enviar os dados para si. É melhor para bots, painéis em direto e tudo aquilo em que 30 segundos de avanço contam.

Algumas coisas a ter em conta

• Trate o seu segredo de webhook como uma palavra-passe. Quem o tiver pode ler os resultados da sua pesquisa. Não o coloque num repositório público.
• Os URL externos têm de ser HTTPS (ou HTTP para desenvolvimento local). O Vinotify não entrega em esquemas que não sejam HTTP.
• Os payloads têm um limite de 50 artigos por entrega. Se uma única verificação encontrar mais correspondências, o payload contém as primeiras 50. Assim, os pedidos mantêm um tamanho razoável para os serviços seguintes.
• A entrega é feita com o melhor esforço. Se o seu endpoint estiver em baixo ou devolver um erro, o payload continua em cache e disponível através do endpoint de consulta durante 24 horas. Não existe uma fila automática de repetições — mantenha o seu recetor fiável ou use o endpoint de consulta como alternativa.

Como começar

Se já tem o plano Pro, cada pesquisa que criar tem um segredo de webhook. Vá às definições da pesquisa, copie o segredo e consulte o endpoint do último payload ou defina um URL externo.

Se tem Free, Plus ou Premium, os webhooks não estão incluídos — mas as notificações push e o e-mail cobrem bem a maioria das utilizações pessoais. Os webhooks fazem sentido quando quer fazer algo programático com os dados, e não apenas vê-los.

Criar um alerta →