Liens courts

Un lien court est une adresse courte comme https://sms.exemple.com/l/7KQ2M9XH4B qui envoie quiconque l'ouvre vers une adresse plus longue de votre choix. La passerelle le sert elle-même et compte chaque ouverture.

À quoi servent les liens courts

• Gagner des caractères. Une longue adresse web peut doubler le nombre de SMS facturés par destinataire. Un lien court fait tenir le message en moins de SMS.
• Mesurer. Vous voyez combien de destinataires ont ouvert le lien, et combien de personnes distinctes l'ont fait. Rattachés à une campagne, les clics apparaissent aussi dans son compteur Clics.
• Garder vos données chez vous. Aucun raccourcisseur tiers n'intervient : personne en dehors de votre passerelle ne sait qui a cliqué ni ce que vous promouvez.

Trois façons d'obtenir un lien court

Vos intégrations peuvent faire de même par l'API : voir Par l'API.

Comment ça marche

1. Un lien est créé à partir d'une adresse de destination, éventuellement rattaché à une campagne.
2. Son adresse courte est l'adresse publique de votre passerelle (GATEWAY_PUBLIC_URL) suivie de /l/ et d'un code de dix caractères. Tous les liens courts de votre passerelle ont la même longueur, ce qui permet au dashboard de vous annoncer à l'avance la longueur de votre message.
3. L'adresse courte va dans votre message.
4. Quand un destinataire la touche, la passerelle enregistre le clic et l'envoie vers la destination.

Le code utilise des lettres majuscules et des chiffres, sans I, L, O ni U, pour ne pas être mal lu lorsqu'il est recopié. Il est tiré au hasard et assez long pour que personne ne puisse deviner vos autres liens en essayant des codes.

Votre passerelle doit être joignable depuis Internet à son adresse publique pour que les téléphones des destinataires puissent ouvrir le lien. Une passerelle joignable seulement sur votre réseau local produit des liens qui fonctionnent dans votre réseau et nulle part ailleurs. L'écran Liens courts vous rappelle par quoi commencent vos liens.

L'écran Liens courts

Ouvrez Liens courts dans la section Messages du menu. Tous les comptes le voient ; créer et supprimer demandent un compte Opérateur ou Superadministrateur (un compte Lecture seule voit la liste et les clics, sans les boutons).

La liste

Les liens les plus récents viennent en premier, 50 à la fois (Charger la suite affiche les suivants).

Les compteurs se mettent à jour d'eux-mêmes quand quelqu'un clique, sans recharger la page.

Le filtre Campagne au-dessus de la liste n'affiche que les liens d'une campagne. Le choix est gardé dans l'adresse de la page : vous pouvez mettre en favori ou partager la vue des liens d'une campagne.

Actions d'une ligne

Le menu en bout de ligne propose :

Créer un lien

Cliquez sur Nouveau lien court :

Cliquez sur Créer le lien. La fenêtre affiche alors le lien court avec un bouton de copie ; Terminé la ferme et le lien apparaît en haut de la liste.

Raccourcir automatiquement les liens d'un message

L'interrupteur Raccourcir et suivre les liens se trouve sous le message dans Envoi rapide, à l'étape 2 de Nouvelle campagne, et dans la fenêtre Modifier d'une campagne qui n'a pas démarré. Il est désactivé par défaut : un message part exactement tel que saisi, sauf si vous l'activez.

Quand il est activé :

• chaque adresse qui commence par http:// ou https:// est remplacée par un nouveau lien court. Le reste du texte n'est pas touché, et la ponctuation qui suit une adresse (un point final, une virgule, une parenthèse fermante) reste hors du lien ;
• la même adresse écrite deux fois donne un seul lien ;
• tous les destinataires de l'envoi partagent le même lien : les clics sont comptés par lien, pas par personne ;
• une adresse qui est déjà un lien court de votre passerelle, ou qui serait refusée (plus de 2000 caractères), reste telle que saisie.

Comment la longueur change

