LINE活用の基礎

LINE絵文字で送信エラーになるとき|indexとUTF-16の文字数を確認

制作:LIFE合同会社

AIを使用して制作・更新制作方法と確認範囲

#Messaging API#LINE絵文字#テキスト#送信エラー

この記事の結論

Messaging APIのテキストにLINE絵文字を入れると送れないとき、$の位置とUTF-16の数え方を切り分けます。Unicode絵文字との違い、代替テキストによる文字数、差し込み後の検証を解説します。

最終更新:2026年11月17日

LINE絵文字を追加したテキストが送れないときは、「絵文字を置く位置」と「送信できる長さ」を別々に確認します。 目で見た文字数だけでは、Messaging APIが求める位置や長さと一致しない場合があります。

この記事は type: text のテキストメッセージで、$ と emojis を使う場合が対象です。textV2 の置換指定やFlex Messageには、同じ記法をそのまま流用しません。スタンプを送る場合はスタンプのIDと送信条件へ進みます。

Unicode絵文字とLINE絵文字を分ける

Unicode絵文字は、たとえば「🍎」のようにテキストへ直接入る文字です。一方、ここで扱うLINE絵文字は、テキストの $ を、productId と emojiId で指定した絵文字へ置き換える方式です。送信可能な組み合わせは公式のLINE絵文字一覧で確認します。

テキストメッセージの仕様では、emojis.index は0から数える $ の位置です。指定位置が $ でなければエラーになります。emojis は最大20件で、スタンプのパッケージIDを代わりに渡す指定ではありません。

見た目で二つ目でも、indexは2とは限らない

文字数の公式説明では、UTF-16の符号単位で数えます。「🍎」は二つ分になるため、次の説明用文字列では $ の位置は3です。

const text = "A🍎$";
text.length;       // 4
text.indexOf("$");  // 3

これはJavaScriptで位置を確認するだけの例で、送信用の完成コードではありません。「A」「🍎」「$」という見た目の三つを数え、最後の位置を2にすると合いません。

複数の $ がある場合、最初の一つを探すだけでは足りません。使う各位置を順に求め、対応する絵文字をそれぞれ指定します。言語によって文字列の長さの単位が違うため、別の言語へ移す際は、同じ関数名でもUTF-16の単位になるか確認してください。

A、Unicode絵文字のりんご、ドル記号を並べた説明用文字列では、UTF-16の位置はAが0、りんごが1と2、ドル記号が3となる。LINE絵文字の置換位置には3を使う。差し込み後の最終テキストから位置を求め、位置の正しさと送信上限の確認を分ける。LINE絵文字の代替テキストは非公開であり、単なる文字列の長さだけでは上限を判断しきれない。

図解画像を開く(保存用)

名前などを差し込んだ後の文で位置を求める

架空の受付案内で、テンプレートの先頭へ宛名を差し込むとします。テンプレート上で計算した index を保持したまま、後から宛名を追加すると、$ の位置が移動します。宛名にUnicode絵文字や一部の漢字が含まれる場合は、見た目の文字数だけの加算でもずれる可能性があります。

実装を点検するときは、次の順で確認します。

  1. 宛名や日時を反映し、送信する最終テキストを作る。
  2. そのテキスト上の $ の位置をUTF-16で求める。
  3. 絵文字のIDと位置を対応させる。
  4. その後に文字を追加・削除していないか、送信直前の内容を確認する。

実データを公開ログへ出す必要はありません。架空の宛名を使い、空文字、長い宛名、二つの符号単位を使う文字などで再現できます。見た目を整える処理や改行の追加が、位置計算の後に走っていないかも確認します。

文字列の長さが上限以内でも、別の確認が必要

type: text のテキストは最大5,000文字ですが、LINE絵文字は $ 一文字のままで数えられるわけではありません。公式資料は、絵文字の代替テキストへ置き換えた後の文字数で判定すると説明しています。その代替テキスト自体は公開されていません。

したがって、text.length が5,000以下だったという確認だけで、LINE絵文字を含む文が必ず上限内だとは言えません。「絵文字一つにつき何文字の余白なら必ず通る」と固定値を保証するのも避けます。長い説明は内容を整理し、実際に送るメッセージオブジェクトを検証します。

ボタンのラベルなどには、UTF-16とは異なる数え方の例外もあります。この記事の数え方や5,000という上限を、すべてのテキスト欄へ一律に適用しないでください。

エラーの内容に合わせて修正する

確認できた問題次に調べる場所
指定位置に $ がない最終テキスト、位置計算、計算後の書き換え
絵文字のIDに問題がある公式一覧にある送信可能な組み合わせ
長さに関するエラー差し込み後の文、LINE絵文字の代替テキストによる計数
検証は通るが届かない実際の送信結果、送信先・送信方法の条件

送信前のメッセージ検証APIは、指定したメッセージオブジェクトを確認する入口です。検証の成功は、宛先への配送や表示まで確認したことにはなりません。

運用担当へはエラー種別と、修正した文面の版を渡します。実アカウントで確認する場合は、許可されたテスト先で表示を見てから本番の文面へ反映します。飾りの絵文字がなくても用件が伝わる文を用意しておくと、内容を確認する人と修正する人が同じ案内を扱えます。

仕様確認:2026年11月15日。位置計算の例と公式仕様の整理です。実際の送信APIや顧客への配信を実施した記録ではありません。

この記事に関連するサービス