Threads API 자동화 구축기 — 발급 절차와 실패 지점 8가지

Threads API는 메타가 공식으로 여는 창구입니다. 이용료가 붙지 않고, 글 발행과 댓글 응답을 프로그램으로 처리할 수 있습니다. 다만 콘솔 화면이 낯설어서 중간에 포기하는 경우가 많습니다. 실제로 붙여보니 어려운 건 기술이 아니라 순서였습니다. 이 글은 2026년 7월 기준으로 직접 발급하며 기록한 절차와, 도중에 막혔던 지점을 정리한 것입니다.

Threads API로 가능한 작업과 불가능한 작업

Threads API는 텍스트 게시물 생성, 게시물 발행, 댓글 조회, 댓글 응답을 지원합니다. 게시물은 컨테이너를 만든 뒤 발행하는 2단계로 처리되며, 공식 문서는 두 호출 사이에 평균 30초 대기를 권장합니다. 반면 다이렉트 메시지 관련 엔드포인트는 존재하지 않습니다. DM 자동 발송이 목적이라면 이 API로는 달성할 수 없고, 공개 응답으로 대체해야 합니다.

작업	지원 여부
텍스트 게시물 발행	지원 (컨테이너 생성 → 발행)
게시물 댓글 조회	지원 (페이지네이션 필요)
댓글에 응답	지원 (공개 응답)
다이렉트 메시지	미지원

구독형 자동화 도구와의 비용 구조 차이

시중의 워크플로 자동화 서비스는 사용 기간에 비례해 요금이 발생합니다. 메타 공식 API는 호출 자체에 과금하지 않고, 대신 24시간 단위 호출 한도를 둡니다. 초기 구성을 수동으로 한 번 처리해야 한다는 점이 비용과 맞바꾸는 조건입니다.

항목	구독형 서비스	메타 Threads API
반복 비용	사용 기간에 비례	발생하지 않음
초기 구성	계정 인증만	앱 생성, 권한 승인, 토큰 발급
24시간 한도	요금제별 상이	게시물 250회, 응답 1,000회
DM 자동화	서비스별 상이	불가

시작 조건 두 가지

계정 공개 설정이 전제 조건입니다. 비공개 상태에서는 토큰 생성기 자체가 동작하지 않습니다. 그리고 모바일 앱이 필요합니다. 초대 승인 단계에서 한 번 사용합니다.

앱 생성과 이용 사례 선택

메타 개발자 콘솔에서 앱을 만들면 다섯 화면을 차례로 지나갑니다. 앱 상세 정보를 적고, 이용 사례를 고르고, 비즈니스 연결 여부를 정하고, 게시 요구사항을 확인한 뒤 개요에서 마무리하는 흐름입니다. 두 번째 화면에 나오는 스레드 API 액세스 항목을 고르면 나머지가 비활성화됩니다. 하나의 앱에서 병행할 수 없다는 제약이며, 정상 동작입니다. 비즈니스 포트폴리오는 연결하지 않아도 되고, 요구사항 단계는 빈 상태로 통과합니다. 마지막에 계정 비밀번호를 다시 입력하는 확인 절차가 있습니다.

권한 4종의 역할 구분

콘솔에 표시되는 권한은 총 11종이지만, 발행과 자동 응답에 필요한 것은 4종입니다. 이 중 응답 관련 두 권한의 구분이 실패를 부릅니다. 읽기 권한만 부여하면 댓글 목록은 받아오지만 응답 호출이 거부됩니다. 반대 구성에서는 응답은 가능하지만 대상 댓글을 가져오지 못합니다.

권한명	담당
threads_basic	앱 생성과 동시에 부여
threads_content_publish	게시물 발행
threads_manage_replies	응답 작성
threads_read_replies	응답 및 댓글 조회

테스터 역할 선택 오류

