Zapier

Zapier communique avec la même API REST que vos propres scripts. Il vous faut un espace de travail Growth ou Ultimate et un jeton API issu de Intégrations → Zapier (ou API — c'est le même jeton).

Connecter l'application

1. Dans Zapier, ajoutez la connexion Letlink et collez le jeton API lorsqu'il vous est demandé.
2. Zapier appelle GET /api/v1/auth/me pour le vérifier.
3. Si le test échoue avec une erreur 403, l'offre de l'espace de travail n'inclut pas encore l'API — passez à Growth.

Déclencheur : un lien est visité

Il s'agit d'un REST Hook sur l'événement link_visited. Lorsque vous activez le Zap, Zapier envoie un POST à /api/v1/hooks/subscribe avec son URL Catch. Chaque clic enregistré est ensuite envoyé en POST au format de payload des webhooks (voir Webhooks). Pendant que vous associez les champs, Zapier peut aussi appeler GET /api/v1/visits pour récupérer des lignes d'exemple — cet endpoint renvoie les 50 derniers clics au même format.

Champs utiles dans le Zap : link_shortcode, link_destination_url, visitor_device_type, visitor_browser, visitor_referrer, visitor_variation, utm_source, utm_campaign, instagram_username.

Action : créer un lien

Correspond à POST /api/v1/links. Vous pouvez transmettre type, destination, short_code, title, domain et les champs des types intelligents (ios_url, android_url, etc.). Les types intelligents sur l'offre Free et les espaces de travail au-delà du quota renvoient une erreur dans le journal d'exécution du Zap.

Notes opérationnelles

• Régénérer le jeton dans Letlink coupe la connexion Zapier jusqu'à ce que vous colliez la nouvelle valeur.
• Désactiver un Zap devrait désabonner le hook. S'il reste une URL Catch, supprimez-la dans Intégrations → Webhooks.
• Les liens à fort trafic déclencheront une exécution de Zap par clic enregistré. Filtrez dans Zapier (par exemple uniquement visitor_variation = qr) plutôt que d'enregistrer un second code court.