채널
채널은 Anyy 상주 Gateway를 메시징 플랫폼에 연결합니다. Dashboard는 계정 추가, 상태 확인, 설정 업데이트, 재인증, 연결 제거의 주 인터페이스입니다.
지원 플랫폼 목록과 동작 비교는 메시징 플랫폼을 참조하세요.
세션 동작과 플랫폼 연결
플랫폼 계정 인증, 수신 메시지, 발신 전달은 Anyy 통합입니다. 세션에 수용된 뒤에는 에이전트 메시지, 방향 조정/후속 대기열, 중단, 이벤트가 다른 Anyy 인터페이스와 같은 Pi 정렬 수명 주기를 사용합니다. 플랫폼 어댑터가 별도 에이전트 루프나 대기열 정책을 추가하지 않습니다.
고정 Pi v1.2.0 기본 저장소에는 대응되는 통합 네이티브 Feishu/Weixin/Slack 어댑터 API가 없습니다. README는 채팅 워크플로를 별도 pi-chat 프로젝트로 안내합니다. 해당 프로젝트와 타사 플러그인은 이 포팅의 참조 대상이 아닙니다. 로컬 계정 설정과 통제된 프로토콜 검사만으로 실제 외부 계정 연결이 증명되지는 않습니다. 관찰된 상태를 확인하세요.
Channel 페이지 열기
Dashboard → Channel을 엽니다. 필터로 다음을 전환합니다.
- Configured — 연결이 끊긴 계정도 포함해 이 프로필에 저장된 계정.
- Available — Anyy가 구성할 수 있는 플랫폼 어댑터.
각 구성 계정에는 안정적인 계정 ID와 현재 연결을 식별하는 인카네이션이 있습니다. 현재 설정은 플랫폼 계정이 없을 때만 추가하며 두 번째 계정 생성 흐름은 없습니다.
계정 구성
- 사용 가능한 플랫폼을 선택합니다.
- 계정 ID를 입력합니다.
- 플랫폼별 필드를 작성합니다.
- 선택한 Dashboard 작업이 제공하는 필드를 작성합니다.
- 구성을 저장합니다.
저장은 선택 계정 작업을 직접 제출하고 Operation 영수증을 반환합니다. 계정 설정과 보호된 자격 증명 바인딩은 함께 확정됩니다. 비밀정보를 비워도 해당 필드가 보존을 허용할 때만 기존 값이 유지됩니다. 계정의 Anyy 관리 자격 증명을 정리하려면 계정을 제거하세요.
committed나 no_op 영수증은 로컬 설정을 설명하며 플랫폼 연결 확인이 아닙니다. 새 시작/재시도나 원하는 상태가 같은 작업도 런타임에 연결 조정을 요청합니다. 동일 호출자 요청의 재시도는 원래 영수증을 반환합니다. 실제 결과는 관찰된 계정 상태로 확인하세요.
Weixin은 QR 흐름을 사용합니다. 원하는 계정으로 스캔하고 휴대전화에서 확인한 뒤 인증 결과를 기다립니다. QR 상호작용은 5분입니다. 만료 전 수락된 확인은 이후 로컬 검증을 마칠 수 있지만 완료 계정도 관찰된 전송 상태를 확인해야 합니다. 페이지에서 현재 시도를 취소하거나 교체하세요.
Gateway 재시작으로 실시간 QR 폴링 핸들이 사라지면 시도는 알 수 없음 또는 만료로 종료됩니다. Anyy가 조용히 다른 QR을 가져오지는 않습니다. 안내가 나오면 새로 시작하세요.
로그인 요청 응답이 유실되면 Retry를 사용하거나 로그인 페이지를 다시 로드하세요. Dashboard는 같은 요청을 유지하므로 재시도가 새 인증 시도를 시작하지 않습니다. 명시적 새로 고침만 새 QR을 요청합니다. 요청 복구는 동작마다 10분이며 이후 계정 설정으로 돌아갑니다. QR의 5분 수명은 늘어나지 않습니다.
Weixin 재인증 시 같은 정체성으로 스캔하세요. 다른 정체성으로 교체하려면 이전 계정을 먼저 제거하고 새로 구성하세요.
대부분 플랫폼의 Dashboard/TUI 자격 증명 양식에는 DM/그룹 정책 입력이 없습니다. 대화형 anyy setup channel 마법사로 변경하세요. Weixin에는 연결된 계정의 별도 접근 양식이 있습니다. Feishu 설정은 기본 장기 연결이며 표준 설정 인터페이스에는 연결 프로필 전환 선택기가 없습니다. 기존 웹훅 계정은 플랫폼 안내를 참조하세요.
계정 상태 읽기
구성 계정을 열어 다음을 확인합니다.
- 원하는 런타임 상태와 현재 상태.
- 정상, 저하, 비정상, 알 수 없음 상태.
- 마지막 수신·발신 활동.
- 선언된 전달 확인 지원과 관찰된 재시도/백오프 증거.
- 인증 또는 권한 오류.
- 비밀정보가 가려진 구성 값.
저하된 계정도 일부 작동할 수 있습니다. 반복해서 다시 로드하기 전에 페이지의 조치를 따르세요.
전달 확인 지원은 어댑터가 선언한 기능이며 특정 메시지가 플랫폼에 도착했다는 증거가 아닙니다. 현재 증거, 진단, 다음 재시도 시간이 관찰된 연결을 설명합니다.
Anyy는 전송 전에 안전하게 재시도할 수 있으면 최종 응답을 대기 상태로 둡니다. 일부가 수락되었거나 원격 결과가 불확실하면 자동 반복하지 않습니다. 다른 사본을 요청하기 전에 플랫폼 대화를 확인하세요. 종료된 턴의 진행 정보가 최종 응답 뒤에 따라가지 않습니다.
접근 정책
제어는 플랫폼에 따라 다릅니다. 일반 정책은 다음과 같습니다.
- DM 비활성화, 페어링, 허용 목록, 개방.
- 멘션 또는 기존 방 허용 목록으로 그룹 메시지 제한.
- 지원 플랫폼에서 새 발신자의 CLI 페어링 승인.
정책/목록 필드는 인터페이스별입니다. 현재 공개 발신자 목록 입력은 Weixin과 IRC에 있습니다. 다른 어댑터는 기존 목록을 쓸 수 있지만 현재 설정 작업은 항목 편집을 제공하지 않습니다. allowlist 선택이 목록을 만든다고 가정하지 마세요. 실제 설정 흐름이 구성할 수 있는 가장 좁은 정책을 사용하세요. 계정 연결이 모든 발신자를 허가하지는 않습니다.
이미 연결된 Weixin 계정은 설정에서 DM 정책과 allow_from 발신자 목록을 바꿉니다. 접근 설정 저장은 현재 로그인을 유지하며 새 QR 스캔은 불필요합니다. 빈 목록은 모든 허용 목록 항목을 제거합니다.
채널 다시 로드
현재 저장 계정을 런타임에 조정해야 하면 Reload를 선택하세요. 계정 저장은 보통 이미 조정을 요청합니다. Reload는 과거 메시지를 재전송하거나 비활성 웹훅 리스너를 시작하지 않습니다.
CLI에서는:
anyy channel reload
anyy channel doctor telegram
doctor는 계정 구성을 바꾸지 않고 구성 채널 연결을 관찰하고 진단합니다. 웹훅 리스너 변경에는 Gateway 재시작이 필요합니다. 메시징 플랫폼을 참조하세요.
CLI 페어링
현재 Dashboard 채널 페이지에는 페어링 요청 승인 목록이 없습니다. 페어링 플랫폼에서는 CLI를 사용하세요.
anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID
anyy channel pairing reject --request REQUEST_ID
anyy channel pairing revoke --grant GRANT_ID
승인 전에 플랫폼, 계정, 가려진 발신자 식별자, 요청 접근을 검토하세요.
제한된 목록에서 아는 요청이나 권한 ID를 찾지 못하면 계정 범위를 명시하세요.
anyy channel pairing approve --request REQUEST_ID --channel telegram --account personal
anyy channel pairing revoke --grant GRANT_ID --channel telegram --account personal
같은 ID 기반 작업의 현재 계정을 선택할 뿐 소유권 검사를 우회하지 않습니다.
계정 제거
계정 상세 페이지에 삭제 작업이 있습니다. 제거하면 해당 계정의 채널 구성과 Anyy 관리 자격 증명을 삭제합니다. 외부 플랫폼 메시지는 삭제하지 않습니다.
제거는 로컬 중지/제거 사실과 자격 증명 정리를 함께 확정한 뒤 실제 전송을 조정합니다. 같은 정체성을 다시 구성하기 전에 목록과 연결 상태를 갱신하세요. 로컬 제거 영수증만으로 플랫폼 로그아웃이 증명되지 않습니다.
CLI 설정
대화형 마법사를 실행합니다.
anyy setup channel
플랫폼 이름을 추가하면 플랫폼별 마법사가 아닌 비대화형 구성을 선택합니다. 예를 들어 기존 Telegram 계정은 허용된 자격 증명을 보존하며 정책을 업데이트할 수 있습니다.
anyy setup channel telegram --set dm_policy=pairing --set group_policy=mention
새 계정 구성에는 선언된 자격 증명 입력도 필요합니다.
비대화형 --set과 민감 입력 옵션은 anyy setup channel --help를 사용하세요.
보안 팁
- 봇 토큰과 서명 비밀정보를 셸 기록·스크린샷에 남기지 마세요.
- DM 개방 전에 페어링이나 허용 목록으로 시작하세요.
- 공급자 쪽 웹훅 엔드포인트와 플랫폼 권한을 확인하세요.
- 계정을 폐기할 때 자격 증명을 제거하세요.
- 외부 메시지와 첨부 파일은 신뢰하지 않는 입력으로 취급하세요.
문제 해결
| 문제 | 해결 |
|---|---|
| 계정이 계속 사용 불가 | 상세 페이지에서 보고된 조치 수행 |
| 로그인 만료 | 같은 계정 정체성 재인증 |
| 수신은 되지만 응답 실패 | 발신 권한, 전달 상태, 플랫폼 속도 제한 확인 |
| 새 발신자가 Anyy 사용 불가 | DM 정책과 대기 페어링 요청 검토 |
| 구성 변경이 런타임에 미반영 | Reload 또는 anyy channel reload |
연결된 채널로 예약 결과를 전달하려면 Cron을 참조하세요.