Webhooks: i clic sui tuoi link arrivano da soli sul tuo server

Lix.li invia un evento per ogni clic direttamente al tuo URL tramite HTTP POST — in tempo reale, firmato con HMAC e con consegna affidabile. Niente più polling continuo dell'API: i dati arrivano da soli nel momento stesso del clic.

Configura un webhook Guarda il formato dei dati

Tempo reale · firma HMAC · retry e log delle consegne

# Lix.li itself sends POST to your server during transitions POST https://your-server.com/hooks X-Lix-Signature: sha256=9f86d0818884… Content-Type: application/json { "event_type": "redirects.batch", "count": 2, "events": [ { "link_id": 9053352, "country": "DE", "device": "mobile" } ] }

A cosa servono i webhook

Ricevi i dati sui clic nell'istante in cui accadono e costruisci i tuoi flussi su di essi

Tempo reale

Gli eventi arrivano nel momento del clic. Niente più polling programmato dell'API in attesa di aggiornamenti.

Dati su ogni clic

Paese, città, dispositivo, sistema operativo, browser, referrer e flag bot — tutto ciò che serve per le tue analisi.

Sicuro per progettazione

Ogni richiesta è firmata con HMAC usando il tuo secret, così distingui facilmente gli eventi reali da quelli falsificati.

Consegna affidabile

Se il tuo server non è raggiungibile, la consegna viene ritentata. Ogni tentativo e il suo stato sono visibili nel log delle consegne.

Casi d'uso

Dove vengono solitamente indirizzati gli eventi di clic

Lix.li POST
La tua analytics o il tuo CRM

Salva ogni clic nel tuo database o CRM e costruisci report esattamente come vuoi tu.

Lix.li POST
Notifiche in chat

Fai in modo che un bot Telegram, Slack o Discord ti avvisi dei nuovi clic all'istante, senza controlli manuali.

Lix.li POST
Automazione

Avvia flussi su Zapier, Make o n8n: un evento di clic diventa il trigger per qualsiasi azione successiva.

Cosa arriva nel webhook

L'evento redirects.batch: un unico payload raggruppa un lotto di clic in una finestra temporale

{ "delivery_id": "d_01HXY9F0…", "event_type": "redirects.batch", "sent_at": "2026-08-04T10:15:00Z", "window": { "from": "…10:14:00Z", "to": "…10:15:00Z" }, "count": 1, "truncated": false, "events": [ { "event_id": "e_9f86d0…", "link_id": 9053352, "datetime": "2026-08-04T10:14:12Z", "country": "DE", "city": "Berlin", "browser": "Chrome", "os": "Android", "device": "mobile", "ref_domain": "t.me", "group_id": null, "is_bot": false } ] }

L'indirizzo IP del visitatore non viene incluso di default (sono dati personali) e viene aggiunto solo se lo abiliti esplicitamente per quell'endpoint.

Cosa puoi fare con i webhook

Configurazione flessibile, sicurezza solida e consegna prevedibile

Consegna degli eventi in batch

I clic arrivano raggruppati (redirects.batch) in una finestra temporale — questo riduce le richieste verso il tuo server.

Ambito a tua scelta

Tutti i link dell'account, un gruppo specifico o un singolo link — ricevi solo gli eventi di cui hai davvero bisogno.

Firma HMAC

Ogni richiesta è firmata con il tuo secret. Puoi rigenerare il secret in qualsiasi momento.

Retry e disattivazione automatica

Un server non raggiungibile fa scattare nuovi tentativi; un endpoint costantemente "morto" viene disattivato automaticamente.

Log delle consegne

Uno storico di tutti gli invii, con stato e contenuto — utile per risalire alla causa di un problema.

Invio di test (ping)

Verifica l'integrazione con un clic prima di ricevere traffico reale — il tuo server riceverà un evento di test.

Dati ricchi per ogni evento

link_id, orario, paese, città, sistema operativo, dispositivo, browser, referrer e flag bot per ogni clic.

Privacy di default

L'indirizzo IP non viene inviato a meno che tu non lo abiliti esplicitamente per uno specifico endpoint.

Prova gratis

Come configurare un webhook

Cinque passaggi — dall'URL del tuo server a un flusso continuo di eventi di clic

