인스타그램 연동
인스타그램 APP_ID·APP_SECRET 발급 가이드 (Unified Login)
프로페셔널 계정 전환부터 신규 연동용 Unified Login 설정, Meta 앱 ID·시크릿과 Configuration ID 확인까지 순서대로 안내합니다.
Meta 개발자 앱 콘솔 열기1. 인스타그램 프로페셔널 계정으로 전환
Unified Login에는 비즈니스 또는 크리에이터 유형의 프로페셔널 계정이 필요합니다. 이미 해당 유형이면 전환하지 않고 다음 단계로 진행합니다.
- 인스타그램 앱에서 연동할 계정으로 로그인하고, 오른쪽 아래 프로필을 연 뒤 오른쪽 위 메뉴를 누릅니다.
- 설정 및 활동의 프로페셔널용 영역에서 계정 유형 및 도구(Account type and tools)를 엽니다. 앱 버전과 언어에 따라 메뉴 이름이 다를 수 있습니다.
- 프로페셔널 계정으로 전환(Switch to professional account)을 누르고 계정을 설명하는 카테고리를 선택합니다.
- 유형을 선택합니다. 매장·브랜드·서비스 운영은 비즈니스, 콘텐츠 제작자·아티스트·인플루언서는 크리에이터가 맞습니다. 두 유형 모두 프로페셔널 계정입니다.
- 연락처와 프로필 표시 항목을 확인하고 전환을 완료합니다. 프로필에 프로페셔널 대시보드가 표시되고, 설정에서 비즈니스 또는 크리에이터 도구를 확인할 수 있는지 살펴봅니다.
PC에서는 instagram.com에 로그인한 뒤 더 보기 > 설정 > 계정 유형 및 도구 > 프로페셔널 계정으로 전환에서 진행합니다. 카테고리와 비즈니스·크리에이터 유형을 선택하고 화면의 안내를 완료합니다.
공식 문서: 인스타그램 프로페셔널 계정 설정
2. 준비할 발급값 한눈에 보기
APP_ID와 APP_SECRET에는 Meta 앱의 값을 사용합니다. 여기에 로그인 구성 식별자인 config_id가 필요합니다. 계정 ID나 액세스 토큰은 별도의 값입니다.
| 전달 항목 | 복사할 값 | 확인 위치 |
|---|---|---|
| APP_ID | Meta 앱의 App ID | App settings > Basic > App ID |
| APP_SECRET | 같은 Meta 앱의 App Secret | App settings > Basic > App Secret |
| config_id | 로그인 구성의 Configuration ID | API setup with Unified login > Configure your app에서 선택한 구성 |
공식 문서: Instagram 플랫폼 및 접근 권한 · Unified Login 인증 정보
3. Meta 앱 생성 전에 준비할 것
- 서비스 운영자가 관리하는 Meta 개발자 계정과 연락 가능한 이메일을 준비합니다. 첫 이용 시 개발자 등록과 화면에서 요구하는 인증을 완료합니다.
- 앱을 소유할 비즈니스 포트폴리오와 앱 관리자 권한이 필요합니다. 사용할 인스타그램 프로페셔널 계정도 준비합니다.
- 개발자에게 정확한 HTTPS Redirect URL, 필요한 기능·권한, 서비스·개인정보처리방침·데이터 삭제 안내 주소를 받습니다. 주소를 임의로 만들지 않습니다.
4. Unified Login 설정 및 키 확인
Meta 개발자 앱 만들기
위 콘솔에서 내 앱(My Apps) > 앱 만들기(Create App)를 선택합니다. 서비스 앱 이름과 연락 이메일을 입력하고 앱을 소유할 비즈니스 포트폴리오를 연결합니다.
인스타그램 사용 사례 설정 열기
인스타그램 메시지·콘텐츠 관리(Manage messaging & content on Instagram) 사용 사례로 앱을 만듭니다. Use cases > 해당 사용 사례 > Customize > API setup with Unified login을 엽니다.
로그인 구성 만들기
Configure your app > Create new configuration에서 구성을 만듭니다. 개발자와 필요한 권한을 확인하고 Edit permissions에서 조정한 뒤 Use this configuration을 선택합니다. 구성의 Configuration ID(config_id)를 복사합니다.
복귀 주소 저장 및 로그인 URL 복사
선택한 구성의 Redirect URL에 개발자가 준 HTTPS 주소를 입력하고 Save를 누릅니다. 생성된 Login URL도 복사해 config_id와 함께 전달합니다.
Meta 앱의 App ID와 App Secret 복사
App settings > Basic에서 App ID와 App Secret을 확인해 전체 값을 복사합니다. 비밀값 표시나 재인증이 필요하면 계정 소유자가 완료합니다. 개발자는 이 값을 서버의 APP_ID·APP_SECRET에 설정합니다.
공식 문서: Unified Login 설정 · Unified Login 인증 정보
4-1. API 권한 추가 및 검수 승인
현재 사용하는 기능은 발행·댓글·DM·인사이트이며, 통합 로그인 후 Facebook 페이지를 거쳐 Instagram 계정을 연결하는 서비스 구현을 기준으로 합니다. 아래 8개 권한은 필요하고, business_management는 최초 심사에서 제외할 수 있습니다.
| 권한 | 필요 여부 | 이유 |
|---|---|---|
instagram_basic | 필요 | 기본 계정·게시물 조회에 사용합니다. |
instagram_content_publish | 필요 | 게시물·스토리 자동 업로드에 사용합니다. |
instagram_manage_comments | 필요 | 댓글 자동 답글에 사용합니다. |
instagram_manage_messages | 필요 | 자동 DM에 사용합니다. |
instagram_manage_insights | 필요 | 분석 화면의 계정·게시물 통계 조회에 사용합니다. |
pages_show_list | 필요 | 현재 서비스는 Facebook 페이지 목록에서 연결된 Instagram 계정을 찾으므로 계정 연결에 필요합니다. |
pages_read_engagement | 필요 | 현재 페이지 연동 방식에서 댓글·DM·인사이트 기능의 권한 의존성을 충족하는 데 필요합니다. |
pages_manage_metadata | 필요 | 댓글·DM 알림을 서버로 받는 현재 페이지 웹훅 구독에 필요합니다. |
business_management | 제외 가능 | 현재 기능에는 사용하지 않으므로 심사 항목을 줄이기 위해 최초 신청에서 제외합니다. 페이지를 거치지 않는 비즈니스 자산 조회·관리가 필요해지면 별도로 검토합니다. |
- API setup with Unified login > Configure your app에서 사용할 구성을 열고 Edit permissions로 위 8개 필요 권한을 추가합니다. business_management는 최초 신청에서 제외하고 Use this configuration을 선택한 뒤, 이 구성을 가리키는 config_id를 개발자에게 전달합니다.
- 앱 역할이 없는 외부 고객을 연결하려면 사용하는 각 권한의 Advanced Access를 App Review로 승인받아야 합니다. 콘솔에서 요구하는 사용 목적·재현 절차·시연 자료와 비즈니스 인증을 완료하고 Live 모드 요건을 확인합니다.
- 승인 후에는 로그인 구성이 요청하는 권한과 실제 사용자 동의·토큰에 부여된 권한을 확인합니다. 기존 연결에 권한을 추가했다면 필요한 권한에 다시 동의하도록 연결 절차를 진행합니다.
공식 문서: Unified Login 권한 및 승인 요건 · Meta 페이지·비즈니스 권한
5. 복귀 주소와 웹훅 설정 확인
- Redirect URL은 인증 후 우리 서비스로 돌아오는 주소입니다. HTTPS, 도메인, 경로, 마지막 슬래시까지 실제 로그인 요청과 일치해야 합니다. 개발·운영 환경별로 등록한 주소를 구분해 전달합니다.
- Configure webhooks에는 개발자가 알려준 별도의 Callback URL과 Verify token을 입력하고 검증합니다. 필요한 이벤트를 구독하며, 계정 연결 후 계정별 구독도 개발자가 확인합니다. 웹훅 주소와 OAuth 복귀 주소는 용도가 다릅니다.
- 앱 기본 정보, 개인정보처리방침, 데이터 삭제 안내 등 현재 콘솔에서 요구하는 항목을 저장합니다.
6. 테스트 및 일반 사용자 공개
- Generate access tokens > Add account에서 테스트할 인스타그램 프로페셔널 계정을 추가합니다. 인스타그램 웹의 설정 > 웹사이트 권한 > 앱 및 웹사이트 > 테스터 초대에서 수락한 뒤 Generate token으로 테스트 토큰을 발급합니다.
- 개발자와 Login URL을 통한 로그인, 비즈니스 포트폴리오·인스타그램 계정 선택, 권한 동의와 웹훅 수신을 확인합니다. 테스트 토큰은 APP_SECRET과 별도이며, 만료 조건은 구성에서 확인합니다.
- 앱 역할이 있는 사용자로 테스트하는 Standard Access와 외부 고객을 연결하는 Advanced Access를 구분합니다. 외부 고객 공개 전 필요한 권한의 Advanced Access, 앱 검수·비즈니스 인증과 Live 모드 요건을 완료합니다.
공식 문서: Instagram 플랫폼 및 접근 권한 · Unified Login 설정
7. 개발자에게 전달할 항목
- 앱 이름, Meta 앱의 App ID(APP_ID)·App Secret(APP_SECRET) 전체 값, Configuration ID(config_id), 생성된 Login URL.
- 저장한 Redirect URL, 개발·운영 환경 구분, 연결한 인스타그램 계정과 비즈니스 포트폴리오, 요청·승인한 권한 목록.
- 테스터 초대 수락 여부, 앱 모드, 비즈니스 인증·앱 검수 상태. 설정 확인용 화면은 비밀값을 가린 뒤 공유합니다.
설정이 안 보이거나 연결이 실패한다면
- 전환 메뉴가 없음: 현재 계정이 이미 비즈니스·크리에이터인지 확인하고, 계정 유형 및 도구 또는 해당 프로페셔널 도구 메뉴를 확인합니다.
- Unified Login 메뉴가 없음: 앱의 비즈니스 포트폴리오 소유 여부, 앱 관리자 권한과 Facebook Login for Business 사용 여부를 확인합니다. Unified Login은 이 기능을 기반으로 동작합니다.
- 인증 실패: APP_ID·APP_SECRET이 같은 Meta 앱의 값인지, config_id가 해당 앱에서 선택한 구성인지, Redirect URL이 저장된 주소와 일치하는지 확인합니다.
문서 확인: 2026년 11월 22일. 메뉴 이름은 앱 버전·언어에 따라 달라질 수 있습니다. 인스타그램 도움말은 로그인이 필요할 수 있습니다.