결론부터
- 1설명은 처음 연 빈 화면에(512자), 소개는 프로필에(120자).
- 2@BotFather 로 바로, 봇 API 로는 언어별로 나눠 등록.
- 3기본값은 영어, 한국어는 language_code=ko 로 따로.
사용자가 보는 봇 정보 네 가지
| 정보 | 어디에 보이나 | 한도 |
|---|---|---|
| 이름 | 대화 목록·대화 머리·프로필 | 사용자명(…bot)과 달리 바꿔도 주소가 그대로 |
| 설명(description) | 봇과 처음 대화를 열었을 때 빈 화면 가운데 — '이 봇이 할 수 있는 일' | 최대 512자 |
| 소개(short description · about) | 봇 프로필 페이지, 봇 링크를 공유했을 때 미리 보기 | 최대 120자 |
| 프로필 사진 | 대화 목록·프로필 | 알아보기 쉬운 그림 — 사칭으로 보이지 않게 |
설명은 사용자가 '시작'을 누르기 전에 읽는 유일한 글입니다. 무엇을 하는 봇인지, 무엇을 저장하는지, 문의는 어디로 하는지를 짧게 적습니다.
바꾸는 두 가지 방법
| 정보 | @BotFather | 봇 API |
|---|---|---|
| 이름 | /setname | setMyName |
| 설명 | /setdescription | setMyDescription |
| 소개 | /setabouttext | setMyShortDescription |
| 사진 | /setuserpic | — |
@BotFather 는 바로 되는 대신 한 언어만 다루기 쉽고, 봇 API 는 언어별로 나눠 등록할 수 있습니다. 지금 값은 getMyName · getMyDescription · getMyShortDescription 으로 봅니다.
언어별로 등록하기
세 API 모두 language_code 를 받습니다. 사용자 앱 언어가 한국어면 한국어 값이, 맞는 언어가 없으면 언어 없이 등록한 기본값이 보입니다.
curl https://api.telegram.org/bot123456:ABC-EXAMPLE/setMyDescription \
-d language_code=ko \
-d description="채널 소개를 제보받는 봇입니다. 보낸 글은 검토용으로만 보관합니다."
기본값(언어 없음)은 영어로 두고 한국어를 따로 등록하면, 해외 사용자와 국내 사용자 모두 자기 말로 봅니다. 값을 비워 보내면 그 언어 등록이 지워져 기본값으로 돌아갑니다.
봇 만들기 처음부터는 BotFather 로 봇 만들기, 명령 목록 언어 나누기는 명령어 등록에 있습니다.
자주 묻는 질문
텔레그램 봇 설명은 어디에 보이나요?
사용자가 봇과 처음 대화를 열었을 때 빈 화면 가운데에 보입니다. 최대 512자입니다.
봇 소개(about)와 설명은 무엇이 다른가요?
소개는 봇 프로필과 링크 미리 보기에 보이는 120자 이내의 짧은 글이고, 설명은 처음 대화 화면의 긴 글입니다.
봇 설명을 한국어·영어로 따로 보여 줄 수 있나요?
setMyDescription 에 language_code 를 주어 언어별로 등록하면 사용자 앱 언어에 맞춰 보입니다.
봇 이름을 바꾸면 주소도 바뀌나요?
아닙니다. 이름만 바뀌고 …bot 으로 끝나는 사용자명과 주소는 그대로입니다.
참고한 공식 문서
한눈에 정리
- 1설명
처음 화면 · 512자.
- 2소개
프로필 · 120자.
- 3언어
language_code 로 나누기.
최종 수정 2026-10-06