인스타그램 연동 — 담당자 가이드 (@glossyblossom_official)

홈페이지 하단 인스타 피드가 @glossyblossom_official 최신 게시물을 자동으로 가져오게 하려면, 담당자가 Meta에서 권한(토큰)을 발급해 개발팀에 전달해야 합니다.

최종 업데이트: 2026-07-16 · 대상 계정: @glossyblossom_official

한 줄 요약

담당자 = Meta에서 열쇠(토큰) + 계정 번호(User ID) 발급 → 개발팀에 안전하게 전달
개발팀 = Firebase에 넣고 배포 → 관리자 화면에서 「지금 동기화」 확인

메타 등록만으로 사이트가 자동 연동되지는 않습니다.

개발팀에 넘길 것 (딱 2가지)

준비물

• 인스타 계정 @glossyblossom_official 관리 권한 (본인 또는 관리자)

• 그 인스타와 연결된 페이스북 페이지 (비즈니스 연동용)

• PC 브라우저 (Chrome 권장)

• 회사 이메일로 로그인 가능한 페이스북 계정

⚠️ 개인 인스타(일반 계정)만으로는 공식 연동이 어렵습니다. 프로페셔널 계정(비즈니스 또는 크리에이터) 이어야 합니다.

1단계. 인스타를 프로페셔널 계정으로

1. 휴대폰 인스타 앱 → @glossyblossom_official 로그인

2. 프로필 → ☰ 메뉴 → 설정 및 활동

3. 계정 유형 및 도구 (또는 비슷한 메뉴)

4. 프로페셔널 계정으로 전환

5. 유형: 비즈니스 권장 (크리에이터도 가능)

6. 카테고리·연락처는 대략 맞게 선택 후 완료

이미 비즈니스/크리에이터면 이 단계는 생략합니다.

2단계. 페이스북 페이지와 인스타 연결

1. PC에서 facebook.com 로그인

2. 샤인비(또는 glossyblossom) 페이스북 페이지로 이동 — 없으면 페이지 만들기 → 비즈니스/브랜드

3. 페이지 설정 → 연결된 계정 / Instagram

4. @glossyblossom_official 연결 → “연결됨” 확인

API가 “이 인스타 계정”을 찾을 때, 대부분 페이스북 페이지 ↔ 인스타 연결이 필요합니다.

3단계. Meta 개발자 계정 등록

1. PC: https://developers.facebook.com

2. 우측 상단 시작하기 / Log In

3. 2단계에서 쓴 같은 페이스북 계정으로 로그인

4. 개발자 등록 약관 동의 (개인/회사 정보 요청 시 회사 정보로)

5. 개발자 대시보드가 보이면 성공

4단계. 앱(App) 만들기

1. 개발자 사이트 상단 내 앱 → 앱 만들기

2. 용도: 비즈니스 (또는 “웹사이트에 인스타 피드 표시”에 가까운 유형 / 기타)

3. 앱 이름 예: SHINEB Website 또는 샤인비 홈페이지

4. 연락용 이메일: 담당자 회사 메일

5. 앱 만들기 완료 후 앱 대시보드로 진입

5단계. Instagram 관련 제품 추가

1. 앱 대시보드 왼쪽에서 앱에 제품 추가 (또는 제품)

2. 검색창에 Instagram → 가능한 것 추가
   — Instagram / Instagram Graph API
   — 또는 Facebook 로그인 + Instagram 관련 권한

3. 필요 시 비즈니스 설정(Business Manager)과 앱 연결, 2단계 페이스북 페이지를 자산으로 추가

화면 이름은 Meta 쪽에서 자주 바뀌므로, 막히면 개발팀에 화면 캡처를 공유하세요 (토큰 문자열은 가리고).

6단계. 권한(Permissions) 확인

인스타 게시물 읽기에 대략 아래가 필요합니다. (이름 표기가 조금 다를 수 있음)

• instagram_basic

• pages_show_list

• pages_read_engagement

피드 표시만이면 인사이트 권한은 필수가 아닙니다.

