Feishu / Lark

카탈로그는 Feishu/Lark 장기 연결 및 웹훅 프로필을 선언합니다. 표준 설정 인터페이스는 공개 웹훅이 필요 없는 기본 Long connection 계정을 만듭니다. 카탈로그에 웹훅이나 전환 작업이 있다고 해서 표준 UI에 프로필 선택기가 있는 것은 아닙니다.

연결 프로필과 설정 제한

프로필	필요한 자격 증명	공개 HTTPS
기본 장기 연결 (feishu.websocket.v1)	App ID, App Secret	불필요
웹훅 (feishu.webhook.v1)	App ID, App Secret, Verification Token, Encrypt Key	필요

현재 앱 콘솔은 플랫폼의 공식 개요를 참고하세요.

플랫폼 사전 요건

어느 프로필이든 다음이 필요합니다.

1. 앱을 만들고 봇 기능을 활성화합니다.
2. 필요한 봇 메시징 권한을 부여합니다.
3. 메시지 이벤트를 구독합니다.

플랫폼의 전달 방식을 기존 Anyy 프로필에 맞추세요. 표준 새 계정 설정은 장기 연결을 사용합니다.

연결

Dashboard → Channel → Add에서 Feishu / Lark를 선택해 기본 장기 연결을 구성합니다. App ID와 App Secret을 입력합니다. 다이렉트 메시지 기본값은 pairing, 그룹 기본값은 mention입니다.

대화형 터미널에서 anyy setup channel을 실행하고 Feishu를 선택해 CLI 정책 입력을 바꿉니다. 표준 CLI, TUI, Dashboard 설정은 현재 연결 프로필 선택기나 전환 동작을 제공하지 않습니다. 카탈로그의 전환 설명자를 실제 작동하는 마법사 명령으로 간주하지 마세요.

기존 웹훅 계정은 기존 프로필 아래에서 업데이트됩니다. CLI 양식에는 웹훅 자격 증명이 포함됩니다. Dashboard/TUI는 자신이 제공하는 앱 자격 증명만 업데이트합니다.

기존 웹훅 계정은 메시징 플랫폼의 공유 리스너와 HTTPS 프록시를 활성화하고 다음을 공개하세요.

/channels/feishu/ACCOUNT_ID/webhook

기본 계정 ID는 work입니다. Feishu/Lark와 Anyy에 동일한 Verification Token과 Encrypt Key를 구성하세요.

접근 정책

다이렉트 메시지는 pairing, open, allowlist, disabled를 지원합니다. 그룹은 mention, open, allowlist, disabled를 지원합니다. 이 정책 입력은 CLI 마법사에 있으며 Dashboard 자격 증명 양식에는 없습니다. 현재 설정에는 Feishu 허용 목록 항목 편집기가 없습니다. 해당 정책을 선택하기 전에 공통 설정 제한을 확인하세요.

anyy channel pairing list
anyy channel pairing approve --request REQUEST_ID

연결 확인

anyy channel doctor feishu
anyy channel reload

먼저 다이렉트 메시지를 테스트한 뒤 그룹 멘션을 테스트하세요.

문제 해결

문제	확인 사항
장기 연결이 활성 상태가 되지 않음	앱 자격 증명, 봇 기능, 이벤트 구독, 외부 네트워크
웹훅 검증 실패	공개 HTTPS 경로, Verification Token, Encrypt Key
이벤트는 도착하지만 메시지 무시	DM/그룹 정책, 페어링, 멘션 요건
응답이 권한 없음으로 실패	봇 메시징 권한과 앱 게시 상태
다른 연결 프로필이 필요함	현재 표준 설정에는 전환 선택기가 없습니다. 프로필 플래그나 작업을 추측하지 마세요