인스타그램

Instagram Direct(다이렉트 메시지)로 들어온 DM을 회원님이 챗봇 설정에 따라 AI·상담원으로 응답하도록 연동합니다.

마지막 업데이트: 2026년 7월 28일 · 경로: 대시보드 > AI 챗봇 > 편집 > 5단계 채널 (/dashboard/chatbot)

먼저 이것만 알아두세요

Instagram 연동은 Meta(Instagram·Facebook) 쪽 준비 3가지 → 마이챗봇에서 «인스타그램 연결» 한 번이면 됩니다.

1. Instagram을 프로페셔널(비즈니스·크리에이터) 계정으로 전환합니다. (개인 계정은 API 연동 불가 — 아래 1-1)
2. Facebook 페이지를 하나 준비합니다. 없으면 Meta에서 새로 만듭니다. (개인 Facebook 프로필과 다름 — 아래 1-2)
3. Instagram ↔ Facebook 페이지 연결 — Instagram 앱 또는 Facebook 페이지 설정에서 «기존 페이지 연결» (계정 센터 «연결된 경험»이 아님 — 아래 1-3)

연동하면 무엇이 달라지나요?

Instagram 채널 연동은 Instagram 앱·웹의 DM(다이렉트 메시지)을 회원님의 챗봇이 받아 처리하게 만드는 작업입니다. 웹사이트에 설치한 챗봇 위젯(iframe)과는 별도의 대화입니다.

• 고객(문의하는 Instagram 사용자)이 회원님의 Instagram 비즈니스(프로) 계정으로 DM을 보냅니다. 고객 쪽은 일반 개인 계정이어도 됩니다.
• Meta가 그 메시지를 마이챗봇 서버(웹훅)로 전달합니다.
• 회원님이 챗봇 편집 1단계 «상호작용 유형»에서 AI만 / 상담원만 / AI+상담원 전환으로 설정한 방식대로 답변하고, Instagram DM으로 다시 보냅니다.
• 대화 내역은 대시보드·상담원 패널에서도 확인할 수 있습니다.

준비물 체크리스트

마이챗봇 연동 전, 아래를 모두 갖추었는지 확인하세요.

• ☐ Instagram 프로페셔널(비즈니스·크리에이터) 계정
• ☐ Facebook 페이지 1개 (없으면 Meta에서 생성 — 아래 1-2 참고)
• ☐ Instagram ↔ Facebook 페이지 연결 완료 (아래 1-3 — Instagram 앱 «기존 페이지 연결» 또는 Facebook 페이지 «Instagram 연결»)
• ☐ Facebook 페이지 관리자인 Facebook 개인 계정 (OAuth 시 이 계정으로 로그인)
• ☐ 마이챗봇 챗봇 1개 (편집 1~4단계 완료 권장)
• ☐ 요금제에 Instagram 채널 포함

전체 흐름 (한눈에 보기)

Meta에서 3단계 준비를 마친 뒤, 마이챗봇 5단계 «채널»에서 인스타그램 연결만 누르면 됩니다.

아래는 위 순서의 상세 단계입니다.

1부. Meta 쪽 준비 (Instagram + Facebook 페이지)

마이챗봇 연동 전에 Meta(Instagram·Facebook) 앱에서 아래 3단계를 순서대로 진행합니다. 모두 끝나야 «인스타그램 연결» 버튼이 정상 동작합니다.

1-1. Instagram → 프로페셔널(비즈니스·크리에이터) 계정으로 전환

1. Instagram 앱 → 프로필 → ☰ → 설정 및 활동
2. 계정 유형 및 도구 (또는 «프로페셔널 계정으로 전환») → 비즈니스 선택 (mychatbot DM 연동은 비즈니스 권장)
3. 카테고리·연락처 안내에 따라 마법사를 완료합니다.
4. 프로필에 인사이트·프로모션 메뉴가 보이면 전환된 상태입니다.

PC 브라우저(instagram.com)에도 «프로페셔널 계정으로 전환»이 있을 수 있으나, 최근 UI는 앱에서 진행하는 경우가 많습니다.

