텔레그램 봇 명령어 가이드: setMyCommands, 명령어 스코프, /start 딥링크
텔레그램 봇 명령어는 /start, /help처럼 /로 시작하는 키워드로, 텔레그램 앱이 메시지 안에서 강조 표시하고 사용자가 /를 입력하면 추천 목록으로, 봇 메뉴에서는 목록으로 보여 줍니다. 명령어 목록은 @BotFather의 /setcommands나 setMyCommands 메서드로 설정하며, 메서드를 쓰면 스코프(그룹, 관리자, 특정 채팅별로 다른 명령어)와 언어별 목록도 지정할 수 있습니다. 봇은 명령어를 일반 텍스트 메시지로 받고, /start에는 딥링크 파라미터를 실을 수 있습니다. 이 글에서는 curl, Python, JavaScript 예제로 이 내용을 모두 다룹니다.
텔레그램 봇 명령어의 동작 방식
명령어는 텍스트가 /로 시작하는 메시지일 뿐입니다. 명령어를 등록해도 봇이 받는 내용은 달라지지 않고, 텔레그램 앱에 무엇을 추천할지 알려 주는 역할만 합니다. setMyCommands로 등록하는 목록(BotCommand 객체)의 규칙은 다음과 같습니다.
command: 1~32자, 영문 소문자, 숫자, 밑줄만 허용되며 앞의 슬래시는 빼고 씁니다.description: 1~256자, 추천 목록에서 명령어 옆에 표시됩니다.- 목록당 최대 100개.
텔레그램은 모든 봇이 전역 명령어 /start(대화 시작, 딥링크 파라미터도 이 명령어로 받음)와 /help(봇의 기능과 명령어 목록)를 지원하고, 설정이 있는 봇이라면 /settings도 지원하도록 권장합니다. 추가 인자가 필요한 포괄적인 /new보다는 /newlocation처럼 구체적인 명령어가 좋습니다.
@BotFather로 명령어 설정하기
코드 없이 설정하는 방법으로, 목록이 고정되어 있을 때 적합합니다.
- @BotFather를 열고
/setcommands를 보냅니다. - 봇을 선택합니다.
command - description형식으로 한 줄에 하나씩 목록을 보냅니다.
start - 봇 시작
help - 사용 방법
settings - 내 설정
아직 봇이 없다면 텔레그램 봇 만들기부터 진행하십시오.
setMyCommands로 명령어 설정하기
setMyCommands는 같은 작업을 코드로 처리하므로 명령어 목록을 저장소에서 관리하고 배포할 때마다 갱신할 수 있습니다. 파라미터는 commands(필수, BotCommand 배열), scope(선택, 기본값은 default 스코프), language_code(선택, ISO 639-1 두 글자 코드)이며, 성공하면 true를 반환합니다.
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setMyCommands" \
-H "Content-Type: application/json" \
-d '{"commands":[{"command":"start","description":"봇 시작"},{"command":"help","description":"사용 방법"}]}'
코드 없이 시험해 보려면 Bot API Tester의 setMyCommands를 열어 토큰을 붙여 넣고 명령어를 채운 뒤 Execute를 누르십시오. 이어서 getMyCommands를 호출하면 저장된 목록을 확인할 수 있습니다.
명령어 스코프와 언어
스코프는 누가 그 목록을 볼지 결정합니다. BotCommandScope 유형은 7가지입니다.
스코프 type | 목록을 보는 대상 | 추가 필드 |
|---|---|---|
default | 더 좁은 목록이 없을 때 모든 사용자 | — |
all_private_chats | 봇과의 모든 개인 채팅 | — |
all_group_chats | 모든 그룹과 슈퍼그룹 | — |
all_chat_administrators | 모든 그룹과 슈퍼그룹의 관리자 | — |
chat | 특정 채팅 하나 | chat_id |
chat_administrators | 특정 그룹 또는 슈퍼그룹의 관리자 | chat_id |
chat_member | 특정 그룹 또는 슈퍼그룹의 특정 멤버 | chat_id, user_id |
chat_id는 숫자 ID 또는 슈퍼그룹의 @username이며, 채널과 채널 다이렉트 메시지 채팅은 지원하지 않습니다. 스코프마다 언어별 목록도 둘 수 있습니다. language_code를 지정하면 앱 언어가 그 언어인 사용자에게, 지정하지 않으면 전용 언어 목록이 없는 해당 스코프의 모든 사용자에게 표시됩니다.
텔레그램은 가장 좁은 스코프부터 차례로 확인해 처음 설정된 목록을 보여 줍니다. 개인 채팅에서는 chat → all_private_chats → default 순서이고, 그룹에서는 chat_member → chat_administrators → chat → all_chat_administrators → all_group_chats → default 순서입니다(관리자 스코프는 관리자에게만 적용). 각 단계에서 사용자의 language_code에 맞는 목록이 언어 미지정 목록보다 우선합니다.
다음 스크립트는 기본 목록, 영어 번역, 그룹 관리자용 추가 명령어를 설정한 뒤 하나를 다시 읽어 옵니다.
import os
import requests
TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"
def call(method, **params):
data = requests.post(f"{API}/{method}", json=params, timeout=10).json()
if not data["ok"]:
raise RuntimeError(f"{method}: {data['error_code']} {data['description']}")
return data["result"]
# 모든 사용자에게 보이는 기본 목록
call("setMyCommands", commands=[
{"command": "start", "description": "봇 시작"},
{"command": "help", "description": "사용 방법"},
{"command": "settings", "description": "내 설정"},
])
# 텔레그램 앱 언어가 영어인 사용자용 같은 명령어
call("setMyCommands", language_code="en", commands=[
{"command": "start", "description": "Start the bot"},
{"command": "help", "description": "How to use the bot"},
{"command": "settings", "description": "Your settings"},
])
# 모든 그룹 관리자용 추가 명령어
call("setMyCommands", scope={"type": "all_chat_administrators"}, commands=[
{"command": "help", "description": "사용 방법"},
{"command": "stats", "description": "그룹 통계"},
])
print(call("getMyCommands", scope={"type": "all_chat_administrators"}))const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;
async function call(method, params = {}) {
const res = await fetch(`${API}/${method}`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify(params),
});
const data = await res.json();
if (!data.ok) throw new Error(`${method}: ${data.error_code} ${data.description}`);
return data.result;
}
// 모든 사용자에게 보이는 기본 목록
await call("setMyCommands", {
commands: [
{ command: "start", description: "봇 시작" },
{ command: "help", description: "사용 방법" },
{ command: "settings", description: "내 설정" },
],
});
// 텔레그램 앱 언어가 영어인 사용자용 같은 명령어
await call("setMyCommands", {
language_code: "en",
commands: [
{ command: "start", description: "Start the bot" },
{ command: "help", description: "How to use the bot" },
{ command: "settings", description: "Your settings" },
],
});
// 모든 그룹 관리자용 추가 명령어
await call("setMyCommands", {
scope: { type: "all_chat_administrators" },
commands: [
{ command: "help", description: "사용 방법" },
{ command: "stats", description: "그룹 통계" },
],
});
console.log(await call("getMyCommands", { scope: { type: "all_chat_administrators" } }));스코프는 사용자에게 보이는 것만 제어합니다. 업데이트에는 명령어가 어느 스코프에서 왔는지 표시되지 않고, 사용자는 등록하지 않은 명령어를 포함해 어떤 명령어든 직접 입력할 수 있습니다. 서버에서 항상 명령어가 존재하는지, 그 사용자가 실행할 권한이 있는지 확인하십시오(예: getChatMember로 관리자 권한 확인).
getMyCommands와 deleteMyCommands
getMyCommands는 지정한 scope와 language_code의 BotCommand 배열을 반환하며, 설정된 목록이 없으면 빈 배열을 돌려줍니다. deleteMyCommands는 해당 스코프와 언어의 목록을 삭제하고, 영향을 받는 사용자에게는 조회 순서상 다음 목록이 표시됩니다.
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/deleteMyCommands" \
-H "Content-Type: application/json" \
-d '{"scope":{"type":"all_chat_administrators"}}'
명령어와 /start 파라미터 처리
명령어는 입력한 텍스트 그대로 일반 message 업데이트로 들어옵니다. 그룹에서는 /command@your_bot처럼 특정 봇을 지정할 수 있으므로 @username 부분을 떼어 내고 다른 봇을 향한 명령어는 무시해야 합니다. 딥링크는 다음과 같이 동작합니다.
https://t.me/your_bot?start=airplane은 봇과의 채팅을 열고, 봇은/start airplane을 받습니다.https://t.me/your_bot?startgroup=spaceship은 봇을 추가할 그룹을 고르게 하고, 봇은/start@your_bot spaceship을 받습니다.- 파라미터는 최대 64자이며
A-Z,a-z,0-9,_,-만 허용됩니다. 바이너리나 그 밖의 데이터는 base64url 인코딩을 텔레그램이 권장합니다.
다음은 명령어를 파싱하고, 파라미터가 있는 /start와 없는 /start를 구분해 처리하며, base64url 딥링크를 만드는 롱 폴링 봇입니다.
import base64
import os
import re
import requests
TOKEN = os.environ["BOT_TOKEN"]
API = f"https://api.telegram.org/bot{TOKEN}"
BOT_USERNAME = requests.get(f"{API}/getMe", timeout=10).json()["result"]["username"]
COMMAND_RE = re.compile(r"^/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(?:\s+(.*))?$", re.S)
def make_start_link(payload: str) -> str:
# "=" 패딩을 뺀 base64url: A-Z a-z 0-9 _ -만 남음(최대 64자)
code = base64.urlsafe_b64encode(payload.encode()).decode().rstrip("=")
return f"https://t.me/{BOT_USERNAME}?start={code}"
def read_start_param(code: str) -> str:
return base64.urlsafe_b64decode(code + "=" * (-len(code) % 4)).decode()
def parse_command(text):
m = COMMAND_RE.match(text)
if not m or (m[2] and m[2].lower() != BOT_USERNAME.lower()):
return None # 명령어가 아니거나 다른 봇을 향한 명령어
return m[1].lower(), (m[3] or "").strip()
def send(chat_id, text):
requests.post(f"{API}/sendMessage", json={"chat_id": chat_id, "text": text}, timeout=10)
print("공유할 링크:", make_start_link("ref:42"))
offset = 0
while True:
resp = requests.get(f"{API}/getUpdates", params={"offset": offset, "timeout": 30}, timeout=40).json()
for update in resp["result"]:
offset = update["update_id"] + 1
msg = update.get("message")
parsed = parse_command(msg.get("text", "")) if msg else None
if not parsed:
continue
name, args = parsed
chat_id = msg["chat"]["id"]
if name == "start" and args:
try:
send(chat_id, "환영합니다! 유입 경로: " + read_start_param(args))
except ValueError:
send(chat_id, "환영합니다! 알 수 없는 시작 파라미터입니다.")
elif name == "start":
send(chat_id, "환영합니다! /help를 보내면 제가 할 수 있는 일을 알려 드립니다.")
elif name == "help":
send(chat_id, "/start - 봇 시작\n/help - 이 도움말\n/settings - 내 설정")
elif name == "settings":
send(chat_id, "아직 설정 항목이 없습니다.")const TOKEN = process.env.BOT_TOKEN;
const API = `https://api.telegram.org/bot${TOKEN}`;
const BOT_USERNAME = (await (await fetch(`${API}/getMe`)).json()).result.username;
const COMMAND_RE = /^\/([A-Za-z0-9_]+)(?:@([A-Za-z0-9_]+))?(?:\s+([\s\S]*))?$/;
function makeStartLink(payload) {
// Node의 base64url에는 "=" 패딩이 없음: A-Z a-z 0-9 _ -만 남음(최대 64자)
const code = Buffer.from(payload).toString("base64url");
return `https://t.me/${BOT_USERNAME}?start=${code}`;
}
function readStartParam(code) {
return Buffer.from(code, "base64url").toString("utf8");
}
function parseCommand(text) {
const m = COMMAND_RE.exec(text);
if (!m || (m[2] && m[2].toLowerCase() !== BOT_USERNAME.toLowerCase())) {
return null; // 명령어가 아니거나 다른 봇을 향한 명령어
}
return { name: m[1].toLowerCase(), args: (m[3] ?? "").trim() };
}
async function send(chatId, text) {
await fetch(`${API}/sendMessage`, {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({ chat_id: chatId, text }),
});
}
console.log("공유할 링크:", makeStartLink("ref:42"));
let offset = 0;
while (true) {
const resp = await (await fetch(`${API}/getUpdates?offset=${offset}&timeout=30`)).json();
for (const update of resp.result) {
offset = update.update_id + 1;
const msg = update.message;
const parsed = msg ? parseCommand(msg.text ?? "") : null;
if (!parsed) continue;
const { name, args } = parsed;
const chatId = msg.chat.id;
if (name === "start" && args) {
await send(chatId, "환영합니다! 유입 경로: " + readStartParam(args));
} else if (name === "start") {
await send(chatId, "환영합니다! /help를 보내면 제가 할 수 있는 일을 알려 드립니다.");
} else if (name === "help") {
await send(chatId, "/start - 봇 시작\n/help - 이 도움말\n/settings - 내 설정");
} else if (name === "settings") {
await send(chatId, "아직 설정 항목이 없습니다.");
}
}
}JavaScript 버전은 최상위 await를 쓰므로 bot.mjs로 저장해 Node.js 18 이상에서 실행합니다. 시작 파라미터는 신뢰할 수 없는 입력으로 다루십시오. 누구나 링크를 만들 수 있으므로, 그 자체로 접근 권한을 주는 비밀 값을 넣어서는 안 됩니다. 웹훅이 설정된 동안에는 getUpdates가 동작하지 않습니다. 운영 환경 설정은 텔레그램 봇 웹훅 설정을 참고하십시오.
그룹의 명령어와 프라이버시 모드
그룹에 있는 봇은 기본적으로 프라이버시 모드로 동작합니다. 이때 봇은 자신을 명시한 명령어(/command@your_bot), 그 그룹에 마지막으로 메시지를 보낸 봇일 때만 /start 같은 일반 명령어, 자신의 메시지에 대한 답장, 서비스 메시지를 받습니다. 한 그룹에 봇이 여럿 있다면 사용자에게 목록에서 명령어를 눌러 입력하도록 안내하십시오. 그러면 @your_bot 부분이 자동으로 붙습니다. 모든 메시지를 받으려면 봇을 관리자로 지정하거나 @BotFather의 /setprivacy로 프라이버시 모드를 끕니다.
메뉴 버튼
개인 채팅에서 입력창 옆의 메뉴 버튼은 기본적으로 명령어 목록을 엽니다. setChatMenuButton으로 이 버튼이 Mini App을 열도록 바꾸거나 다시 명령어 목록으로 되돌릴 수 있으며, chat_id를 생략하면 모든 채팅의 기본값이 바뀝니다.
curl "https://api.telegram.org/bot123456789:AAEexampleTokenReplaceWithYours/setChatMenuButton" \
-H "Content-Type: application/json" \
-d '{"menu_button":{"type":"commands"}}'
다른 유형으로는 web_app(text, web_app 포함)과 default가 있습니다. Bot API 10.2부터는 BotCommand에 is_ephemeral: true를 지정할 수도 있습니다. 이런 명령어는 그룹에서 보내도 다른 멤버와 봇에게 보이지 않고 해당 봇만 받습니다.
봇 명령어 설계 팁
- 목록은 짧게. 사용자가 실제로 필요한 명령어만 등록하고, 드물게 쓰는 관리 기능은 관리자 전용 스코프로 옮깁니다.
- 설명은 동작 중심으로. "리마인더"보다 "리마인더 만들기"가 더 많은 정보를 줍니다.
- 배포할 때 명령어 설정. 배포 스크립트에서
setMyCommands를 호출하면 메뉴와 처리 코드가 항상 일치합니다. - 모르는 명령어에도 친절하게. 개인 채팅에서는 예를 들어
/help를 안내합니다. - 선택지는 버튼으로. 여러 단계로 이어지는 흐름에서는 인자가 붙는 명령어보다 인라인 키보드가 쓰기 편한 경우가 많습니다.
문제 해결
| 증상 | 예상 원인 | 해결 |
|---|---|---|
BOT_COMMAND_INVALID와 함께 400 | command에 대문자, 하이픈, 맨 앞 /가 있거나 32자 초과 | 슬래시 없이 영문 소문자, 숫자, 밑줄 1~32자로 작성 |
| 명령어를 설정했는데 사용자에게 다른 목록이 보임 | 더 좁은 스코프나 사용자 언어용 목록이 우선 적용됨 | getMyCommands로 스코프와 언어별 목록을 하나씩 확인 |
그룹에서 봇이 /start를 무시함 | 프라이버시 모드이고 마지막으로 메시지를 보낸 봇이 다른 봇임 | /start@your_bot을 보내거나 프라이버시 모드 변경 |
| 시작 파라미터가 전달되지 않음 | A-Z a-z 0-9 _ - 이외의 문자(예: = 패딩)가 있거나 64자 초과 | base64url로 인코딩하고 패딩을 제거하거나 페이로드를 줄임 |
401 Unauthorized | 잘못되었거나 폐기된 토큰 | 텔레그램 봇 토큰 가이드 참고 |
자주 묻는 질문
텔레그램 봇에 명령어를 추가하려면 어떻게 하나요?
@BotFather에 /setcommands를 보내고 봇을 고르거나, Bot API 메서드 setMyCommands에 BotCommand 객체 목록을 넘겨 호출합니다. 그러면 사용자가 /를 입력할 때 텔레그램 앱이 명령어를 추천하고 메뉴에도 표시합니다.
텔레그램 봇 명령어에는 어떤 문자를 쓸 수 있나요?
setMyCommands에서 명령어는 1~32자이며 영문 소문자, 숫자, 밑줄만 쓸 수 있습니다. 설명은 1~256자입니다. 스코프와 언어 조합당 최대 100개까지 등록할 수 있습니다.
/start에 파라미터를 넘기려면 어떻게 하나요?
https://t.me/your_bot?start=airplane 같은 딥링크를 씁니다. 봇은 /start airplane 메시지를 받습니다. 파라미터는 최대 64자이고 A-Z, a-z, 0-9, _, -만 허용되므로 다른 데이터는 base64url로 인코딩하십시오.
그룹에서 봇이 명령어를 인식하지 못하는 이유는 무엇인가요?
프라이버시 모드가 켜져 있으면(기본값) 그룹의 봇은 /command@your_bot처럼 자신을 지정한 명령어만 받고, /start 같은 일반 명령어는 그 그룹에 마지막으로 메시지를 보낸 봇일 때만 받습니다. @your_bot 형식을 쓰거나, 봇을 관리자로 지정하거나, /setprivacy로 프라이버시 모드를 끄십시오.
그룹 관리자에게만 다른 명령어를 보여 줄 수 있나요?
모든 그룹이라면 scope를 {"type": "all_chat_administrators"}로, 특정 그룹이라면 {"type": "chat_administrators", "chat_id": ...}로 지정해 setMyCommands를 호출합니다. 업데이트에는 어느 스코프의 명령어인지 표시되지 않으므로 서버에서 권한을 따로 확인해야 합니다.
봇의 명령어를 모두 지우려면 어떻게 하나요?
등록한 스코프와 language_code 조합마다 deleteMyCommands를 호출합니다. 삭제하면 사용자에게는 조회 순서상 다음 목록(예: 기본 명령어)이 표시됩니다.
관련 가이드
텔레그램 봇 만들기: @BotFather로 생성하고 첫 메시지 보내기
텔레그램 봇 만들기 가이드입니다. @BotFather의 /newbot으로 봇을 생성하고 토큰을 getMe로 확인한 뒤, getUpdates와 sendMessage로 첫 메시지를 보내는 과정을 curl과 Python 예제로 설명합니다.
텔레그램 봇 배포와 호스팅: VPS, Docker, 서버리스
텔레그램 봇 배포 방법: 폴링과 웹훅 선택, VPS의 systemd 서비스, Docker, secret_token을 검증하는 Cloudflare Workers, 출시 전 체크리스트까지 정리했습니다.
텔레그램 봇 API 10.0~10.5 변경 사항: 봇 설정, 위젯, 리치 메시지, 임시 메시지, 게스트 모드
텔레그램 봇 API 10.0~10.5의 새 기능을 정리했습니다. setMySettings와 BotFullInfo, HTML 위젯, 리치·임시 메시지, 게스트 모드를 JSON 예제와 함께 설명합니다.
텔레그램 봇 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 처리, 파일 크기·메시지 길이 제한까지 다룹니다.
텔레그램 봇 키보드: 인라인 키보드, 콜백 버튼, 리플라이 키보드
텔레그램 봇 버튼 만드는 법을 정리했습니다. 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 검증까지 다룹니다.