# 텔레그램 인라인 키보드 빌더 | JSON 없이 reply_markup

> JSON 없이 Telegram 봇의 인라인 버튼을 만드세요. 시각적 행과 열, Bot API의 네 가지 유형, callback_data 바이트 카운터, cURL, aiogram, grammY용 코드. 무료, 계정 불필요.

- **출처 (source):** https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215/f/telegram-bot-inline-keyboard-builder
- **플랫폼 (platform):** AiToolsForApps
- **언어 (language):** ko

## 요약

- JSON을 쓰지 않고 Telegram 봇의 인라인 키보드 만들기
- 메시지 말풍선 위에서 직접 탭해 행과 버튼을 추가하고, Bot API의 네 가지 유형 중에서 고른 뒤 검증된 reply_markup을 복사하세요. 무료, 브라우저에서 실행, 계정 불필요.
- 보이는 곳에서 편집해요. 버튼은 별도 폼이 아니라 메시지 목업에서 바로 탭해서 편집해요. 행 추가, 행에 버튼 추가, 수정, 삭제가 가능하고 너무 많이 바꿨을 때를 위한 실행 취소도 있어요.
- Bot API의 네 가지 유형과 각각의 규칙
- callback_data의 실제 바이트 카운터

## JSON을 쓰지 않고 Telegram 봇의 인라인 키보드 만들기

Telegram 인라인 키보드 빌더는 앱의 봇 탭이에요. 왼쪽에서 메시지를 쓰고, 아래에서 키보드를 만들며, 위에서는 구독자에게 도착할 모습 그대로의 Telegram 말풍선을 볼 수 있어요. 별도의 폼도, JSON 배열이 담긴 텍스트 상자도 없어요. 행을 추가하고, 그 행에 버튼을 추가하고, 목업을 탭해서 각 버튼을 편집해요. 보이는 것이 곧 직렬화될 내용이에요.

각 버튼에는 텍스트(최대 64자)와 Bot API가 지원하는 네 가지 유형 중 하나가 있어요. 링크(url), 콜백(callback_data), 미니 앱(web_app), 인라인 검색(switch_inline_query)이에요. 유형에 따라 검증이 달라져요. 링크는 https://, http:// 또는 tg://로 시작해야 하고, 미니 앱은 HTTPS가 필요하며, callback_data에는 문자 수가 아닌 실제 바이트 카운터가 있어요. Telegram의 64 한도는 UTF-8 바이트로 측정되고 이모지 하나가 한 번에 4바이트를 차지하기 때문이에요.

무엇이든 건네 주기 전에 키보드는 스키마 검증기를 거쳐요. 검증기는 「오류가 있어요」가 아니라 정확한 경로를 알려 줘요. 「2행, 3번째 버튼: callback_data가 71바이트이고 최대는 64바이트예요」처럼요. 텍스트가 없는 버튼, 잘못된 유형, 반쯤만 채워진 템플릿 대상, 잘못된 링크, 비어 있거나 너무 긴 callback은 오류로 표시하고, Telegram이 받아들이긴 하지만 결과가 좋지 않을 것들(한 행에 버튼 8개 초과, 메시지에 버튼 100개 초과, 중복 버튼)은 경고로 표시해요. 문제가 있는 버튼은 목업에서 빨간 테두리로 나타나서 오류를 제자리에서 볼 수 있어요.

준비가 되면 가져가세요. 서식이 적용된 reply_markup JSON, 또는 cURL, 원시 Bot API, python-telegram-bot, aiogram, telegraf, grammY용으로 완성된 전체 메시지를 받을 수 있고, 텍스트는 앱과 같은 엔진으로 MarkdownV2로 이스케이프돼요. 처음부터 시작하고 싶지 않다면 판매, 커뮤니티, 콘텐츠, 지원, 미니 앱 다섯 카테고리에 걸쳐 키보드 템플릿 29개가 있고 실제 키보드 썸네일이 보여요. 빈칸을 채우고, 기존 키보드를 교체할지 아래에 추가할지 고르세요. 채널의 주제를 입력하면 AI가 구조는 건드리지 않고 버튼 텍스트를 언어와 분야에 맞게 조정해 줘요.

## 포함된 내용

