0. 4회차에 무슨 일이 있었나 — 사실 기록
2026-08-06 4회차 — 수강생 약 16명 중 약 3분의 2가 「인스타 계정 인증」 단계에서 멈춤. 파트2(인스타 API) 실습이 사실상 진행되지 못했다.
설계 오류 인정 — 4회차 계획서는 「인스타 계정 추가」에 12분을 배정했다. 이 단계를 한 덩어리로 본 것 자체가 오류였다. 실제로는 서로 다른 관문 여러 개가 겹쳐 있고, 각각 원인·해법·소요시간이 다르다. 진단 없이 시간만 늘려서는 해결되지 않는다.
이 문서는 그 실패를 원인별로 분해하고, 다음 수업에서 같은 일이 반복되지 않도록 만든 정본이다. 5회차 안내문·계획서는 이 문서를 기준으로 작성한다.
1. 원리 — 왜 인스타를 하는데 페이스북이 끼어드나
학생이 가장 먼저 던지는 질문이다. 답을 강사가 정확히 알고 있어야 한다.
둘은 다른 것이다.
· 페이스북 「페이지」 — 사업체용 공개 페이지. 지금 방식에서는 필요 없다
· 페이스북 「계정」 — 개인 로그인 계정. 이건 반드시 필요하다
인스타는 Meta 소유다. 그래서 개발자 등록·앱 관리를 페이스북 계정으로 한다. 인스타 계정만으로는 developers.facebook.com에 가입조차 안 된다.
인스타 계정 유형 — API가 되는 것과 안 되는 것
| 유형 | API | 비고 |
|---|
| 개인(Personal) | 불가 | 어떤 공식 API로도 접근 불가 |
| 프로페셔널 — 크리에이터 | 가능 | 콘텐츠 게시 됨. 학생에게 이쪽을 권해도 무방 |
| 프로페셔널 — 비즈니스 | 가능 | 동일 |
크리에이터도 됩니다. "비즈니스로 바꿔야 한다"고 잘못 안내하면 학생이 부담을 느낀다. Meta 문서는 게시 대상을 일관되게 "professional accounts (businesses and creators)"로 표기한다.
두 가지 연결 방식 — 우리가 쓰는 쪽
| 항목 | Instagram Login (우리 방식) | Facebook Login |
|---|
| FB 페이지 연결 | 불필요 — 공식 확인 | 필수 |
| FB 계정(개발자용) | 필수 | 필수 |
| 콘텐츠 게시 | 가능(비즈·크리 모두) | 가능 |
| 해시태그 검색·제품태깅 | 불가 | 가능 |
| 게시 한도 | 24시간 100건 (동일) |
Instagram Login 방식은 2024년 7월에 열렸다. 그 전 자료·블로그는 전부 "페이스북 페이지가 필요하다"고 쓰여 있다. 학생이 인터넷에서 찾아온 정보와 우리 안내가 다를 수 있으니 강사가 이 차이를 알고 있어야 한다.
혼동 주의 — Meta Quest·Horizon에서 쓰는 「Meta 계정」은 인스타로도 만들 수 있다. 그건 개발자 등록과 무관하다. 학생이 "메타 계정 있는데요?"라고 하면 이 구분을 짚어줄 것.
2. 관문 지도 — 전체 흐름과 실제 병목
붉은 칸 = 실제로 막히는 곳. 4회차 계획서는 관문 1·2를 아예 없는 것으로 취급했고, 4를 12분 안에 끼워 넣었다.
★3분의 2가 동시에 막혔다면 원인은 집단적이다. 가장 유력한 것 두 가지 —
1관문 1·2 (페이스북 계정 부재 + 개발자 등록 SMS) — 목수 수강생층은 페이스북 미사용률이 높다. FB 계정이 없으면 개발자 등록 자체가 불가하고, 새로 만들면 SMS 인증·신규계정 검문이 줄줄이 걸린다. 같은 화면에서 다수가 동시에 멈추는 형태가 정확히 이것이다.
2관문 4 (인스타가 개인 계정) — 인스타 로그인은 되는데 계정 추가만 실패하는 형태로 나타난다. 증상이 애매해서 진단이 늦어진다.
3. ★강사용 즉시 진단표 — 순회하며 쓰는 것
사용법 — 학생 화면만 보고 왼쪽 열에서 증상을 찾는다. 원인을 묻지 말고 화면을 본다. 학생은 자기가 어디서 막혔는지 설명하지 못한다.
| # | 화면·증상 | 원인 | 즉시 조치 | 당일 해결 |
|---|
| B1 | developers.facebook.com에서 페이스북 로그인 화면에 멈춤 | FB 계정 없음 | 오늘은 관찰 트랙으로 전환. 계정 생성은 과제로(인스타 앱 → Accounts Center → Facebook 계정 추가) | ✕ |
| B2 | "인증 코드를 보냈습니다" 후 SMS 미수신, 재시도 반복 | 개발자 등록의 전화번호 확인 단계에서 스팸방어 잠금 | 재시도를 멈추게 한다(더 잠긴다). 알뜰폰·데이터전용 회선은 실패율 높음 → 관찰 트랙 | △ |
| B3 | "계정이 제한되었습니다" / 셀카·신분증 요구 | 신규 FB 계정이 당일 앱 생성 → 자동 이상탐지 | 당일 해결 불가. 이의신청뿐. 신규 FB 계정으로 당일 앱 생성 금지 | ✕ |
| B4 | 계정 추가 팝업이 돌다가 실패, 또는 목록에 계정이 안 뜸 | 인스타가 개인 계정 | 인스타 앱 → 설정 → 계정 유형 및 도구 → 프로페셔널 전환(크리에이터 OK) | ○ 2분 |
| B5 | 인스타 2FA 코드 무한 반복 / "코드가 올바르지 않습니다" | SMS 지연·번호 변경·시간 동기 오류 | 인증앱으로 전환 또는 백업코드 사용
설정 → 계정 센터 → 비밀번호 및 보안 → 2단계 인증 → 계정 선택 → 추가 방법 → 백업 코드 | ○ |
| B6 | 권한 화면에 엉뚱한 계정명이 뜸 | 브라우저에 다른 계정 로그인 | 시크릿 창 1개에서 전 과정 재수행. 팝업 상단 계정명 육안 확인 | ○ |
| B7 | "Invalid platform app" / "Sorry, something went wrong" | 앱 유즈케이스 오선택(FB용 앱으로 IG 로그인 시도) | 앱을 Instagram 유즈케이스로 다시 생성. ★필요 시 App roles에 Instagram Tester 추가(커뮤니티 근거) | ○ |
| B8 | 동료·회사 계정 추가 시 실패 | 개발모드는 배정된 역할의 계정만 인증 가능 | 수업에서는 본인 소유 계정만 쓰게 한다 | ○ |
| B9 | 프로페셔널 전환 중 "Facebook 페이지 연결" 화면에서 멈춤 | 전환 흐름의 선택 단계인데 필수로 오해 | ★「건너뛰기(Skip)」를 누르면 된다. 페이지 없이 완료 가능 | ○ |
| B10 | 모든 게 맞는데 권한에서 튕김 | 신규·휴면 계정 자동 보안검문 (추정 — 공식 요건은 없음) | 수업용 계정을 급조하지 않게 한다 | △ |
B9는 특히 아깝다. 「건너뛰기」 한 번이면 되는데 필수인 줄 알고 페이스북 페이지를 만들러 가면 수업 하나가 통째로 날아간다. 이 화면이 뜨면 즉시 개입할 것.
4. 사전 준비 체크리스트 — 전날까지
이게 이 문서의 핵심이다. 관문 1·2·4는 수업 시간에 해결할 수 없다. 전날까지 끝내야 하고, 못 끝낸 학생은 관찰 트랙으로 돌린다. 이걸 안 하면 다음 수업도 똑같이 무너진다.
- ① 페이스북 계정 보유 확인 — 없으면 최소 3일 전 생성 + 실사용 흔적(프로필·친구 몇 명). ★가장 큰 병목
- ② Meta 개발자 등록을 전날 완료 — SMS·이메일 코드까지. 수업 중엔 절대 하지 않는다
- ③ 인스타를 프로페셔널(크리에이터)로 전환 — 페이지 연결 화면은 건너뛰기
- ④ 인스타 2FA를 인증앱으로 전환 + 백업코드 캡처 저장
- ⑤ 데스크톱 크롬에서 인스타·페이스북 각각 1회 로그인 성공 — 2FA 통과 이력을 미리 만들어 둔다
- ⑥ 수업 당일은 시크릿 창 1개만 사용, 다른 계정 전부 로그아웃
- ⑦ 휴대폰 지참·SMS 수신 확인 — 알뜰폰·해외번호는 사전 신고
①②는 사실상 「숙제」다. 단톡방 공지로는 이행률이 낮을 것이 확실하므로, 4회차와 5회차 사이에 한 번 중간 점검(단톡방에서 "개발자 등록 끝난 분 손") 하는 것을 권한다.
5. 5회차 재설계 — 무엇을 바꾸나
구조 변경 — 세 가지
| 항목 | 4회차(실패) | 5회차(재설계) |
|---|
| 준비 단계 | 수업 중에 전부 | 관문 1·2·4는 사전과제로 분리 |
| 수업 범위 | 계정~게시 전 과정 | 「앱 생성 → 토큰 발급 → 게시」만 |
| 미충족자 | 같이 붙잡고 감 | 관찰 트랙으로 분리 — 강사 화면을 따라 봄 |
수업 시작 3분 — 세 문항 점검으로 반을 나눈다
시작 전에 세 가지만 손 들어 확인하겠습니다.
① 페이스북 계정 있으신 분? (페이지 말고 계정입니다)
② 메타 개발자 등록 끝내신 분?
③ 인스타가 프로페셔널로 바뀐 분?
세 개 다 되신 분은 실습 트랙, 하나라도 안 되신 분은 관찰 트랙입니다. 관찰 트랙도 오늘 손해 보는 것 없습니다 — 흐름을 한 번 보시면 집에서 하실 수 있고, 못 하신 건 제가 따로 봐 드립니다.
이 분리가 핵심이다. 4회차는 못 따라오는 학생을 붙잡느라 따라올 수 있는 학생까지 멈췄다. 트랙을 나누면 최소한 3분의 1은 완주한다.
관찰 트랙을 빈손으로 두지 않는 법
- 강사 화면을 큰 화면으로 띄우고 전 과정을 천천히 진행
- 관찰 트랙에게는 크롬 네비게이션 실습(파트1 성격)을 대신 시킨다 — 인스타 없이도 되는 것
- 또는 공공데이터 API 실습(법제처 — 열쇠조차 불필요)으로 "API를 붙인다"는 경험만이라도 통과시킨다
이미 만들어 둔 자료 — 공공데이터 API 안내문(건축목공반_4회차_공공데이터API_안내문_v1.html), 대안 과제(건축목공반_4회차_대안과제_인스타없이_v1.html). 5회차 관찰 트랙에 그대로 쓸 수 있다.
6. 페이스북 계정이 없는 학생 — 대안이 있나
공식 우회 경로는 없다. Meta 개발자 계정을 거치지 않고 인스타 API를 쓰는 방법은 존재하지 않는다. 이건 정책이지 설정 문제가 아니다.
| 방안 | 내용 | 판단 |
|---|
| ① FB 계정 신규 생성 | 인스타 앱 → Accounts Center → Facebook 계정 추가 | 가능하나 당일은 위험(B3 신규계정 검문). 최소 3일 전 |
| ② 강사 앱에 Instagram Tester로 초대 | 강사 앱의 App roles에 학생 인스타를 추가 → 학생이 인스타에서 수락 → 본인 계정만 연결해 실습 | ★확인 필요(커뮤니티 근거, 공식 문서 미명시). 되면 가장 현실적인 대체 |
| ③ 관찰 트랙 | 강사 화면을 보고, 본인은 공공데이터 API로 대체 실습 | 확실히 되는 안전망. 5회차 기본값으로 |
②를 5회차 전에 검증해두면 판이 달라진다. 강사 계정 하나로 학생 여러 명을 태울 수 있는지 — 대표님 앱에서 본인 다른 계정으로 한 번 시험해 볼 가치가 있다.
7. 근거와 ★확인 필요
공식 문서로 확인된 것
- 개인 계정은 API 불가 / 크리에이터·비즈니스 모두 게시 가능
- Instagram Login 방식은 페이스북 페이지 불필요 — 원문: "does not require a Facebook Page to be linked"
- Meta 개발자 등록은 페이스북 로그인 상태에서 진행 + 전화·이메일 확인코드
- 개발모드 앱은 admin/developer/tester로 배정된 계정만 인증 가능
- 프로페셔널 전환 시 페이지 연결은 건너뛸 수 있다
★확인 필요 (실행 전 재검증)
- Instagram Tester 초대로 타인 계정 실습이 되는가 — 위 6-② . 커뮤니티 근거만 있고 공식 문서 미명시
- 신규 계정 나이 요건 — 공식 문서에 API용 계정 나이 요건은 없다. 신규일수록 보안검문 확률이 오른다는 것은 추정
- 4회차에서 실제로 막힌 지점 — 위 진단표 중 어느 것이었는지 대표님 확인 시 이 문서를 갱신할 것
출처 — developers.facebook.com: Instagram API with Instagram Login · Instagram Platform Overview · Register as a Meta Developer · Create an App · App Modes · Content Publishing / help.instagram.com: 2단계 인증 / Meta 커뮤니티 포럼: 개발자 등록 SMS 미수신·계정 제한 스레드
이 문서의 위치 — 정본(Instructor Reference). 5회차 이후 수업계획서·안내문은 이 문서를 기준으로 작성한다. 새로 알게 된 실패 모드는 3장 진단표에 추가하고 버전을 올린다. 학생에게 배포하지 않는다(진단표·트랙 분리 기준이 담겨 있음).