How-to guide

Comment ajouter un aperçu de lien sur Bluesky ou Mastodon

Last updated: 2026-05-26 · Bluesky · By SocialKit Team

Les aperçus de liens sur Bluesky et Mastodon semblent simples, mais ils se brisent pour des raisons différentes selon la plateforme. Ce guide explique pourquoi — enregistrements embed AT Protocol sur Bluesky, récupération OpenGraph côté serveur sur Mastodon — et montre comment programmer des publications avec une carte fonctionnelle à chaque fois.

Avant de commencer

Vous avez besoin d'un compte Bluesky (n'importe quel identifiant) et/ou d'un compte Mastodon sur n'importe quelle instance. Pour programmer des publications avec liens à l'avance, vous avez également besoin d'un compte SocialKit — l'essai gratuit de 7 jours (0,00 € à régler aujourd'hui) couvre les deux plateformes.

Côté propriétaire de la page : l'URL que vous ciblez doit avoir des balises méta OpenGraph correctes (`og:title`, `og:description`, `og:image`) pour qu'une carte apparaisse sur l'un ou l'autre réseau. Si vous êtes propriétaire de la page cible, vérifiez ces balises en premier. Si vous faites un lien vers une URL tierce, vous ne pouvez influencer que votre publication — pas la présence de balises OG sur leur page — ajustez vos attentes en conséquence.

