Features 텔레그램 봇

Frigg · May 7, 2025

개요

텔레그램 알림 봇은 게임 캐릭터를 텔레그램 채팅에 연결하여 게임 내 이벤트 알림을 수신하고, 텔레그램에서 직접 캐릭터의 보안 설정을 관리할 수 있는 시스템입니다.

캐릭터 연결

시작하려면 게임 캐릭터를 텔레그램 계정에 연결해야 합니다:

[]게임 내에서 메뉴 → 텔레그램 봇으로 이동하세요. 창이 열리면 서버에서 고유한 일회용 토큰이 생성됩니다.
[]QR 코드를 스캔하거나 링크를 클릭하세요. 봇으로 이동됩니다.
[]봇에 확인 화면이 표시됩니다 — "연결하시겠습니까?" / "취소".
[]확인 후 캐릭터가 텔레그램 채팅에 연결됩니다.

주요 사항:

[]하나의 텔레그램 채팅에 서로 다른 서버의 여러 캐릭터를 연결할 수 있습니다.
[]처음 연결된 계정은 기본 계정으로 간주됩니다. 다른 텔레그램 계정이 동일한 캐릭터에 연결을 시도하면, 기본 계정으로 승인 요청이 전송됩니다.
내 캐릭터 → 프로필 → 연결 해제 또는 전체 연결 해제 메뉴를 통해 캐릭터 연결을 해제할 수 있습니다.

알림

연결이 완료되면 캐릭터와 관련된 이벤트 알림을 텔레그램 메시지로 받게 됩니다. 알림은 카테고리별로 구성됩니다:

캐릭터 카테고리

알림	설명
캐릭터 사망	캐릭터가 사망했을 때 알림이 전송됩니다. 다른 플레이어에게 처치된 경우 해당 플레이어의 이름과 클랜이 표시됩니다
접속 종료	캐릭터가 게임에서 접속 종료되었을 때 알림이 전송됩니다
인스턴스 시간 만료 임박	인스턴스 존 이용 시간이 곧 만료될 때 알림이 전송됩니다

월드 거래 카테고리

알림	설명
아이템 구매	캐릭터가 월드 거래에서 아이템을 구매했을 때 알림이 전송됩니다
아이템 판매	캐릭터의 아이템이 월드 거래에서 판매되었을 때 알림이 전송됩니다
캐릭터 판매	캐릭터가 월드 거래를 통해 판매되었을 때 알림이 전송됩니다

채팅 카테고리

알림	설명
개인 메시지	개인 메시지를 수신했을 때 알림이 전송됩니다
친구 메시지	친구로부터 메시지를 받았을 때 알림이 전송됩니다

알림 설정 관리: 텔레그램 봇에서 내 캐릭터 → 캐릭터 선택 → 알림으로 이동하세요. 각 카테고리 안에서 개별 알림을 활성화/비활성화할 수 있습니다. 기본적으로 모든 알림은 활성화되어 있습니다.

계정 단위 알림 (서버 알림)
캐릭터별 알림 외에도 특정 캐릭터에 종속되지 않는 서버 단위 알림이 있습니다:

알림	설명
서버 온라인	게임 서버가 시작되었을 때 알림이 전송됩니다
서버 오프라인	게임 서버가 종료되었을 때 알림이 전송됩니다
GM 공지	운영진의 전체 공지가 있을 때 알림이 전송됩니다
레이드 보스 등장	에픽 보스가 등장했을 때 알림이 전송됩니다

알림 설정 관리: 텔레그램 봇에서 계정 설정 → 서버 선택으로 이동하세요. 개별 알림을 활성화/비활성화할 수 있습니다. 기본적으로 모든 알림은 활성화되어 있습니다.

보안 설정

기본 계정에서만 사용할 수 있습니다 (처음 연결된 텔레그램 계정).

보안 설정을 사용하면 캐릭터를 비인가 행동으로부터 보호할 수 있습니다. 옵션이 활성화된 경우, 게임 내에서 해당 행동을 시도할 때마다 텔레그램으로 확인 요청이 전송되며, 응답하기 전까지 해당 행동은 차단됩니다.
보안 설정은 캐릭터가 온라인 상태일 때만 변경할 수 있습니다.
행동은 카테고리별로 구성됩니다:

월드 거래

[]캐릭터 판매
[]아이템 구매
[]아이템 판매
[]구매 주문 등록
[]판매 주문 등록

거래

[]거래
[]우편
[]멀티셀
[]아이템 구매
[]아이템 판매

아이템

[]아이템 드롭
[]아이템 삭제
[]강화
[]옵션 부여
[]소울 부여
[]축복
[]합성

상점

[]L-Store
[]특수 제작
[]프라임 상점

기타

[]DKP 설정 변경
[]채팅 (비인가 채팅 사용 방지)

확인 요청 방식

[]게임 내 캐릭터가 보호된 행동을 시도합니다 (예: 아이템 드롭).
[]해당 행동은 차단되며, 기본 텔레그램 계정으로 다음 메시지가 전송됩니다:

"캐릭터 이름이(가) 다음 행동을 시도하고 있습니다: 아이템 드롭. 승인하시겠습니까?"
사용 가능한 버튼:

승인 — 해당 행동이 허용됩니다 (현재 세션에서, 해당 행동에 한해)
거부 — 해당 행동이 거부됩니다
이번 세션 동안 모두 허용 — 다음 로그인 전까지 모든 보호 행동이 허용됩니다 (추가 확인 필요)
90초 이내에 응답이 없으면 요청이 만료되며, 해당 행동은 거부됩니다.

봇 메뉴

토큰 없이 /start를 입력하면 고정 메뉴가 표시됩니다:

버튼	설명
내 캐릭터	연결된 캐릭터 목록, 알림 및 보안 관리
계정 설정	서버 구독 관리 (서버 단위 알림)
언어	봇 인터페이스 언어 변경
도움말	도움말 정보

스팸 방지

시스템에는 내장된 rate limiter가 적용되어 있어, 대규모 게임 내 이벤트 중 스팸을 방지하기 위해 채팅당 분당 전송 가능한 알림 수가 제한됩니다.