텔레그램 봇이 보내는 글자 메시지는 서식 기호를 뺀 글자 기준으로 1자 이상 4,096자 이하이고, 사진이나 파일에 붙이는 설명(캡션)은 0자 이상 1,024자 이하입니다. 한글은 한 글자가 1자이므로 한글만으로 본문 4,096자, 캡션 1,024자까지 쓸 수 있습니다. 이 글은 Telegram Bot API 공개 문서의 값을 기준으로, 글자수닷컴 계산 함수로 한글과 이모지를 직접 세어 한도에 걸리는 지점을 정리했습니다.
AI 생성 이미지
텔레그램 메시지는 몇 자까지 보낼 수 있나요?
Telegram Bot API 문서에서 글자를 보내는 sendMessage 방법의 text 항목은 「1-4096 characters after entities parsing」, 즉 서식 해석(entities parsing)이 끝난 뒤 1자 이상 4,096자 이하라고 적혀 있습니다. 사진을 보내는 sendPhoto, 파일을 보내는 sendDocument 같은 방법의 caption 항목은 「0-1024 characters after entities parsing」, 0자 이상 1,024자 이하입니다. 캡션은 없어도 되니 0자부터 허용되고, 본문 메시지는 비어 있으면 안 되니 1자부터입니다.
| 항목 | 공식 문서의 한도 | 한글 기준 |
|---|---|---|
| 글자 메시지(text) | 1~4,096자 | 한글 4,096자까지 |
| 사진·파일 캡션(caption) | 0~1,024자 | 한글 1,024자까지 |
본문 한도는 캡션 한도의 정확히 4배입니다. 사진에 긴 설명을 붙이고 싶을 때 캡션에 다 넣으려 하기보다, 짧은 캡션을 붙이고 긴 설명은 별도 글자 메시지로 보내는 편이 한도에 여유가 있습니다.
이 값은 봇이 API로 보낼 때의 문서 기준입니다. 일반 사용자가 앱의 입력창에서 쓰는 글의 한도는 이번에 공식 문서에서 확인하지 못했으니, 앱에서 직접 쓰는 경우에는 이 글의 숫자를 그대로 적용하지 마세요.
같은 한도, 다른 서비스와 비교하면 어떤가요?
디스코드 개발자 문서는 메시지 본문(content)을 「up to 2000 characters」, 즉 2,000자까지로 적고, 임베드(embed)의 설명(description)은 4,096자까지로 적습니다. 텔레그램 본문 한도와 디스코드 임베드 설명 한도가 같은 4,096이고, 디스코드 일반 본문은 그 절반 정도입니다.
같은 글을 두 서비스에 함께 올린다면 짧은 쪽에 맞춰야 합니다. 한글 2,000자를 넘는 글은 텔레그램에는 한 번에 들어가도 디스코드 본문에는 들어가지 않습니다. 글자수닷컴 함수로 한글 2,000자를 세면 2,000자이고 UTF-8로 6,000바이트입니다.
「서식 해석 이후」는 무슨 뜻인가요?
문서는 한도를 「after entities parsing」, 서식 해석 이후의 글자라고 적습니다. 굵게 같은 서식을 HTML 태그나 마크다운 기호로 적어 보내면 텔레그램이 그 기호를 읽어 서식으로 바꾸는데, 이 해석이 끝난 뒤 남는 글자로 한도를 잰다는 뜻으로 읽힙니다. 예를 들어 굵은 글씨용 태그로 감싼 「안녕」은 입력한 문자열로는 9자이지만 서식을 해석하면 글자는 「안녕」 2자입니다. 글자수닷컴 함수로 센 입력 문자열 길이는 9, 해석 뒤의 글자는 2입니다.
그래서 서식을 많이 쓰는 글은 입력창에 보이는 길이를 그대로 한도와 비교하면 안 됩니다. 반대로, 링크 주소를 서식으로 감싸 보내는 경우 주소 부분이 글자 수에 어떻게 들어가는지는 이번에 확인하지 못했습니다. 한도 가까이에서는 여유를 두세요.
한글은 몇 자까지 들어가나요?
한글 음절 하나는 글자 1개입니다. 글자수닷컴 함수로 「가」를 4,096번 반복한 글을 세면 4,096자이고, 한 글자를 더하면 4,097자로 한도를 넘습니다. 캡션은 1,024자와 1,025자가 경계입니다. 문서가 한도를 글자로만 적고 바이트는 적지 않았으므로 UTF-8 바이트(한글 4,096자는 12,288바이트, 캡션 1,024자는 3,072바이트)는 한도 판정에 쓰이지 않는 참고값입니다. 한글만 쓰는 글이라면 공백과 줄바꿈을 포함한 글자 수만 세면 됩니다. 공백 포함 글자 수는 글자수 세기에서 바로 확인할 수 있습니다.
이모지가 섞이면 한도는 어떻게 달라지나요?
여기에서 확인할 점이 있습니다. 문서는 4,096의 단위를 「characters」라고만 적었고, 같은 문서의 「Entities」 설명은 서식의 위치와 길이를 「UTF-16 코드 단위」로 세라고 적었습니다. UTF-16 코드 단위는 한글 한 글자도 1이지만 이모지는 한 글자가 2 이상이 됩니다. 한도 판정이 눈에 보이는 글자 수(그래핌)인지 UTF-16 단위인지는 문서에 적혀 있지 않아, 이번에 실제로 전송해 확인하지 못했습니다. 두 방식으로 센 값을 나란히 놓으면 이렇습니다.
영문과 한글은 두 방식의 값이 같아 걱정할 필요가 없습니다. 이모지가 섞이면 값이 갈립니다.
| 글 구성 | 글자(그래핌) | UTF-16 단위 | 4,096 기준 |
|---|---|---|---|
| 한글 4,096자 | 4,096 | 4,096 | 두 방식 모두 통과(한도와 같음) |
| 한글 4,097자 | 4,097 | 4,097 | 두 방식 모두 초과 |
| 웃는 얼굴 이모지 2,048개 | 2,048 | 4,096 | 두 방식 모두 통과 |
| 웃는 얼굴 이모지 4,096개 | 4,096 | 8,192 | 글자 방식 통과, UTF-16 방식 초과 |
| 한글 4,000자 + 웃는 얼굴 이모지 48개 | 4,048 | 4,096 | 두 방식 모두 통과 |
| 한글 4,000자 + 웃는 얼굴 이모지 96개 | 4,096 | 4,192 | 글자 방식 통과, UTF-16 방식 초과 |
한글에 웃는 얼굴 이모지를 조금 섞은 글은 4,000자 안팎에서 두 방식의 차이가 96 정도까지 벌어질 수 있습니다. 가장 안전한 방법은 이모지가 많은 긴 글을 UTF-16 단위로도 세어 4,096 이하로 맞추는 것입니다. 이 방식으로 세어 통과하면 어느 쪽으로 판정해도 넘지 않습니다.
4,096자를 넘는 글은 어떻게 나누나요?
문서의 한도는 글자 메시지 하나에 대한 것이므로, 더 긴 글은 한도 안에서 여러 메시지로 나누어 보내야 합니다. 한글 10,000자를 4,096자씩 나누면 4,096자, 4,096자, 1,808자의 메시지 3개가 됩니다. 캡션에 한글 3,000자를 넣고 싶다면 1,024자, 1,024자, 952자로 나뉘니 캡션에는 앞부분만 두고 나머지는 글자 메시지로 보내는 편이 낫습니다.
나눌 때는 글자의 중간에서 끊지 않는 것이 중요합니다. 이모지처럼 여러 부분이 이어진 글자를 가운데서 자르면 깨져 보일 수 있습니다. 앞에서부터 한도 안에 들어가는 부분을 미리 보고 싶다면 글자수 맞춰 자르기에 제한을 넣고 글을 붙여 넣으세요. 넘는 지점이 바로 표시됩니다. 바이트가 궁금하면 바이트 계산기에서 UTF-8 기준으로 볼 수 있습니다.
직접 확인하는 코드
브라우저 콘솔에 붙여 넣으면 눈에 보이는 글자 수와 UTF-16 단위 수를 함께 보고, 글자 단위로 한도에 맞춰 나눌 수 있습니다. 위 표의 값을 낸 것과 같은 규칙입니다.
// 눈에 보이는 글자(그래핌)와 UTF-16 단위를 함께 센다
const seg = new Intl.Segmenter('ko', { granularity: 'grapheme' });
function telegramCount(text) {
return { graphemes: [...seg.segment(text)].length, utf16: text.length };
}
// 글자 단위로 limit 개씩 나눈다 (글자 중간에서 자르지 않는다)
function splitByGraphemes(text, limit = 4096) {
const parts = [];
let cur = '', n = 0;
for (const { segment } of seg.segment(text)) {
if (n === limit) { parts.push(cur); cur = ''; n = 0; }
cur += segment; n++;
}
if (cur) parts.push(cur);
return parts;
}
const smile = '\u{1F600}';
telegramCount('가'.repeat(4000) + smile.repeat(96)); // { graphemes: 4096, utf16: 4192 }
splitByGraphemes('가'.repeat(10000)).map((p) => p.length); // [4096, 4096, 1808]
자주 묻는 질문
앱에서 직접 쓰는 메시지도 4,096자까지인가요?
이 글의 4,096자와 1,024자는 Telegram Bot API 문서에 적힌 값으로, 봇이 보내는 메시지의 한도입니다. 사람이 앱 입력창에서 쓰는 메시지의 한도는 공식 문서에서 확인하지 못했습니다. 앱에서 보낼 글이라면 실제로 붙여 넣어 보고 확인하세요.
줄바꿈과 공백도 글자 수에 들어가나요?
글자수닷컴 함수로 세면 줄바꿈 하나는 1자입니다. 윈도우식 줄바꿈(CRLF)은 글자로는 1자이지만 UTF-16 단위로는 2입니다. 텔레그램이 줄바꿈을 한도에 어떻게 넣는지는 문서에 적혀 있지 않아 확인하지 못했으니, 한도 가까이에서는 여유를 두세요.
사진 캡션이 1,024자를 넘으면 어떻게 하나요?
캡션은 1,024자까지이므로 설명이 더 길다면 캡션에는 핵심만 쓰고 나머지는 별도의 글자 메시지(최대 4,096자)로 보내는 방법이 있습니다. 한도를 넘었을 때 텔레그램이 어떤 응답을 주는지는 이번에 확인하지 못했습니다. 보내기 전에 글자수 세기로 글자 수를 먼저 확인하세요.