Threads API 연동 가이드
Meta Threads API 설정 · 약 15분 소요
사전 준비 사항
- Instagram 계정 (비즈니스 또는 크리에이터 계정으로 전환 필요)
- Threads 앱 설치 및 Instagram 계정으로 Threads 프로필 생성
- Meta (Facebook) 계정
Meta for Developers 가입
developers.facebook.com에 접속하여 Facebook 계정으로 로그인합니다.
상단 메뉴에서 "시작하기" 또는 "My Apps"를 클릭합니다.
개발자 계정 등록이 안 되어 있다면 이메일 인증과 전화번호 인증을 진행합니다.
새 앱 만들기
"앱 만들기" 버튼을 클릭합니다.
1. 사용 사례 선택 → "기타"를 선택합니다.
2. 앱 유형 선택 → "비즈니스"를 선택합니다.
3. 앱 이름을 입력합니다 (예: "내 Threads 자동화")
4. "앱 만들기"를 클릭합니다.
Threads API 사용 사례 추가
앱 대시보드에서 아래쪽으로 스크롤하여 "제품 추가" 섹션을 찾습니다.
1. "Threads API"를 찾아 "설정"을 클릭합니다.
2. 왼쪽 메뉴에 Threads API 항목이 추가된 것을 확인합니다.
Threads 권한 설정
왼쪽 메뉴에서 "Threads API" → "설정"으로 이동합니다.
아래 권한들이 활성화되어 있는지 확인합니다:
threads_basic— 기본 프로필 읽기threads_content_publish— 게시물 작성threads_manage_replies— 답글 관리threads_read_replies— 답글 읽기
테스트 사용자 추가
앱이 아직 심사 전(개발 모드)이므로, 본인의 Threads 계정을 테스트 사용자로 추가해야 합니다.
1. 왼쪽 메뉴 "앱 역할" → "역할"
2. "사람 추가" 클릭 → 본인의 Instagram 사용자 이름 입력
3. "Threads 테스터" 역할 선택 후 초대
4. Instagram 앱의 설정 → 웹사이트 권한 → 앱 및 웹사이트에서 초대를 수락
액세스 토큰 생성
Threads API에서 사용할 액세스 토큰을 생성합니다.
6-1. 단기 토큰 발급
1. 왼쪽 메뉴 "Threads API" → "API 설정(Graph API 탐색기)"
2. 상단에서 본인의 앱을 선택합니다.
3. "사용자 토큰 만들기" → 권한 체크 → "Generate Access Token"
4. 로그인 팝업에서 Threads 계정으로 로그인 및 권한 허용
5. 생성된 토큰을 복사합니다 (유효기간: 1시간)
6-2. 장기 토큰으로 교환 (60일)
단기 토큰을 60일짜리 장기 토큰으로 교환합니다. 브라우저 주소창에 아래 URL을 입력하세요:
https://graph.threads.net/access_token?grant_type=th_exchange_token&client_secret={앱_시크릿_키}&access_token={단기_토큰}
{앱_시크릿_키}는 앱 설정 → 기본 설정에서 확인할 수 있습니다.
응답으로 받은 access_token 값이 장기 토큰입니다.
사용자 ID 확인
브라우저에서 아래 URL로 접속하여 사용자 ID를 확인합니다:
https://graph.threads.net/v1.0/me?access_token={장기_토큰}
응답에서 "id" 값을 복사합니다.
AutoPost 웹앱에 입력
AutoPost 웹앱에 로그인 후 설정 페이지로 이동합니다.
1. Threads Access Token 필드에 장기 토큰을 붙여넣기
2. Threads User ID 필드에 사용자 ID를 붙여넣기
3. "저장" 버튼 클릭
4. "연동 테스트" 버튼으로 정상 동작 확인
토큰 갱신 안내
장기 토큰의 유효기간은 60일입니다. 만료 전에 아래 URL로 갱신할 수 있습니다:
https://graph.threads.net/refresh_access_token?grant_type=th_refresh_token&access_token={현재_토큰}
갱신된 토큰을 웹앱 설정 페이지에서 다시 입력하시면 됩니다.