인스타그램 연동

인스타그램 APP_ID·APP_SECRET 발급 가이드 (Unified Login)

프로페셔널 계정 전환부터 신규 연동용 Unified Login 설정, Meta 앱 ID·시크릿과 Configuration ID 확인까지 순서대로 안내합니다.

Meta 개발자 앱 콘솔 열기

1. 인스타그램 프로페셔널 계정으로 전환

Unified Login에는 비즈니스 또는 크리에이터 유형의 프로페셔널 계정이 필요합니다. 이미 해당 유형이면 전환하지 않고 다음 단계로 진행합니다.

  1. 인스타그램 앱에서 연동할 계정으로 로그인하고, 오른쪽 아래 프로필을 연 뒤 오른쪽 위 메뉴를 누릅니다.
  2. 설정 및 활동의 프로페셔널용 영역에서 계정 유형 및 도구(Account type and tools)를 엽니다. 앱 버전과 언어에 따라 메뉴 이름이 다를 수 있습니다.
  3. 프로페셔널 계정으로 전환(Switch to professional account)을 누르고 계정을 설명하는 카테고리를 선택합니다.
  4. 유형을 선택합니다. 매장·브랜드·서비스 운영은 비즈니스, 콘텐츠 제작자·아티스트·인플루언서는 크리에이터가 맞습니다. 두 유형 모두 프로페셔널 계정입니다.
  5. 연락처와 프로필 표시 항목을 확인하고 전환을 완료합니다. 프로필에 프로페셔널 대시보드가 표시되고, 설정에서 비즈니스 또는 크리에이터 도구를 확인할 수 있는지 살펴봅니다.

PC에서는 instagram.com에 로그인한 뒤 더 보기 > 설정 > 계정 유형 및 도구 > 프로페셔널 계정으로 전환에서 진행합니다. 카테고리와 비즈니스·크리에이터 유형을 선택하고 화면의 안내를 완료합니다.

공식 문서: 인스타그램 프로페셔널 계정 설정

2. 준비할 발급값 한눈에 보기

APP_ID와 APP_SECRET에는 Meta 앱의 값을 사용합니다. 여기에 로그인 구성 식별자인 config_id가 필요합니다. 계정 ID나 액세스 토큰은 별도의 값입니다.

Unified Login 연동을 위해 개발자에게 전달할 값
전달 항목복사할 값확인 위치
APP_IDMeta 앱의 App IDApp settings > Basic > App ID
APP_SECRET같은 Meta 앱의 App SecretApp settings > Basic > App Secret
config_id로그인 구성의 Configuration IDAPI setup with Unified login > Configure your app에서 선택한 구성

공식 문서: Instagram 플랫폼 및 접근 권한 · Unified Login 인증 정보

3. Meta 앱 생성 전에 준비할 것

  • 서비스 운영자가 관리하는 Meta 개발자 계정과 연락 가능한 이메일을 준비합니다. 첫 이용 시 개발자 등록과 화면에서 요구하는 인증을 완료합니다.
  • 앱을 소유할 비즈니스 포트폴리오와 앱 관리자 권한이 필요합니다. 사용할 인스타그램 프로페셔널 계정도 준비합니다.
  • 개발자에게 정확한 HTTPS Redirect URL, 필요한 기능·권한, 서비스·개인정보처리방침·데이터 삭제 안내 주소를 받습니다. 주소를 임의로 만들지 않습니다.

4. Unified Login 설정 및 키 확인

  1. Meta 개발자 앱 만들기

    위 콘솔에서 내 앱(My Apps) > 앱 만들기(Create App)를 선택합니다. 서비스 앱 이름과 연락 이메일을 입력하고 앱을 소유할 비즈니스 포트폴리오를 연결합니다.

  2. 인스타그램 사용 사례 설정 열기

    인스타그램 메시지·콘텐츠 관리(Manage messaging & content on Instagram) 사용 사례로 앱을 만듭니다. Use cases > 해당 사용 사례 > Customize > API setup with Unified login을 엽니다.

  3. 로그인 구성 만들기

    Configure your app > Create new configuration에서 구성을 만듭니다. 개발자와 필요한 권한을 확인하고 Edit permissions에서 조정한 뒤 Use this configuration을 선택합니다. 구성의 Configuration ID(config_id)를 복사합니다.

  4. 복귀 주소 저장 및 로그인 URL 복사

    선택한 구성의 Redirect URL에 개발자가 준 HTTPS 주소를 입력하고 Save를 누릅니다. 생성된 Login URL도 복사해 config_id와 함께 전달합니다.

  5. 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는 최초 심사에서 제외할 수 있습니다.

현재 기능·계정 연결 방식 기준: 필요 권한 8개와 제외 가능한 권한 1개
권한필요 여부이유
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제외 가능현재 기능에는 사용하지 않으므로 심사 항목을 줄이기 위해 최초 신청에서 제외합니다. 페이지를 거치지 않는 비즈니스 자산 조회·관리가 필요해지면 별도로 검토합니다.
  1. API setup with Unified login > Configure your app에서 사용할 구성을 열고 Edit permissions로 위 8개 필요 권한을 추가합니다. business_management는 최초 신청에서 제외하고 Use this configuration을 선택한 뒤, 이 구성을 가리키는 config_id를 개발자에게 전달합니다.
  2. 앱 역할이 없는 외부 고객을 연결하려면 사용하는 각 권한의 Advanced Access를 App Review로 승인받아야 합니다. 콘솔에서 요구하는 사용 목적·재현 절차·시연 자료와 비즈니스 인증을 완료하고 Live 모드 요건을 확인합니다.
  3. 승인 후에는 로그인 구성이 요청하는 권한과 실제 사용자 동의·토큰에 부여된 권한을 확인합니다. 기존 연결에 권한을 추가했다면 필요한 권한에 다시 동의하도록 연결 절차를 진행합니다.

공식 문서: 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일. 메뉴 이름은 앱 버전·언어에 따라 달라질 수 있습니다. 인스타그램 도움말은 로그인이 필요할 수 있습니다.