참고: 앱이 개발 모드일 때는 테스트/관리자 계정으로만 동작할 수 있습니다. 일반 공개 연동 시 앱 검수(App Review) 가 필요할 수 있습니다 → 그 단계는 개발팀과 확인.

7단계. Access Token 발급 (넘길 것 ①)

담당자는 아래 중 되는 방법 하나만 따라 하면 됩니다.

방법 A — Graph API 탐색기 (권장)

1. Graph API Explorer 접속

2. 우측 상단 Meta 앱에서 4단계 앱 선택

3. 사용자 또는 페이지 토큰 생성

4. 권한 추가에서 위 권한들 체크 후 토큰 생성

5. 페이스북 로그인·권한 허용

6. 화면에 긴 문자열(EAA…)이 보이면 그게 단기 토큰

⚠️ 단기 토큰은 몇 시간~하루 만에 만료됩니다. 개발팀에 넘기기 전 장기 토큰으로 연장하세요.

장기 토큰으로 바꾸기 (필수에 가깝게 권장)

1. 액세스 토큰 도구

2. 단기 토큰 붙여넣기 → 디버그

3. 액세스 토큰 연장 (Extend Access Token)

4. 나온 긴 토큰을 복사 → 개발팀에 전달 (제목 예: INSTAGRAM_ACCESS_TOKEN)

🔒 토큰은 비밀번호와 동일합니다. 카톡 단체방·노션 공개 페이지에 올리지 마세요. 가능하면 1:1 메일 / 보안 메모.

8단계. Instagram User ID 확인 (넘길 것 ②)

아이디 이름 glossyblossom_official 이 아닙니다. 숫자만 있는 ID가 필요합니다.

Graph API 탐색기

1. Graph API Explorer에서 페이지 토큰 사용

2. 요청: me/accounts

3. 결과에서 샤인비 페이스북 페이지의 id 확인

4. 다음 요청: {페이지ID}?fields=instagram_business_account

5. 결과에 "instagram_business_account": { "id": "1784……" } 가 나오면, 그 id 숫자가 INSTAGRAM_USER_ID

안 보이면

• 인스타 ↔ 페이지 연결(2단계) 재확인

• 토큰에 페이지/인스타 권한 있는지 재발급

• 개발자에게 탐색기 결과 화면 캡처 공유 (토큰 문자열은 가리고)

9단계. 개발팀에 전달할 체크리스트

 [인스타 연동 발급 정보]1) 인스타 계정: @glossyblossom_official2) 프로페셔널 계정 여부: 예 / 아니오3) 연결된 페이스북 페이지 이름: _______________4) INSTAGRAM_ACCESS_TOKEN: (장기 토큰, 별도 보안 전달)5) INSTAGRAM_USER_ID: (숫자만, 예: 1784xxxxxxxxxx)6) 발급일: 20__-__-__7) 발급 담당자: _______________

개발팀 쪽 작업(참고, 담당자 불필요):

firebase functions:secrets:set INSTAGRAM_ACCESS_TOKENfirebase functions:secrets:set INSTAGRAM_USER_IDfirebase deploy --only functions

이후 관리자 화면 인스타그램 연동 → 지금 동기화 로 확인합니다. 정상 시 홈 하단 피드에 최신 글이 뜹니다. (실패 시 같은 화면에 오류 문구가 남습니다.)

자주 하는 실수

담당자 기준 “끝” 체크

1. 인스타 = 프로페셔널

2. 페이스북 페이지와 연결

3. Meta 개발자 앱 생성

4. 장기 Access Token 확보

5. 숫자 Instagram User ID 확보

6. 위 2개를 개발자에게 안전하게 전달

여기까지면 담당자 역할은 완료입니다. 이후 배포·동기화는 개발/관리자 영역입니다.

연동 후 동작 (참고)

• Cloud Functions가 6시간마다 최신 게시물을 가져와 저장합니다

• 관리자 → 인스타그램 연동에서 수동 「지금 동기화」 가능

• 토큰 만료 시 홈 피드가 예전 이미지(폴백)로 보일 수 있습니다 → 토큰 재발급 후 개발팀에 재전달