FAQタグ：#Messaging API

リッチメニューをアクティブにするには、Chatsモードで画面右下にある［Rich Menu］ペイン内のリッチメニューをクリックします。

URLに「http://」または「https://」が含まれていることを確認してください。リンクはブラウザで使用されるURLと同じフォーマットで指定する必要があります。

Chatsモードでトークにメッセージを追加すると、アクションは実際のボットで実行する場合と同様に動作します。

セキュリティを保つため、実際のボットで使用できるURLは「https://」で始まるものに限られます。LINE Bot Designerでは、プロトタイプを作成しやすくするため、この制限がかけられていません。

『LINE Developersコンソールドキュメント』の「作成できるチャネルの数について」を参照してください。

チャネルIDは、LINE Official Account Manager、またはLINE Developersコンソールで確認できます。

• LINE Official Account Managerの場合（管理者権限が必要）
  アカウント名のリストからアカウントを選択し、画面右上の［設定］ボタンをクリックします。サイドメニューの［Messaging API］をクリックすると、「Channel情報」の項目にチャネルIDが表示されます。
  
• LINE Developersコンソールの場合
  LINE Developersコンソールでプロバイダーを選択して、チャネルを選択します。［チャネル基本設定］タブにチャネルIDが表示されます。
  

プロバイダーIDは、LINE Developersコンソールで確認できます。

• プロバイダーのAdmin権限がある場合
  LINE Developersコンソールでプロバイダーを選択して、［プロバイダー設定］タブをクリックします。「基本情報」の項目に、プロバイダーIDが表示されます。
  
• プロバイダーのAdmin権限がない場合
  LINE Developersコンソールでプロバイダーを選択します。表示されたページのURLのうち、/provider/の後ろのセグメントがプロバイダーIDです。
  

LINE公式アカウントのビジネスプロフィールで、認証アイコン（プレミアム、認証済、未認証）をタップすると表示される企業名（プロバイダー名）は、下記の手順で変更できます。

• 認証プロバイダーの場合
  弊社への申請が必要であるため、担当営業までご連絡ください。
• 未認証プロバイダーの場合
  LINE Developersコンソールでプロバイダーを選択して、［プロバイダー設定］タブをクリックします。「基本情報」にある「プロバイダー名」の［編集］ボタンをクリックします。

なおプロバイダー名を変更してからビジネスプロフィールページに反映されるまでに時間がかかる場合があります。

同様に認証アイコンをタップすると表示される法人名、およびビジネス名は、ビジネスマネージャーで変更できます。

LINEプラットフォームで発生した問題について報告したり、改善要望を伝えたりしたい場合は、ヘルプセンターの「問題報告フォーム」からお問い合わせください。お問い合わせのすべてにご返答できない場合がありますので、あらかじめご了承ください。

テクニカルサポートを必要とされている場合は、FAQの「LINE APIに関する問い合わせがしたいです。テクニカルサポートの窓口はどこですか？」を参照してください。

LINE Profile+を用いてユーザーの電話番号を取得することができます。詳しくは、『法人ユーザー向けオプションドキュメント』の「LINE Profile+のスコープの種類」を参照してください。

LINE Profile+は所定の申請等を行った法人ユーザーのみがご利用いただけます。利用を希望のお客様は担当営業までご連絡いただくか、弊社パートナーにお問い合わせください。

あるプロバイダー配下で発行されたユーザーID（userId）について、対応するLINEアカウントが削除された場合も、同じユーザーIDがそのプロバイダーにおいて他のLINEアカウントに使い回されることはありません。

ユーザーIDの説明は、「ユーザーID、グループID、トークルームIDとはどのような値ですか？」も参照してください。

LINEプラットフォームで使用するユーザーIDは、ユーザーを識別するために利用する識別子であり、以下のような特徴を持ちます。

• LINEでの友だち検索に利用するIDとは異なり、ユーザーではなくLINEプラットフォームが発行する値です。
• チャネルのプロバイダーごとに異なるユーザーIDが発行されます。チャネルのプロバイダーが同じであれば、サービスの種類（LINEログインやMessaging API）にかかわらず、同じユーザーIDが割り当てられます。
• ユーザーIDの値は、U[0-9a-f]{32}の正規表現にマッチする文字列になります。

