モジュールチャネルからMessaging APIを利用する

オプション機能を利用するには手続きが必要です

本ドキュメントに記載の機能は、所定の申請等を行った法人ユーザーのみがご利用いただけます。モジュールを利用した拡張機能の公開を希望するお客様は、担当営業までご連絡いただくか、LINEマーケットプレイス お問い合わせ (opens new window)よりお問い合わせください。

モジュールチャネルではMessaging APIチャネルと同様にMessaging APIを使ってメッセージを送信や、リッチメニューの切り替えが可能です。

• モジュールチャネルのチャネルアクセストークンでMessaging APIを利用する
• Webhookを受信する
• モジュールチャネルからLINE公式アカウントの情報を取得する
• 注意事項

モジュールチャネルのチャネルアクセストークンでMessaging APIを利用する

• モジュールチャネルで利用するユーザーID
• モジュールチャネルのチャネルアクセストークン
• Messaging APIのエンドポイントを呼び出す
• Messaging APIを利用する際のレート制限

モジュールチャネルで利用するユーザーID

LINEマーケットプレイスで提供するモジュールチャネルでは、ユーザー個別の識別子であるユーザーIDは、Lからはじまる68桁の文字列で構成されます。

この識別子は、同一ユーザーであっても、LINE公式アカウントごとに異なる値となります。

Lから始まる68桁の識別子の例

LUb577ef3cbe786a8da85ff8e902a03fc6-U5fac33f633e72c192759f09afc41fa28

モジュールチャネルのチャネルアクセストークン

モジュールチャネルがActive Channelに切り替わったら、モジュールチャネルのチャネルアクセストークンを利用して、Messaging APIやModule Channel APIを呼び出すことができます。

モジュールチャネルでは、以下のチャネルアクセストークンを利用できます。

• 短期のチャネルアクセストークン
• 任意の有効期間を指定できるチャネルアクセストークン（チャネルアクセストークンv2.1）

チャネルアクセストークンを発行する際に必要な情報は、LINE Developersコンソールのモジュールチャネルの［チャネル基本設定］タブで確認できます。

長期のチャネルアクセストークンは使用できません

モジュールチャネルでは、長期のチャネルアクセストークンは使用できません。

Messaging APIのエンドポイントを呼び出す

モジュールチャネルのチャネルアクセストークンを利用して、Messaging APIを呼び出すことができます。

ただし、スコープとリクエストヘッダーに注意してください。

スコープ

Messaging APIを利用するには、エンドポイントごとに決められたスコープを持つアクセストークンが必要です。

スコープは、モジュールチャネルをアタッチするときに指定し、LINE公式アカウントの管理者から利用の許可を得る必要があります。詳しくは、「LINE公式アカウントの管理者に認可を要求する」を参照してください。

リクエストヘッダー

モジュールチャネルからMessaging APIのエンドポイントを呼び出すときは、Authorizationヘッダーにはモジュールチャネルのチャネルアクセストークンを指定します。また、モジュールチャネルは複数のLINE公式アカウントにアタッチすることを前提にしたサービスのため、「ボットのユーザーIDを指定するヘッダー」を必ず指定してください。

Authorization

必須

Bearer {channel access token}

{channel access token}には、モジュールチャネルのチャネルアクセストークンを指定してください。

ボットのユーザーIDを指定するヘッダー

必須

モジュールチャネルにアタッチされたLINE公式アカウントのボットのユーザーID。

ボットのユーザーIDは、「モジュールチャネルの提供者の操作で連携（アタッチ）する」のレスポンスやAttachedイベントで取得できます。

ヘッダーの詳細については参画される際に別途提供いたします

本ヘッダーの名前（パラメーター名）は、実際にLINEマーケットプレイス (opens new window)に参画するお客様に限定して公開しています。

以下は、モジュールチャネルからMessaging APIでプッシュメッセージを送信する場合の例です。

curl -v -X POST https://api.line.me/v2/bot/message/push \
-H 'Content-Type:application/json' \
-H 'Authorization: Bearer {channel access token}' \
-H 'ボットのユーザーIDを指定するヘッダー: xxxxxxxxxxxxxxxxxxxxxxxx'　\      // NEED THIS HEADER
-d '{
    "to": "LUb577ef3cbe...",
    "messages":[
        {
            "type":"text",
            "text":"Hello, world1"
        }
    ]
}'

Messaging APIを利用する際のレート制限

