Livré sans ralentir le clic
Le clic visiteur est servi d'abord. La livraison webhook est journalisée et traitée en arrière-plan.
Bêta développeur
Recevoir vos événements Linka Factory
Envoyez les clics, règles de routage servies et événements de liens courts vers vos outils internes, Make, Zapier, un CRM ou un tableau de reporting. Les redirections visiteurs restent prioritaires : les webhooks partent en arrière-plan.
Statut bêta : l'interface, la signature et les retries sont opérationnels. Les événements et champs peuvent encore évoluer avant stabilisation complète ; vérifiez vos intégrations après chaque ajout d'événement.
Chaque requête est signée
Chaque POST contient une signature HMAC SHA-256 dans X-Linka-Factory-Signature.
Réessais en cas d'échec
Les erreurs réseau et réponses HTTP non 2xx sont retentées automatiquement, avec un journal visible dans Settings.
Événements disponibles
campaign.click.recordedUn clic a été servi par une campagne.
campaign.routing_rule.matchedUne règle de routage avancé a été appliquée avant la répartition.
short_link.click.recordedUn clic a été servi par un lien court Linka Factory.
Garde-fous
- Endpoint HTTPS public uniquement, port 443.
- Localhost, IP privées, identifiants dans l'URL et domaines internes Linka Factory sont refusés.
- Le secret complet n'est affiché qu'une fois. Pour le remplacer, créez un nouvel endpoint puis révoquez l'ancien.
- Une confirmation UI ne remplace jamais la vérification serveur de signature.
Payload JSON
{
"id": "evt_campaign_click_recorded_01hq...",
"type": "campaign.click.recorded",
"created_at": "2026-05-01T17:40:00.000Z",
"account_id": "acc_...",
"data": {
"accountId": "acc_...",
"timestamp": "2026-05-01T17:40:00.000Z",
"campaignId": "cmp_...",
"urlId": "url_...",
"servedUrl": "https://example.com/landing-a",
"routingRuleId": "rule_...",
"routingRuleLabel": "France mobile",
"country": "FR",
"deviceType": "mobile",
"browserFamily": "chrome",
"platformFamily": "android",
"sourceSite": "newsletter",
"refererHost": "example.com",
"ipMasked": "203.0.113.0",
"suspicious": false
}
}Vérifier la signature
La signature est calculée sur la chaîne timestamp.point.body brut. Gardez le body exact reçu avant parsing JSON.
import crypto from "node:crypto"
export function verifyLinkaFactoryWebhook({ rawBody, signatureHeader, secret }) {
const parts = Object.fromEntries(
signatureHeader.split(",").map((part) => part.split("=").map((value) => value.trim()))
)
const timestamp = parts.t
const expected = crypto
.createHmac("sha256", secret)
.update(`${timestamp}.${rawBody}`)
.digest("hex")
return crypto.timingSafeEqual(
Buffer.from(expected, "hex"),
Buffer.from(parts.v1 || "", "hex")
)
}Livraison
Comment Linka Factory réessaie
Un statut HTTP 2xx marque la livraison comme envoyée. Les autres statuts, timeouts et erreurs réseau passent en nouvelle tentative.
Le calendrier actuel retente environ après 60 secondes, 5 minutes, 30 minutes, puis 2 heures, avec 5 tentatives maximum.
Le journal des dernières livraisons affiche le statut, le nombre de tentatives, le code HTTP et un extrait de réponse pour déboguer vite.
Prochaine étape