앱 역할 화면에서 사람 추가를 누르면 대화상자 위쪽에 네 가지가 먼저 뜹니다. 관리자와 개발자, 그 아래 테스터와 분석 사용자입니다. 이 중 테스터를 고르면 Threads API 권한이 붙지 않습니다. 실제로 필요한 항목은 대화상자를 스크롤해야 나오는 추가 역할 영역의 Threads 테스터입니다.

이 오류가 까다로운 이유는 즉시 드러나지 않기 때문입니다. 잘못된 역할을 선택해도 오류 메시지가 없고, 초대와 승인까지 정상적으로 진행됩니다. 문제는 이후 토큰 생성기에 계정이 나타나지 않는 시점에 드러나며, 원인을 앞 단계로 되짚기 어렵습니다.

승인 위치도 분리돼 있습니다. 초대는 개발자 콘솔에서 보내지만, 승인은 모바일 앱의 설정 안 '웹사이트 권한' 항목에서 처리합니다.

앱 ID가 두 개인 이유

콘솔에는 서로 다른 두 개의 식별자가 존재합니다. 앱 목록에 표시되는 값과, 이용 사례 설정 화면에 있는 Threads 앱 ID가 다릅니다. 프로그램에 넣어야 하는 값은 후자이며, 공식 문서도 이 값을 명시합니다. 설정 화면 상단이 아니라 아래쪽에 배치돼 있어 스크롤하지 않으면 발견하기 어렵습니다. 잘못된 식별자를 넣으면 인증 단계에서 계속 실패합니다.

액세스 토큰 유효기간과 갱신 조건

이용 사례 설정 화면 하단의 사용자 토큰 생성기에서 버튼을 누르면 유효기간 60일짜리 토큰이 즉시 발급됩니다. 검색 결과에는 단기 토큰을 장기 토큰으로 교환하는 절차가 다수 노출되는데, 이 경로에서는 해당 과정이 필요하지 않습니다.

갱신에는 조건이 하나 붙습니다. 발급 시점으로부터 24시간이 지나야 갱신 호출이 처리됩니다. 발급 직후 갱신을 시도하면 거부되므로, 만료 임박 시점에 처리하는 것이 맞습니다.

계정 정지를 부르는 링크 배치

여기서는 제 실패 사례를 남깁니다. 첫 댓글에 영상 주소와 오픈채팅 주소를 함께 넣은 게시물이 스팸으로 분류돼 삭제됐습니다. 사라진 건 댓글이 아니라 게시물 전체였습니다.

이후로는 규칙을 고정했습니다. 게시물 본문에는 주소를 넣지 않고, 첫 댓글에도 하나만 답니다. 두 번째 경로가 필요하면 특정 단어를 댓글로 남기도록 유도한 뒤 자동 응답으로 전달합니다. 공개 응답만 가능하다는 제약이 오히려 도움이 되는데, 응답이 누적되면 게시물 노출이 늘어나기 때문입니다.

댓글 조회에도 함정이 있습니다. 첫 페이지만 가져오면 오래된 댓글이 영구히 누락됩니다. 페이지네이션을 끝까지 순회해야 합니다.

자주 막히는 지점 정리

증상	원인
토큰 생성기에 계정이 안 보임	일반 테스터로 등록됨
초대 상태가 대기 중에서 안 바뀜	모바일 앱에서 승인하지 않음
인증이 계속 실패함	앱 목록의 ID를 사용함
응답 호출만 거부됨	manage_replies 권한 누락
갱신 요청이 거부됨	발급 후 24시간 미경과

권한과 한도 정책은 변경될 수 있습니다. 최신 사양은 메타 Threads 개발자 문서에서 확인하시면 됩니다.

화면을 눈으로 따라가는 편이 빠르다면, 방구석컴퍼니 채널에 발급부터 실행까지 이어지는 영상이 올라가 있습니다.

혹시 위 표에 없는 증상으로 막히신 적 있으신가요? 어떤 화면이었는지 알려주시면 사례를 추가하겠습니다.