Telegramボットが送るテキストメッセージは、書式の記号を解釈した後の文字で1文字以上4,096文字以下、写真やファイルに付ける説明(キャプション)は0文字以上1,024文字以下です。この記事は例として韓国語テキストを使っているため、韓国語の例文は原文のまま残しています。ハングル1字は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には1回で入ってもDiscordの本文には入りません。文字数ドットコムの関数でハングル2,000字を数えると、2,000文字でUTF-8では6,000バイトです。
「書式解釈の後」とはどういう意味ですか?
ドキュメントは上限を「after entities parsing」、書式解釈の後の文字として書いています。太字などの書式をHTMLタグやMarkdown記号で書いて送ると、Telegramがその記号を読んで書式に変えますが、この解釈が終わった後に残る文字で上限を測るという意味に読めます。たとえば太字用のタグで囲んだ「안녕」(こんにちは)は、入力した文字列としては9文字ですが、書式を解釈すると文字は「안녕」の2文字です。文字数ドットコムの関数で数えた入力文字列の長さは9、解釈後の文字は2です。
そのため、書式をたくさん使う文章は、入力欄に見える長さをそのまま上限と比べてはいけません。逆に、リンクのアドレスを書式で囲んで送る場合、アドレス部分が文字数にどう入るかは今回確認できませんでした。上限の近くでは余裕を持たせてください。
ハングルは何字まで入りますか?
ハングルの音節1つは1文字です。文字数ドットコムの関数で「가」を4,096回繰り返した文章を数えると4,096文字で、1文字足すと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字は1ですが、絵文字は1つで2以上になります。上限の判定が目に見える文字(書記素)なのかUTF-16単位なのかはドキュメントに書かれておらず、今回実際に送って確認することはできませんでした。2つの方式で数えた値を並べると次のとおりです。
英字とハングルは2つの方式で値が同じなので心配はいりません。絵文字が混ざると値が分かれます。
| 文章の構成 | 文字(書記素) | 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字前後で2つの方式の差が96ほどまで開くことがあります。いちばん安全なのは、絵文字の多い長い文章をUTF-16単位でも数えて4,096以下に収めることです。この方式で数えて通過すれば、どちらで判定されても超えません。
4,096文字を超える文章はどう分けますか?
ドキュメントの上限はテキストメッセージ1つについてのものなので、それより長い文章は上限の範囲で複数のメッセージに分けて送る必要があります。ハングル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つは1文字です。Windows式の改行(CRLF)は文字としては1文字ですが、UTF-16単位では2です。Telegramが改行を上限にどう入れるかはドキュメントに書かれておらず確認できなかったので、上限の近くでは余裕を持たせてください。
写真のキャプションが1,024文字を超えたらどうしますか?
キャプションは1,024文字までなので、説明がそれより長いなら、キャプションには要点だけを書き、残りは別のテキストメッセージ(最大4,096文字)で送る方法があります。上限を超えたときTelegramがどんな応答を返すかは、今回確認できませんでした。送る前に文字数カウントで文字数を先に確認してください。