페이스북 (Messenger)

Facebook 페이지의 Messenger로 들어온 DM을 마이챗봇 AI·상담원이 응답하도록 연동합니다.

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

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

Messenger 채널 연동은 Facebook 페이지로 들어온 메신저 DM을 마이챗봇이 받아 처리하게 만드는 작업입니다. 웹사이트에 설치한 챗봇 위젯(iframe)과는 별도의 대화입니다.

• 고객이 Facebook Messenger 앱에서 페이지(예: «마이챗봇»)로 메시지를 보냅니다.
• Meta가 그 메시지를 마이챗봇 서버(웹훅 URL)로 전달합니다.
• 마이챗봇이 AI 또는 상담원 설정에 따라 답변하고, Messenger 앱으로 다시 보냅니다.
• 대화 내역은 대시보드·상담원 패널에서도 확인할 수 있습니다.

준비물

• Meta for Developers 계정
• 연동할 Facebook 페이지 관리자 권한
• 마이챗봇에서 챗봇 1개 생성 완료 (편집 마법사 1~4단계 권장)
• 메모장 등 — 인증 토큰(직접 만드는 문자열)을 적어 둘 곳

전체 흐름 (한눈에 보기)

Meta와 마이챗봇을 번갈아 설정합니다. 아래 순서대로 진행하세요.

아래는 위 순서를 따라가는 상세 단계입니다. ① Meta → ② 마이챗봇 → ③ Meta 웹훅 순으로 진행하세요.

1부. Meta에서 앱·Messenger 준비

1-1. Meta 앱 만들기

1. developers.facebook.com/apps에 접속합니다.
2. 우측 상단 앱 만들기를 클릭합니다.
3. 앱 이름(예: 마이챗봇)과 앱 연락처 이메일을 입력하고 다음을 누릅니다.
4. 이용 사례에서 필터 기타를 선택한 뒤, 하단 «다른 옵션»의 기타를 선택하고 다음을 누릅니다.
5. 앱 유형에서 비즈니스를 선택하고 다음 → 앱 생성을 완료합니다.

편집 참고: 앱 상세정보(이름·이메일) 입력, «비즈니스» 유형 선택 화면은 UI가 단순해 별도 스크린샷 없이 위 글만으로 충분합니다.

1-2. Messenger 제품 추가

1. 생성한 앱 대시보드에서 추가할 수 있는 제품 목록을 찾습니다.
2. Messenger 카드의 설정 버튼을 클릭합니다.
3. 왼쪽 메뉴에서 Messenger → Messenger API 설정으로 이동합니다.

1-3. Facebook 페이지 연결 & 액세스 토큰 생성

1. 2. 액세스 토큰 생성 섹션에서 연결을 클릭합니다.
2. Facebook 로그인·권한 화면에서 Messenger에 쓸 페이지를 선택합니다. (예: «마이챗봇») 현재 페이지에만 옵트 인을 권장합니다.
3. 계속을 눌러 연결을 마칩니다.
4. 페이지 목록이 나타나면 해당 페이지 행의 생성 버튼을 클릭해 페이지 액세스 토큰을 만듭니다.
5. 생성된 토큰 문자열을 안전한 곳에 복사해 둡니다. (마이챗봇 입력용)

편집 참고: Facebook 페이지 선택 팝업(«현재 페이지에만 옵트 인»)은 글 설명만으로 충분해 별도 이미지 생략 가능.

1-4. 앱 ID · 앱 시크릿 코드 확인

1. Meta 앱 왼쪽 메뉴 앱 설정 → 기본 설정으로 이동합니다.
2. 앱 ID와 앱 시크릿 코드를 복사해 둡니다. (마이챗봇 입력용)

2부. 마이챗봇에서 Messenger 채널 등록

2-1. 채널 정보 입력

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

마이챗봇 필드	어디서 가져오나요?
앱 ID	Meta → 앱 설정 → 기본 설정
앱 시크릿 코드	Meta → 앱 설정 → 기본 설정
페이지 이름	연동한 Facebook 페이지 이름 (예: 마이챗봇)
액세스 토큰	Meta → Messenger API 설정 → «2. 액세스 토큰 생성»에서 생성한 토큰
인증 토큰	직접 만드는 문자열 (Meta에서 발급되지 않음). 아래 안내 참고.