グループトークで使用するグループIDと、複数人トークで使用するトークルームIDも、グループトークや複数人トークを識別するためにLINEプラットフォームが発行する識別子です。

グループIDの値はC[0-9a-f]{32}、トークルームIDの値はR[0-9a-f]{32}の正規表現にマッチする文字列になります。

ユーザーIDはチャネルのプロバイダーごとに発行されます。あるプロバイダー配下で発行されたユーザーID（userId）は、ユーザーがLINEアカウントを削除しない限り変わることはありません。

ユーザーが機種変更をしてLINEアカウントの引き継ぎを行った場合も、ユーザーIDは変わりません。

LINEアカウントを削除したユーザーが、同じ電話番号で再度LINEアカウントを作りなおした場合は、ユーザーIDが変わります。

ユーザーIDの説明は、「ユーザーID、グループID、トークルームIDとはどのような値ですか？」も参照してください。

LINE APIの障害状況やステータスは、以下で確認できます。

• LINE Developersサイトのニュースの障害報告
• LINE API Status

LINEでは、ウェブサイトのOpen Graphタグを使用してURLプレビューが生成されます。

LINEで使用される3つのOGPタグ：

URLプレビューの例：

この動作はAndroid/iOSなどのOSの仕様に依存するものです。

LINEアプリ側で制御しているものではありません。

テキストメッセージのURLをリンクにする動作は、Android/iOSなどのOSの仕様に依存しており、LINEアプリ側で制御しているものではありません。このため、テキストメッセージ内のURLがリンクにならないことがあります。

なお、テキストメッセージに含まれるURLの前に半角スペースや改行などを追加することで、有効なURLとして認識される場合があります。

はい、できます。詳しくは、『Messaging APIドキュメント』の「グループトークや複数人トークにLINE公式アカウントを招待する」を参照してください。

LINE公式アカウントを友だち追加しているユーザーを、LINE公式アカウント側からブロックすることはできません。

Webhookイベントのフォローイベントやフォロー解除イベントで判別できます。なお、ユーザーがLINE公式アカウントの友だちかどうかを判別するためのエンドポイントはありません。

現在、LINE公式アカウントが参加している、グループトークと複数人トークの一覧は取得できません。

現在、ユーザーの言語に応じて、メッセージやリッチメニューの言語を切り替える機能はありません。

プロフィール情報を取得するエンドポイントを使って、ユーザーの言語を取得した上で、ユーザーの言語に応じたメッセージの送信やユーザー単位のリッチメニューの設定を行ってください。

いいえ、リッチメニューの背景を透過させることはできません。

特定のユーザーがLINE公式アカウントをどの経路で友だち追加したのかは、Messaging APIでは確認できません。

個人を特定できない、友だち追加経路の統計情報は、LINE Official Account Managerで確認できます。詳しくは、『LINEヤフー for Business』の「分析 - 友だち」を参照してください。

いいえ、できません。

紹介された相手がLINE公式アカウントを友だち追加またはブロック解除すると、LINEプラットフォームからボットサーバーにWebhookのフォローイベントが送信されます。しかし、そのユーザーがLINE公式アカウントをどの経路で友だち追加したのか（誰の紹介で友だち追加したのか）は、Messaging APIでは確認できません。

また友だち紹介の結果、何人が友だち追加したかという人数も取得できません。

Messaging APIでは、ユーザーがメッセージを読んだかどうかを確認する方法は提供していません。なお、送信したメッセージの統計情報は、以下のエンドポイントで確認できます。

• 「ユーザーの操作に基づく統計情報を取得する」エンドポイント
• 「ユニットごとの統計情報を取得する」エンドポイント

Messaging APIでPDFファイルを送ることはできません。

Messaging APIでは、「スタンプ」に記載されているスタンプのみを送信できます。

それ以外のスタンプは、以下の方法で送信できます。

• ご自身のLINEアカウントで所持しているスタンプは、LINE Official Account ManagerおよびLINE公式アカウント管理アプリの「チャット」で送信できます。詳しくは、『LINEヤフー for Business』の「チャット」を参照してください。
• スポンサードスタンプやクリエイターズスタンプなど、自社でライセンスを保有しているスタンプを送信する機能は、所定の申請等を行った法人ユーザーのみがご利用いただけます。自社のLINE公式アカウントでご利用になりたいお客様は、担当営業までご連絡いただくか、弊社パートナーにお問い合わせください。