Step by step

  1. Comprendre comment Bluesky génère les cartes de lien

    Sur Bluesky, une carte d'aperçu de lien n'est pas simplement une URL rendue — c'est un enregistrement `app.bsky.embed.external` explicitement attaché à votre publication au moment de sa création. En juin 2026, lorsque vous collez une URL dans l'application web Bluesky ou un compositeur tiers conforme, le client récupère les balises OpenGraph de la page et intègre le titre, la description et la miniature dans cet enregistrement embed. L'AT Protocol le stocke alors aux côtés du texte de la publication. Si l'enregistrement embed est absent, aucune carte n'apparaît — même si l'URL figure dans le texte de la publication.

    Tip: Une URL brute saisie dans le corps d'une publication sans enregistrement embed apparaîtra comme du texte brut sur la plupart des clients Bluesky, et non comme une carte. Confirmez toujours que l'aperçu de la carte s'affiche dans le compositeur avant de publier.

  2. Vérifier que l'URL cible possède des balises OpenGraph

    Collez l'URL dans un navigateur et affichez le code source (Ctrl/Cmd + U), puis recherchez `og:title`, `og:description` et `og:image`. Toutes les trois doivent être présentes. Si `og:image` est absente, certains clients génèrent une carte textuelle uniquement ; si les dimensions de l'image sont trop petites (Bluesky attend au moins 800 px de large en juin 2026), la miniature peut être vide ou mal recadrée. Pour vos propres pages, corrigez les balises dans le CMS ou le `<head>` et validez avec un vérificateur de balises OG gratuit avant de diffuser le lien.

    Tip: Les images des cartes Bluesky s'affichent dans un ratio 1,91:1 (environ 1200 × 628 px), identique au standard OG. Une image `og:image` carrée sera affichée en letterbox plutôt que rognée sur la plupart des clients — utilisez une image 1200 × 628 px pour un résultat optimal.

  3. Composez votre publication Bluesky dans SocialKit et confirmez l'aperçu de la carte

    Ouvrez le compositeur de SocialKit et sélectionnez votre compte Bluesky connecté comme destination. Collez votre URL dans le corps de la publication. En juin 2026, SocialKit récupère les données OpenGraph de la page et affiche un aperçu en direct de la carte dans le compositeur afin que vous puissiez confirmer le titre, la description et la miniature avant de programmer. Si la carte est vide ou affiche un texte générique, le problème vient probablement des balises OG de la page cible — corrigez-les d'abord (voir l'étape 2), puis actualisez le compositeur.

    Tip: Si vous faites un lien vers une page dont les balises OG ont été récemment modifiées, certains CDN ou caches de prévisualisation peuvent mettre des minutes à des heures à se rafraîchir. Ajouter un paramètre de cache-busting (ex. `?v=2`) force une nouvelle récupération dans la plupart des compositeurs, mais modifie l'URL canonique — utilisez cette méthode uniquement sur des pages que vous possédez et où ce changement est acceptable.

  4. Comprendre comment Mastodon génère les cartes de lien

    Les cartes de lien Mastodon fonctionnent différemment de Bluesky. Lorsque votre instance principale reçoit une publication contenant une URL, son serveur récupère la page cible de manière asynchrone et analyse ses balises OpenGraph — généralement en quelques secondes, parfois jusqu'à une minute sur les instances chargées ou soumises à des limites de débit. La carte apparaît une fois cette récupération côté serveur terminée. En juin 2026, cela signifie : (a) la carte peut ne pas apparaître immédiatement même si les balises OG sont correctes ; (b) si l'URL cible est protégée par un CAPTCHA ou un défi Cloudflare bloquant les robots, l'instance ne pourra pas la récupérer et la carte n'apparaîtra jamais ; (c) le comportement des cartes peut varier selon les versions de Mastodon (la ligne stable actuelle est la 4.x).

    Tip: Mastodon ne stocke pas la carte dans l'enregistrement de publication comme Bluesky — elle est générée à la demande depuis l'URL à chaque chargement de publication par un client. Corriger une balise OG défectueuse sur la page cible finira donc par corriger la carte sur toutes les publications Mastodon passées qui y font référence, une fois le cache de l'instance actualisé.

  5. Composez votre publication Mastodon dans SocialKit et programmez-la

    Dans le compositeur de SocialKit, sélectionnez votre compte Mastodon connecté en complément (ou à la place) de Bluesky. Rédigez le texte de votre publication et collez l'URL. Utilisez la personnalisation par plateforme pour adapter la légende si vous publiez sur les deux réseaux simultanément — la limite de caractères par défaut de Mastodon est 500 (certaines instances l'augmentent ; vérifiez la limite de votre instance dans les paramètres de votre compte), tandis que la limite de Bluesky est de 300 graphèmes en juin 2026. Choisissez une heure précise ou utilisez les données de meilleur moment, puis programmez. SocialKit publie automatiquement sur Mastodon à l'heure prévue ; aucune interaction téléphonique n'est requise.

    Tip: Le champ Avertissement de contenu (CW) de Mastodon est une zone de texte distincte qui masque le contenu de la publication derrière un clic. Il est couramment utilisé pour les spoilers, les sujets sensibles ou les longs fils — pas pour les publications de liens standard. Laissez-le vide à moins que les normes de votre communauté ne l'exigent.

  6. Ajoutez des paramètres UTM pour suivre les clics par réseau

    Si le lien de votre publication pointe vers une page que vous possédez, ajoutez des paramètres UTM afin que Google Analytics 4 (ou toute autre plateforme d'analyse) distingue les clics Bluesky des clics Mastodon. Un jeu minimal ressemble à `?utm_source=bluesky&utm_medium=social&utm_campaign=votre-campagne`. Utilisez le générateur UTM gratuit de SocialKit pour les créer sans fautes de frappe, puis collez l'URL taguée dans le compositeur avant que la carte de prévisualisation ne soit récupérée. La carte affichera les métadonnées de la page de destination même si l'URL inclut des paramètres.

    Tip: Bluesky et Mastodon transmettent les URL non modifiées — ni l'un ni l'autre ne supprime les paramètres UTM comme certaines plateformes le font. La miniature et le titre de la carte proviennent des balises OG de la page de destination quelle que soit la chaîne de requête, les URL taguées UTM produisent donc des aperçus de carte corrects.

  7. Partagez la même publication avec lien sur X, Threads ou d'autres plateformes

    Toujours dans la même session du compositeur SocialKit, ajoutez X (Twitter), Threads ou l'une des neuf autres plateformes prises en charge comme destinations supplémentaires. Chacune dispose de son propre champ de légende — gardez Bluesky sous 300 graphèmes, Mastodon sous la limite de votre instance, X (Twitter) sous 280 caractères (comptes standard, en juin 2026 ; les abonnements premium diffèrent) et Threads sous 500 caractères. Le comportement des cartes de lien varie selon la plateforme : X affiche une carte de prévisualisation et retire l'URL du nombre de caractères ; Threads et Bluesky affichent des cartes intégrées ; Mastodon en récupère une de manière asynchrone. Programmez toutes les destinations en une seule session.

Best practices

  • Incluez toujours les trois balises OpenGraph essentielles — `og:title`, `og:description` et `og:image` — sur toute page dont vous prévoyez de partager le lien. L'absence de l'une d'elles dégrade ou supprime la carte sur Bluesky et Mastodon.
  • Utilisez une image 1200 × 628 px pour `og:image`. Ce ratio 1,91:1 est le standard sur Bluesky, Mastodon et la plupart des autres réseaux, et évite le letterboxing ou le rognage selon les clients.
  • Sur Bluesky, confirmez que la carte s'affiche dans le compositeur de SocialKit avant de programmer — une fois une publication publiée sur l'AT Protocol, l'enregistrement embed est figé et ne peut être modifié sans supprimer et reposter.
  • Sur Mastodon, attendez jusqu'à 60 secondes après la mise en ligne d'une publication avant de conclure que la carte est défectueuse — notamment sur les petites instances ou les instances chargées en juin 2026.
  • Utilisez des URL taguées UTM pour chaque publication avec lien et adoptez une convention de nommage cohérente (`utm_source=bluesky`, `utm_source=mastodon`) afin que vos analytics distinguent clairement le trafic des protocoles ouverts des autres canaux.
  • Programmez vos publications avec liens pendant les heures d'activité de votre audience grâce aux données de meilleur moment de SocialKit — une carte correcte qui arrive quand personne n'est en ligne reste peu performante. Consultez /best-time-to-post/bluesky et /best-time-to-post/mastodon pour des fenêtres de départ actuelles.

Good to know

Pourquoi « j'ai collé l'URL mais il n'y a pas de carte » — les deux causes les plus fréquentes

Sur Bluesky : la cause la plus courante est que le compositeur n'a pas généré d'enregistrement embed, soit parce que la récupération OG a échoué (blocage anti-robots, serveur lent, balises manquantes), soit parce que vous avez collé l'URL après avoir tapé un autre texte et que le client n'a pas re-déclenché la récupération. Pour corriger, effacez la publication, collez l'URL en premier, attendez que l'aperçu de la carte apparaisse, puis ajoutez votre texte de légende autour. Si la carte n'apparaît toujours pas, les balises OG de la page cible sont absentes ou renvoient des erreurs.

Sur Mastodon : la cause la plus courante est que votre instance n'a pas encore terminé la récupération asynchrone, ou que le serveur cible a bloqué la requête de l'instance (Cloudflare, CAPTCHA ou blocage au niveau IP). Il n'existe aucun contournement pour une URL cible bloquée autre que d'utiliser une redirection ou une destination différente. Attendre 30 à 60 secondes et actualiser la publication résout généralement une situation de récupération lente en juin 2026.

Modification des publications Bluesky et enregistrement embed

En juin 2026, Bluesky ne prend pas en charge la modification des enregistrements de publication après publication — c'est un choix de conception délibéré de l'AT Protocol autour de l'immuabilité des publications et de l'intégrité de la fédération. Si une publication part avec une carte défectueuse ou manquante, votre seule option est de la supprimer et de la reposter avec l'embed corrigé. Cela rend la confirmation de la carte dans l'aperçu de SocialKit avant la programmation plus importante sur Bluesky que sur toute autre plateforme.

Mastodon prend en charge la modification des publications sur les instances exécutant la version 3.5.0 et ultérieures ; les publications modifiées affichent un badge d'historique d'édition sur les clients qui le supportent. Cependant, la modification d'une publication Mastodon actualise ou non le cache de la carte de lien selon les instances en juin 2026.

Do it in SocialKit

Le compositeur de SocialKit récupère les données OpenGraph et affiche un aperçu en direct de la carte avant que vous ne programmiez — pour détecter les aperçus défectueux avant qu'ils ne soient publiés. Programmez sur Bluesky, Mastodon et neuf autres plateformes depuis un seul calendrier. Publications programmées illimitées sur tous les forfaits, essai gratuit de 7 jours, 0,00 € à régler aujourd'hui.

Programmez vos publications avec liens Bluesky et Mastodon avec SocialKit
All 11 platforms included

Try it free

Schedule and cross-post to all 11 networks from one calendar on one flat plan. 7-day free trial — €0.00 due today.

Démarrer mon essai gratuit

0,00 € dû aujourd’hui · annulable à tout moment · garantie 7 jours satisfait ou remboursé

FAQ

Frequently asked questions

The questions people ask before they schedule — answered honestly, hedged where platform behavior changes.

Démarrer mon essai gratuit

0,00 € dû aujourd’hui · annulable à tout moment · garantie 7 jours satisfait ou remboursé