Telegram 연동

## 이 연동으로 되는 것 - **알림 수신** — 모닝 브리핑 · 능동 알림 · 예산 경보 - **AI 비서와 대화** — 텔레그램에서 바로 질문하고 답 받기 접속하지 않아도 데이터를 확인할 수 있어, **가장 먼저 붙이길 권하는 알림 채널**입니다. ## 사전 준비물 | 항목 | 어디서 | |---|---| | 텔레그램 계정 | | | **Bot Token** | BotFather 에서 봇 생성 | | **Chat ID** | 수신자(본인) 계정 ID | 준비물이 적고 심사가 없어 5분이면 끝납니다. ## 발급 절차 ### 1. 봇 만들기 (한 번만) 1. 텔레그램에서 [@BotFather](https://t.me/BotFather) 를 검색해 대화 시작 2. `/newbot` 명령 전송 3. 봇 이름과 사용자명을 입력 (사용자명은 `_bot` 으로 끝나야 합니다) 4. **Bot Token** 이 발급됩니다 → 복사 ### 2. 봇에게 `/start` 보내기 — 빠뜨리기 쉬움 만든 봇을 검색해 대화를 열고 **`/start`** 를 전송합니다. > ⚠️ **이 단계를 건너뛰면 알림이 오지 않습니다.** > 텔레그램은 사용자가 먼저 대화를 시작하지 않은 상대에게 봇이 메시지를 보내는 것을 막습니다. ### 3. Chat ID 확인 > ⚠️ Chat ID 는 **봇의 ID 가 아니라 수신자(본인) 계정의 ID** 입니다. > Bot Token 앞부분 숫자와 혼동하기 쉽습니다. 두 가지 방법 중 편한 것을 쓰세요. **방법 A — userinfobot (간단)** [@userinfobot](https://t.me/userinfobot) 에 `/start` 를 보내면 본인 ID 를 즉시 알려줍니다. **방법 B — API 직접 확인** 브라우저에서 아래 주소를 엽니다. `<TOKEN>` 부분을 발급받은 Bot Token 으로 바꿉니다. ``` https://api.telegram.org/bot<TOKEN>/getUpdates ``` 응답에서 `"chat":{"id": ... }` 의 숫자가 Chat ID 입니다. 응답이 비어 있으면 2단계(`/start`)를 아직 안 한 것입니다. ## 모닝인사이트에 입력 1. **설정 → 알림** 탭 2. **메신저 AI 비서 연동 → Telegram** 카드 클릭 3. Bot Token · Chat ID 입력 4. **저장** 5. **테스트 메시지** 를 눌러 수신되는지 확인 ## 알림 켜기 연동만으로는 알림이 오지 않습니다. **어떤 알림을 받을지** 선택해야 합니다. **설정 → 알림** 탭에서: 1. 받을 알림 종류를 켭니다 (데일리 브리핑 · 주간 리포트 등) 2. 채널로 **Telegram** 을 선택합니다 3. **지금 즉시 실행** 으로 실제 발송을 확인합니다 능동 알림은 별도로 **설정 → AI Agent → 능동 알림** 에서 채널을 선택합니다 → [능동 알림 설정](/news/guide/proactive-alerts) ## 텔레그램에서 질문하기 봇 대화창에 질문을 보내면 AI 비서가 답합니다. > "오늘 매출 얼마야?" > "이번 주 광고비 알려줘" 웹에 접속하지 않고 이동 중에 확인할 때 유용합니다. ## 팀 그룹으로 받기 개인이 아니라 팀 채팅방으로 받고 싶으면: 1. 그룹을 만들고 봇을 **멤버로 초대** 2. 그룹에서 봇에게 메시지를 한 번 보냅니다 3. `getUpdates` 로 확인하면 **그룹의 Chat ID** 가 나옵니다 (보통 **음수**) 4. 그 값을 Chat ID 로 입력 ## 자주 나는 오류 | 증상 | 원인 | 대응 | |---|---|---| | 테스트 메시지가 안 온다 | 봇에게 **`/start` 미전송** | 봇 대화창에서 `/start` | | 테스트 메시지가 안 온다 | Chat ID 에 봇 ID 를 입력 | 수신자 계정 ID 로 교체 | | `getUpdates` 응답이 비어 있다 | 봇과 대화를 시작하지 않음 | `/start` 후 다시 확인 | | 인증 실패 | Bot Token 에 공백 포함 | 다시 붙여넣기 | | 갑자기 안 온다 | 봇을 차단·삭제했음 | 차단 해제 후 `/start` | | 그룹에서 안 온다 | 그룹 Chat ID 가 아님 | 음수 형태의 그룹 ID 사용 | | 연동은 됐는데 알림이 없다 | 알림 종류를 안 켰음 | 설정 → 알림에서 켜기 | ## 보안 주의 - **Bot Token 은 비밀입니다.** 노출되면 누구나 그 봇으로 메시지를 보낼 수 있습니다 - 토큰이 유출됐다면 BotFather 에서 `/revoke` 로 재발급하세요 - 회사 정보를 받는 채널이므로 **개인 계정 관리에 주의**하세요 ## 관련 문서 - [모닝 브리핑 받기](/news/guide/morning-briefing) - [능동 알림 설정](/news/guide/proactive-alerts) - [Slack 연동](/news/guide/slack) · [Microsoft Teams 연동](/news/guide/teams) · [KakaoTalk 연동](/news/guide/kakao)