2nd/10_Wiki/Topics/Backend/telegram_notify.md

📨 텔레그램 보고

다른 도구가 보고를 메신저로 보낼 때 호출하는 통신선이에요. 이 도구를 직접 [▶ 실행]하면 연결 테스트 메시지를 보냅니다 — 받으면 OK, 안 오면 토큰/chat_id 다시 확인.

어떻게 도와주나요?

• ✅ 연결 확인용 핑 (아무 인자 없이 실행)
• 📨 다른 도구(내 영상 체크, 경쟁 채널 분석 등)가 자동 보고를 보내는 채널
• 🔕 토큰이나 chat_id가 비어있으면 다른 도구들은 그냥 텔레그램 단계만 건너뜁니다

봇 만드는 법 (한 번만)

1. 텔레그램에서 @BotFather 검색 → /newbot → 이름·핸들 정하면 123:ABC... 형식 토큰을 줍니다
2. 새로 만든 봇한테 아무 메시지나 한 번 보내기 (/start 권장)
3. 브라우저에서 https://api.telegram.org/bot<TOKEN>/getUpdates 열어서 chat.id 확인
4. [[youtube_account|youtube_account]].json의 TELEGRAM_BOT_TOKEN / TELEGRAM_CHAT_ID에 입력
5. 이 도구 [▶ 실행] → 핑 메시지 받으면 끝

다른 도구에서 어떻게 쓰이나?

• "내 영상 체크" → 떡상/부진 요약을 자동 푸시
• "경쟁 채널 분석" → 다음 액션 브리프 자동 푸시
• 향후 트렌드 스나이퍼/오토 플래너 결과도 같은 라인을 통해 보냅니다