Guia de Integração do Figma
O que a integração com o Figma faz
Com o Figma conectado, o Nakama mostra os projetos e arquivos da sua equipe (com miniaturas em tempo real) em seu próprio painel. Clicar em um arquivo o abre em tamanho real no Figma no seu navegador; o feed de comentários de cada arquivo fica bem dentro do painel: leia threads, responda, filtre os comentários que mencionam você e transforme qualquer comentário em um todo.
Adicionar o app (conectar)
1. Abra o painel lateral do Nakama no Chrome.
2. Pressione o botão + (Add) na parte inferior da barra à direita para abrir o Marketplace.
3. Escolha o Figma e pressione Conectar.
4. Uma página de login do Figma abre como uma aba do navegador. Entre e pressione Permitir para autorizar o Nakama.
5. Configuração única: cole a URL da sua equipe no Figma (abra sua equipe no figma.com e copie a barra de endereços). A API do Figma não tem um "listar minhas equipes", então o Nakama pergunta uma vez.
6. Um ícone do Figma aparece na barra do Nakama e o painel abre com os seus projetos.
Usar o app
Navegue pelos projetos. O título do painel é um seletor de projetos: alterne entre projetos pelo menu suspenso.
Abra arquivos. Cada arquivo mostra sua miniatura, nome e horário da última modificação. Clique nele e o arquivo abre no Figma em uma aba do navegador. O Nakama nunca tenta executar o Figma dentro do painel.
Acompanhe comentários. Pressione o botão de comentários em um arquivo para ver o feed dele: threads agrupadas, não resolvidas primeiro, com um filtro @me para os comentários que mencionam você. Novos comentários chegam em fluxo enquanto o feed está aberto.
Responda e atue. Escreva respostas bem dentro do painel; passe o cursor sobre um comentário para adicioná-lo à sua lista de Todo. Arraste um cartão de arquivo para o Slack ou o Telegram para compartilhar o link dele.
Permissões e tratamento de dados
O Nakama solicita os escopos do Figma files:read (projetos, arquivos, comentários) e file_comments:write (publicar respostas). Seu token do Figma é armazenado apenas no armazenamento local da extensão no seu navegador e nunca nos servidores do Nakama; o segredo do app permanece no servidor apenas para a troca do OAuth.
Remover o app (desconectar)
No Nakama: pressione + (Add) na barra para abrir o Marketplace, encontre o Figma (exibido como Conectado) e pressione-o para desconectar. O ícone sai da barra e o token armazenado é excluído do seu navegador.
No Figma: você também pode revogar o acesso em Figma Settings → Connected apps, o que o revoga pelo lado do Figma.
Solução de problemas
"Isso não parece uma URL de equipe": a URL da equipe precisa conter /team/<número>/. Abra sua equipe no navegador de arquivos do figma.com e copie o endereço completo.
Qualquer outra coisa: consulte a Central de ajuda ou envie um e-mail para help@rexplore.xyz.