1-2. Facebook 페이지 만들기 (없을 때만)

Facebook 페이지가 이미 있으면 이 단계는 건너뛰고 1-3으로 가세요.

1. Facebook 앱 또는 facebook.com/pages/create 에 접속합니다.
2. «페이지 만들기» → 카테고리·페이지 이름(예: 회사명·브랜드명) 입력 → 만들기를 완료합니다.
3. 만든 페이지에 본인 Facebook 계정이 관리자인지 확인합니다.

1-3. Instagram ↔ Facebook 페이지 연결

가장 중요한 단계입니다. Instagram 프로페셔널(비즈니스) 계정과 Facebook 페이지를 짝으로 묶어야 mychatbot «인스타그램 연결» OAuth가 성공합니다.

방법 A — Instagram 앱에서 연결 (권장)

1. @mychatbot_ai 등 연동할 Instagram 계정으로 Instagram 앱 로그인
2. 프로필 → 우측 상단 ☰ → 설정 및 활동
3. 프로필 편집 (또는 «비즈니스용 공개 정보» / «페이지» 항목)
4. 페이지 (Page) → 기존 페이지 연결 (Connect existing Page)
5. Facebook 로그인 후 1-2에서 만든 Facebook 페이지 선택 → 완료

메뉴가 다르면: 설정 및 활동 → 전문가용 도구 및 설정 (또는 «비즈니스») 안의 «Facebook 페이지 연결»·«페이지 연결»을 찾으세요.

방법 B — Facebook 페이지 설정에서 연결

1. Facebook에서 1-2의 페이지로 전환 (개인 프로필이 아님)
2. 페이지 설정 → 연결된 계정 (Linked accounts) → Instagram
3. 계정 연결 → Instagram(@mychatbot_ai) 로그인·권한 허용

연결 확인

• Instagram 프로필 편집 → «페이지» 아래에 Facebook 페이지 이름이 보임
• Facebook 페이지 설정 → 연결된 계정 → Instagram에 @계정 표시
• mychatbot «인스타그램 연결» OAuth 시 해당 페이지에 connected Instagram이 잡힘

2부. 마이챗봇에서 «인스타그램 연결» (1부 완료 후)

1부(프로페셔널 전환 + Facebook 페이지 + Instagram↔페이지 연결)를 모두 마친 뒤 진행하세요. 마이챗봇에서는 버튼 한 번으로 채널이 등록됩니다. (App ID·토큰 직접 입력 없음)

2-1. 채널 화면 열기

1. 마이챗봇 대시보드 → AI 챗봇에서 연동할 챗봇 편집을 엽니다.
2. 상단 5단계 중 채널을 선택합니다.
3. Instagram 카드를 클릭해 팝업을 엽니다.

2-2. «설정 필요»가 보일 때

팝업에 노란색 «설정 필요» 안내가 보이면, 서비스 운영 측 Meta·관리자 설정(아래 3부)이 아직 완료되지 않은 상태입니다. «인스타그램 연결» 버튼 대신 «관리자에게 설정을 요청하세요.»가 표시됩니다.

• 일반 사용자: 마이챗봇 운영·고객 지원에 Instagram 채널 활성화를 요청하세요.
• 설정이 완료되면 팝업을 닫았다가 다시 열면 인스타그램 연결 버튼이 나타납니다.

2-3. «인스타그램 연결» (OAuth) 진행

1. 팝업 하단의 인스타그램 연결 버튼을 클릭합니다.
2. 브라우저가 Meta(Facebook) 로그인 팝업 창을 엽니다. (팝업 차단 시 허용 필요)
3. 1-3에서 Instagram과 연결해 둔 Facebook 페이지를 관리하는 Facebook 개인 계정으로 로그인합니다. (Instagram 계정·비밀번호가 아님)
4. Meta 권한 요청 화면에서 허용(계속)을 누릅니다.

2-4. 연결 완료 확인

