- Home
- Integrazioni
- Webhook
Webhook
Webhook per collegare i tuoi link ai tuoi scenari automatizzati
Un link raggiunge la data di fine, una pagina viene creata o modificata: entro un minuto, TinyLink invia un messaggio JSON firmato all’indirizzo che scegli. Il tuo scenario Make, Zapier o n8n, o il tuo server, prende il testimone. Fino a 10 indirizzi per spazio, ognuno con i suoi eventi; gli endpoint dell’API REST fanno il percorso inverso.
Webhook inclusi dal piano Pro, a 29 € IVA esclusa al mese, senza vincoli. Gratis per iniziare, senza carta di credito.
Quanto costa un’informazione che arriva tardi
Una vendita privata finisce domenica sera. Il link smette di reindirizzare, come previsto, ma nessuno viene avvisato: la campagna resta aperta nel CRM, il promemoria parte lunedì verso un’offerta conclusa e il foglio di monitoraggio aspetta che qualcuno vada a prendere i clic. Senza un segnale, i tuoi strumenti lavorano con le informazioni di ieri, e qualcuno passa i lunedì a controllare.
Gli eventi che contano
Scegli, per ogni indirizzo, gli eventi che riceve. Ogni messaggio descrive l’elemento interessato, con i suoi identificativi e il suo indirizzo, pronto per essere letto dal tuo scenario.
- link.expired: un link breve raggiunge la data di fine o il numero massimo di clic
- page.created: viene creata una pagina nello spazio, dalla dashboard, dall’API o da un’importazione
- page.updated: cambia una pagina o uno dei suoi componenti, inviato dopo un minuto senza nuove modifiche
- test.ping: un messaggio di prova, inviato con un clic, per verificare il tuo ricevitore
Slack, Discord, Teams, Make, n8n e i tuoi server
Incolla l’indirizzo del tuo canale Discord, Slack, Microsoft Teams, Google Chat o Telegram: il team legge un vero messaggio, «Il link tnlnk.fr/vente-privee è scaduto». Incolla quello di uno scenario Make, Zapier o n8n, o del tuo server: riceve il JSON completo e firmato, con il tipo di evento nell’intestazione X-TinyLink-Event. Niente da adattare, TinyLink riconosce la destinazione.
Firmati, reinviati, tracciabili
Ogni messaggio è firmato in HMAC SHA-256 con un segreto proprio dell’indirizzo, e marcato con l’ora per escludere i replay. In caso di errore, TinyLink lo reinvia fino a cinque volte, da un minuto a sei ore dopo. Il pannello mostra lo storico degli ultimi 20 invii con il codice di risposta; un indirizzo che fallisce 20 volte di fila viene messo in pausa invece di insistere.
Una vendita privata che si chiude da sola
Un marchio programma il link della sua vendita privata fino a domenica alle 23:59. All’ora stabilita, il link smette di reindirizzare e TinyLink invia link.expired allo scenario n8n del team marketing. Entro un minuto, lo scenario avvisa il team, chiude la campagna nel CRM e riporta il numero finale di clic nel foglio di monitoraggio. Nessuno ha dovuto pensarci.
Domande frequenti
Da quale piano?
I webhook sono inclusi dal piano Pro, a 29 € IVA esclusa al mese, senza vincoli, come l’API. Ogni spazio può dichiarare fino a 10 indirizzi, ciascuno con i suoi eventi.
Come verifico che un messaggio arrivi davvero da TinyLink?
Ogni messaggio porta l’intestazione X-TinyLink-Signature, con un timestamp e una firma HMAC SHA-256 calcolata con il segreto dell’indirizzo. Il tuo ricevitore ricalcola la firma e confronta; la documentazione spiega la verifica passo per passo. Il segreto si rinnova in qualsiasi momento.
Bisogna saper programmare?
Non con Make, Zapier o n8n: aggiungi un trigger webhook al tuo scenario, copia il suo indirizzo in TinyLink, poi invia un messaggio di prova perché lo strumento riconosca la struttura del messaggio.
Cosa succede se il mio scenario non risponde?
Il tuo ricevitore deve rispondere con un codice 2xx entro dieci secondi. Altrimenti, il messaggio viene reinviato dopo 1 minuto, 5 minuti, 30 minuti, 2 ore e poi 6 ore. Dopo 20 errori di fila, l’indirizzo viene messo in pausa: correggilo, poi riattivalo nel pannello, che mostra gli ultimi 20 invii e la loro risposta.
I tuoi strumenti avvisati al momento giusto
Crea il tuo account, passa al piano Pro e aggiungi il tuo primo indirizzo in Libreria ▸ Integrazioni ▸ Webhook. Il messaggio di prova parte con un clic.