Facebook Messenger
Facebook 채널은 Anyy를 Facebook 페이지에 연결합니다. Messenger 이벤트는 서명된 웹훅으로 도착하고 응답은 페이지 접근 토큰을 사용합니다.
필요한 항목
- Messenger가 활성화된 Meta 앱.
- 해당 앱이 관리하는 Facebook 페이지.
- Page ID와 App ID.
- 페이지 접근 토큰.
- 소유자가 정한 웹훅 검증 토큰.
- Meta 앱 비밀정보.
- Anyy Gateway로 향하는 공개 HTTPS 경로.
앱 심사, 페이지 구독, 권한 요건은 Meta의 최신 Messenger Platform 시작 안내를 사용하세요.
Dashboard에서 연결
- Dashboard → Channel → Add를 엽니다.
- Facebook을 선택합니다. 기본 항목은 Messenger webhook을 사용합니다.
- Page ID와 App ID를 입력합니다.
- 페이지 접근 토큰, 웹훅 검증 토큰, 앱 비밀정보를 추가합니다.
- 계정을 저장합니다. 필요하면 CLI 마법사에서 DM 정책을 바꿉니다.
- 페이지에서 메시지 이벤트를 구독하고 setup/doctor에 표시된 권한을 완료합니다.
콜백을 등록하기 전에 웹훅 플랫폼에 설명된 공유 리스너와 HTTPS 프록시를 활성화하세요. 콜백 경로는 다음과 같습니다.
/channels/facebook/ACCOUNT_ID/webhook
기본 계정 ID는 page입니다. Meta와 Anyy에 같은 검증 토큰을 사용하세요.
다이렉트 메시지 접근
Facebook Messenger는 다이렉트 메시지 정책 pairing, open, allowlist, disabled를 사용합니다. Anyy 프로필은 Facebook 그룹 대화를 제공하지 않습니다.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
대화형 anyy setup channel 마법사에서 Facebook을 선택해 정책을 편집하세요. Dashboard에는 정책이나 페어링 승인 목록이 없고 현재 설정 작업은 Facebook 허용 목록 항목을 편집하지 않습니다. 페어링은 해당 발신자가 비서에 접근하도록 허가합니다. 페이지와 발신자 신원을 확인하고 CLI로 승인한 다음 새 메시지를 보내 달라고 하세요.
연결 확인
anyy channel doctor facebook
anyy channel reload
허용된 계정에서 페이지로 메시지를 보내세요. 수신 이벤트, 페어링 흐름, 응답을 각각 확인하세요.
먼저 플랫폼 역할이 있는 계정으로 테스트하세요
앱 심사나 확대 공개 전에 앱/페이지에 적절한 역할이 있는 Meta 계정을 사용하세요. Anyy 구성 문제와 플랫폼 접근 제한을 구분할 수 있습니다.
문제 해결
| 문제 | 확인 사항 |
|---|---|
| Meta가 콜백을 검증하지 못함 | HTTPS 접근 가능 여부와 웹훅 검증 토큰 |
| 서명된 이벤트가 거부됨 | 앱 비밀정보와 역방향 프록시의 헤더/본문 보존 |
| 페이지가 수신하지만 응답하지 못함 | 페이지 접근 토큰과 메시징 권한 |
| 발신자가 아무것도 받지 못함 | DM 정책, 페어링/허용 목록, Gateway 상태 |
| 관리자에게만 작동함 | Meta 앱 모드, 앱 심사, 페이지 구독 |