LINE公式アカウントとMessaging APIチャネルを一度紐づけると、後からその紐づけを解除することはできません。

LINE公式アカウントの利用は継続したいが、LINE公式アカウントに紐づいているMessaging APIの利用は停止したい場合は、『Messaging APIドキュメント』の「Messaging APIの利用を停止する」を参照してください。

いいえ。Messaging APIでLINE公式アカウントからメッセージを送った場合、メッセージの送信取消をしたり、メッセージを削除したりすることはできません。

また、メッセージの送信をリクエストした後、送信の処理を途中でキャンセルすることもできません。

Messaging APIで送信したメッセージがユーザーに届くまで、時間がかかる場合があります。

Messaging APIのエンドポイントに対するメッセージ送信のリクエストは、非同期で処理されます。このため、LINE公式アカウントの友だち登録数が多い場合や、同じ時間帯に他のLINE公式アカウントからのメッセージ送信のリクエストが集中した場合、メッセージ送信の処理に時間がかかることがあります。

いいえ、応答メッセージはメッセージ通数にカウントされません。

LINE公式アカウントやMessaging APIではさまざまなメッセージ機能がありますが、すべてのメッセージ配信がメッセージ通数としてカウントされるわけではありません。LINE Official Account Managerにおけるチャットや応答メッセージなど、一部のメッセージ配信は無料で利用できます。

• メッセージ通数にカウントされる送信方法
  • LINE Official Account Managerにおけるメッセージ配信（絞り込み配信、ステップ配信含む）
  • Messaging APIのプッシュメッセージやマルチキャストメッセージ、ブロードキャストメッセージ、ナローキャストメッセージ
• メッセージ通数にカウントされない送信方法
  • LINE Official Account Managerにおけるチャット、応答メッセージ、あいさつメッセージ
  • Messaging APIの応答メッセージ

メッセージ通数にカウントされる送信方法について詳しくは、『LINEヤフー for Business』の「課金対象となるメッセージについて」を参照してください。

Messaging APIの料金について詳しくは、「Messaging APIの料金」を参照してください。

グループトークの概要を取得するAPIで、LINE公式アカウントが参加しているグループトークのグループ名やアイコンのURLを取得できます。

ボットを削除するにはLINE公式アカウントを削除する必要があります。

コンテンツを取得した際に、レスポンスで返されるバイナリデータのファイル形式は、レスポンスのContent-Typeヘッダーで示されます。

Content-Typeヘッダーの値を確認することで、コンテンツのファイル形式を確認できます。Content-Typeヘッダーで示される、ファイル形式の例は以下のとおりです。

既存のLINE公式アカウントでMessaging APIを利用するには、LINE Official Account ManagerでMessaging APIの利用を有効にします。

詳しくは、『Messaging APIドキュメント』の「LINE公式アカウントでMessaging APIを有効にする」を参照してください。

Messaging APIでメッセージを送信して200番台のステータスコードが返ったにもかかわらず、ユーザーにメッセージが届いていない場合、以下のような理由が考えられます。

• 「ユーザーがLINE公式アカウントをブロックしている」など、送信に必要な条件を満たしていない
  • プッシュメッセージを送信できる条件
  • マルチキャストメッセージを送信できる条件
  • ナローキャストメッセージを送信できる条件

上記について問題がないにもかかわらず、LINEアプリにメッセージが届いていない場合は、何らかの原因でユーザーの端末とLINEのサーバーの自動同期ができていない可能性があります。ヘルプセンターの「トークに関する問題 > トークリストの情報が間違っている > 自分が見ているトーク履歴の情報が他のユーザーと違う」を参照して、LINEアプリを利用している端末から「トーク履歴の情報を同期」をお試しいただくようユーザーにご案内ください。

なおヘルプセンターに記載のとおり、トーク履歴の情報を手動で同期する際は、必ず事前にトーク履歴のバックアップを行ってください。

