Liens courts pour SaaS : intégrez ClicAven dans votre produit via API

Les produits SaaS modernes génèrent quotidiennement des URLs à partager : invitations d'équipe, partages de documents, liens de téléchargement, pages de statut... Intégrer un raccourcisseur d'URL directement dans votre SaaS améliore l'expérience utilisateur et vous donne une visibilité précieuse sur les comportements de partage. L'API ClicAven rend cette intégration rapide et fiable.

Pourquoi les SaaS bénéficient des liens courts

L'intégration d'un raccourcisseur d'URL dans un SaaS répond à plusieurs cas d'usage concrets :

• Liens d'invitation : « Invitez un collègue » génère un lien court personnalisé avec le prénom de l'invitant et un token d'invitation — lisible, partageable par SMS ou email
• Partage de contenu : vos utilisateurs partagent des rapports, tableaux de bord ou documents. Un lien court go.votre-saas.com/rapport-xyz est bien plus pro que l'URL interne de votre app
• Téléchargements et exports : les liens de téléchargement temporaires sont souvent longs et complexes. Un lien court avec expiration est plus rassurant pour l'utilisateur
• Notifications et emails transactionnels : les liens dans vos emails de notification (confirmation, reset password, etc.) peuvent bénéficier d'un domaine cohérent avec votre marque
• Analytics sur les partages : mesurez combien de liens générés par vos utilisateurs sont effectivement cliqués — une métrique d'engagement précieuse

Intégrer l'API ClicAven dans votre SaaS

Voici un exemple d'intégration pour générer automatiquement un lien court lors d'un partage de rapport :

curl -X POST https://clicaven.com/api/v1/links \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.votre-saas.com/rapports/rpt_a1b2c3?token=eyJhbGc...",
"slug": "rapport-juin-equipe-acme",
"domain": "share.votre-saas.com",
"expires_at": "2025-07-31T23:59:59Z",
"metadata": {
  "user_id": "usr_456",
  "report_id": "rpt_a1b2c3",
  "workspace": "acme-corp"
}
}'

Le champ metadata vous permet de stocker des identifiants internes qui vous permettront de relier chaque clic ClicAven à un utilisateur et un objet spécifique dans votre base de données.

Webhooks ClicAven pour les notifications en temps réel

Plutôt que de poller l'API ClicAven pour détecter de nouveaux clics, configurez des webhooks pour recevoir une notification HTTP en temps réel à chaque événement :

• Événement link.clicked : reçu à chaque clic sur un lien. Contient l'ID du lien, la date/heure, le pays et le type d'appareil.
• Événement link.expired : notifie quand un lien atteint sa date d'expiration ou son nombre de clics maximum.
• Événement link.created : utile pour synchroniser les liens créés via l'interface ClicAven (par un opérateur) avec votre base de données.

Configuration du webhook dans ClicAven :

curl -X POST https://clicaven.com/api/v1/webhooks \
-H "Authorization: Bearer VOTRE_CLE_API" \
-H "Content-Type: application/json" \
-d '{
"url": "https://app.votre-saas.com/webhooks/clicaven",
"events": ["link.clicked", "link.expired"],
"secret": "votre_secret_webhook_pour_verifier_la_signature"
}'

Bonnes pratiques d'intégration SaaS

• Utilisez un domaine dédié pour vos partages : share.votre-saas.com ou go.votre-saas.com renforce votre identité de marque à chaque partage
• Créez les liens de manière asynchrone : ne bloquez jamais votre UI en attendant la réponse de l'API ClicAven. Créez le lien en background et renvoyez-le à l'utilisateur dès qu'il est disponible
• Gérez les expirations côté métier : définissez des durées de validité cohérentes avec votre logique applicative (ex. : lien d'invitation valable 7 jours)
• Stockez l'ID ClicAven dans votre base de données : conservez l'ID du lien ClicAven avec l'objet associé pour pouvoir interroger les stats ou supprimer le lien en cas de besoin
• Testez la résilience : que se passe-t-il si l'API ClicAven est temporairement indisponible ? Votre app doit gracefully fallback sur l'URL complète

Consultez la documentation complète de l'API ClicAven et les plans tarifaires pour SaaS. Créez votre compte pour commencer l'intégration.