텔레그램 봇 API 10.0~10.5 변경 사항: 봇 설정, 위젯, 리치 메시지, 임시 메시지, 게스트 모드
텔레그램 봇 API 10.5는 2026년 11월 22일에 공개된 현재 버전으로, 메서드는 194개입니다. 2026년 5월 8일 Bot API 10.0으로 시작한 10.x 시리즈는 게스트 모드, 라이브 포토, 스트리밍 초안을 지원하는 리치 메시지, 임시(ephemeral) 메시지, 커뮤니티, 가입 요청 쿼리, 메시지 속 인터랙티브 HTML 위젯(10.4)을 차례로 추가했고, 10.5에서는 setMySettings 메서드와 getMe가 반환하는 새 객체 BotFullInfo가 등장했습니다. 아래에서 릴리스별 새 기능을 짧은 JSON 예제와 함께 정리하고, 기존 봇을 깨뜨릴 수 있는 변경 사항도 짚어 봅니다.
텔레그램 봇 API 10 한눈에 보기
| 버전 | 날짜 | 주요 내용 |
|---|---|---|
| 10.0 | 2026년 5월 8일 | 게스트 모드, 라이브 포토, 투표 속 미디어, 반응 삭제 |
| 10.1 | 2026년 6월 11일 | 리치 메시지와 리치 초안, 가입 요청 쿼리 |
| 10.2 | 2026년 7월 14일 | 임시 메시지, 커뮤니티, subscription 업데이트, 미니앱 출처 보호 |
| 10.3 | 2026년 8월 24일 | EphemeralMessageParameters, 중지 가능한 초안, DisabledButton, 리치 메시지 속 버튼 |
| 10.4 | 2026년 11월 9일 | HTML 위젯, 모든 채팅에서 콜백 쿼리에 임시 답장, 리치 메시지 인용, TON 지갑 카드, 채팅 공유 테마 |
| 10.5 | 2026년 11월 22일 | setMySettings, getMe의 BotFullInfo, callback_query_mode, 봇 초대 링크, 펼침 인용의 블록 |
Bot API 10.0: 게스트 모드, 라이브 포토, 투표
게스트 모드. @BotFather 미니앱에서 Guest Mode를 켜면 사용자가 봇이 멤버로 있지 않은 채팅에서도 봇을 멘션할 수 있습니다. 봇은 guest_message 업데이트를 받고, 메시지의 guest_query_id와 InlineQueryResult를 넘겨 answerGuestQuery로 한 번 답할 수 있습니다.
{
"guest_query_id": "<message.guest_query_id>",
"result": {
"type": "article",
"id": "1",
"title": "번역",
"input_message_content": {"message_text": "Bonjour tout le monde"}
}
}
게스트 봇은 채팅 기록이나 멤버 목록에 접근할 수 없고, 다시 멘션되거나 답장을 받지 않는 한 이후 메시지도 보지 못합니다.
- 반응과 관리자:
deleteMessageReaction은 그룹에서 반응 하나를 삭제하고,deleteAllMessageReactions는 특정 사용자나 채팅이 남긴 최근 반응을 최대 10000개까지 삭제합니다.getChatAdministrators에return_bots가 추가되었습니다. - 투표: 투표, 선택지, 퀴즈 해설에 미디어를 넣을 수 있고(
media,explanation_media),members_only와country_codes가 추가되었습니다. 최소 선택지 수는 2개에서 1개로 줄었습니다. - 라이브 포토:
sendLivePhoto는 짧은 동영상이 붙은 사진을 보냅니다. 라이브 포토는sendMediaGroup,editMessageMedia, 유료 미디어에서도 쓸 수 있습니다. - 기타:
getManagedBotAccessSettings와setManagedBotAccessSettings,getUserPersonalChatMessages, 두 봇이 모두 허용한 경우 사용자명으로 주고받는 봇 간 메시지, "Thinking..." 플레이스홀더를 띄우기 위한sendMessageDraft의 빈text가 추가되었습니다.
Bot API 10.1: 텔레그램 리치 메시지와 가입 요청 쿼리
리치 메시지는 보고서, 문서, AI 답변처럼 구조화된 출력을 위한 기능입니다. sendRichMessage는 html 또는 markdown으로 내용을 담은 rich_message 객체를 받습니다(10.2에서 명시적인 blocks와 media 목록이 추가됨). 제목, 목록과 체크리스트, 표, 인용, 접을 수 있는 상세 블록, 각주, LaTeX 수식, 지도, 콜라주, 슬라이드쇼, 미디어 블록을 지원합니다. 제한은 UTF-8 32768자, 블록 500개, 중첩 16단계, 미디어 50개, 표 열 20개입니다.
curl -X POST "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/sendRichMessage" \
-H "Content-Type: application/json" \
-d '{
"chat_id": 123456789,
"rich_message": {
"markdown": "# 주간 보고서\n\n| 지표 | 값 |\n|:-------|------:|\n| 사용자 | **1204** |\n| 오류 | 3 |\n\n- [x] v2.1 배포\n- [ ] 문서 업데이트\n\n$$E = mc^2$$"
}
}'
sendRichMessageDraft는 생성 중인 리치 메시지를 개인 채팅에 스트리밍합니다. 초안은 30초짜리 임시 미리보기이므로 마지막에는 sendRichMessage로 마무리해야 합니다. editMessageText도 이제 rich_message를 받습니다.
가입 요청 쿼리. 봇이 채팅의 가드 봇으로 설정되어 있으면 chat_join_request 업데이트에 query_id가 담깁니다. answerChatJoinRequestQuery로 즉시 결정하거나(approve, decline, 다른 관리자에게 결정을 넘기는 queue), 먼저 sendChatJoinRequestWebApp으로 미니앱을 보여 줄 수 있습니다. 미니앱은 init data에서 chat_join_request_query_id를 받습니다.
{"chat_join_request_query_id": "<chat_join_request.query_id>", "result": "approve"}
10.1에서는 투표에 링크 미디어도 추가되었습니다.
Bot API 10.2: 텔레그램 임시 메시지, 커뮤니티, 미니앱 보안
임시 메시지는 그룹에서 한 사용자와 봇만 볼 수 있는 메시지로, 힌트, 환영 문구, 개인 결과를 공용 타임라인에 노출하지 않을 수 있습니다. 사용자도 다른 사람에게 보이지 않는 임시 명령어(BotCommand.is_ephemeral)를 보낼 수 있습니다. 전달 규칙은 다음과 같습니다.
- 어떤 봇이든 해당 동작으로부터 15초 이내에 임시 메시지로 답할 수 있습니다. 대상 동작은 콜백 쿼리(그 id 사용) 또는 들어온 임시 메시지(
reply_parameters.ephemeral_message_id사용)입니다. - 채팅 관리자인 봇은 봇이 아닌 멤버에게 언제든 임시 메시지를 보낼 수 있습니다.
- 특히 사용자가 오프라인이면 전달이 보장되지 않습니다.
임시 메시지에는 전용 메서드가 있습니다. editEphemeralMessageText, editEphemeralMessageMedia, editEphemeralMessageCaption, editEphemeralMessageReplyMarkup, 그리고 deleteEphemeralMessage입니다.
{"chat_id": -1001234567890, "receiver_user_id": 123456789, "ephemeral_message_id": 15}
- 커뮤니티: 공통 주제로 묶인 슈퍼그룹, 채널, 봇의 모음입니다.
Community타입,community_chat_added와community_chat_removed서비스 메시지,ChatFullInfo.community가 추가되었습니다. - 구독: 새
subscription업데이트가 사용자의 결제 구독 변경을 알려 줍니다. - 미니앱 출처 보호: 미니앱 도메인과 다른 출처에서 미니앱 메서드를 호출하면 차단됩니다. 2026년 7월 20일 모든 미니앱에 적용되었고 @BotFather에서 해제할 수 있습니다. 실제로 어떤 영향이 있는지는 텔레그램 미니앱 테스트 가이드를 참고하십시오.
Bot API 10.3: EphemeralMessageParameters, 중지 가능한 초안, DisabledButton
임시 메시지의 호환성이 깨지는 변경. 10.2의 receiver_user_id와 callback_query_id 파라미터가 13개 전송 메서드(sendMessage, sendPhoto, sendVideo, sendAnimation, sendAudio, sendDocument, sendLivePhoto, sendSticker, sendVideoNote, sendVoice, sendContact, sendLocation, sendVenue)에서 하나의 객체 ephemeral_message_parameters로 대체되었습니다. sendRichMessage도 이를 받으며, 새로 추가된 replace_callback_query_message를 쓰면 버튼이 눌린 메시지 자리에 임시 메시지가 표시됩니다.
{
"chat_id": -1001234567890,
"text": "이 메시지는 회원님에게만 보입니다.",
"ephemeral_message_parameters": {
"receiver_user_id": 123456789,
"callback_query_id": "<callback_query.id>",
"replace_callback_query_message": true
}
}
중지 가능한 초안. sendMessageDraft나 sendRichMessageDraft에 can_stop을 넘기면 중지 버튼이 표시됩니다. 사용자가 누르면 봇은 chat과 draft_id가 담긴 stopped_message_generation 업데이트를 받으므로 모델 생성을 취소할 수 있습니다. keep_on_stop은 중간까지 생성된 초안을 잠시 화면에 남겨 두며, 계속 남겨야 한다면 일반 메시지로 보내십시오.
import time
import requests
API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours"
text, last = "", 0.0
for chunk in generate_reply(): # LLM 토큰 스트림
text += chunk
if time.monotonic() - last > 0.5: # 토큰마다 초안을 보내지 않음
requests.post(f"{API}/sendMessageDraft", json={"chat_id": 123456789,
"draft_id": 1, "text": text, "can_stop": True}, timeout=10)
last = time.monotonic()
requests.post(f"{API}/sendMessage", json={"chat_id": 123456789, "text": text}, timeout=10)const API = "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours";
const post = (method, body) => fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(body),
signal: AbortSignal.timeout(10_000),
});
let text = "", last = 0;
for await (const chunk of generateReply()) { // LLM 토큰 스트림
text += chunk;
if (Date.now() - last > 500) { // 토큰마다 초안을 보내지 않음
await post("sendMessageDraft", { chat_id: 123456789,
draft_id: 1, text, can_stop: true });
last = Date.now();
}
}
await post("sendMessage", { chat_id: 123456789, text });- 비활성 버튼:
InlineKeyboardButton의 새disabled필드는DisabledButton객체를 받습니다. 예를 들어{"text": "품절", "disabled": {}}처럼 쓰면 눌러도 아무 동작을 하지 않습니다.InlineKeyboardMarkup과ReplyKeyboardMarkup에도force_reply가 추가되었습니다. - 리치 메시지: 메시지 안의 버튼(
<tg-button>,<tg-button-row>), 컴팩트 표, 펼침 인용, 문서 블록이 추가되었습니다. - 관리자:
ChatAdministratorRights와promoteChatMember에can_send_welcome_messages권한이 추가되었습니다. - 임시 메시지 수정:
editEphemeralMessageMedia에서 새 파일 업로드,editEphemeralMessageCaption의show_caption_above_media,editEphemeralMessageText의rich_message를 지원합니다.
Bot API 10.4: 텔레그램 위젯, 모든 채팅에서 임시 답장, TON 지갑
위젯. 이제 봇이 메시지 안에 작은 인터랙티브 HTML 블록을 보낼 수 있습니다. 위젯은 앱이 네트워크 없는 샌드박스에서 실행하는 HTML 문서 하나(최대 32768바이트, zlib 압축 후 4096바이트)와, 봇만 바꿀 수 있는 상태로 이루어집니다. 상태는 메시지 하나에 속하는 chat_data와 위젯이 표시되는 모든 곳에서 공유되는 public_data입니다. 새 메서드는 sendWidget, sendSharedWidget, answerWidgetQuery, editMessageWidgetData, editSharedWidgetData이고, 새 업데이트는 widget_query와 shared_widget_query입니다. 인라인 모드에는 InputWidgetMessageContent와 InputSharedWidgetMessageContent가 추가되었습니다(현재는 테스트 서버 전용).
{
"chat_id": 123456789,
"html": "<h3>주문 #1042</h3><p>마르게리타 2개, 레모네이드 1개</p><p><strong>합계: $23.50</strong></p>",
"caption": "주문 #1042: $23.50"
}
운영 환경에서 위젯은 현재 개인 채팅에서만 동작하고 보호된 콘텐츠로 전송되므로 전달할 수 없습니다. 그룹, 인라인 모드, 전달은 테스트 서버에서 동작합니다. 위젯 메시지는 copyMessage / copyMessages로 복사할 수 없으며, can_send_other_messages 권한이 이제 위젯도 포함합니다. 자세한 내용은 텔레그램 위젯 완벽 정리를 참고하십시오.
모든 채팅에서 콜백 쿼리에 임시 답장(채널 DM 채팅 제외). ephemeral_message_parameters에 receiver_user_id 없이 callback_query_id만 넘기면 버튼을 누른 사용자에게만 메시지가 표시됩니다. receiver_user_id와 전송 메서드의 chat_id 파라미터는 이제 선택 사항입니다. answerCallbackQuery는 여전히 호출해야 합니다.
{
"text": "이 답변은 회원님에게만 보입니다.",
"ephemeral_message_parameters": {"callback_query_id": "<callback_query.id>"}
}
- 리치 메시지 인용:
TextQuote.rich_texts와ReplyParameters.quote_rich_texts. - TON 지갑:
TonWalletCard와ChatFullInfo.ton_wallet_card,ton_wallet_transfer서비스 메시지가 추가되었고,StoryAreaPosition은AreaPosition으로 이름이 바뀌었습니다. - 채팅 공유 테마:
ChatFullInfo.share_theme와 새 메서드getChatShareThemeBackdrops. - 선물:
getUniqueGift는 이름으로 고유 선물을 반환하고,deleteBusinessAccountGift는 관리 중인 비즈니스 계정의 일반 선물을 Stars를 받지 않고 삭제합니다. - 엔티티와 인증: 새
MessageEntity타입ton_address와bank_card_number,verifyUser와verifyChat의custom_description_parse_mode,custom_description_entities. - 기타:
paid_messages_waived서비스 메시지, Premium 사용자는 소유한 봇 최대 2개에 agent, ai, app, game, gay로 끝나는 보조 사용자명을 붙일 수 있음, 봇과의 개인 채팅 토픽 링크https://t.me/<bot_username>/<message_thread_id>.
Bot API 10.5: setMySettings, BotFullInfo, 봇 초대 링크
코드로 봇 설정 변경. 새 메서드 setMySettings는 지금까지 @BotFather에서만 바꿀 수 있던 설정을 변경합니다. 모든 파라미터가 선택 사항이므로 바꾸려는 것만 넘기면 되고, True를 반환합니다.
- 인라인 모드:
supports_inline_queries,inline_query_placeholder,needs_inline_query_location,inline_feedback_share_denominator(선택된 인라인 결과를 1, 10, 100, 1000건 중 1건씩 수신, 0이면 끔). - 그룹과 프라이버시:
can_join_groups와can_read_all_group_messages(true면 프라이버시 모드 해제). - 기능:
can_connect_to_business,can_manage_bots,supports_guest_queries,supports_join_request_queries, 봇 간 통신을 위한can_communicate_with_bots. - 개인 채팅의 토픽:
has_topics_enabled,allows_users_to_create_topics,has_topic_sidebar. - 콜백 쿼리:
callback_query_mode는 봇이 보낸 메시지의 버튼에서 오는 콜백 쿼리를 어떻게 받을지 정합니다."default"는 항상message필드를 쓰고,"auto"는 봇이 메시지에 접근할 수 없을 때 대신inline_message_id를 쓰며,"inline"은 항상message대신inline_message_id를 씁니다.
{
"supports_inline_queries": true,
"inline_query_placeholder": "레시피 검색...",
"can_join_groups": false,
"has_topics_enabled": true,
"callback_query_mode": "auto"
}
이 JSON을 https://api.telegram.org/bot<token>/setMySettings로 보내거나 Bot API Tester에서 내 토큰으로 실행한 뒤, getMe를 호출해 결과를 확인하십시오.
BotFullInfo(호환성이 깨지는 변경). getMe는 이제 User 대신 새 객체 BotFullInfo를 반환하며, 원래 getMe에서만 반환되던 필드는 User에서 제거되었습니다. BotFullInfo에는 active_usernames, inline_query_placeholder, needs_inline_query_location, has_topic_sidebar도 추가되었습니다. getMe 결과에서 can_join_groups, can_read_all_group_messages, supports_inline_queries 같은 필드를 읽는 코드는 이 필드들이 BotFullInfo에 있으므로 그대로 동작합니다. 깨지는 것은 이 필드를 다른 User 객체에서 기대하는 코드와, getMe 결과 타입을 User로 선언한 타입 기반 코드입니다.
- 봇 초대 링크: 봇 소유자는
https://t.me/botinvite/<bot_username>으로 최대 10명을 한 번에 봇과의 개인 채팅에 초대할 수 있고, 이후 봇은 초대된 사용자에게 메시지를 보낼 수 있습니다.WriteAccessAllowed에inviter필드가 추가되었습니다. - 펼침 인용(호환성이 깨지는 변경):
RichBlockExpandableBlockQuotation과InputRichBlockExpandableBlockQuotation의text필드가blocks로 바뀌어, 이제 펼침 인용 안에 어떤 리치 블록이든 넣을 수 있습니다.
봇을 Bot API 10.5로 업그레이드하는 방법
- 사용하는 라이브러리(python-telegram-bot, aiogram, grammY, Telegraf 등)를 변경 로그에 Bot API 10.5 지원이 명시된 버전으로 업데이트합니다.
- 10.2 방식의
receiver_user_id와callback_query_id를ephemeral_message_parameters안으로 옮깁니다. allowed_updates목록을 명시적으로 넘긴다면 처리하는 새 타입을 추가합니다:guest_message,subscription,stopped_message_generation,widget_query,shared_widget_query.- 투표 검증을 완화합니다. 이제 선택지 하나도 허용됩니다.
- 미니앱이라면 모든
Telegram.WebApp호출이 등록된 도메인에서 실행되는지 확인합니다. - 코드에서 타입 이름으로 참조한다면
StoryAreaPosition을AreaPosition으로 바꿉니다. getMe결과를BotFullInfo로 다루고,can_join_groups같은 getMe 전용 필드를 다른User객체에서 읽지 않도록 합니다.- 리치 메시지의 펼침 인용은
text대신blocks로 만듭니다. callback_query_mode를"auto"나"inline"으로 바꾼다면,message가 없을 때inline_message_id를 처리하도록 콜백 핸들러를 수정합니다.- Bot API Tester에서 내 토큰으로 새 메서드를 시험해 봅니다: setMySettings, sendWidget, sendRichMessage, deleteEphemeralMessage, answerChatJoinRequestQuery.
임시 메시지와 일반 메시지는 기본이 같으므로 텔레그램 봇 API 메시지 보내기로 기초를 다시 확인해 두면 좋고, 텔레그램 봇 API 제한에는 기존 제한과 함께 리치 메시지 제한도 정리되어 있습니다. 전체 이력은 공식 Bot API changelog에서 확인할 수 있습니다.
자주 묻는 질문
텔레그램 봇 API의 최신 버전은 무엇인가요?
2026년 11월 22일에 나온 Bot API 10.5이며 메서드는 194개입니다. 2026년 5월 8일 Bot API 10.0으로 시작한 10.x 시리즈의 여섯 번째 릴리스로, 봇이 자기 설정을 바꾸는 setMySettings가 추가되었고 getMe가 BotFullInfo를 반환하게 되었습니다. 직전 버전인 10.4(2026년 11월 9일)에서는 메시지 속 HTML 위젯이 추가되었습니다.
텔레그램 리치 메시지란 무엇인가요?
리치 메시지(Bot API 10.1)는 sendRichMessage로 보내는 구조화된 메시지로, 제목, 목록, 표, LaTeX 수식, 미디어 블록, 지도, 그리고 10.3부터는 버튼까지 담을 수 있습니다. 내용은 rich_message에 HTML, Markdown 또는 블록으로 넘기며 UTF-8 기준 최대 32768자입니다.
텔레그램 봇의 임시(ephemeral) 메시지란 무엇인가요?
임시 메시지(Bot API 10.2)는 그룹이나 슈퍼그룹에서 특정 사용자 한 명과 봇만 볼 수 있는 메시지입니다. 10.3부터는 sendMessage 등 전송 메서드의 ephemeral_message_parameters로 보내고, 10.4부터는 채널 DM 채팅을 제외한 모든 채팅에서 콜백 쿼리에 임시 메시지로 답할 수 있습니다. 특히 사용자가 오프라인이면 전달이 보장되지 않습니다.
텔레그램 봇에서 AI 답변을 스트리밍하려면 어떻게 하나요?
개인 채팅에서 같은 draft_id로 sendMessageDraft 또는 sendRichMessageDraft를 반복 호출한 뒤, 최종 텍스트는 sendMessage나 sendRichMessage로 보냅니다. 초안은 30초짜리 임시 미리보기일 뿐이기 때문입니다. can_stop을 넘기면 사용자에게 중지 버튼이 표시되고 봇은 stopped_message_generation을 받습니다.
Bot API 10.5의 setMySettings는 무엇인가요?
setMySettings는 봇이 @BotFather 없이 자기 설정을 바꾸는 메서드입니다. 인라인 모드, 프라이버시 모드, 그룹 참여, 비즈니스 연결, 게스트·가입 요청 쿼리, 개인 채팅의 토픽, 봇 간 통신, callback_query_mode를 다룹니다. 바꿀 필드만 넘기면 되고 True를 반환합니다. 현재 값은 이제 BotFullInfo를 반환하는 getMe로 확인합니다.
Bot API 10.0의 게스트 모드는 무엇인가요?
게스트 모드는 봇이 멤버가 아닌 채팅에서 멘션되었을 때 답할 수 있게 하는 기능입니다. 봇은 guest_message 업데이트를 받아 answerGuestQuery로 한 번 답하며, 채팅 기록에는 접근할 수 없습니다. @BotFather 미니앱에서 켭니다.
관련 가이드
텔레그램 봇 만들기: @BotFather로 생성하고 첫 메시지 보내기
텔레그램 봇 만들기 가이드입니다. @BotFather의 /newbot으로 봇을 생성하고 토큰을 getMe로 확인한 뒤, getUpdates와 sendMessage로 첫 메시지를 보내는 과정을 curl과 Python 예제로 설명합니다.
텔레그램 봇 배포와 호스팅: VPS, Docker, 서버리스
텔레그램 봇 배포 방법: 폴링과 웹훅 선택, VPS의 systemd 서비스, Docker, secret_token을 검증하는 Cloudflare Workers, 출시 전 체크리스트까지 정리했습니다.
텔레그램 봇 API 오류 총정리: 오류별 의미와 해결 방법
텔레그램 봇 API 오류를 코드별로 정리했습니다. 400 chat not found, 403 bot was blocked by the user, 409 Conflict, 429 retry_after의 원인과 해결, 처리 코드까지 다룹니다.
텔레그램 봇 API 제한 총정리: 전송 속도, 429 오류, 파일 크기, 메시지 길이
텔레그램 봇 API 전송 제한을 정리했습니다. 초당 30건, 채팅당 초당 1건, 그룹 분당 20건 기준과 429 retry_after 처리, 파일 크기·메시지 길이 제한까지 다룹니다.
텔레그램 봇 명령어 가이드: setMyCommands, 명령어 스코프, /start 딥링크
텔레그램 봇 명령어 설정 방법: @BotFather /setcommands, 스코프·언어별 setMyCommands, /start 딥링크 파라미터, 그룹의 /cmd@bot 처리를 예제로 설명합니다.
텔레그램 봇 키보드: 인라인 키보드, 콜백 버튼, 리플라이 키보드
텔레그램 봇 버튼 만드는 법을 정리했습니다. callback_data 인라인 키보드, answerCallbackQuery, 버튼을 누른 뒤 메시지 수정, 리플라이 키보드와 ForceReply까지 다룹니다.
n8n 텔레그램 연동 가이드: 봇 연결, 워크플로 트리거, 메시지 보내기
n8n 텔레그램 연동 방법: 봇 토큰을 Access Token으로 등록하고, 공개 HTTPS로 Telegram Trigger 웹훅을 받고, chat id로 메시지를 보내며 자주 나는 오류를 해결합니다.
텔레그램 봇 API로 메시지 보내기: sendMessage 사용법과 예제
텔레그램 봇 API 메시지 보내기 가이드입니다. sendMessage를 curl·Python·JavaScript로 호출하는 예제, HTML·MarkdownV2 서식, 인라인 버튼, 그룹·채널 전송, 400·403·429 오류 해결법을 정리했습니다.
텔레그램 봇 토큰: 발급부터 확인, 폐기, 안전한 보관까지
텔레그램 봇 토큰을 @BotFather에서 발급받는 법, 기존 봇의 토큰 찾기, getMe로 유효성 확인, 유출 시 폐기 방법을 정리했습니다. n8n·AI 비서 연동에 필요한 bot token과 chat id도 안내합니다.
텔레그램 웹훅 설정 가이드: setWebhook, secret_token, getWebhookInfo
텔레그램 봇 웹훅 설정 방법을 단계별로 정리했습니다. setWebhook 파라미터, secret_token 헤더 검증 코드, getWebhookInfo 상태 확인, deleteWebhook으로 되돌리기, 409·HTTPS 오류 해결까지 다룹니다.
텔레그램 chat id 확인방법: 개인, 그룹, 채널, 토픽별 chat id 찾기
텔레그램 chat id 확인방법을 개인 채팅, 그룹, 슈퍼그룹, 채널, 포럼 토픽별로 정리했습니다. getUpdates로 chat id를 찾는 법, -100으로 시작하는 ID의 의미, 결과가 비어 있을 때 해결법까지 설명합니다.
텔레그램 인라인 봇 가이드: 인라인 모드 활성화와 인라인 쿼리 응답
텔레그램 인라인 봇 만드는 법: @BotFather나 setMySettings로 인라인 모드를 켜고 inline_query에 answerInlineQuery로 답하는 과정을 Python·JS 예제로 설명합니다.
텔레그램 스타 결제 봇 가이드: 인보이스, 결제 전 확인, 환불, 구독
텔레그램 봇에서 스타(Stars) 결제 받는 법: XTR sendInvoice, pre_checkout_query, successful_payment, 환불, 구독까지 Python·JS 코드로 설명합니다.
텔레그램 테스트 서버: 텔레그램 봇 테스트 환경에서 봇을 테스트하는 방법
텔레그램 테스트 서버 사용법을 정리했습니다. 테스트 환경 로그인, 테스트용 봇 만들기, /test/ 주소로 Bot API 호출하기, Bot API Tester의 TEST 스위치까지 다룹니다.
텔레그램 웹사이트 위젯: 로그인 위젯, 게시물 임베드, 댓글, 공유 버튼
웹사이트에 텔레그램을 붙이는 방법을 정리했습니다. 새 Telegram Login(OIDC), 기존 로그인 위젯과 hash 검증 코드, 게시물 임베드, 댓글, 공유 버튼까지 다룹니다.
TelegramWidget JavaScript API: 텔레그램 위젯 API 레퍼런스와 오류 코드, 제한
텔레그램 위젯의 TelegramWidget JavaScript API를 정리했습니다. 속성, request(), 이벤트, 오류 코드, CSS 변수, widget_query와 answerWidgetQuery, 모든 제한값까지 담았습니다.
텔레그램 위젯 예제: HTML과 Python 봇 코드 전체 공개
바로 실행할 수 있는 텔레그램 위젯 예제 모음입니다. 정적 주문 카드, widget_query 카운터, 실시간 공유 투표, 브라우저 미리보기까지 HTML과 Python 코드로 설명합니다.
텔레그램 위젯 가이드: 봇 메시지 안에서 동작하는 HTML 위젯
Bot API 10.4에 추가된 텔레그램 위젯의 개념, sendWidget 사용법, chat_data와 public_data, 현재 사용 가능한 범위와 Mini App과의 차이를 정리했습니다.
텔레그램 미니앱 테스트 가이드: 브라우저 목 모드부터 실제 텔레그램까지
텔레그램 미니앱 테스트 방법을 단계별로 정리했습니다. 브라우저 목(mock) 모드, HTTPS 터널로 localhost 열기, 테스트 환경, 플랫폼별 DevTools, initData 검증까지 다룹니다.