LINE公式アカウントをブロックしているユーザーIDや、存在していないユーザーIDなど、メッセージが実際には届かないユーザーを宛先に指定した場合は、メッセージ送信のAPIを呼び出してもメッセージ通数にはカウントされません。

LINE公式アカウントをブロックしているユーザー、またはアカウントを削除したユーザーを指定してメッセージを送信しても、エラーは発生せず、レスポンスとしてはステータスコード200が返ります。

なお、この場合、ユーザーにメッセージは届きません。

いいえ、Webhookリクエスト送信元のLINEプラットフォームのIPアドレスは開示していません。セキュリティの担保はIPアドレスによるアクセス制御ではなく、署名の検証で実施してください。

メッセージ通数は、メッセージの送信対象となった人数でカウントされます。この例のように、メッセージを送ったグループトークや複数人トークに5人いれば、カウントされるメッセージ通数は5通です。1回のリクエストで指定したメッセージオブジェクトの件数は、メッセージ通数には影響しません。

メッセージが届かないユーザーを宛先に指定した場合のメッセージ通数については、「メッセージが届かないユーザーを宛先に指定してメッセージを送信した場合も、メッセージ通数1通分としてカウントされますか？」を参照してください。

料金について詳しくは、「Messaging APIの料金」を参照してください。

はい。

メッセージ送信時のリクエストボディに複数のメッセージオブジェクトを設定した場合、上から設定した順にメッセージが配信されます。

テキストの文字数は、UTF-16の符号単位（16ビット）でカウントします。一部の漢字やUnicode絵文字など、複数の符号単位で表現する文字は、1文字ではなく、複数の文字としてカウントします。

ただし、一部のプロパティについては、UTF-16の符号単位ではなく、書記素クラスタ単位でカウントします。詳しくは、『Messaging APIドキュメント』の「テキストの文字数のカウント」を参照してください。

また、LINEが提供するLINE絵文字については、Unicode絵文字と異なり、内部的に代替テキスト（例：(love)）に変換されるため、代替テキストの文字数でカウントします。

UTF-16の符号単位による文字数のカウント例は以下のとおりです。

メッセージIDには、Messaging APIの環境全体で一意となる値が割り振られます。

画像などのメッセージの種類ごと、チャネルごとに一意ということではありません。

メッセージの表示順序は、複数のメッセージをどのように送信したかによって異なります。

メッセージを送信するエンドポイントを複数回実行した場合、エンドポイントの実行順序とメッセージの表示順序は必ずしも一致しません。

メッセージを送信するエンドポイントを1回実行し、そのリクエストボディに複数のメッセージを指定した場合、リクエストボディで指定した順序でメッセージが表示されます。

自分のユーザーIDは、LINE Developersコンソールのチャネルの［チャネル基本設定］タブにある［あなたのユーザーID］で確認できます。詳しくは、『Messaging APIドキュメント』の「開発者が自分自身のユーザーIDを取得する」を参照してください。

動画を含むメッセージの送信に成功したとしても、ユーザーの端末上で動画を正しく再生できない場合があります。動画が正しく再生できない場合は以下のことを確認してください。

• 動画が再生可能なファイル形式（mp4）であること
• 動画のファイルサイズが200MB以下であること
• 動画をホストしているサーバーが、HTTPの範囲リクエスト（Range request）に対応していること
• 動画のコーデックやプロファイル、レベルが適切な設定であること（※）

※特定の端末で動画が正常に再生できない場合は、動画のコーデックやプロファイル、レベルを適切に設定するなどの対応をしてください。端末側で処理しやすい設定にすることで、動画が再生できるようになる場合があります。

お使いのアカウントがWebhookを許可する設定になっていない可能性があります。Webhookを有効にするには、LINE Developersコンソールのチャネル設定にある［Messaging API設定］タブで、［Webhookの利用］を有効にします。

当月に配信できるメッセージ数が十分に残っている場合でも、メッセージを配信している最中に別のメッセージを送信しようとすると、429 Too Many RequestsおよびエラーメッセージYou have reached your monthly limit.が返され、メッセージの送信に失敗することがあります。

