Anyy의 WhatsApp 채널은 Meta 공식 Business Cloud API를 사용합니다. 서명된 웹훅으로 다이렉트 메시지를 수신하고 구성된 비즈니스 전화 정체성으로 응답합니다.
필요한 항목
- WhatsApp이 활성화된 Meta 앱.
- App ID, WhatsApp Business Account ID, Phone Number ID.
- Cloud API 사용이 허가된 접근 토큰.
- 소유자가 정한 웹훅 검증 토큰.
- Meta 앱 비밀정보.
- Anyy Gateway로 향하는 공개 HTTPS 경로.
현재 플랫폼 설정은 Meta의 Cloud API 문서를 따르세요.
Dashboard에서 연결
- Dashboard → Channel → Add를 엽니다.
- WhatsApp을 선택합니다. 기본 항목은 Business Cloud API webhook을 사용합니다.
- App ID, Business Account ID, Phone Number ID를 입력합니다.
- 접근 토큰, 웹훅 검증 토큰, 앱 비밀정보를 추가합니다.
- 자격 증명을 저장합니다. 정책 변경은 이 자격 증명 양식이 아니라 대화형 CLI 마법사를 사용합니다.
- 계정을 저장하고 보고된 Meta 사전 요건과 권한을 완료합니다.
콜백 등록 전에 메시징 플랫폼의 리스너와 HTTPS 프록시를 활성화하세요. 수신 콜백 경로는 다음과 같습니다.
/channels/whatsapp/ACCOUNT_ID/webhook
기본 계정의 ACCOUNT_ID는 personal입니다. 이 경로를 HTTPS로 공개하고 같은 검증 토큰으로 Meta 앱의 WhatsApp 메시지 이벤트를 구독하세요.
접근 정책
WhatsApp은 다이렉트 메시지 접근으로 pairing, open, allowlist, disabled를 지원하며 기본값은 pairing입니다. 대화형 anyy setup channel 마법사에서 WhatsApp을 선택해 정책을 바꿉니다. 현재 설정 작업에는 허용 목록 항목 편집기가 없습니다. 공통 설정 제한을 참조하세요. 이 프로필은 그룹이나 네이티브 미디어 수신 허용을 제공하지 않습니다.
전화 신원을 확인한 후에만 대기 발신자를 승인하세요.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
플랫폼 제약
v0.1.107의 Anyy는 내장 EEA/브라질 국가 코드 목록과 일치하는 수신자 식별자만 수락하고 전송합니다. 개방 DM 정책도 이 구현 제한을 우회할 수 없습니다. Meta의 최신 자격 및 지역 규칙은 별도로 확인하세요. Anyy의 고정 목록은 현재 플랫폼 정책 전체를 나타내지 않습니다.
자유 형식 응답에는 원래 사용자가 시작한 메시지 컨텍스트와 플랫폼이 허용한 응답 시간이 필요합니다. 현재 경로에는 수신 메시지 ID가 포함되므로 한 연락처의 연속 메시지가 반드시 단일 Anyy 세션을 공유하지는 않습니다.
Anyy는 수신자를 임의로 만들거나 Meta 대화 규칙을 우회하지 않습니다. 허가된 수신 대화에서 시작하고 전달 예약·재시도 시 플랫폼 정책을 고려하세요.
연결 확인
anyy channel doctor whatsapp
anyy channel reload
비즈니스 번호로 다이렉트 메시지를 보내고 페어링을 완료하여 Anyy가 응답하는지 확인하세요.
문제 해결
| 문제 | 확인 사항 |
|---|---|
| 웹훅 챌린지 실패 | 공개 HTTPS 경로와 웹훅 검증 토큰 |
| 이벤트가 401을 받음 | Meta 앱 비밀정보와 X-Hub-Signature-256 라우팅 |
| 수신은 되지만 전송 실패 | 접근 토큰, Phone Number ID, 권한, 자격 |
| 발신자 무시 | DM 정책, 페어링 상태, 허용 목록 |
| 나중에 응답이 거부됨 | 사용자 시작 응답 시간과 현재 Meta 규칙 |