TikTok에 앱 연결하기
앱을 TikTok에 연결하여 크리에이터 프로필을 읽고, 게시된 영상을 가져오고, Lovable 앱에서 소셜 통합을 구축하세요.
TikTok은 크리에이터 프로필과 콘텐츠에 접근할 수 있는 API를 제공하는 숏폼 비디오 플랫폼입니다. TikTok 커넥터를 사용하면 Lovable 앱에서 계정 프로필 데이터를 읽고, 영상 메타데이터에 접근하며, 특정 TikTok 계정 정보를 활용하는 크리에이터 워크플로우를 만들 수 있습니다.
TikTok을 연동하면 앱에서 다음과 같은 작업이 가능합니다:
- 표시 이름, 계정 ID 등 기본 프로필 데이터 읽기
- 팔로워 수, 좋아요 수, 영상 통계 조회
- 자기소개, 아바타 등 확장 프로필 정보 읽기
- 게시된 영상 목록 및 메타데이터 가져오기
TikTok 커넥터는 읽기 전용이며 OAuth를 통해 단일 TikTok 계정에 연결됩니다. 크리에이터 도구, 소셜 대시보드, 콘텐츠 포트폴리오, 특정 TikTok 계정 기반 분석 앱에 적합합니다.
주요 활용 사례 및 예시 앱
| 예시 앱 | 프롬프트 예시 | 설명 |
|---|---|---|
| 크리에이터 분석 대시보드 | TikTok을 사용해서 내 팔로워 수, 총 좋아요, 영상 성과를 시간대별로 보여주는 대시보드를 만들어줘. | TikTok 계정 지표를 집중적으로 보여주는 대시보드를 제공합니다. 프로필 통계와 영상 데이터를 읽어 시간 추이를 표시하고, 크리에이터가 한 곳에서 성장을 추적할 수 있게 합니다. |
| 영상 포트폴리오 사이트 | TikTok을 사용해서 내가 게시한 TikTok 영상을 제목과 조회수와 함께 보여주는 포트폴리오 페이지를 만들어줘. | 크리에이터의 TikTok 콘텐츠를 커스텀 웹사이트에 전시합니다. 게시된 영상 목록을 가져와 제목, 썸네일, 참여 지표 등과 함께 렌더링합니다. |
| 캠페인 트래커 | TikTok을 사용해서 스폰서 게시물의 TikTok 영상 메타데이터를 저장하고 캠페인 레코드와 연결하는 트래커를 만들어줘. | 연결된 TikTok 계정에 속한 캠페인 콘텐츠를 추적합니다. 게시된 영상 메타데이터를 읽어 캠페인과 매칭하고, 리포팅 데이터를 한곳에 정리해 둡니다. |
| 콘텐츠 관리 도구 | TikTok을 사용해서 게시된 TikTok 영상을 검토하고, 내부 메모를 추가하고, 캠페인별로 태깅할 수 있는 도구를 만들어줘. | 게시된 TikTok 영상 위에 가벼운 콘텐츠 관리 레이어를 구축합니다. TikTok에서 가져온 영상을 나열하고 별도 저장되는 커스텀 필드, 태그, 메모를 추가할 수 있게 합니다. |
| 프로필 동기화 유틸리티 | TikTok을 사용해서 내 TikTok 표시 이름과 계정 식별자를 CRM 레코드에 동기화하는 유틸리티를 만들어줘. | 내부 시스템을 TikTok 계정 정보와 일치시킵니다. 연결된 TikTok 계정에서 프로필 데이터를 읽어 CRM의 해당 필드에 기록해 수동 업데이트를 줄입니다. |
TikTok 연결 방법
워크스페이스 admin 또는 owner가 TikTok을 연결할 수 있습니다. 서로 다른 계정으로 여러 TikTok 연결을 만들 수 있으며, 환경을 분리하거나 여러 크리에이터를 관리할 때 유용합니다.
연결이 만들어지면 워크스페이스의 모든 프로젝트에서 TikTok을 사용할 수 있습니다. 프로젝트에서 작업하는 누구나 채팅에서 Lovable에게 프로젝트를 해당 연결에 연결해 달라고 요청할 수 있습니다.
사전 준비
TikTok을 연결하기 전에 다음을 준비하세요:
- 연결할 TikTok 계정 (OAuth 플로우 중에 새로 만들 수도 있습니다)
- Lovable 워크스페이스 owner 또는 admin 권한
이 커넥터를 통한 모든 API 요청은 TikTok 플랜에 따라 TikTok API 단위를 소비합니다. 청구와 쿼터는 Lovable이 아닌 TikTok에서 직접 처리합니다.
TikTok 연결 설정
Connectors에서 TikTok 열기
Connectors → App connectors에서 TikTok을 선택합니다.
연결 추가
Add connection을 클릭합니다.
연결 이름 지정
Display name에 연결 이름을 입력합니다(예: My TikTok). 이 이름은 Lovable 내부에서만 연결을 식별하는 용도로 사용됩니다.
Scope 검토 (선택)
Advanced settings를 펼쳐 앱이 요청할 권한을 검토합니다. 일반적인 사용 사례에 맞춰 기본 scope가 미리 선택되어 있습니다. Scope는 연결이 접근할 수 있는 데이터를 제어합니다. 네 가지 scope가 모두 기본으로 선택되어 있습니다.
필수인 Read basic profile information을 제외하면 어떤 선택적 scope든 제거할 수 있습니다.
| Scope | 설명 |
|---|---|
Read basic profile information (user.info.basic) | 표시 이름과 계정 ID |
Read user stats (user.info.stats) | 팔로워 수, 좋아요 수, 영상 수 |
Read extended profile information (user.info.profile) | 자기소개, 아바타, 프로필 세부 정보 |
Read published video metadata (video.list) | 게시된 영상 목록과 메타데이터 |
전체 scope 문서는 TikTok API scopes 레퍼런스를 참고하세요.
이 연결에 접근할 수 있는 사용자 선택
Who can access this connection에서 워크스페이스 내 누가 이 연결을 사용할 수 있는지 결정합니다:
- Only you (기본값): 연결을 만든 사람만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite specific people: 본인과 명시적으로 추가된 워크스페이스 멤버만 연결과 관련 데이터를 사용할 수 있습니다.
- Invite entire workspace: Invite entire workspace를 클릭하면 Lovable 워크스페이스 전체에서 연결을 사용할 수 있습니다.
자세한 내용은 연결 수준 접근을 참고하세요.
TikTok에 연결하고 권한 승인
Connect를 클릭합니다. TikTok 인증 창이 열리니 브라우저에서 팝업을 차단하지 마세요. 차단되면 Lovable이 대신 리다이렉트합니다.
필요하면 TikTok에 로그인하고, 요청 권한을 검토한 뒤 Allow를 클릭합니다.
승인이 완료되면 확인과 함께 Lovable로 돌아옵니다.
연결이 완료되면 프로젝트에서 작업하는 누구나 (설정된 연결 수준 접근에 따라) 채팅에서 Lovable에게 자신의 프로젝트를 TikTok에 연결해 달라고 요청할 수 있습니다. 이후 Lovable 앱에서 TikTok 프로필 데이터와 영상 콘텐츠를 읽기 시작할 수 있습니다.
제한 사항
TikTok 커넥터는 읽기 전용입니다. 다음은 지원하지 않습니다:
- TikTok에 영상 업로드 또는 게시
- 비공개 영상 또는 초안 콘텐츠 접근
- 댓글, DM, 알림 읽기
- 팔로워 관리 또는 다른 계정과의 상호작용
- TikTok 웹훅 또는 실시간 이벤트 수신
- 최종 사용자별 TikTok 로그인 지원. 각 연결은 하나의 TikTok 계정을 나타내며, 연결된 모든 프로젝트에서 공유됩니다.
TikTok 쪽에서 인증이 해제되면 API 호출이 다시 성공하기 전에 Lovable에서 통합을 다시 연결해야 합니다.
TikTok 연결에서 프로젝트 연결 해제
Editor 이상 권한을 가진 사용자는 연결 자체를 삭제하지 않고 특정 프로젝트만 연결에서 제거할 수 있습니다. 연결은 다른 프로젝트에서 계속 사용할 수 있습니다.
연결 해제 방법:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **TikTok**을 선택합니다.
연결 열기
관리할 연결을 엽니다.
프로젝트 선택
Linked projects에서 연결 해제할 프로젝트를 체크합니다.
확인
Unlink projects를 클릭하고 확인합니다.
연결 해제 후 해당 프로젝트는 이 연결을 통해 TikTok에 접근할 수 없습니다. 다시 필요하면 사용 가능한 다른 연결로 연결할 수 있습니다.
TikTok 연결 삭제
워크스페이스 admin 또는 owner가 TikTok 연결을 삭제할 수 있습니다.
연결 삭제는 영구적이며 되돌릴 수 없습니다. 연결된 모든 프로젝트에서 인증 정보가 제거되며, 새 연결을 추가하기 전까지 이 연결을 사용하던 앱은 동작을 멈춥니다.
삭제 전에 Linked projects 섹션에서 현재 이 연결을 사용 중인 프로젝트를 먼저 확인하세요.
삭제 방법:
Connectors 열기
Connectors를 열고 App connectors로 이동한 뒤 **TikTok**을 선택합니다.
연결 열기
삭제할 연결을 엽니다.
연결된 프로젝트 검토
Linked projects 섹션을 확인합니다.
삭제
Delete this connection에서 Delete를 클릭하고 확인합니다.