これは、LINE Official Account ManagerおよびMessaging APIによるメッセージ配信において、送信開始から実際に送信される件数が確定するまでの間、配信予定のメッセージ数が一時的に予約されるために発生します。メッセージの配信設定によっては、実際の配信対象のユーザー数に関わらずターゲットリーチ分のメッセージ数が予約され、残数が一時的に枯渇する場合があります。

配信予定数の予約によって当月に配信できるメッセージの残数が一時的に枯渇している場合、別のメッセージの送信に失敗することがあります。先に実行している配信が完了し、配信されたメッセージ数が確定した段階で当月に配信できるメッセージの残数があれば、改めてメッセージを送信できます。

詳しくは、『Messaging APIリファレンス』の「当月に配信できるメッセージの残数に関する注意事項」を参照してください。

LINE公式アカウントの設定で［グループトークや複数人トークへの参加を許可する］が無効になっているか、招待したグループトークや複数人トークにすでに他のLINE公式アカウントが参加している可能性があります。

詳しくは、『Messaging APIドキュメント』の「グループトークや複数人トークにLINE公式アカウントを招待する」を参照してください。

LINE Official Account Managerの応答設定によっては、LINE公式アカウントが自動的に応答します。

LINE Developersコンソールのチャネル設定にある［Messaging API設定］タブで、［応答メッセージ］の［編集］をクリックして、LINE Official Account Managerにアクセスし、「応答設定」を確認してください。

以下のいずれかの設定になっていれば、自動的に応答します。

• ［あいさつメッセージ］が「オン」に設定されている場合、友だち追加したときに自動的に応答します。
• ［応答メッセージ］が「オン」に設定されている場合、あらかじめ設定した条件に従って自動的に応答します。
• ［チャット］が「オン」に設定されている場合、［チャットの応答方法］の設定に従って、自動的に応答することがあります。

ユーザー単位のリッチメニューをリンクした後に、ユーザーがそのLINE公式アカウントをブロックし、ブロック解除した場合は、リッチメニューとユーザーのリンクは解除されます。

その際に、デフォルトのリッチメニューが設定されていた場合は、ユーザーの画面にはデフォルトのリッチメニューが代わりに表示されます。デフォルトのリッチメニューが設定されていない場合は、リッチメニュー自体が表示されなくなります。

意図したリッチメニューが表示されない理由はいくつか考えられます。

• 表示優先度がより高いリッチメニューが設定されている
  リッチメニューは、設定した日時ではなく表示優先度に基づいて表示されます。たとえば、ユーザー単位のリッチメニューを設定していたとします。その後にデフォルトのリッチメニューを設定した場合は、デフォルトのリッチメニューよりも優先順位が高いユーザー単位のリッチメニューが表示されます。
  詳しくは、『Messaging APIドキュメント』の「意図したリッチメニューが表示されないときは」を参照してください。
• ユーザーがLINE公式アカウントをブロックした後、ブロック解除した
  ユーザー単位のリッチメニューをリンクした後に、ユーザーがそのLINE公式アカウントをブロックし、ブロック解除した場合は、リッチメニューとユーザーのリンクは解除されます。
• 開発者がリッチメニューを削除した
  開発者がユーザー単位のリッチメニューを削除すると、そのリッチメニューは表示されなくなります。
  デフォルトのリッチメニューが設定されている場合は、デフォルトのリッチメニューが代わりに表示されます。デフォルトのリッチメニューが設定されていない場合は、リッチメニュー自体が表示されなくなります。

LINEアカウントを作成したiPadや、LINEアカウントを引き継いだ先のiPadでは、リッチメニューが表示されます。

それ以外のiPadではリッチメニューが表示されません。

使用中のiPadでリッチメニューが表示されるかどうかは、LINEの設定画面で確認できます。

• ［設定］ > ［アカウント］ > ［アカウント削除］が表示される場合は、リッチメニューが表示されます。
• ［設定］ > ［アカウント］ > ［ログアウト］が表示される場合は、リッチメニューが表示されません。

いいえ、ありません。そのAPIや機能を利用するために必要な手続きをしてください。

いいえ、Webhook URLに複数のボットサーバーのエンドポイントは設定できません。1つのMessaging APIチャネルにつき、Webhook URLに設定できるボットサーバーのエンドポイントは1つだけです。