1. OAuth가 성공하면 팝업에 «인스타그램 연결이 완료되었습니다»와 @사용자명·Facebook 페이지 이름이 표시됩니다.
2. 창 닫기를 누르거나 팝업을 닫습니다.
3. 마이챗봇 팝업 상태가 «인스타그램 인증이 확인되었습니다. 채널을 추가하는 중...» → «인스타그램 채널이 연동되었습니다»로 바뀝니다.
4. 아래 채널 목록에 instagram 행과 @사용자명이 보이면 채널 등록 성공입니다.
5. DM 수신까지 확인하려면 다른 Instagram 계정에서 @연동계정으로 메시지를 보내 «연동 확인» 섹션을 참고하세요.

3부. Meta·관리자 설정 (운영 / SaaS 관리자용)

이 섹션은 마이챗봇 서비스 운영자·관리자가 Meta 앱과 플랫폼 설정을 할 때 참고합니다. 일반 회원은 1부·2부만 진행하면 되며, Meta 개발자 콘솔에 직접 들어갈 필요가 없습니다.

Meta 앱에는 Messenger뿐 아니라 Facebook Login 제품도 반드시 추가·설정해야 합니다. 회원 «인스타그램 연결»은 OAuth(dialog/oauth)로 동작하며, Redirect URI 등록은 Facebook Login 설정에서만 할 수 있습니다.

3-0. Meta 앱에 필요한 제품 (Messenger + Facebook Login)

Instagram DM 연동에는 Meta 앱에 제품 2개가 모두 필요합니다. Messenger만 추가하면 웹훅은 설정할 수 있어도, 회원 «인스타그램 연결» OAuth가 실패할 수 있습니다.

Meta 제품	역할	설정 위치 (Meta 콘솔)
Messenger	Instagram DM 웹훅·Facebook 페이지·메시지 API	Messenger → Messenger API 설정
Facebook Login (또는 Facebook Login for Business)	회원 «인스타그램 연결» OAuth·Redirect URI	Facebook Login → 설정(Settings)

3-0-1. Messenger 제품 추가

Instagram DM 웹훅·메시지 수신용입니다. (이미 추가했다면 3-0-2로 넘어가세요.)

1. developers.facebook.com/apps → Instagram 연동에 쓸 앱을 선택합니다.
2. 앱 대시보드 본문의 추가할 수 있는 제품 목록을 찾습니다. (왼쪽 메뉴 하단 제품 추가에서도 같은 목록을 볼 수 있습니다.)
3. Messenger 카드의 파란 설정 버튼을 클릭합니다.
4. 왼쪽 메뉴에 Messenger가 생겼는지 확인합니다. Webhooks 등은 3-3에서 설정합니다.

Messenger «설정» 버튼·Webhooks 화면 위치는 페이스북 (Messenger) 가이드 1-2·3부를 참고하세요.

3-0-2. Facebook Login 제품 추가

회원 «인스타그램 연결» OAuth에 필요합니다. Messenger와 달리 별도 제품으로 한 번 더 «설정»해야 합니다.

1. 같은 Meta 앱 대시보드에서 추가할 수 있는 제품 목록으로 이동합니다.
2. Facebook Login 카드를 찾습니다.
   • 비즈니스 앱이면 Facebook Login for Business로 표시될 수 있습니다. (둘 중 앱에 보이는 이름을 선택하면 됩니다.)
   • 목록에 없으면 상단 검색 또는 제품 추가 메뉴에서 «Facebook Login»을 검색합니다.
3. Facebook Login (또는 Facebook Login for Business) 카드의 설정 버튼을 클릭합니다.
4. 빠른 시작(Quickstart) 화면이 나오면 건너뛰기하거나 닫아도 됩니다. Instagram 연동에는 필수 단계가 아닙니다.
5. 왼쪽 메뉴에 Facebook Login (또는 Facebook Login for Business) 항목이 생겼는지 확인합니다.
6. 해당 메뉴 아래 설정(Settings)을 클릭합니다. (Valid OAuth Redirect URIs 입력란이 보여야 합니다.)
7. 다음 3-2에서 Redirect URL을 등록합니다. (제품만 추가하고 URI를 넣지 않으면 «인스타그램 연결»이 실패합니다.)

