Telegram 봇 버튼으로 자주 쓰는 Hermes 작업을 실행하기
2026.06.07

소개
텔레그램에서 매번 자연어를 입력하기보다는 버튼을 클릭하면 에이전트 작업을 실행할 수 있도록 구현
현재까지 구현된 메뉴는 다음과 같습니다.
오늘할일
포트폴리오 트래킹
새로운 동영상 확인하기
지수확인하기
**Hermes Telegram 버튼형 운영 패널**
- Telegram inline keyboard로 `오늘할일 / 포트폴리오 트래킹 / 새로운 동영상확인하기 / 지수확인하기` 실행
- callback 이벤트를 Hermes 사용자 요청으로 변환해 기존 agent 실행 파이프라인 재사용
- bot 메시지 callback에서 실제 클릭 사용자를 식별하도록 attribution 문제 해결
진행 방법
어떤 도구를 사용했고, 어떻게 활용하셨나요?
Tip: 사용한 프롬프트 전문을 꼭 포함하고, 내용을 짧게 소개해 주세요.
Tip: 활용 이미지나 캡처 화면을 꼭 남겨주세요.
Tip: 코드 전문은 코드블록에 감싸서 작성해주세요. ( / 을 눌러 '코드 블록'을 선택)
Hermes Agent 에서 다음과 같이 프롬프트를 입력하였음
텔레그램 메시지에서 버튼을 누르면 해당 작업이 실행되도록 하면 좋겠어.
"1.오늘할일", "2.포트폴리오 트래킹", "3.새로운 동영상확인하기", "4.지수확인하기"
```그러자 에르메스가 버튼별 callback 을 설계하여 그에 맞는 파일을 수정 및 생성하였고 /action_buttons 라는 quick command 도 등록하였음 .
**Hermes 작업:**
- Telegram inline keyboard 버튼으로 자주 쓰는 Hermes 작업을 실행하는 구조를 구현했습니다.
- 버튼별 callback을 `qa:` prefix로 설계했습니다.
- `qa:today` - 오늘 할 일 정리
- `qa:portfolio` - 포트폴리오 트래킹
- `qa:youtube` - 새 YouTube 영상 확인
- `qa:index` - 주요 지수 확인
- `지수확인하기`는 사용자 선호에 맞춰 KOSPI, KOSDAQ, USD/KRW 환율을 맨 위에 배치하고, 미국 30년물·한국 10년물/30년물 금리까지 포함하도록 프롬프트를 보강했습니다.
- 생성/수정된 주요 파일:
- `/Users/cavinon/.hermes/hermes-agent/gateway/platforms/telegram.py` - Telegram callback 처리 확장
- `/Users/cavinon/.hermes/scripts/send_telegram_action_buttons.py` - 버튼 메뉴 발송 스크립트
- `/Users/cavinon/.hermes/config.yaml` - `/action_buttons` quick command 등록결과와 배운 점
/action_buttons 커맨드를 실행 후 버튼을 클릭하였으나 응답이 되지 않은 문제 발생
=> 에르메스가 gateway 로그를 확인하여 에러메시지를 확인하여 원인을 자동으로 파악했음.
문제는 버튼을 클릭시에 callback 이벤트 발생시 클릭 주체를 사용자가 아닌 bot 이 한 것으로 인식하여 이를 사용자로 재바인딩하도록 수정 후 gateway 자동 재시작 후 정상 작동됨을 확인
## 작업 22. Telegram 버튼 무응답 문제 해결 (2026-06-06)
```
버튼을 눌렀는데 답이 없는데
```
**Hermes 작업:**
- gateway 로그를 확인해 버튼 클릭 이벤트가 `Unauthorized user: lalala-hermes`로 거부되는 문제를 발견했습니다.
- 원인: 버튼 메시지는 bot이 보낸 메시지라, callback을 일반 메시지로 변환할 때 사용자 주체가 실제 클릭한 사람이 아니라 bot으로 잡혔습니다.
- 해결: callback 이벤트 생성 시 `query.from_user`를 실제 사용자로 재바인딩하도록 수정했습니다.
- 수정 후 문법 검사, gateway 재시작, 새 버튼 메시지 발송까지 검증했습니다.
- 생성/수정된 주요 파일:
- `/Users/cavinon/.hermes/hermes-agent/gateway/platforms/telegram.py` - quick-action callback 사용자 attribution 수정그외 한투증권 API 연결하여 퇴직연금 DC 계좌도 포트폴리오 트래킹에 추가하려 함.
이유 :
한투증권앱의 UI 가 상당히 불편 (메뉴 찾기 힘듦 )
투자종목의 실시간 수익현황이 대쉬보드에 나타나지 않음 .
결론 : DC 계좌는 서비스이용이 불가함을 확인 함. 😢
## 작업 20. 한국투자증권 OpenAPI 퇴직연금 계좌 지원 범위 확인 (2026-06-03) ``` 한국투자증권 OpenAPI로 퇴직연금 계좌도 연결 가능한지 확인해줘. ``` **Hermes 작업:** - 한국투자 OpenAPI 포털과 FAQ를 확인해 계좌 유형별 지원 범위를 정리했습니다. - 확인 결과: - 연금저축 계좌(22): 주문, 계좌조회, 시세조회 가능 - IRP 계좌(29): 계좌조회, 시세조회 가능 / 주문 불가 - DC가입자 계좌(55): OpenAPI 신청 및 서비스 이용 불가 - 포트폴리오 자동화에서 퇴직연금 계좌를 다룰 때, 계좌별로 가능한 기능을 분리해야 한다는 운영 기준을 세웠습니다.
추후 시도 :
현재는 구글시트에 보유종목을 읽어서 포트폴리오 트래킹을 하고 있으나 이용하고 있는 증권사의 API 를 연결하여 웹상에서 대쉬보드 구현해볼 예정.
도움 받은 글 (옵션)
참고한 지피터스 글이나 외부 사례를 알려주세요.
DD님의 지난주 발표 (ETF 트레이딩 MVP제작기)에서 텔레그램봇에서 버튼으로 구현이 가능함을 확인하여 시도하였습니다.
로그인하고 댓글을 남겨 주세요



대시보드 기대됩니다^^