モジュールチャネルからMessaging APIを利用する際のレート制限は、モジュールチャネル単位かつモジュールチャネルを連携しているLINE公式アカウントのボットごとに、各API機能（エンドポイント）に対して適用されます。

モジュールチャネルが複数のLINE公式アカウントのボットと連携していたとしても、モジュールチャネル x LINE公式アカウントのボット x API機能の組み合わせごとにレート制限が適用されます。

各エンドポイントのレート制限について詳しくは、『Messaging APIリファレンス』の「レート制限」を参照してください。

Webhookを受信する

モジュールチャネルに登録したWebhook URLサーバーでWebhookイベントを受信した際は、modeプロパティとdestinationプロパティの値を確認してください。

注意

モジュールチャネルのWebhook URLサーバーでWebhookイベントを受信できない場合は、以下の点を確認してください。

• モジュールチャネルをLINE公式アカウントにアタッチしていること。モジュールチャネルから、LINE公式アカウントを友だち追加しているユーザーにプッシュメッセージを送信できることを確認してください。
• モジュールチャネルをアタッチするために、LINE公式アカウントの管理者に認可を要求する際、認可URLのscopeクエリパラメータにmessage%3Areceive（message:receive）を指定していること。

スコープについて詳しくは、「LINE公式アカウントの管理者に認可を要求する」を参照してください。

• modeプロパティ
• destinationプロパティ
• モジュールチャネル専用のWebhookイベントを受信する
• モジュールチャネルからLINE公式アカウントの情報を取得する

modeプロパティ

ユーザーが、LINE公式アカウントにメッセージを送信したり、友だち追加したりすると、LINE公式アカウントに紐づくすべてのチャネル（Primary ChannelおよびLINE公式アカウントにアタッチされたモジュールチャネル）に、Webhookイベントが同時に送信されます。

Webhookイベントを処理する前に、モジュールチャネルが主導権（Chat Control）を持っていることを確認し、そのチャネルがエンドユーザーに対して応答すべきかどうかを確認してください。

主導権（Chat Control）を持っているかを確認するには、Webhookイベントのmodeプロパティを利用します。

modeプロパティの値	説明
active	Webhookイベントを受信したチャネルは、アクティブです。 このWebhookイベントを受信したWebhook URLサーバーから、返信メッセージやプッシュメッセージなどを送信できます。
standby	Webhookイベントを受信したチャネルは、待機状態です。 このWebhookイベントを受信したWebhook URLサーバーは、メッセージの送信を控えてください。 なお、待機状態のチャネルに届くWebhookイベントには、replyTokenプロパティが含まれません。そのため、応答メッセージは利用できません。

LINE公式アカウントにアタッチされているチャネルのうち、modeプロパティがactiveに設定されているチャネルは1つだけです。それ以外のチャネルでは、modeプロパティがstandbyに設定されています。

以下は、modeプロパティの値がactive場合とstandbyの場合に送信されるWebhookイベントの例です。

#Active Channelに送信されるWebhookイベントの例
{
    "replyToken": "0f3779fba3b349968c5d07db31eab56f", // NOTICE THIS PROPERTY
    "type": "message",
    "mode": "active", // NOTICE THIS PROPERTY
    "timestamp": 1462629479859,
    "source": {
        "type": "user",
        "userId": "LUb577ef3cbe..."
    },
    "message": {
        "id": "325708",
        "type": "text",
        "text": "Hello, world"
    }
}

#Standby Channelに送信されるWebhookイベントの例
{
    // replyToken PROPERTY DOES NOT EXIST
    "type": "message",
    "mode": "standby", // NOTICE THIS PROPERTY
    "timestamp": 1462629479859,
    "source": {
        "type": "user",
        "userId": "U4af4980629..."
    },
    "message": {
        "id": "325708",
        "type": "text",
        "text": "Hello, world!"
    }
}

destinationプロパティ

モジュールチャネルは、下図のように複数のLINE公式アカウント（OA "X"、OA "Y"、OA "Z"、…）にアタッチされる可能性があります。

そのため、WebhookがどのLINE公式アカウントから送信されたかを判別するために、destinationプロパティを利用します。

destination

String

Webhookイベントの送信元のLINE公式アカウントのボットのユーザーID。

ボットのユーザーIDの値は、U[0-9a-f]{32}の正規表現にマッチする文字列です。

以下は、Webhookイベントの例です。

{
  "destination": "U53387d54817...",  // CHECK THIS PROPERTY
  "events": [...]
}

