1. Générez votre jeton d’accès personnel Figma

Pour connecter votre fichier Figma au plugin Commentful, vous devez générer un jeton d’accès personnel dans votre compte Figma :

1. Ouvrez le panneau Settings (dans le menu déroulant sous l’icône de votre compte Figma).
2. Dans l’onglet Account de la fenêtre des réglages, faites défiler jusqu’à la section Personal access tokens.
3. Cliquez sur Generate new token.
4. Saisissez un Token name (par exemple, Commentful Figma Plugin).
5. Réglez l’option déroulante Expiration sur 90 Days.
6. Vérifiez que l’option déroulante File content est réglée sur Read-only.
7. Vérifiez que l’option déroulante Comments est réglée sur Write.
8. Toutes les autres options déroulantes peuvent rester sur No access.
9. Cliquez sur le bouton Generate token.
10. Cliquez sur Copy this token (c’est votre seule occasion de le faire).

Figma a supprimé l’option No expiration du menu déroulant Expiration : vous devrez donc renouveler votre jeton d’accès personnel Figma tous les 90 jours. Vous ne perdrez aucune donnée, aucun commentaire ni aucune donnée de revue si votre jeton d’accès personnel Figma expire : le jeton sert uniquement à authentifier le plugin Commentful pour qu’il puisse afficher les commentaires de votre fichier Figma.

Limites de requêtes de l’API Figma (en vigueur depuis le 17 novembre 2024). Figma limite les requêtes API à 5 par minute pour les utilisateurs de son offre Starter (gratuite). Commentful atténue automatiquement cette limite grâce à la mise en cache et à la limitation des requêtes. Pour un usage plus intensif (par exemple, publier de nombreux commentaires par minute via le plugin Commentful), envisagez de passer à un siège Figma Full.

2. Collez votre jeton et l’URL de votre fichier Figma dans Commentful

Une fois votre jeton d’accès personnel Figma généré et copié dans votre presse-papiers, lancez le plugin Commentful et suivez les étapes ci-dessous :

1. Cliquez sur le bouton Connect This Figma File dans le plugin Commentful.
2. Collez votre jeton d’accès personnel dans le plugin et cliquez sur le bouton Save Token.
3. Cliquez sur le bouton Share en haut à droite de votre fichier Figma pour ouvrir la fenêtre de partage.
4. Réglez les autorisations du fichier Figma pour Anyone with the link sur can view.
5. Cliquez sur Copy link pour copier l’URL du fichier Figma en cours dans votre presse-papiers.
6. Collez l’URL de votre fichier Figma dans le plugin et cliquez sur le bouton Save URL.

Si vous avez dupliqué un fichier Figma à partir d’un autre fichier déjà relié à Commentful, vous devez relier de nouveau le plugin à l’URL du fichier Figma dupliqué en cliquant sur le bouton Re-link your Figma File dans le panneau Settings de Commentful.