1
Crea un endpoint

Registrati su Lix.li, apri la sezione Webhooks e inserisci l'URL del tuo server — è lì che Lix.li invierà gli eventi di clic.

2
Scegli l'ambito

Decidi per quali link vuoi ricevere eventi: tutti i link dell'account, un gruppo specifico o un singolo link.

3
Salva il secret di firma

Lix.li ti fornisce una chiave segreta. Ogni richiesta è firmata con HMAC — verifica la firma nell'header per confermare che l'evento provenga davvero da Lix.li.

4
Invia una richiesta di test

Clicca su "Test" (ping) e verifica che il tuo server accetti la richiesta e risponda con un 2xx. Così validi l'integrazione prima dell'arrivo di traffico reale.

5
Monitora il log delle consegne

Nel log vedi tutti gli invii, il loro stato e i tentativi ripetuti. Se il server non è raggiungibile, la consegna viene ritentata, e un endpoint costantemente "morto" viene disattivato automaticamente.

Configura un webhook

Domande frequenti sui webhook

Un webhook è una notifica HTTP che Lix.li invia autonomamente al tuo server quando accade un evento. Non devi interrogare nessuna API: i dati arrivano automaticamente nel momento in cui qualcuno clicca sul tuo link.
I clic sui tuoi link brevi. Gli eventi arrivano in batch (event_type = redirects.batch); ogni clic include orario, paese, città, sistema operativo, dispositivo, browser, referrer e flag bot.
JSON via HTTP POST. Il corpo contiene campi tecnici (delivery_id, finestra temporale, count) più un array events con i dati di ogni clic. Un esempio completo del corpo della richiesta è disponibile in questa pagina.
Ogni richiesta è firmata con HMAC a partire dalla tua chiave segreta — confronta la firma nell'header con il corpo della richiesta per scartare le falsificazioni. Puoi rigenerare il secret (rotazione) in qualsiasi momento.
La consegna viene ritentata automaticamente. Se un endpoint resta senza risposta troppo a lungo, viene disattivato temporaneamente, e tutti i tentativi con il loro stato restano nel log delle consegne — nessun evento va perso senza che tu te ne accorga.
Sì. Puoi scegliere l'ambito: tutti i link dell'account, i link di un gruppo specifico o un singolo link. Così eviti traffico inutile verso il tuo server.
Di default no, perché sono dati personali. L'IP viene incluso negli eventi solo se lo abiliti esplicitamente nelle impostazioni di quello specifico endpoint.
I webhook sono disponibili con il piano Premium. Registrati e passa a Premium per collegare il tuo endpoint.

Costruisci integrazioni sugli eventi di clic

Configura un webhook in pochi minuti e ricevi i dati sui clic esattamente dove ti servono.

I webhook di Lix.li sono un modo per ricevere automaticamente notifiche di clic sui tuoi link brevi. Invece di interrogare un'API di continuo, fornisci l'URL del tuo server e Lix.li invia lì una richiesta HTTP POST nel momento del clic. È il classico HTTP callback applicato ai link brevi, che porta gli eventi di clic nel tuo sistema in tempo reale.

Ogni corpo di richiesta è un evento redirects.batch con un array di clic: ognuno include orario, paese, città, browser, sistema operativo, dispositivo, referrer e flag bot. È facile far confluire questi dati nel tuo database o CRM, trasformarli in notifiche di clic su Telegram, Slack o Discord, oppure usarli come trigger in Zapier, Make e n8n. Le richieste sono protette da una firma HMAC: confronti la firma nell'header con il corpo per scartare le falsificazioni, e puoi rigenerare il secret ogni volta che serve.

La consegna è prevedibile: in caso di guasto del server, gli eventi vengono ritentati, un endpoint costantemente "morto" viene disattivato temporaneamente, e ogni tentativo compare nel log delle consegne. Puoi limitare l'ambito a tutti i link, a un solo gruppo o a un singolo link, e validare l'integrazione con un invio di test (ping) prima dell'arrivo di traffico reale. I webhook funzionano insieme ai normali link brevi di Lix.li, ai codici QR e alle statistiche, e sono disponibili con il piano Premium.

Configura un webhook