Weixin / WeChat
Anyy의 Weixin 채널은 대화형 QR 확인 롱 폴링 세션을 사용합니다. 다이렉트 메시지, 수신·발신 미디어, 입력 상태, 실시간 점검, /voice 채널 제어를 지원합니다.
현재 연결 프로필은 미리 보기 단계입니다. 인증 코드, 리디렉션 호스트, 일부 이미 연결된 계정, 정체성 갱신, 원격 수명 주기 사례는 지원되지 않습니다. 복구용 다른 Anyy 인터페이스를 사용 가능한 상태로 유지하세요.
1. QR 인증 시작
Dashboard → Channel → Add → Weixin / WeChat을 엽니다. 이 항목은 Ilink 롱 폴링을 사용합니다. 계정 페이지에서 인증을 시작하세요.
Dashboard는 대화형 단계에 QR 코드를 표시합니다. 원하는 Weixin 계정으로 스캔하고 휴대전화에서 확인하세요. 인증 단계의 제한 시간은 5분이며 취소할 수 있습니다.
반환된 로그인 토큰은 프로필 자격 증명 참조로 저장되며 일반 채널 구성에서 다시 표시되지 않습니다.
CLI와 TUI 설정도 같은 인증 흐름을 사용합니다. 독립 스캔이 성공했지만 계정 저장 전에 취소하면 Anyy는 사용하지 않은 로컬 로그인 초안을 폐기합니다. 취소해도 이미 저장된 계정은 연결 해제되지 않습니다.
2. 다이렉트 메시지 접근 선택
Weixin은 DM 정책 open, allowlist, disabled를 지원합니다. 현재 기본값은 open입니다.
QR 연결 후 계정 설정에서 DM 정책을 선택하고 allow_from을 편집하세요. 아는 발신자만 Anyy에 접근해야 하면 allowlist를 선택합니다. 항목은 채널이 관찰한 Weixin 발신자 식별자를 사용합니다. 설정을 저장해도 현재 로그인은 유지되고 새 QR 코드를 요청하지 않습니다. 빈 목록은 모든 항목을 제거합니다.
현재 프로필의 Weixin은 다이렉트 메시지 전용이며 그룹 정책은 제공되지 않습니다.
3. 계정 확인
QR 흐름이 완료되면 다음을 실행합니다.
anyy channel reload
anyy channel doctor weixin
허용 계정에서 같은 대화에 다이렉트 메시지 두 개를 보내세요. 각각 응답 하나를 받고 두 번째가 대화 컨텍스트를 유지하는지 확인합니다. 실제 트래픽 이후 Doctor에 현재 자격 증명과 수신/발신 전송 증거가 표시되어야 합니다. 두 번째 메시지 후에도 웹 대화와 채널 상세 페이지가 로드되는지 확인하세요.
성공한 응답은 마지막 수락 전송 시간을 갱신하며 이전 전송 실패를 지울 수 있습니다. 준비 상태가 같다고 타임스탬프 갱신이 멈춰야 하는 것은 아닙니다. 실제 메시징이 작동해도 일부 미리 보기 점검 축은 사용 불가로 남습니다. 사용 불가 점검을 모든 기능 실패의 증거로 해석하지 말고 보고된 축과 진단을 확인하세요.
메시지, 미디어, 명령
어댑터는 텍스트를 수신·전송하고 지원 수신 미디어를 준비하며 구성 한도 내에서 이미지, 동영상, 오디오, 음성, 파일 첨부를 전달할 수 있습니다. 현재 계정과 상대방의 응답 컨텍스트 토큰을 영속 저장하고 갱신합니다. 토큰은 Anyy가 관리하도록 두세요. 일반적인 전송 실패 자체가 자격 증명 만료 신호는 아닙니다. 새 QR 흐름을 시작하거나 불확실한 응답을 반복하기 전에 진단과 플랫폼 대화를 확인하세요.
일반적인 Weixin 명령은 다음과 같습니다.
/status
/stop
/new
/voice
/voice는 TTS가 구성된 경우 해당 채널 대화의 음성 응답을 관리합니다.
명령 응답 전달 중 오류가 발생해도 완료된 로컬 작업은 취소되지 않습니다. 명령을 수동 반복하기 전에 현재 대화와 계정 상태를 확인하세요.
만료된 세션 재인증
원격 자격 증명이 만료되면 채널 상태가 자격 증명 만료로 바뀌고 조치 안내가 새 QR 스캔을 요청합니다. Dashboard → Channel → Weixin에서 인증을 다시 시작하고 스캔·확인한 다음 Doctor를 다시 실행하세요.
다른 계정에서 얻은 토큰을 붙여 넣거나 수동 편집하지 마세요. Anyy는 확정된 원격 정체성과 자격 증명 수명 주기를 구성된 채널 계정에 연결합니다.
Gateway 재시작으로 실시간 QR 폴링 핸들이 사라지면 시도는 알 수 없음 또는 만료로 종료됩니다. 자동으로 다른 QR을 요청하지 않습니다. 채널 페이지에서 새 스캔을 시작하세요.
로그인 요청의 응답만 유실되었다면 로그인 페이지를 재시도하거나 다시 로드하여 같은 요청을 복구하세요. 새 QR에는 명시적 새로 고침이 필요합니다. Dashboard는 QR의 5분 수명을 늘리지 않으면서 각 요청을 10분간 복구 가능하게 유지합니다. 이후에는 계정 설정으로 돌아가세요.
문제 해결
| 증상 | 확인 사항 |
|---|---|
| QR 코드 만료 | 새 인증 시도를 시작하고 5분 안에 스캔 |
| 휴대전화가 미지원 인증 경로 요구 | 취소하고 지원되는 QR 확인 흐름 사용. 프로필은 미리 보기 단계 |
| 상태가 자격 증명 만료임 | 채널 페이지에서 새 QR 코드 스캔 |
| 메시지는 오지만 응답 실패 | 발신 전송, 컨텍스트 토큰 상태, 미디어 제한, 롱 폴링 상태 확인 |
| 예상치 못한 발신자가 Anyy에 메시지를 보냄 | 연결 계정 설정에서 allowlist 선택 후 허용할 발신자 식별자를 입력하고 저장 |
공통 채널 진단은 메시징 플랫폼을 참조하세요.