1. 모든 필드를 입력한 뒤 채널 추가를 클릭합니다.
2. «메신저 채널이 연동되었습니다…» 안내가 보이면 성공입니다. 팝업은 X로 닫으면 됩니다.

2-2. 웹훅 URL 복사

1. 같은 «채널» 화면 아래 채널 목록에서 방금 추가한 messenger 행을 찾습니다.
2. 웹훅 복사 버튼을 클릭합니다.
3. 클립보드에 복사된 URL(예: https://mychatbot.ai.kr/api/v2/chatbot/…/messenger)을 메모장에 붙여 넣어 둡니다.

3부. Meta에 웹훅 등록 (다시 Meta로)

3-1. Webhooks 구성

1. Meta 앱 → Messenger → Messenger API 설정으로 돌아갑니다.
2. 1. Webhooks 구성 섹션을 엽니다.
3. 콜백 URL에 2부에서 복사한 웹훅 URL을 붙여 넣습니다.
4. 인증 토큰에 2부에서 입력했던 인증 토큰과 동일한 값을 입력합니다.
5. 확인 및 저장을 클릭합니다. Meta가 URL을 검증하면 성공입니다.

저장 후 아래 Webhook 필드에서 messages, messaging_postbacks 등 메시지 수신에 필요한 항목을 구독 상태로 켜 주세요. (Meta UI 버전에 따라 «구독 추가» 또는 토글로 표시됩니다.)

3-2. 앱 검수 (실서비스·일반 사용자 대상)

앱 모드가 개발일 때는 앱 관리자·테스터 등 제한된 계정만 테스트할 수 있습니다. 일반 Facebook 사용자에게 Messenger 봇을 제공하려면 앱 검수가 필요합니다.

1. 3. 앱 검수 완료 섹션에서 권한 요청을 클릭합니다.
2. pages_messaging 등 Messenger 메시지 송수신 권한을 요청·승인받습니다.
3. 승인 후 앱 모드를 라이브로 전환합니다.

연동 확인

1. Facebook Messenger 앱에서 연동한 페이지로 테스트 메시지를 보냅니다.
2. AI 모드라면 챗봇이 자동으로 답장하는지 확인합니다.
3. 마이챗봇 상담원 또는 대화 기록에서 해당 Messenger 대화가 쌓이는지 확인합니다.

자주 묻는 질문

«Unauthenticated.» 오류가 나요.

로그인 세션이 만료되었을 수 있습니다. 로그아웃 후 다시 로그인하고, 페이지를 새로고침한 뒤 «채널 추가»를 다시 시도하세요. (관리자 계정에서만 발생하는 경우 일반 사용자 계정으로 테스트해 보세요.)

채널 추가는 됐는데 목록에 안 보여요.

성공 메시지가 떴다면 DB에는 저장된 경우가 많습니다. «세부 정보»에서 웹훅 URL을 확인하거나, 페이지를 나갔다가 «채널» 단계를 다시 열어 보세요.

인증 토큰은 몇 자 이상이어야 하나요?

Meta 공식 최소 길이는 UI마다 다르지만, 20자 이상의 추측하기 어려운 문자열을 권장합니다. 중요한 것은 Meta 웹훅 설정과 마이챗봇 입력값이 완전히 동일한지입니다.

웹훅 «확인 및 저장»이 실패해요.

• 콜백 URL이 마이챗봇 «웹훅 복사» 값과 정확히 같은지 확인
• 인증 토큰이 채널 등록 시 입력값과 동일한지 확인
• 마이챗봇 서버가 HTTPS로 외부에서 접근 가능한지 확인

같은 페이지로 채널을 두 번 등록했어요.

채널 목록에 messenger가 중복으로 보일 수 있습니다. 사용하지 않는 행은 «세부 정보 → 삭제»로 정리하고, Meta 웹훅 URL도 해당 채널 ID에 맞는 하나만 쓰세요.

챗봇 만들기 전체 흐름은 5분 만에 챗봇 만들기, 다른 채널은 인스타그램· 텔레그램 가이드를 참고하세요.