- Accueil
- Intégrations
- Webhooks
Webhooks
Des webhooks pour connecter vos liens à vos scénarios automatisés
Un lien atteint sa date de fin, une page est créée ou modifiée : TinyLink envoie dans la minute un message JSON signé à l’adresse de votre choix. Votre scénario Make, Zapier ou n8n, ou votre propre serveur, prend le relais. Jusqu’à 10 adresses par espace, chacune avec ses événements ; les endpoints de l’API REST font le chemin inverse.
Webhooks inclus à partir de l’offre Pro, à 29 € HT par mois, sans engagement. Gratuit pour commencer, sans carte bancaire.
Ce que coûte une information qui arrive trop tard
Une vente privée se termine dimanche soir. Le lien cesse de rediriger, comme prévu, mais personne n’est prévenu : la campagne reste ouverte dans le CRM, la relance part lundi vers une offre finie, et le tableau de suivi attend qu’on vienne relever les clics. Sans signal, vos outils travaillent avec les informations d’hier, et quelqu’un passe ses lundis à vérifier.
Les événements qui comptent
Choisissez, pour chaque adresse, les événements qu’elle reçoit. Chaque message décrit l’objet concerné, avec ses identifiants et son adresse, prêt à être lu par votre scénario.
- link.expired : un lien court atteint sa date de fin ou son nombre de clics maximum
- page.created : une page est créée dans l’espace, depuis le tableau de bord, l’API ou un import
- page.updated : une page ou l’un de ses composants change, envoyé après une minute sans nouvelle modification
- test.ping : un message d’essai, envoyé d’un clic, pour vérifier votre récepteur
Slack, Discord, Teams, Make, n8n et vos serveurs
Collez l’adresse de votre canal Discord, Slack, Microsoft Teams, Google Chat ou Telegram : l’équipe y lit un vrai message, « Le lien tnlnk.fr/vente-privee a expiré ». Collez celle d’un scénario Make, Zapier ou n8n, ou de votre serveur : il reçoit le JSON complet, signé, avec le type d’événement dans l’en-tête X-TinyLink-Event. Aucune adaptation à faire, TinyLink reconnaît la destination.
Signés, renvoyés, traçables
Chaque message est signé en HMAC SHA-256 avec un secret propre à l’adresse, et horodaté pour écarter les rejeux. En cas d’échec, TinyLink le renvoie jusqu’à cinq fois, d’une minute à six heures plus tard. Le panneau affiche l’historique des 20 derniers envois avec leur code de réponse ; une adresse qui échoue 20 fois de suite est mise en pause plutôt que d’insister.
Une vente privée qui se clôt toute seule
Une marque programme le lien de sa vente privée jusqu’à dimanche, 23 h 59. À l’heure dite, le lien cesse de rediriger et TinyLink envoie link.expired au scénario n8n de l’équipe marketing. Dans la minute, le scénario prévient l’équipe, clôt la campagne dans le CRM et reporte le nombre de clics final dans le tableau de suivi. Personne n’a eu à y penser.
Questions fréquentes
À partir de quelle offre ?
Les webhooks sont inclus à partir de l’offre Pro, à 29 € HT par mois, sans engagement, comme l’API. Chaque espace peut déclarer jusqu’à 10 adresses, chacune avec ses événements.
Comment vérifier qu’un message vient bien de TinyLink ?
Chaque message porte l’en-tête X-TinyLink-Signature, avec un horodatage et une signature HMAC SHA-256 calculée avec le secret de l’adresse. Votre récepteur recalcule la signature et compare ; la documentation détaille la vérification pas à pas. Le secret se renouvelle à tout moment.
Faut-il savoir coder ?
Non, avec Make, Zapier ou n8n : ajoutez un déclencheur webhook à votre scénario, copiez son adresse dans TinyLink, puis envoyez un message d’essai pour que l’outil reconnaisse la structure du message.
Que se passe-t-il si mon scénario est en panne ?
Votre récepteur doit répondre par un code 2xx en moins de dix secondes. Sinon, le message est renvoyé après 1 minute, 5 minutes, 30 minutes, 2 heures puis 6 heures. Après 20 échecs d’affilée, l’adresse est mise en pause : réparez-la, puis réactivez-la dans le panneau, qui affiche les 20 derniers envois et leur réponse.
Vos outils prévenus au moment où ça compte
Créez votre compte, passez à l’offre Pro et ajoutez votre première adresse dans Bibliothèque ▸ Intégrations ▸ Webhooks. Le message d’essai part d’un clic.