1. Figma 개인 액세스 토큰 생성

Figma 파일을 Commentful 플러그인에 연결하려면 Figma 계정에서 개인 액세스 토큰을 생성해야 해요.

1. Settings 패널로 이동하세요(Figma 계정 아이콘 아래 드롭다운 메뉴에 있어요).
2. 설정 팝업의 Account 탭에서 Personal access tokens 섹션까지 스크롤하세요.
3. Generate new token을 클릭하세요.
4. Token name을 입력하세요(예: Commentful Figma Plugin).
5. Expiration 드롭다운 옵션을 90 Days로 설정하세요.
6. File content 드롭다운 옵션이 Read-only로 설정되어 있는지 확인하세요.
7. Comments 드롭다운 옵션이 Write로 설정되어 있는지 확인하세요.
8. 나머지 드롭다운 옵션은 모두 No access로 두면 돼요.
9. Generate token 버튼을 클릭하세요.
10. Copy this token을 클릭하세요(토큰을 복사할 수 있는 기회는 이번 한 번뿐이에요).

Figma가 Expiration 드롭다운에서 No expiration 옵션을 없앴기 때문에, Figma 개인 액세스 토큰을 90일마다 새로 발급해야 해요. 토큰이 만료되어도 데이터, 댓글, 리뷰 데이터는 전혀 사라지지 않아요. 토큰은 Commentful 플러그인이 Figma 파일의 댓글을 볼 수 있도록 인증하는 역할만 해요.

Figma API 요청 한도(2024년 11월 17일부터 적용) Figma는 Starter(무료) 플랜 사용자의 API 요청을 분당 5회로 제한해요. Commentful은 캐싱과 요청 제한으로 이 한도의 영향을 자동으로 줄여요. 사용량이 많다면(예: Commentful 플러그인으로 분당 많은 댓글을 게시하는 경우) Figma Full 시트로 업그레이드하는 것을 고려해 보세요.

2. Commentful에 토큰과 Figma 파일 URL 붙여 넣기

Figma 개인 액세스 토큰을 생성해 클립보드에 복사했다면 Commentful 플러그인을 실행하고 아래 단계를 따르세요.

1. Commentful 플러그인에서 Connect This Figma File 버튼을 클릭하세요.
2. 개인 액세스 토큰을 플러그인에 붙여 넣고 Save Token 버튼을 클릭하세요.
3. Figma 파일 오른쪽 위의 Share 버튼을 클릭해 공유 팝업을 여세요.
4. Anyone with the link의 Figma 파일 권한을 can view로 설정하세요.
5. Copy link를 클릭해 현재 Figma 파일 URL을 클립보드에 복사하세요.
6. Figma 파일 URL을 플러그인에 붙여 넣고 Save URL 버튼을 클릭하세요.

이미 Commentful에 연결된 Figma 파일을 복제해 새 파일을 만들었다면, Commentful Settings 패널의 Re-link your Figma File 버튼을 클릭해 복제한 Figma 파일의 새 URL로 플러그인을 다시 연결해야 해요.