> For the complete documentation index, see [llms.txt](https://docs.crew.you/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.crew.you/ko/messenger-channels/telegram.md).

# Telegram

자신만의 개인 봇을 만들어 Crew를 Telegram에 연결하세요. 나만 사용할 수 있는 전용 AI 어시스턴트 봇이 됩니다.

## 설정 가이드

### 1단계: Telegram에서 봇 만들기

1. Telegram을 열고 **@BotFather**를 검색합니다
2. `/newbot` 명령어를 보냅니다
3. 안내에 따라 진행합니다:
   * 봇의 **이름**을 정하세요 (예: "내 Crew 어시스턴트")
   * `bot`으로 끝나는 **유저네임**을 정하세요 (예: `my_crew_assistant_bot`)
4. BotFather가 **API 토큰**을 알려줍니다 — 복사하세요 (`123456789:ABCdef...` 형식)

### 2단계: 봇을 Crew에 연결하기

1. Crew 웹 앱에서 **메신저**로 이동
2. Telegram 옆의 **연결** 클릭
3. **봇 토큰**을 입력 필드에 붙여넣기
4. **연결** 클릭

Crew가 토큰을 검증하고 웹훅을 자동으로 설정합니다.

### 3단계: 대화 시작

1. Telegram에서 설정한 봇을 찾습니다 (유저네임으로 검색)
2. **시작** 버튼을 누르거나 아무 메시지나 보냅니다
3. Telegram에서 Crew 어시스턴트 사용 준비 완료!

## 왜 개인 봇인가요?

다른 메신저는 Crew 공식 봇과 대화하지만, Telegram은 **개인 봇 방식**을 사용합니다:

* **나만의 봇**: 이름과 프로필 사진을 자유롭게 설정
* **완전한 프라이버시**: 나만 사용하는 전용 봇
* **고유 유저네임**: 여러 기기에서 봇 링크를 통해 접근 가능

## 활용 예시

> "오늘 안 읽은 이메일 요약해 줘."

> "이 내용으로 PDF 보고서 만들어 줘: \[내용]"

> "오늘 IT 업계 뉴스 Top 5 알려 줘."

> \[음성 메시지 전송] "내일 3시에 치과 전화해야 하는 거 리마인드해 줘."

## 기능

* **텍스트 메시지**: 서식 지원 풍부한 AI 응답
* **파일 공유**: 이미지, 문서, 오디오 파일 전송 및 수신
* **음성 메시지**: 음성 녹음 자동 텍스트 변환
* **입력 중 표시**: Crew가 요청을 처리하는 동안 표시됨
* **긴 메시지 분할**: Telegram 4,096자 제한 초과 시 자동으로 여러 메시지로 분할

## 문제 해결

### 봇이 응답하지 않나요?

* **시작** 버튼을 누르거나 `/start`를 보냈는지 확인하세요
* 메신저 페이지에서 연결 상태가 "Connected"인지 확인하세요
* 같은 토큰으로 연결 해제 후 재연결해 보세요

### 봇 토큰을 분실했나요?

* Telegram에서 @BotFather에 접속
* `/mybots` → 봇 선택 → **API Token**에서 확인

## 연결 해제

연결을 해제하려면:

1. Crew 웹 앱에서 **메신저**로 이동
2. Telegram 옆의 **연결 해제** 클릭

봇이 응답을 중단합니다. 언제든 같은 토큰이나 다른 봇 토큰으로 다시 연결할 수 있습니다.