- 보이는 곳에서 편집해요. 버튼은 별도 폼이 아니라 메시지 목업에서 바로 탭해서 편집해요. 행 추가, 행에 버튼 추가, 수정, 삭제가 가능하고 너무 많이 바꿨을 때를 위한 실행 취소도 있어요.
- **Bot API의 네 가지 유형과 각각의 규칙** — url(https://, http:// 또는 tg://), callback_data, web_app(HTTPS만 가능), switch_inline_query는 봇의 인라인 검색을 실행하도록 비워 둘 수 있어요.
- **callback_data의 실제 바이트 카운터** — 64자가 아니라 64바이트예요. 입력하는 동안 현재 얼마나 썼는지 보이고, 400 오류가 난 뒤가 아니라 전송 전에 경고가 나와요.
- 검증기는 「뭔가 잘못됨」이 아니라 오류의 경로를 알려 줘요. 정확한 행과 버튼, 텍스트가 없는 버튼, 반쯤만 채워진 템플릿 대상, 잘못된 링크, 빈 callback을 알려 주고, 문제가 있는 버튼은 목업에서 빨간색으로 강조돼요.
- 문법만이 아니라 디자인 경고도 해요. 한 행에 버튼이 8개를 넘을 때(Telegram이 텍스트를 자름), 메시지의 버튼이 100개를 넘을 때, 복사해서 붙여 넣다가 실수로 생기기 쉬운 중복 버튼을 알려 줘요.
- 판매, 커뮤니티, 콘텐츠, 지원, 미니 앱 다섯 카테고리의 템플릿 29개가 준비되어 있어요. 실제 키보드 썸네일을 볼 수 있고, 채울 칸이 있으며, 키보드를 교체하거나 이미 있는 키보드 아래에 행을 추가할 수 있어요.
- **실제 Telegram 말풍선 미리보기, 밝은 테마와 어두운 테마** — 메시지가 이미 MarkdownV2로 이스케이프된 텍스트로 그려지므로 미리보기는 착시가 아니라 검증이에요.
- 코드도 완성되어 있어요. 서식이 적용된 JSON reply_markup 또는 cURL, python-telegram-bot, aiogram, telegraf, grammY용 전체 전송 코드를 제공해요. <TU_TOKEN>과 <CHAT_ID> 자리 표시자가 들어 있고, 앱은 봇 토큰을 요구하지 않으며 대신 아무것도 보내지 않아요.

## 자주 묻는 질문

### Telegram 봇 메시지 아래에 버튼을 어떻게 넣나요?

메시지에 붙어 보이는 버튼은 인라인 키보드예요. sendMessage의 reply_markup 매개변수로 보내고, 형식은 {"inline_keyboard": [[버튼, 버튼], [버튼]]}이며 안쪽 배열 하나가 한 행이에요. 각 버튼은 text와 동작 속성 하나(url, callback_data, web_app, switch_inline_query 중 하나)를 가진 객체예요. Telegram 인라인 키보드 빌더에서는 메시지 목업을 탭해서 행을 만들고, 이미 직렬화되고 검증된 reply_markup이나 cURL, python-telegram-bot, aiogram, telegraf, grammY용 전체 전송 코드를 가져갈 수 있어요.

### callback_data는 얼마나 길 수 있고 왜 바이트로 측정하나요?

Bot API는 callback_data를 64자가 아니라 64바이트로 제한해요. 값의 UTF-8 인코딩 기준으로 한도가 적용되기 때문이에요. ASCII 문자는 1바이트, 악센트가 있는 모음은 2바이트, 이모지는 4바이트까지 차지할 수 있어서, 화면에서는 짧아 보이는 데이터도 한도를 넘겨 전송 시 오류가 날 수 있어요. 빌더는 입력하는 동안 실제 바이트 카운터를 보여 주고, 한도를 넘는 순간 해당 행과 버튼을 지정해 빨간색으로 표시해요. 더 많은 정보가 필요하면 callback_data에는 짧은 식별자를 저장하고 나머지는 봇에서 처리하는 것이 일반적이에요.

### 인라인 버튼은 한 행에 몇 개, 전체로는 몇 개까지 넣을 수 있나요?

Telegram은 행을 빽빽하게 채우는 것을 막지는 않지만, 특히 모바일에서 버튼 텍스트가 들어가지 않으면 잘라 내요. 빌더는 한 행에 버튼이 8개가 되면 경고하고, 메시지 전체 버튼이 100개를 넘을 때도 경고해요. 그 이상이면 휴대폰 화면에서 키보드를 쓸 수 없기 때문이에요. 실용적인 규칙은 설명하는 텍스트가 들어가면 행당 버튼 1~2개, 아주 짧은 라벨일 때만 3~4개예요. 밝은 테마와 어두운 테마의 실제 Telegram 말풍선 미리보기로 전송 전에 확인할 수 있어요.

### 빌더를 쓰려면 봇 토큰이나 회원가입이 필요한가요?

둘 다 필요 없어요. 빌더, reply_markup 검증기, 미리보기, 코드 조각은 모두 브라우저에서 계산돼요. 계정 없이 비용 없이 사용할 수 있어요. 앱은 봇 토큰을 요구하지 않고 대신 메시지를 보내지도 않아요. 복사하는 코드에는 <TU_TOKEN>과 <CHAT_ID> 자리 표시자가 있고 본인 환경에서 직접 채우시면 돼요. 무료 계정은 두 가지에만 필요해요. 키보드가 포함된 메시지를 저장해서 나중에 다시 쓰는 것, 그리고 템플릿의 버튼 텍스트를 채널 주제에 맞게 AI로 조정하는 것이에요.

### 인라인 버튼 유형에는 어떤 것이 있고 어느 것이 맞나요?

네 가지이고, 빌더에서 선택기로 제공돼요. 링크(url)는 웹사이트, 채널, 그룹을 열며 https://, http:// 또는 tg://로 시작해야 해요. 콜백(callback_data)은 누르면 봇에 데이터를 보내고, 그 callback을 받는 봇이 있어야만 작동해요. 미니 앱(web_app)은 Telegram 미니 앱을 열고 HTTPS와 설정된 봇이 필요해요. 인라인 검색(switch_inline_query)은 사용자를 다른 채팅에서 봇에 쿼리를 입력하도록 이끌고 값을 비워 둘 수 있어요. 채널만 운영하고 프로그래밍된 봇이 없다면 다른 설정 없이 작동하는 유형은 링크예요. 템플릿에 콜백 버튼이 들어 있으면 앱이 알려 줘요.

- [Telegram — AI 텔레그램 스티커, 이모지, 채널 브랜딩](https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215)

## 플랫폼 소개

**Telegram — AI 텔레그램 스티커, 이모지, 채널 브랜딩** — 앱 개발: AiToolsForApps. 이용 가능 위치:: https://kr.aitoolsforapps.com/telegram-sticker-emoji-channel-branding-215/f/telegram-bot-inline-keyboard-builder

### 다른 언어

- `es`: https://kr.aitoolsforapps.com/es/aitelegram-stickers-emojis-y-branding-para-telegram-215/f/constructor-de-teclados-inline-para-bots-de-telegram
- `en`: https://kr.aitoolsforapps.com/en/aitelegram-stickers-emojis-and-branding-for-telegram-215/f/inline-keyboard-builder-for-telegram-bots
- `fr`: https://kr.aitoolsforapps.com/fr/aitelegram-stickers-emojis-et-branding-pour-telegram-215/f/constructeur-de-claviers-inline-pour-bots-telegram
- `it`: https://kr.aitoolsforapps.com/it/aitelegram-stickers-emojis-e-branding-per-telegram-215/f/costruttore-di-tastiere-inline-per-bot-di-telegram
- `pt`: https://kr.aitoolsforapps.com/pt/aitelegram-stickers-emojis-e-branding-para-telegram-215/f/construtor-de-teclados-inline-para-bots-de-telegram
- `de`: https://kr.aitoolsforapps.com/de/aitelegram-stickers-emojis-und-branding-fuer-telegram-215/f/inline-tastenkonstruktor-fuer-telegram-bots
- `bg`: https://kr.aitoolsforapps.com/bg/telegram-sazdavayte-stikeri-i-emodzhita-koito-stickers-priema-215/f/konstruktor-na-inline-klaviaturi-za-botove-v-telegram
- `ja`: https://kr.aitoolsforapps.com/ja/telegram-sticker-emoji-sakusei-215/f/telegram-inline-keyboard-builder
- `nl`: https://kr.aitoolsforapps.com/nl/telegram-maak-telegram-stickers-en-emoji-s-die-stickers-accepteert-215/f/inline-toetsenbordbouwer-voor-telegram-bots
- `sv`: https://kr.aitoolsforapps.com/sv/telegram-skapa-telegram-stickers-och-emojis-som-stickers-godkanner-215/f/byggare-for-inline-tangentbord-till-telegram-bots
- `da`: https://kr.aitoolsforapps.com/da/telegram-lav-telegram-stickers-og-emojis-som-stickers-accepterer-215/f/bygger-til-inline-tastaturer-til-telegram-bots
- `id`: https://kr.aitoolsforapps.com/id/telegram-buat-stiker-dan-emoji-telegram-yang-diterima-stickers-215/f/pembuat-keyboard-inline-untuk-bot-telegram
- `cs`: https://kr.aitoolsforapps.com/cs/telegram-stickery-a-emoji-pro-telegram-ktere-stickers-prijme-215/f/konstruktor-inline-klavesnic-pro-boty-telegram
- `fi`: https://kr.aitoolsforapps.com/fi/telegram-tee-telegram-tarroja-ja-emojeja-jotka-stickers-hyvaksyy-215/f/inline-nappaimiston-rakentaja-telegram-boteille
- `zh`: https://kr.aitoolsforapps.com/zh/telegram-stickers-emojis-branding-215/f/telegram-jiqiren-hangnei-jianpan-jiangoqi
- `pl`: https://kr.aitoolsforapps.com/pl/telegram-tworz-stickery-i-emoji-ktore-przyjmie-stickers-215/f/konstruktor-klawiatur-inline-dla-botow-telegram
- `no`: https://kr.aitoolsforapps.com/no/telegram-lag-telegram-stickers-og-emojier-stickers-godtar-215/f/bygger-for-inline-tastatur-til-telegram-botter
- `ar`: https://kr.aitoolsforapps.com/ar/telegram-anshi-mlsqat-wiimuji-telegram-yqblha-stickers-215/f/telegram-inline-keyboard-builder-for-bots
- `he`: https://kr.aitoolsforapps.com/he/telegram-yotsrim-stikrim-vaimog-ym-sh-stickers-mkbl-215/f/boneh-mikladot-inline-le-botim-shel-telegram
