Vídeo tutorial: exportar comentários de arquivos do Figma

Este vídeo mostra como exportar os comentários dos seus arquivos do Figma para arquivos CSV/JSON (com referências em imagem) usando o plugin CopyDoc.

Gerar seu token de acesso pessoal do Figma

Para exportar comentários com o plugin CopyDoc, 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, CopyDoc Figma Plugin).
5. Na lista suspensa Expiration, escolha 90 Days.
6. Confira se a lista suspensa File content está definida como Read-only.
7. Confira se a lista suspensa Comments está definida como Write.
8. Todas as outras listas suspensas podem ficar como No access.
9. Clique no botão Generate token.
10. Clique em Copy this token (essa é sua única chance de copiá-lo).

Exportar os comentários do Figma com o plugin CopyDoc

Para começar a usar este recurso, clique no botão Export Comments na tela principal do plugin CopyDoc e siga os passos abaixo:

Adicionar seu token pessoal do Figma

Para autenticar a leitura dos comentários do seu arquivo do Figma, você precisa adicionar manualmente um token de acesso pessoal do Figma seguindo os passos da seção Gerar seu token de acesso pessoal do Figma acima.

Seu token é salvo automaticamente depois de uma exportação bem-sucedida. Depois que você exportar comentários com sucesso pelo CopyDoc, seu token de acesso pessoal do Figma será salvo automaticamente (e já virá preenchido no campo) para uso futuro no plugin, também em outros projetos do Figma.

Adicionar a URL do arquivo do Figma

Você precisa adicionar manualmente a URL da sua página do Figma: clique no botão Share no cabeçalho do Figma, depois em Copy link na janela que abrir e, por fim, cole a URL copiada no campo Figma Page URL (Required) nas configurações do plugin CopyDoc.

Ativar a opção de referências do design

Ativar a opção Include Design References inclui imagens .png (com marcadores numerados e posicionados para cada conversa de comentários) de cada frame que tenha pelo menos um comentário. Elas servem de referência visual junto com os comentários em texto exportados para os arquivos .csv e .json.

Buscar e exportar os comentários

Depois de adicionar uma Figma Page URL e um Figma Personal Access Token válidos, clique no botão Export Comments to CSV/JSON. O CopyDoc vai procurar comentários no seu arquivo do Figma e gerar um arquivo CSV e um JSON (junto com as imagens de referência, se a opção Include Design References estiver ativada).

Quando o CopyDoc terminar de exportar os comentários, você verá uma mensagem de confirmação. Para baixar o arquivo .zip com os comentários exportados, clique no botão Download Comments.

Salvar arquivos baixados do Figma. Se você usa o app desktop do Figma, vai aparecer uma janela para baixar o arquivo. Já se você usa o Figma em um navegador, por padrão o arquivo é baixado automaticamente para o seu computador (normalmente para a pasta Downloads).

Abrir o arquivo .zip

Depois de baixar o arquivo .zip do Figma para o seu computador, abra o gerenciador de arquivos na pasta onde ele foi salvo. Clique duas vezes no arquivo .zip exportado para descompactar o conteúdo e usar seus comentários como quiser.