Sous l'interrupteur, l'écran vous annonce l'effet avant l'envoi, par exemple : « Liens à raccourcir : 1. Longueur : 212 caractères avant, 118 après, soit 2 SMS avant et 1 après, par destinataire. » Le compteur de caractères et le coût de l'envoi sont calculés sur le texte avec ses liens courts, puisque c'est ce que votre opérateur facture.

Un lien court mesure la longueur de votre adresse publique plus 13 caractères (/l/ et le code). La plupart du temps il raccourcit le message ; une adresse déjà très courte peut l'allonger légèrement. Interrupteur activé, le compteur de SMS montre toujours le chiffre réel.

Dans l'envoi rapide

Les adresses sont remplacées au clic sur Envoyer. Les messages des Derniers envois, de la file et des conversations montrent les liens courts, c'est-à-dire ce que reçoivent les destinataires. Les nouveaux liens apparaissent dans Liens courts, rattachés à aucune campagne.

Dans une campagne

Le choix est enregistré avec la campagne. Les adresses sont remplacées une seule fois, au démarrage de la campagne (à Envoyer maintenant, à Lancer, ou à son heure programmée), par des liens rattachés à cette campagne :

• jusqu'au démarrage, le texte de la campagne garde les adresses que vous avez saisies, et vous pouvez encore désactiver l'interrupteur dans Modifier ;
• à partir du démarrage, le texte de la campagne montre les liens courts, chaque destinataire reçoit exactement le même texte, et chaque clic s'ajoute au compteur Clics de la campagne ;
• le récapitulatif de l'étape 3 rappelle le choix sous Liens.

Une campagne dupliquée à partir d'une campagne déjà démarrée reprend son texte avec les liens courts de l'originale : leurs clics comptent toujours pour la campagne d'origine. Pour mesurer la nouvelle campagne séparément, remettez les adresses d'origine dans le texte de la copie.

Ce qui est enregistré lors d'un clic

Le panneau Voir les clics liste les ouvertures d'un lien, les plus récentes d'abord, avec le total et le nombre de visiteurs uniques :

Les visiteurs distincts sont comptés à partir de l'adresse tronquée et de la description du navigateur : deux personnes derrière la même connexion de bureau avec le même modèle de téléphone peuvent compter pour une. Considérez le nombre de visiteurs uniques comme une bonne estimation, pas comme un décompte exact.

L'événement link.clicked peut prévenir vos outils à chaque clic : voir Webhooks.

Par l'API

Champs de POST /api/v1/links :

Avec une clé API, la lecture demande la portée read, et créer ou supprimer un lien demande la portée admin. Voir Clés API.

Exemple :

curl -X POST https://sms.exemple.com/api/v1/links \
  -H "X-API-KEY: $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"targetUrl": "https://boutique.exemple.com/soldes/automne?utm_source=sms",
       "campaignId": "0192f0c4-3b1e-7c55-9a41-2f5d8e6b7a10"}'

La réponse contient shortUrl, à coller dans votre message, et les compteurs clickCount (chaque ouverture) et uniqueClickCount (visiteurs distincts).

Pour raccourcir les adresses d'un message envoyé par l'API, ajoutez "shortenLinks": true à POST /api/v1/messages : cela se comporte comme l'interrupteur de l'Envoi rapide, avec la portée qui envoie des messages. Les campagnes acceptent le même champ, shortenLinks, à la création et en modification. Voir Utiliser l'API.

Limites

• Un lien ne se modifie pas : pour changer sa destination, créez-en un nouveau.
• Supprimer un lien le casse pour tous ceux qui l'ont déjà reçu : ils obtiennent une page « introuvable ».
• L'ouverture d'un lien est toujours comptée, y compris par les aperçus de liens automatiques que font certaines messageries et certains filtres de sécurité. Quelques clics juste après l'envoi peuvent venir d'eux.
• Un lien dont la campagne a été supprimée continue de fonctionner et de compter ses clics. Il n'est simplement plus rattaché à une campagne.
• Les liens fabriqués par un envoi sont partagés par tous ses destinataires : la passerelle ne vous dit pas quel destinataire a cliqué.

Dépannage