3-1. 마이챗봇 관리자 화면 (플랫폼 자격 증명)

관리자 계정으로 로그인한 뒤 아래 경로에서 Meta 앱 정보를 저장합니다. (일반 회원에게는 이 메뉴가 보이지 않거나 접근할 수 없습니다.)

경로: /dashboard/admin/chatbot-instagram/settings

입력 필드	어디서 가져오나
Instagram App ID	Meta → 앱 설정 → 기본 설정 → 앱 ID
Instagram App Secret	Meta → 앱 설정 → 기본 설정 → 앱 시크릿 코드
Verify Token	직접 만드는 문자열 (20자 이상 권장). Meta Webhooks·마이챗봇에 동일 값

화면에 표시되는 읽기 전용 URL (Meta에 그대로 등록):

항목	URL
Webhook URL (Meta Webhooks 콜백)	https://mychatbot.ai.kr/api/v2/chatbot/webhook/instagram
Redirect URL (OAuth 콜백)	https://mychatbot.ai.kr/chatbot/instagram/oauth/callback

1. 위 3개 필드를 입력하고 저장합니다.
2. «Instagram settings updated»(설정이 업데이트되었습니다) 안내가 보이면 성공입니다.
3. 저장 후 회원 «채널» 화면의 «설정 필요» 안내가 사라지고 «인스타그램 연결» 버튼이 나타납니다.

3-2. Meta — Facebook Login (OAuth Redirect URI)

3-0-2에서 Facebook Login 제품을 추가한 뒤, 회원 «인스타그램 연결» 팝업이 동작하도록 Redirect URI를 등록합니다.

1. Meta for Developers → 해당 앱
2. 왼쪽 메뉴 Facebook Login (또는 Facebook Login for Business) → 설정(Settings)
3. Valid OAuth Redirect URIs(유효한 OAuth 리디렉션 URI)에 아래 URL을 한 줄 추가:
   https://mychatbot.ai.kr/chatbot/instagram/oauth/callback
4. Client OAuth Login, Web OAuth Login → 예(켜짐)
5. 변경 사항 저장

3-3. Meta — Messenger Webhooks (DM 수신)

Instagram DM을 마이챗봇 서버로 받으려면 Messenger 제품의 Webhooks를 등록합니다.

아래는 두 단계입니다. URL·토큰만 저장하고 messages 구독을 빠뜨리면 DM이 서버로 오지 않습니다.

3-3-1. 콜백 URL · Verify Token 등록

1. Meta 앱 → Messenger → Messenger API 설정
2. 1. Webhooks 구성 섹션
3. 콜백 URL: https://mychatbot.ai.kr/api/v2/chatbot/webhook/instagram
4. 인증 토큰: 3-1에서 저장한 Verify Token과 동일한 값
5. 확인 및 저장 클릭 → Meta가 URL을 검증해 정상 저장되어야 합니다.

3-3-2. Webhook 필드 — messages 구독 (필수)

«확인 및 저장»만 하고 끝내면 안 됩니다. 같은 화면 아래 Webhook 필드 표에서 Instagram DM 이벤트를 받을 필드를 켜야 합니다.

1. «1. Webhooks 구성» 아래 Webhook 필드 표를 스크롤합니다.
2. messages 행을 찾습니다. (affiliation, attire 등은 Instagram DM과 무관)
3. 해당 행 토글을 구독됨으로 전환합니다. ( «구독 취소됨»이면 DM이 수신되지 않음 )
4. 표에 messages가 안 보이면 3-3-1 «확인 및 저장»을 먼저 성공시킨 뒤 페이지를 새로고침합니다.

앱 만들기·Messenger «설정» 버튼 위치 등은 페이스북 (Messenger) 가이드 1부·3부를 참고하세요.

3-4. Meta — 앱 역할 (개발 모드 테스트)

