Telegram

Anyy는 봇 토큰과 Bot API 롱 폴링 프로필로 Telegram에 연결합니다. 다이렉트 메시지, 그룹, 수신 미디어, 페어링, 실시간 상태 확인을 지원합니다.

1. Telegram 봇 만들기

Telegram에서 공식 BotFather 계정을 엽니다.

1. /newbot을 보냅니다.
2. 봇의 표시 이름과 사용자 이름을 정합니다.
3. 봇 토큰을 한 번 복사합니다.
4. 그룹에 봇을 추가할 경우 BotFather 개인정보/그룹 설정을 검토합니다.

토큰은 비밀번호처럼 취급하세요. 토큰을 가진 누구나 봇으로 행동할 수 있습니다.

2. Anyy에 계정 추가

Dashboard → Channel → Add → Telegram을 엽니다. Bot API 롱 폴링 항목에 계정 ID와 봇 토큰을 입력합니다. 정책 설정에는 아래 CLI 마법사를 사용하세요. Dashboard 자격 증명 양식에는 정책이 없습니다.

CLI 설정도 가능합니다.

anyy setup channel

마법사에서 Telegram을 선택합니다. 설정 흐름은 토큰을 프로필 비밀정보 참조로 저장하고 Telegram getMe로 원격 정체성을 검증한 후 어댑터를 정상 상태로 전환합니다.

3. 접근 정책 선택

기본 정책은 다음과 같습니다.

대화	기본값
다이렉트 메시지	pairing
그룹	mention

다이렉트 메시지 정책은 open, allowlist, pairing, disabled입니다. 현재 설정 카탈로그의 그룹 정책은 mention, allowlist, open, disabled입니다. 기존 허용 목록은 Telegram 숫자 사용자/채팅 식별자를 사용합니다. 현재 Telegram 설정에는 목록 항목 편집이 없습니다. 공통 설정 제한을 참조하세요.

페어링이나 허용 목록으로 시작하세요

개방된 봇은 예상치 못한 발신자에게 도구를 노출하고 공급자 할당량을 사용할 수 있습니다. 접근을 확대하기 전에 발신자 접근 정책과 활성 도구를 확인하세요.

4. 시작 및 확인

anyy channel reload
anyy channel doctor telegram

그런 다음 봇에 다이렉트 메시지를 보내세요. 기본 페어링 정책에서는 CLI에서 대기 발신자를 나열하고 승인합니다.

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

발신자 페어링 요청을 승인한 뒤 새 메시지를 보내 Anyy가 같은 Telegram 대화에 응답하는지 확인하세요.

그룹과 멘션

봇을 그룹에 추가하고 기본 mention 정책에서 @username을 사용하세요. Telegram 개인정보 설정 때문에 봇이 원하는 그룹 메시지를 받지 못하면 BotFather에서 조정하고 Telegram 요구에 따라 봇을 다시 추가하거나 로드하세요.

현재 어댑터는 Telegram 스레드 지원을 보장하지 않습니다. 주제별 라우팅에 의존하지 마세요.

미디어와 긴 응답

Anyy는 지원되는 Telegram 수신 미디어를 세션용으로 준비할 수 있습니다. 긴 발신 텍스트는 어댑터 텍스트 한도에 맞춰 분할됩니다. 미디어 다운로드와 메시지 크기는 어댑터 및 Telegram 제한을 따릅니다.

문제 해결

증상	확인 사항
토큰 거부	BotFather 토큰을 재발급/복사하여 저장된 자격 증명 교체
봇이 백오프 상태에 머묾	anyy channel doctor telegram 실행 후 getMe와 Bot API 네트워크 접근 확인
DM에 페어링 안내만 오고 답이 없음	대기 요청 승인 후 새 메시지 전송
그룹 메시지 무시	봇 멘션, 그룹 정책/허용 목록, BotFather 개인정보 모드 확인
중복/이전 메시지가 나타남	롱 폴링 상태를 확인하고 다시 로드. Anyy는 Telegram 업데이트 오프셋을 영속 저장함

공통 채널 제어는 메시징 플랫폼을 참조하세요.