grammY 통합 (텔레그램 봇 API)
왜 grammY인가?
- 장기 폴링 + 웹훅 도우미, 미들웨어, 오류 처리, 속도 제한기가 내장된 TS 최초 Bot API 클라이언트입니다.
- 수동으로 가져오기 + FormData를 수행하는 것보다 더 깔끔한 미디어 도우미; 모든 Bot API 메서드를 지원합니다.
- 확장 가능: 사용자 정의 가져오기, 세션 미들웨어(선택 사항), 유형 안전 컨텍스트를 통한 프록시 지원.
우리가 배송한 것
- 단일 클라이언트 경로: 가져오기 기반 구현이 제거되었습니다. grammY는 이제 기본적으로 grammY 스로틀러가 활성화된 유일한 텔레그램 클라이언트(전송 + 게이트웨이)입니다.
- 게이트웨이:
monitorTelegramProvider는 GrammYBot를 구축하고 멘션/허용 목록 게이팅을 연결하고getFile/download를 통해 미디어를 다운로드하고sendMessage/sendPhoto/sendVideo/sendAudio/sendDocument로 응답을 전달합니다.webhookCallback를 통해 장기 폴링 또는 웹훅을 지원합니다. - 프록시: 선택적
channels.telegram.proxy는 grammY의client.baseFetch를 통해undici.ProxyAgent를 사용합니다. - 웹훅 지원:
webhook-set.ts는setWebhook/deleteWebhook를 래핑합니다.webhook.ts상태 + 정상적인 종료로 콜백을 호스팅합니다. 게이트웨이는channels.telegram.webhookUrl+channels.telegram.webhookSecret가 설정된 경우 웹후크 모드를 활성화합니다(그렇지 않으면 롱 폴링). - 세션: 직접 채팅은 에이전트 기본 세션(
agent:<agentId>:<mainKey>)으로 축소됩니다. 그룹은agent:<agentId>:telegram:group:<chatId>를 사용합니다. 응답은 동일한 채널로 다시 라우팅됩니다. - 구성 손잡이:
channels.telegram.botToken,channels.telegram.dmPolicy,channels.telegram.groups(허용 목록 + 기본값 언급),channels.telegram.allowFrom,channels.telegram.groupAllowFrom,channels.telegram.groupPolicy,channels.telegram.mediaMaxMb,channels.telegram.linkPreview,channels.telegram.proxy,channels.telegram.webhookSecret,channels.telegram.webhookUrl. - 초안 스트리밍: 선택 사항
channels.telegram.streamMode은 비공개 주제 채팅에서sendMessageDraft를 사용합니다(Bot API 9.3+). 이는 채널 블록 스트리밍과 별개입니다. - 테스트: 그래미 모의 커버 DM + 그룹 언급 게이팅 및 아웃바운드 전송; 더 많은 미디어/웹훅 설비를 환영합니다.
공개 질문
- Bot API 429에 도달하는 경우 선택적인 grammY 플러그인(스로틀러).
- 더 많은 구조화된 미디어 테스트(스티커, 음성 메모)를 추가합니다.
- 웹후크 청취 포트를 구성 가능하게 만듭니다(현재 게이트웨이를 통해 연결하지 않는 한 8787로 고정됨).