앱이 개발 모드일 때 OAuth·DM 테스트는 앱에 역할이 있는 Facebook 계정만 안정적으로 사용할 수 있습니다.

권장: 실제 계정을 테스터로 초대 (관리자·개발자 본인만 있으면 생략 가능)

1. Meta 앱 → 앱 역할(App roles) → 역할(Roles) 탭 ( «테스트 사용자» 탭이 아님 )
2. 테스터(Testers) 섹션 → 테스터 추가 → 테스트에 쓸 Facebook 계정 이메일 입력
3. 초대받은 사람이 developers.facebook.com/requests에서 수락
4. «인스타그램 연결»·DM 테스트는 앱 관리자·개발자·테스터 Facebook 계정으로 진행
5. DM을 보낼 Instagram 계정은 해당 Facebook 프로필과 계정 센터에서 연결되어 있어야 합니다.

3-5. 앱 검수 · 라이브 (실서비스·일반 사용자)

일반 Instagram 사용자의 DM을 받으려면 앱 검수 후 앱 모드를 라이브로 전환합니다. 개발 모드에서는 테스터·역할자만 테스트 가능합니다.

• instagram_manage_messages — Instagram DM 관리
• instagram_basic — Instagram 기본 정보
• pages_manage_metadata — 페이지 메타데이터 (Meta 문서 권장)

Meta → 앱 검수(App Review) → 권한 요청 → 승인 후 앱 모드 라이브.

3-6. 운영자 점검 체크리스트

• ☐ Meta 앱 — 3-0-1 Messenger + 3-0-2 Facebook Login 제품 «설정»으로 추가
• ☐ 마이챗봇 관리자 설정 — App ID / Secret / Verify Token 저장
• ☐ Facebook Login — Valid OAuth Redirect URIs에 Redirect URL 등록
• ☐ Messenger Webhooks — 3-3-1 «확인 및 저장» 성공 + 3-3-2 messages 구독됨
• ☐ (개발 모드) 앱 관리자·개발자·테스터 역할 확인 (관리자 본인만 있어도 OAuth 테스트 가능)
• ☐ (실서비스) 앱 검수 승인 + 앱 모드 라이브

연동 확인

채널 등록(OAuth·목록에 @사용자명)과 DM 수신은 별도로 확인합니다.

1. 채널 등록: 5단계 «채널» 목록에 instagram·@사용자명 표시 (2-4)
2. DM 테스트: 다른 Instagram 계정에서 연동해 둔 @인스타로 DM 전송
3. «상호작용 유형» AI만이면 자동 답장 확인
4. 대시보드·상담원 패널 대화 기록에 Instagram 대화 생성 확인
5. «AI+상담원 전환»이면 DM에 #humanagent 입력 테스트

자주 묻는 질문

Instagram만 있으면 되나? Facebook 페이지도 꼭 필요한가?

둘 다 필요합니다. Instagram 프로페셔널 계정만으로는 API 연동이 되지 않습니다. Facebook 페이지(개인 프로필 아님)를 하나 만들고, 1-3에서 Instagram과 페이지를 연결해야 합니다.

계정 센터 «연결된 경험»에서 페이지를 추가하면 되나?

아닙니다. 연결된 경험은 Facebook 개인 프로필과 Instagram 간 콘텐츠 공유·동기화 설정입니다. mychatbot DM API에 필요한 Facebook 페이지 ↔ Instagram 연결은 1-3 방법 A·B(Instagram «기존 페이지 연결» 또는 Facebook 페이지 «Instagram 연결»)에서 합니다.

«인스타그램 연결» 시 어떤 계정으로 로그인하나?

Instagram이 연결된 Facebook 페이지를 관리하는 Facebook 개인 계정으로 Meta OAuth 로그인합니다. Instagram 앱 계정·비밀번호가 아니며, Facebook 페이지 자체로 로그인하는 것도 아닙니다. 페이지 관리자 권한이 있는 계정이어야 합니다.

«Instagram 비즈니스 계정과 연결된 Facebook 페이지를 찾을 수 없습니다» 오류

