Make Agent Fast 문서

Messenger

Meta Messenger Platform 자격 증명과 서명된 웹훅으로 Facebook 페이지를 연결합니다.

이 페이지 한눈에

Meta Messenger Platform 자격 증명과 서명된 웹훅으로 Facebook 페이지를 연결합니다.

커넥터 라우팅하나의 에이전트, 여러 채널, 공유 지식과 인박스

Meta 앱과 페이지 준비하기#

Meta 공식 Messenger Platform 시작 가이드를 따르세요. Meta 앱에 Messenger를 추가하고 메시지를 받을 Facebook 페이지를 연결한 뒤 계정이 두 자산을 모두 관리할 수 있는지 확인합니다.

같은 앱과 페이지에서 값을 수집하세요.

Make Agent Fast 필드	제공자 값	목적
페이지 액세스 토큰	선택한 페이지용 토큰	페이지 식별 정보 조회 및 답변 발신
앱 시크릿	32자 16진수 Meta 앱 시크릿	서명된 수신 웹훅 요청 검증

사용자 액세스 토큰이나 다른 페이지의 토큰을 사용하지 마세요. Meta 앱의 개발/검토 상태가 이 통합을 사용할 수 있는 사람을 제어합니다.

사이트의 커넥터 페이지에서 Messenger를 선택하고 페이지 액세스 토큰과 앱 시크릿을 입력한 뒤 연결을 누릅니다.

Make Agent Fast는 appsecret_proof로 Graph API를 호출해 페이지 ID/이름을 확인하고 수신 이벤트를 그 정확한 페이지에 연결합니다. 커넥터 카드에는 웹훅 URL과 인증 토큰이 표시됩니다.

같은 Meta 앱에서 다음을 수행합니다.

인증 토큰은 초기 챌린지에만 쓰입니다. 런타임 이벤트에는 앱 시크릿과 일치하는 서명이 있어야 합니다. 같은 Meta 앱에서 온 이벤트라도 다른 페이지 대상이면 Make Agent Fast가 거부합니다.

허용된 관리자 아닌 테스트 계정에서 페이지에 일반 메시지를 보내고 응답과 대화 스레드를 확인합니다. 음성 수신이 중요하다면 오디오 첨부 파일도 테스트하세요.

텍스트와 지원 수신 오디오를 처리합니다. 현재 Messenger 커넥터의 발신은 원본이 음성이어도 텍스트만 지원합니다. 전달/읽음 영수증, 페이지 자체 메시지의 echo, 이미지, 기타 미지원 첨부 파일은 무시합니다.

대상 사용자에게 필요한 권한, 앱 검토, 비즈니스 검증, 개인정보 URL, 페이지 공개 단계를 완료하세요. 앱 역할 계정으로 개발 모드에서 성공해도 일반 사용자가 페이지 통합에 메시지를 보낼 수 있다는 뜻은 아닙니다.

운영자를 위해 소유 Meta 앱과 페이지 ID를 기록합니다. 소유자, 권한, 비즈니스 연결, 제공자 정책이 바뀌면 페이지 토큰이 중단될 수 있습니다.

교체 페이지 토큰을 만들고 커넥터를 업데이트해 허용 사용자로 테스트한 다음 이전 토큰을 무효화합니다. 앱 시크릿을 교체한 뒤에는 Make Agent Fast를 즉시 업데이트하세요.

커넥터를 끄거나 삭제해도 Meta에서 페이지 구독이 해제되지 않습니다. 영구 종료할 때 페이지 구독과 사용하지 않는 제공자 자격 증명도 제거합니다.

증상	해결 방법
토큰 거부	대상 페이지용 페이지 토큰이고 앱 시크릿이 같은 앱의 값인지 확인
웹훅 검증 실패	현재 URL과 인증 토큰을 정확히 복사하고 공개 HTTPS 사용
검증되지만 메시지가 오지 않음	페이지와 메시지 이벤트를 구독한 뒤 앱 모드, 사용자 역할, Meta 전달 로그 확인
요청 unauthorized	앱 시크릿 수정; 서명된 POST 요청은 인증 토큰을 사용하지 않음
수신 메시지는 보이지만 답변 없음	페이지 토큰 유효성, 메시징 권한, 제공자 발신 오류, 커넥터 상태 확인
음성이 텍스트로 답변됨	정상 동작이며 Messenger 음성 발신은 현재 미지원

제공자 자격 증명은 인증된 커넥터 폼 또는 신뢰할 수 있는 서버 측 API 호출에만 입력하세요.