1. Gere seu token de acesso pessoal do Figma

Para conectar seu arquivo do Figma ao plugin Commentful, você precisa gerar um token de acesso pessoal na sua conta do Figma:

1. Abra o painel Settings (no menu suspenso do ícone da sua conta do Figma).
2. Na janela de configurações, role a aba Account até a seção Personal access tokens.
3. Clique em Generate new token.
4. Defina um Token name (por exemplo, Commentful Figma Plugin).
5. Defina a opção Expiration do menu suspenso como 90 Days.
6. Confira se a opção File content do menu suspenso está definida como Read-only.
7. Confira se a opção Comments do menu suspenso está definida como Write.
8. Todas as outras opções dos menus suspensos podem ficar como No access.
9. Clique no botão Generate token.
10. Clique em Copy this token (esta é a sua única chance de copiá-lo).

O Figma removeu a opção No expiration do menu suspenso Expiration, então você vai precisar renovar seu token de acesso pessoal do Figma a cada 90 dias. Você não perde nenhum dado, comentário ou dado de revisão se o token expirar: ele só serve para autenticar o plugin Commentful e permitir que ele veja os comentários do seu arquivo do Figma.

Limites de requisições da API do Figma (em vigor desde 17 de novembro de 2024) O Figma limita as requisições à API a 5 por minuto para os usuários do plano Starter (grátis) do Figma. O Commentful reduz automaticamente o impacto desse limite com cache e controle de requisições. Para um uso mais intenso (por exemplo, publicar muitos comentários por minuto pelo plugin Commentful), considere fazer upgrade para um assento Full do Figma.

2. Cole seu token e a URL do arquivo do Figma no Commentful

Depois de gerar seu token de acesso pessoal do Figma e copiá-lo para a área de transferência, execute o plugin Commentful e siga os passos abaixo:

1. Clique no botão Connect This Figma File no plugin Commentful.
2. Cole seu token de acesso pessoal no plugin e clique no botão Save Token.
3. Clique no botão Share no canto superior direito do seu arquivo do Figma para abrir a janela de compartilhamento.
4. Defina as permissões do arquivo do Figma para Anyone with the link como can view.
5. Clique em Copy link para copiar a URL do arquivo do Figma atual para a área de transferência.
6. Cole a URL do arquivo do Figma no plugin e clique no botão Save URL.

Se você duplicou um arquivo do Figma a partir de outro arquivo que já estava vinculado ao Commentful, precisa vincular o plugin novamente com a nova URL do arquivo duplicado clicando no botão Re-link your Figma File no painel Settings do Commentful.