モジュールチャネル専用のWebhookイベントを受信する

以下のWebhookイベントが、モジュールチャネルのWebhook URLサーバーに送信されます。

イベントタイプ	説明
Attachedイベント	モジュールチャネルが、LINE公式アカウントにアタッチされたことを示すイベントです。
Detachedイベント	モジュールチャネルが、LINE公式アカウントからデタッチされたことを示すイベントです。
Activatedイベント	Acquire Control APIを呼び出して、モジュールチャネルがActive Channelに切り替わったことを示すイベントです。
Deactivatedイベント	Acquire Control APIまたはRelease Control APIを呼び出して、モジュールチャネルがStandby Channelに切り替わったことを示すイベントです。
botSuspendイベント	LINE公式アカウントが一時停止状態（Suspend）になったことを示すイベントです。
botResumedイベント	LINE公式アカウントが一時停止状態（Suspend）から復帰したことを示すイベントです。

主導権（Chat Control）の変化を検知するには

モジュールチャネルがActive Channelになっているときに、Release Control APIを呼び出さなくても、自動的に主導権（Chat Control）が変わる場合があります。主導権（Chat Control）が変化した場合、以下のWebhookイベントがWebhook URLサーバーに送信されます。

イベントタイプ	説明
Activatedイベント Deactivatedイベント	LINE公式アカウントにアタッチされているモジュールチャネルが、Acquire Control APIまたはRelease Control APIを呼び出し、チャットの主導権（Chat Control）が切り替わった際に送信されるイベントです。
フォローイベント フォロー解除イベント	エンドユーザーがLINE公式アカウントを友だち追加したり、ブロックしたりすると送信されるイベントです。 LINE公式アカウントをブロックして再度友だち追加すると、主導権（Chat Control）は自動的にデフォルト状態にリセットされます。「Default Active」の機能が付与されたモジュールチャネルの場合は、自動的にActive Channelになります。

LINE公式アカウントの一時停止状態（Suspend）について

モジュールチャネルの設定やサービスの提供状況に関わらず、LINE公式アカウントの運営者の都合で、一時停止状態（Suspend）になる場合があります。具体的には、以下の状態になるとLINE公式アカウントが一時停止状態になります。

• LINE公式アカウントを削除したとき
• 何らかの理由でLINE公式アカウントの利用が停止されたとき

また、LINE公式アカウントが一時停止状態から復帰する場合もあります。LINE公式アカウントが一時停止状態になったり、復帰したりしたときに、Webhookイベントが送信されます。

モジュールチャネル側で管理している情報に齟齬が発生しないように実装してください。

モジュールチャネルからLINE公式アカウントの情報を取得する

以下のAPIを使うことで、モジュールチャネルをアタッチしたLINE公式アカウントの情報を取得できます。

• ボットの情報を取得する
• モジュールをアタッチしたボットのリストを取得する

ボットの情報を取得する

モジュールチャネルをアタッチしたLINE公式アカウントのボットの基本情報を取得します。詳しくは、『Messaging APIリファレンス』の「ボットの情報を取得する」を参照してください。

なお、リクエストヘッダーには、以下の内容を指定してください。

Authorization

Bearer {channel access token}

{channel access token}には、モジュールチャネルのチャネルアクセストークンを指定してください。

ボットのユーザーIDを指定するヘッダー

モジュールチャネルにアタッチされたLINE公式アカウントのボットのユーザーID。

ボットのユーザーIDは、「モジュールチャネルの提供者の操作で連携（アタッチ）する」のレスポンスやAttachedイベントで取得できます。

ヘッダーの詳細については参画される際に別途提供いたします

本ヘッダーの名前（パラメーター名）は、実際にLINEマーケットプレイス (opens new window)に参画するお客様に限定して公開しています。

モジュールをアタッチしたボットのリストを取得する

モジュールチャネルをアタッチした、複数のLINE公式アカウントのボットの基本情報をリストで取得します。詳しくは、『法人ユーザー向けオプションAPIリファレンス』の「モジュールをアタッチしたボットのリストを取得する」を参照してください。

注意事項

• モジュールチャネルをデタッチした際、設定が反映されるまでにタイムラグが発生します。デタッチ後は、リクエストを送信しないようにご注意ください。
• 対象のアカウントにスコープを追加したい場合は、既にアタッチ済のLINE公式アカウントに対しても、追加でアタッチを行うことが可能です。