📸 인스타그램 자동 갤러리 연동 가이드

인스타에 사진을 올리면 홈페이지 갤러리가 자동으로 업데이트됩니다!

인스타 사진 업로드
→
Meta API
→
NAS PHP
→
홈페이지 갤러리 자동 표시 ✨

① 페이스북 페이지 만들기 (2분)

1

https://www.facebook.com/pages/create 에 접속

페이지 이름: 오늘도스냅 입력 → 카테고리: 사진가 → 페이지 만들기

페이스북 계정으로 로그인 후 진행합니다. 기존 계정이 없으면 새로 만드세요 (무료).

② 인스타그램 ↔ 페이스북 페이지 연결

2

인스타그램 앱 → 프로필 → 편집 → 소셜 채널 추가 → Facebook

또는: 인스타그램 설정 → 계정 → 연결된 계정 → Facebook → 방금 만든 페이지 선택

연결 완료 후 인스타그램 프로필에 페이스북 아이콘이 표시됩니다.

③ Meta 개발자 앱 만들기

3

https://developers.facebook.com 접속 → 로그인

내 앱 → 앱 만들기 클릭

항목입력값
사용 사례기타 → 없음 선택
앱 이름OneuldoSnap Website (아무 이름)
앱 연락처 이메일oneuldosnap@naver.com
비즈니스 계정선택 안 해도 됨 (건너뛰기)

④ Instagram 그래프 API 제품 추가

4

앱 대시보드 왼쪽 → 제품 추가 → Instagram 그래프 API → 설정

왼쪽 메뉴 → Instagram 그래프 API → API 탐색기 클릭

⑤ 액세스 토큰 발급 (가장 중요!)

5

방법 A — Graph API 탐색기 사용 (쉬움)

  1. https://developers.facebook.com/tools/explorer/ 접속
  2. Meta App: 방금 만든 앱 선택
  3. 사용자 또는 페이지: 사용자 액세스 토큰 얻기 클릭
  4. 권한 선택:
    • instagram_basic ✅ 체크
    • instagram_content_publish ✅ 체크
    • pages_show_list ✅ 체크
  5. 토큰 생성 클릭
이 토큰은 단기(1~2시간) 토큰입니다. 아래 STEP 6에서 장기 토큰으로 변환해야 합니다!

방법 B — Instagram ID 확인 후 직접 발급

Graph API 탐색기에서 아래 URL 실행:

GET /me/accounts

결과에서 id 값(페이지 ID)을 메모해두세요.

⑥ 장기 액세스 토큰 변환 (60일 유효)

6

아래 URL을 브라우저에서 직접 열어서 실행하세요.
{SHORT_TOKEN} → STEP 5에서 받은 토큰으로 변경
{APP_ID}, {APP_SECRET} → 앱 대시보드 → 설정 → 기본에서 확인

https://graph.facebook.com/v19.0/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_TOKEN}

실행 후 나오는 JSON에서 "access_token" 값을 복사하세요.

{"access_token":"EAABs...LONG_TOKEN...","token_type":"bearer","expires_in":5183944}
이 긴 토큰이 60일짜리 장기 토큰입니다! 복사해두세요.

⑦ 인스타그램 사용자 ID 확인

7

아래 URL을 실행하세요 ({LONG_TOKEN} = STEP 6의 장기 토큰):

https://graph.facebook.com/v19.0/me/accounts?access_token={LONG_TOKEN}

나오는 결과에서 페이지 access_token 을 복사합니다.

그 다음 이 URL로 인스타그램 비즈니스 계정 ID를 확인:

https://graph.facebook.com/v19.0/{PAGE_ID}?fields=instagram_business_account&access_token={PAGE_ACCESS_TOKEN}

⑧ 홈페이지에 토큰 설정하기

8

config/instagram_config.php 파일을 메모장으로 열고 아래 부분을 수정하세요:

// 이 부분을 수정! $INSTAGRAM_ACCESS_TOKEN = 'YOUR_ACCESS_TOKEN_HERE'; // ↓ 이렇게 바꾸세요 $INSTAGRAM_ACCESS_TOKEN = 'EAABs...실제토큰값...';
저장 후 홈페이지 갤러리를 새로고침하면 인스타그램 사진이 표시됩니다! 🎉

⑨ Cowork로 토큰 자동 갱신 설정 (한 번만!)

9

토큰은 60일마다 갱신해야 합니다. Cowork 스케줄로 자동화하세요!

  1. Cowork 앱 → 스케줄 탭 → 새 스케줄 만들기
  2. 이름: 인스타그램 토큰 갱신
  3. 주기: 매월 1일 오전 9시
  4. 작업: URL 호출
  5. URL: http://NAS_IP/api/refresh_token.php
또는 NAS의 DSM → 작업 스케줄러에서 curl 명령으로 설정해도 됩니다.

🔧 문제 해결

증상해결방법
갤러리에 사진이 안 나옴브라우저에서 /api/instagram.php 직접 접속하여 오류 메시지 확인
token_expired: true 오류/api/refresh_token.php 접속하여 토큰 갱신
API 오류: #190토큰이 만료됨 → STEP 5~6 반복하여 새 토큰 발급
이미지가 깨짐인스타그램 CDN URL은 시간이 지나면 만료될 수 있음 → 정상 동작
갤러리가 업데이트 안 됨캐시 TTL이 1시간 → 1시간 후 자동 갱신

🎉 설정 완료 후 동작 방식: