Telegram 機器人傳送的文字訊息,在解析格式符號之後必須是1到4,096字,附在圖片或檔案上的說明(caption)則是0到1,024字。本文以韓文文字作為例子,因此韓文例句保持原文。一個韓文音節算1字,所以光用韓文就能寫滿本文4,096字、說明1,024字。以下數值以 Telegram Bot API 公開文件為準,並用글자수닷컴的計算函式實際計算韓文與表情符號,整理出各自在哪裡碰到上限。
AI 生成圖片
Telegram 一則訊息最多可以傳幾個字?
在 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 傳送時的文件標準。一般使用者在應用程式輸入框裡寫的訊息上限,這次在官方文件中沒有確認到,所以直接在應用程式裡寫的時候,請不要原封不動套用本文的數字。
和其他服務比起來如何?
Discord 開發者文件把訊息本文(content)寫成「up to 2000 characters」,也就是最多2,000字,把嵌入(embed)的說明(description)寫成最多4,096字。Telegram 的本文上限和 Discord 嵌入說明的上限都是4,096,而 Discord 一般的本文大約是它的一半。
如果要把同一段文字發到兩個服務,就要配合較短的那一邊。超過韓文2,000字的文章,Telegram 一次放得下,但 Discord 的本文放不下。用글자수닷컴的函式計算韓文2,000字,是2,000字,UTF-8 為6,000位元組。
「格式解析之後」是什麼意思?
文件把上限寫成「after entities parsing」,也就是格式解析之後的字數。用 HTML 標籤或 Markdown 符號寫出粗體等格式再傳送,Telegram 會讀取這些符號並轉成格式,這裡的意思看起來是以解析完成後剩下的字來衡量上限。例如用粗體標籤包住的「안녕」(你好),以輸入的字串來說是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字。Windows 式換行(CRLF)以字元來說是1字,但以 UTF-16 單位來說是2。Telegram 如何把換行計入上限,文件中沒有寫,也沒有確認到,所以接近上限時請留一些餘裕。
圖片說明超過1,024字怎麼辦?
說明最多1,024字,所以如果解釋更長,可以在說明只寫重點,其餘用另一則文字訊息(最多4,096字)傳送。超過上限時 Telegram 會給出什麼回應,這次沒有確認到。傳送前請先用字數統計確認字數。