콘텐츠로 이동

텔레그램 봇 등록 가이드

Quantiq에서 텔레그램 알림을 쓰기 위한 최소 절차를 안내합니다.

1. BotFather 시작

텔레그램에서 @BotFather를 열고 START를 누릅니다.

BotFather 시작

2. /newbot으로 봇 생성

BotFather 채팅에 /newbot을 입력합니다.

BotFather 명령 목록

봇 이름(bot name)과 아이디(username)를 순서대로 입력합니다.

봇 이름 입력

생성이 완료되면 BotFather가 bot token을 발급합니다.

토큰 발급 (마스킹 예시)

토큰 보안

bot token은 비밀번호와 같습니다. 유출되면 BotFather에서 /revoke로 즉시 재발급하세요.

3. chat_id 확인

  1. 방금 만든 봇 채팅창에서 /start 또는 임의 메시지 1개를 보냅니다.
  2. 아래 URL을 브라우저에서 호출합니다.
https://api.telegram.org/bot<발급받은_토큰>/getUpdates
  1. 응답 JSON의 result[].message.chat.id 값을 확인합니다.

getUpdates에서 chat_id 확인

예시:

{
  "message": {
    "chat": {
      "id": 8653402565,
      "type": "private"
    }
  }
}

chat.id 값(예: 8653402565)이 Chat ID입니다. 이 숫자만 복사하면 됩니다.

4. Quantiq 설정에서 등록 (간소화)

설정 > Telegram 알림에서 다음 순서로 등록합니다.

  1. Bot Token 입력
  2. Chat ID 자동 찾기 클릭
  3. 후보가 1개면 자동 입력, 여러 개면 원하는 chat_id 선택
  4. Owner User ID / Owner Chat ID 확인
  5. Chat ID: 봇과 대화 중인 채팅방 고유번호입니다.
  6. Owner User ID: 명령을 허용할 사용자(본인)의 텔레그램 고유번호입니다. 보안 강화를 위해 설정을 권장합니다.
  7. 자동 조회 후보에 user_id가 있으면 함께 자동으로 채워집니다.
  8. Owner Chat ID를 비우면 Chat ID 값을 대신 사용합니다.
  9. 저장 클릭
  10. 테스트 클릭 후 ✅ Quantiq 연결 테스트 성공 메시지 확인

자동 조회가 실패하면 Chat ID를 직접 입력해도 됩니다. 실패하는 주요 원인은 봇에게 아직 메시지를 보내지 않은 경우(3단계에서 /start 전송 확인)입니다.

보안 권장

Quantiq는 Owner User ID + Owner Chat ID가 모두 일치하는 텔레그램 요청만 처리합니다. 불일치 요청은 사용자에게 별도 응답을 보내지 않고 무시되며 감사 로그에 기록됩니다.

5. 문제 해결

  • getUpdates 결과가 빈 배열("result": [])인 경우:
  • 봇 채팅에 /start를 다시 보낸 뒤 재시도
  • 404/401 오류인 경우:
  • URL 형식 확인: https://api.telegram.org/bot<토큰>/getUpdates
  • 토큰 오탈자 확인
  • 메시지가 안 오는 경우:
  • Quantiq 설정에서 알림 활성화가 켜져 있는지 확인
  • 테스트 버튼으로 먼저 단건 확인

6. 지원 명령어

텔레그램에서는 슬래시 명령(/status)과 한글 명령(현황)을 모두 사용할 수 있습니다.

목적 권장 입력 동의어
현재 상태 확인 현황 상태, /status
전략 목록 조회 전략 전략목록, /strategies
종목 목록 조회 심볼 종목, 종목목록, /symbols
보유 포지션 조회 포지션 보유, /positions
최근 주문 조회 주문 체결, /orders
전략 중단 전략중단 정지, 중지, 중단, /stop_strategy
특정 종목 중단 종목중단 /stop_symbol
긴급 중단(hard pause) 긴급중단 긴급정지, 킬스위치, /kill
도움말 도움 /help

매수/매도 직접 명령은 미지원

텔레그램 봇은 운영 제어/조회 중심입니다. 직접 매수/매도 주문은 앱(또는 HTS/MTS)에서 수행하세요.

다음 단계

텔레그램 연동이 완료됐다면 전략을 활성화하고 모의투자를 시작할 수 있습니다.