Threads 연동
Threads APP_ID·APP_SECRET 발급 가이드
Threads 계정 준비부터 Meta 앱 생성, Threads 전용 앱 ID·시크릿 확인, 테스터 초대와 연동 테스트까지 순서대로 안내합니다.
Meta 개발자 앱 콘솔 열기1. 연동할 Threads 계정 준비
운영에 사용할 Threads 프로필과 앱을 관리할 Meta 개발자 계정을 준비합니다.
- Threads 앱 또는 threads.com에서 연결할 계정으로 로그인하고 프로필과 사용자 이름을 확인합니다. 프로필이 없다면 먼저 생성을 완료합니다.
- 위 Meta 개발자 콘솔에 로그인합니다. 처음 이용한다면 개발자 등록과 화면에서 요구하는 인증을 완료합니다.
- 서비스 운영자가 앱을 관리할 수 있는 계정과 연락 이메일을 준비하고, 앱 설정을 진행할 관리자 권한을 확인합니다.
공식 문서: Threads API 시작하기
2. 준비할 발급값 한눈에 보기
개발자가 요청한 APP_ID·APP_SECRET에는 아래 Threads 전용 값을 전달합니다. 사용자 액세스 토큰은 로그인 동의 후 발급되는 별도 값입니다.
| 전달 항목 | 복사할 값 | 확인 위치 |
|---|---|---|
| APP_ID | Threads app ID | Use cases > Access the Threads API > Customize > Settings |
| APP_SECRET | 같은 앱의 Threads app secret | 같은 Threads 설정 화면의 Threads app secret |
| Redirect URI | 개발자가 제공한 정확한 HTTPS 복귀 주소 | Client OAuth Settings > Valid OAuth redirect URIs |
공식 문서: Threads 사용 사례 설정
3. 앱 생성 전에 개발자에게 받을 것
- 개발·운영 환경별 HTTPS Redirect URI, 서비스 주소, 개인정보처리방침과 데이터 삭제 처리 주소를 받습니다. 주소를 임의로 만들지 않습니다.
- 게시물 발행, 답글 조회·관리, 인사이트 등 사용할 기능과 필요한 권한을 정합니다. 기능에 필요한 권한만 추가합니다.
- 연동 해제 시 호출할 Deauthorize callback URL과 데이터 삭제 요청을 처리할 Data Deletion Requests URL을 확인합니다.
4. Threads 앱 생성 및 키 확인
Meta 개발자 앱 만들기
내 앱(My Apps) > 앱 만들기(Create App)에서 앱 이름과 연락 이메일을 입력하고 Access the Threads API 사용 사례를 선택해 생성합니다. 콘솔에서 요구하는 소유 정보도 입력합니다.
Threads 사용 사례 설정 열기
Use cases > Access the Threads API > Customize를 엽니다. threads_basic을 확인하고, 게시물 발행이 필요하면 threads_content_publish 등 개발자와 정한 권한을 추가합니다.
Threads 전용 App ID·App Secret 복사
해당 사용 사례의 Settings에서 Threads app ID와 Threads app secret 전체 값을 복사합니다. 비밀값 표시를 위한 재인증은 계정 소유자가 진행합니다.
OAuth 복귀 주소 저장
Client OAuth Settings의 Valid OAuth redirect URIs에 개발자가 준 HTTPS 주소를 입력합니다. Deauthorize callback URL과 Data Deletion Requests URL도 확인해 저장합니다.
Threads 테스터 초대
Add or Remove Threads Test Users 또는 App roles > Roles > Add People에서 Threads Tester 역할로 테스트할 Threads 사용자 이름을 추가합니다.
공식 문서: Threads 사용 사례 설정
5. 복귀 주소와 요청 권한 확인
- 등록한 Redirect URI와 실제 로그인 요청의 redirect_uri는 프로토콜, 도메인, 경로, 마지막 슬래시까지 일치시킵니다. 개발·운영 주소를 구분합니다.
- 기본 접근에는 threads_basic, 발행에는 threads_content_publish가 필요합니다. 답글 조회는 threads_read_replies, 답글 관리는 threads_manage_replies, 인사이트는 threads_manage_insights를 검토합니다.
- 개발자는 Threads 인증 화면을 통한 사용자 동의와 서버의 토큰 교환을 구현합니다. APP_SECRET을 브라우저에 넣지 않으며, 토큰 만료·갱신과 재인증 처리도 확인합니다.
공식 문서: 액세스 토큰과 권한 · 장기 토큰과 갱신
5-1. 기능별 API 권한과 승인 요건
외부 사용자가 앱을 연결하려면 사용하는 아래 권한을 각각 Meta App Review로 승인받아야 합니다. threads_basic은 기본 권한이며 나머지는 제공할 기능에 맞게 추가·신청합니다.
| 권한 | 기능 | 승인 요건 |
|---|---|---|
threads_basic | 프로필·게시물 등 기본 접근 | 외부 사용자 제공 시 App Review 승인 필수 |
threads_content_publish | 게시물 발행 | 발행 기능 제공 시 App Review 승인 필수 |
threads_read_replies | 답글 조회 | 답글 조회 기능 제공 시 App Review 승인 필수 |
threads_manage_replies | 답글 작성·관리 | 답글 관리 기능 제공 시 App Review 승인 필수 |
threads_manage_insights | 인사이트 조회 | 통계 기능 제공 시 App Review 승인 필수 |
- Use cases > Access the Threads API > Customize에서 사용할 권한을 추가합니다. 권한 추가만으로 Meta 승인이 완료되지는 않습니다.
- 콘솔의 App Review 또는 Publish 검수 항목에서 사용하는 각 권한을 신청합니다. 요구하는 사용 목적, 검수 재현 절차와 시연 자료를 제출하고 권한별 승인 상태를 확인합니다.
- 필요한 권한이 모두 승인된 뒤 앱 게시(Publish) 요건을 완료합니다. 실제 로그인에서 사용자의 권한 동의를 받고, 부여된 토큰으로 해당 기능이 동작하는지 확인합니다.
공식 문서: Threads API 시작하기 · Threads 사용 사례 설정
6. 초대 수락·연동 테스트·공개
- 초대한 Threads 계정으로 로그인한 뒤 설정(Settings) > 계정(Account) > 웹사이트 권한(Website permissions)에서 테스터 초대를 수락합니다.
- 서비스의 Threads 연결 버튼으로 로그인과 권한 동의를 진행합니다. 개발자와 프로필 조회 및 요청한 발행·답글·인사이트 기능을 실제로 확인합니다.
- 앱 역할이 없는 외부 사용자에게 공개하려면 필요한 권한의 App Review 승인과 앱 게시가 필요합니다. 콘솔의 Publish에서 요구하는 앱 정보·정책 주소·검수 및 인증 항목을 완료합니다.
공식 문서: Threads API 시작하기 · Threads 사용 사례 설정
7. 개발자에게 전달할 항목
- 앱 이름, Threads app ID(APP_ID)와 Threads app secret(APP_SECRET) 전체 값.
- 저장한 Redirect URI, 연동 해제·데이터 삭제 처리 주소, 개발·운영 환경 구분과 필요한 권한 목록.
- Threads 사용자 이름, 테스터 초대 수락 여부, 앱 게시·권한 검수 상태. 설정 확인용 화면은 비밀값을 가린 뒤 공유합니다.
설정이 안 보이거나 연결이 실패한다면
- Threads 키가 안 보임: Access the Threads API 사용 사례와 해당 사용 사례의 Settings를 열었는지, 앱 관리자 권한이 있는지 확인합니다.
- 테스터 연결 실패: 초대한 Threads 사용자 이름, 초대 수락 여부와 로그인한 계정이 일치하는지 확인합니다.
- 인증·API 호출 실패: Threads 전용 ID·시크릿이 같은 앱의 값인지, Redirect URI와 동의한 권한이 맞는지, 토큰이 만료되었는지 확인합니다.
문서 확인: 2026년 11월 22일. 메뉴 이름과 제공 기능은 콘솔 버전·언어에 따라 달라질 수 있습니다.