Webhook API para revendedores: as tuas vendas e alterações de preços em JSON.
A Webhook API envia cada venda, cada oferta e cada alteração de preço Bricker Mode do RestocksAIO para o teu próprio endpoint HTTPS em JSON. Escolhes os grupos de eventos que envia.
Configura em Settings
Introduz o endereço do teu endpoint em Endpoint URL e clica em Test. A aplicação envia um pedido de teste e indica se chegou.
Depois, seleciona Enable Webhook API e os grupos de eventos que queres: Sales, Offers, Bricker e Labels.
Na aplicação: Settings › Notifications › Webhook API
Todos os eventos têm a mesma estrutura
Cada pedido é um HTTPS POST com quatro campos: event, timestampUtc, data e meta. O campo event identifica o evento e data contém os campos desse evento.
Uma venda inclui o ID da venda, o produto, o código de modelo, o marketplace, o tamanho e o valor líquido. Uma alteração de preço inclui a tarefa, o marketplace, o preço anterior, o novo preço e o motivo.
O que os vendedores criam com ela
Termina um anúncio num marketplace que o RestocksAIO não suporta, como Depop, quando o par vende noutro site. O teu próprio código recebe sale.detected e termina o anúncio.
Grava cada venda numa folha de cálculo, numa base de dados ou no teu programa de contabilidade. Publica uma mensagem para a tua equipa quando Bricker Mode altera um preço.
Os eventos e os factos
- sale.detected
- Uma nova venda ou uma venda cujo estado muda.
- offer.detected
- Uma oferta num dos teus anúncios, com o montante, o valor líquido e o lucro se aceitares.
- bricker.price_change
- Bricker Mode aumentou ou baixou um preço.
- bricker.item_sold
- Um par com uma tarefa Bricker Mode vendeu, com o preço e o valor líquido após taxas.
- bricker.item_deleted
- A aplicação tentou eliminar um anúncio, com sucesso ou falha.
- Entrega
- Um evento pode chegar mais do que uma vez. Utiliza o ID da venda ou da tarefa para o tratar uma só vez.
- Aplicação aberta
- A aplicação envia eventos enquanto está aberta.
- Plano
- Premium.
Perguntas
Posso ligar o RestocksAIO a um marketplace que não suporta?
Sim, com o teu próprio código. Quando um par vende num marketplace suportado, o RestocksAIO envia sale.detected para o teu endpoint. O teu código termina depois o mesmo anúncio no Depop ou noutro local. eBay, Shopify, Vinted e Wallapop não precisam de código: a aplicação publica nesses canais.
Que eventos posso receber?
Cinco: sale.detected, offer.detected, bricker.price_change, bricker.item_sold e bricker.item_deleted. Em Settings, ativas por grupo: Sales, Offers, Bricker e Labels.
A Webhook API é o mesmo que as notificações Discord?
Não. As notificações Discord e Telegram são mensagens para leres e fazem parte de todos os planos. A Webhook API envia JSON para o teu próprio software ler e faz parte do Premium.
Que plano inclui a Webhook API?
O Premium. O Bricker Mode e o Offer Sniper, que criam a maioria dos eventos, também fazem parte do Premium.
Relacionado
Envia um evento de teste para o teu endpoint.
Inicia o período de teste Premium, introduz o URL do teu endpoint e clica em Test.