OAuth 권한은 통과했지만 1-3 페이지 연결이 아직 안 된 상태입니다. Instagram 앱 → 프로필 편집 → 페이지 → 기존 페이지 연결을 완료한 뒤 다시 시도하세요.

«설정 필요» / «관리자에게 설정을 요청하세요»가 나와요.

서비스 운영자가 3부 설정(Meta App ID/Secret, Facebook Login Redirect URI, Messenger Webhooks 등)을 아직 마치지 않았습니다. 일반 회원은 운영·지원팀에 Instagram 채널 개통을 요청하세요. 운영자는 3-6 체크리스트를 확인하세요.

Messenger만 추가하면 되나? Facebook Login도 필요한가?

둘 다 필요합니다. Messenger → DM 웹훅 / Facebook Login → «인스타그램 연결» OAuth. MagicAI 공식 가이드에는 Messenger만 안내되어 있으나, 실제 애드온은 OAuth이므로 Facebook Login 제품 추가가 필수입니다 (3-0·3-2).

Facebook Login «고급 액세스»·비즈니스 포트폴리오는 지금 꼭 해야 하나?

개발·테스트(OAuth·채널 연결)만이면 Redirect URI 등록(3-2)으로 시작할 수 있습니다. Facebook Login 화면의 «고급 액세스» 주황 배너·비즈니스 포트폴리오 연결·비즈니스 인증은 일반 사용자 DM·앱 라이브(3-5) 단계에서 요구되는 경우가 많습니다. OAuth 테스트와는 별개로 진행해도 됩니다.

«브라우저가 팝업을 차단했습니다» 오류가 나요.

OAuth는 팝업 창이 필요합니다. 브라우저 주소창 옆 팝업 차단 아이콘에서 mychatbot.ai.kr 허용 후 다시 «인스타그램 연결»을 누르세요.

«인스타그램 데이터를 가져올 수 없습니다»가 나와요.

OAuth 팝업을 너무 빨리 닫았거나, Meta 로그인·권한 허용이 완료되지 않았을 수 있습니다. 팝업을 끝까지 진행한 뒤 «연결 완료» 화면이 보일 때까지 기다리세요.

OAuth는 됐는데 DM이 안 와요.

• 채널 목록에 @사용자명이 보이면 채널 등록은 성공 — DM만 별도 확인
• Instagram ↔ Facebook 페이지 연결(1-3)·비즈니스 계정 여부 확인
• 운영자: Messenger Webhooks messages 구독 (3-3-2) — URL만 저장하고 구독 안 하면 DM 미수신
• Meta 앱 개발 모드이면 DM 보내는 계정·OAuth 계정이 앱 관리자·테스터인지 확인 (3-4)
• 일반 사용자 DM은 앱 검수·라이브 후 (3-5)

Messenger 가이드와 뭐가 다른가요?

항목	Messenger	Instagram
등록 방식	App ID·토큰 등 수동 입력	OAuth («인스타그램 연결»)
웹훅 URL	채널마다 개별 URL («웹훅 복사»)	서비스 공통 URL 1개
인증 토큰	사용자가 직접 생성·Meta에 입력	서비스 공통 설정 (사용자 입력 없음)
계정 요건	Facebook 페이지	Instagram 비즈니스 + Facebook 페이지 연결

Meta 앱·Webhooks 상세는 페이스북 (Messenger) 가이드를 함께 참고하세요.

같은 Instagram을 두 번 연결했어요.

채널 목록에 instagram이 중복으로 보일 수 있습니다. 사용하지 않는 행은 «세부 정보 → 삭제»로 정리하세요. Meta 쪽에서는 동일 Instagram Business Account ID(instagram_id)당 하나의 활성 채널만 두는 것을 권장합니다.

챗봇 만들기 전체 흐름은 5분 만에 챗봇 만들기, Meta 앱·Webhooks 상세는 페이스북 (Messenger), 다른 채널은 텔레그램 가이드를 참고하세요.