LINEコネクタ構成ガイド

必要条件

LINEコネクタには以下が必要です：

• LINE: チャネルアクセストークン。詳細については、メッセージングAPI概要を参照してください。

API情報

このコネクタは以下のベンダーAPIを使用します：

• API名：LINE Messaging API
• APIバージョン：v2
• APIエンドポイント：https://api.line.me/v2
• ドキュメント：LINE: Audience API

バッチ制限

このアクションは、ベンダーへの大量データ転送をサポートするためにバッチリクエストを使用します。詳細については、バッチアクションを参照してください。リクエストは、次のいずれかの閾値に達するか、プロファイルが公開されるまでキューに入れられます：

• 最大リクエスト数：10,000
• 最古のリクエストからの最大時間：30分
• リクエストの最大サイズ：1 MB

サポートされるアクション

アクション名	オーディエンスに対するトリガー	ストリームに対するトリガー
オーディエンスへのユーザー追加	✓	✗
メッセージ送信 - テキスト	✓	✗
メッセージ送信 - 画像	✓	✗
メッセージ送信 - ビデオ	✓	✗
メッセージ送信 - オーディオ	✓	✗
メッセージ送信 - 位置情報	✓	✗
メッセージ送信 - ステッカー	✓	✗
メッセージ送信 - イメージマップ	✓	✗
メッセージ送信 - テンプレートメッセージ（ボタンテンプレート）	✓	✗
メッセージ送信 - テンプレートメッセージ（確認テンプレート）	✓	✗
メッセージ送信 - テンプレートメッセージ（カルーセルテンプレート）	✓	✗
メッセージ送信 - テンプレートメッセージ（画像カルーセルテンプレート）	✓	✗
メッセージ送信 - フレックス	✓	✗

構成の構成

コネクタマーケットプレイスにアクセスして、新しいLINEコネクタを追加します。コネクタの追加方法については、コネクタ概要の記事を参照してください。

ベンダーを構成するには、次の手順に従います：

1. 構成タブで、コネクタインスタンスのタイトルを入力します。
2. LINEアカウント用に構成したチャネルアクセストークンを入力します。
3. 実装に関する追加のノートを提供します。

アクション構成 - パラメータとオプション

次へをクリックするか、アクションタブに移動してアクションを構成し、トリガーします。

このセクションでは、各アクションのパラメータとオプションの構成方法について説明します。

アクション - オーディエンスへのユーザー追加

パラメータ	説明
オーディエンスグループID	リストからオーディエンスグループを選択するか、カスタムテキストとして入力します。
ユーザーID	ユーザーIDまたはIFA（広告用識別子）。複数のユーザーIDを送信するには、このパラメータに配列をマッピングします。
説明	この更新アクションの説明。

オーディエンスへのユーザー追加（バッチ処理）

パラメータ

パラメータ	説明
オーディエンスグループID	リストからオーディエンスグループを選択するか、カスタムテキストとして入力します。
ユーザーID	ユーザーIDまたはIFA。複数のユーザーIDを送信するには、このパラメータに配列をマッピングします。
説明	この更新アクションの説明。

アクション - メッセージ送信 - テキスト

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
メッセージデータ	必須。ユーザーに送信するメッセージの内容。このフィールドは2,000文字に制限され、ユニコード絵文字をサポートし、Tealiumテンプレートエンジンをサポートします。詳細については、コネクタテンプレートについてを参照してください。
テンプレート変数	これらのフィールドは、メッセージデータで使用される変数名に属性をマッピングします。ネストされたテンプレート変数はドット表記で名前を付けます。例えば、items.name。詳細については、コネクターテンプレート変数を参照してください。

アクション - メッセージ送信 - 画像

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
オリジナルコンテンツURL	必須。ユーザーに送信する画像のURL。URLはHTTPSを使用し、1,000文字を超えてはならず、画像はJPEGで、最大寸法は1,024ピクセル×1,024ピクセル、最大サイズは1 MBです。
プレビュー画像URL	必須。ユーザーに送信するプレビュー画像のURL。URLはHTTPを使用し、1,000文字を超えてはならず、画像はJPEG形式で、最大寸法は240ピクセル×240ピクセル、最大サイズは1 MBです。

アクション - メッセージ送信 - ビデオ

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
オリジナルコンテンツURL	必須。ユーザーに送信するビデオのURL。URLはHTTPSプロトコルを使用し、1,000文字を超えてはならず、ビデオはMP4形式で、最大持続時間は1分、最大サイズは10 MBです。
プレビュー画像URL	必須。ユーザーに送信するプレビュー画像のURL。URLはHTTPを使用し、1,000文字を超えてはならず、画像はJPEG形式で、最大寸法は240ピクセル×240ピクセル、最大サイズは1 MBです。

アクション - メッセージ送信 - オーディオ

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
オリジナルコンテンツURL	必須。ユーザーに送信するオーディオのURL。URLはHTTPSプロトコルを使用し、1,000文字を超えてはならず、オーディオはM4A形式で、最大持続時間は1分、最大サイズは10 MBです。
再生時間	必須。オーディオファイルの長さ（ミリ秒単位）。

アクション - メッセージ送信 - 位置情報

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
タイトル	必須。ユーザーに送信する位置情報の名前。
住所	必須。ユーザーに送信する位置情報の住所。
緯度	必須。ユーザーに送信する位置情報の緯度。
経度	必須。ユーザーに送信する位置情報の経度。

アクション - メッセージ送信 - ステッカー

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、LINEビジネスセンターのチャネルコンソールで構成されたウェブフックから受け取ったIDです。ユーザーがアカウントを追加したりメッセージを送信したりすると、HTTPS POSTリクエストがウェブフックURLに送信されます。
パッケージID	必須。ステッカーが属するパッケージのID。
ステッカーID	必須。ユーザーに送信するステッカーのID。

メッセージ送信 - イメージマップ

パラメータ

パラメータ	説明
Contact ID	必須。このパラメータは、Channel Console に構成されたウェブフックから受け取ったIDです。アカウントの追加やメッセージの送信などのユーザーのアクションが行われると、ウェブフックURLにHTTPS POSTリクエストが送信されます。
Base URL	必須。ベース画像のURL。URLはHTTPSプロトコルを使用し、1,000文字を超えてはいけません。
Alternative Text	必須。ベース画像の代替テキストで、最大400文字です。この代替テキストは通知やチャットリストに表示されます。
Base Size - Width	必須。ベース画像の幅（ピクセル）。この値は 1040 に構成します。
Base Size - Height	必須。ベース画像の高さ（ピクセル）。この値は画像の幅が1040ピクセルのときの高さに構成します。

アクションデータ

すべてのアクションデータパラメータは配列です。

パラメータ	説明
Type	アクションのタイプ。可能な値は uri と message です。
Area - X	イメージマップエリアの左端からのアクションエリアの水平位置。最小値は 0 です。
Area - Y	イメージマップエリアの上端からのアクションエリアの垂直位置。最小値は 0 です。
Area - Width	アクションエリアの幅。
Area - Height	アクションエリアの高さ。
Label	アクションのラベル。
Link URI	uri タイプのアクションの場合、アクションのリンクのURI。
Text	メッセージタイプのアクションの場合、アクションのテキスト。
Clipboard Text	クリップボードにコピーされるテキスト。

ビデオデータ

イメージマップにビデオを構成する場合、以下のパラメータが必要です：

パラメータ	説明
Original Content URL	ビデオファイルのURL。URLは2,000文字を超えてはいけませんし、HTTPSプロトコルを使用する必要があります。ビデオは.mp4形式で、200MBを超えてはいけません。
Preview Image URL	プレビュー画像のURL。URLは2,000文字を超えてはいけませんし、HTTPSプロトコルを使用する必要があります。画像はJPEGまたはPNG形式を使用し、1MBを超えてはいけません。
Area - X	イメージマップエリアの左端からのビデオエリアの水平位置。最小値は 0 です。
Area - Y	イメージマップエリアの上端からのビデオエリアの垂直位置。最小値は 0 です。
Area - Width	ビデオエリアの幅。
Area - Height	ビデオエリアの高さ。

ビデオがイメージマップ上で再生され、ビデオ終了後にラベルが表示される場合、以下のパラメータが必要です：

パラメータ	説明
External Link - Link URI	ウェブページのURL。URLは1,000文字を超えてはいけませんし、http, https, line, tel のプロトコルを使用できます。
External Link - Label	ビデオが終了した後に表示されるラベル。ラベルは30文字を超えてはいけません。

プッシュメッセージ - テンプレートメッセージ（ボタンテンプレート）

パラメータ

パラメータ	説明
Contact ID	必須。このパラメータは、Channel Console に構成されたウェブフックから受け取ったIDです。アカウントの追加やメッセージの送信などのユーザーのアクションが行われると、ウェブフックURLにHTTPS POSTリクエストが送信されます。
Alternative Text	必須。メッセージの代替テキストで、テキストは400文字を超えてはいけません。このテキストは通知やチャットリストに表示されます。
Template - Text	必須。メッセージテキスト。画像やタイトルがないテキストは400文字を超えてはいけませんし、画像やタイトルがある場合のテキストは60文字を超えてはいけません。
Template - Thumbnail Image URL	必須。画像のサムネイルのURL。URLは2,000文字を超えてはいけませんし、HTTPSプロトコルを使用する必要があります。
Template - Image Aspect Ratio	必須。画像のアスペクト比。許可される値は rectangle または square です。デフォルト値は rectangle です。
Template - Image Size	必須。画像のサイズ。許可される値は cover または contain です。デフォルト値は cover です。
Template - Image Background Color	必須。画像の背景色（16進数形式）。デフォルト値は #FFFFFF（白）です。
Template - Title	必須。メッセージのタイトル。タイトルは40文字を超えてはいけません。

テンプレート - アクション

すべてのテンプレート - アクションパラメータは配列です。

パラメータ	説明
Type	必須。アクションのタイプ。許可される値は: postback, message, uri, datetimepicker, camera, cameraRoll, location, richmenuswitch, clipboard です。
Label	必須。アクションのラベル。オブジェクトに構成されたアクションに基づいて仕様が異なります。
Data	必須。ウェブフックを通じて postback.data プロパティのポストバックイベントを通じて返される文字列。
Display Text	必須。アクションが実行されたときにLINEチャット画面にユーザーによって送信されたメッセージとして表示されるテキスト。
Text	必須。message タイプのアクションの場合、アクションが実行されたときに送信されるテキスト。
URI	必須。uri タイプのアクションの場合、アクションが実行されたときに開かれるURI。URLはHTTPSプロトコルを使用する必要があります。
Alternative URI - Desktop	必須。uri タイプのアクションの場合、アクションが実行されたときにLINE for macOSおよびWindowsで開かれるURI。
Mode	必須。datetimepicker タイプのアクションの場合、アクションモード。許可される値は: date, time, datetime です。
Initial	必須。datetimepicker タイプのアクションの場合、日付または時間の初期値。
Max	必須。datetimepicker タイプのアクションの場合、選択可能な最大の日付または時間値。
Min	必須。datetimepicker タイプのアクションの場合、選択可能な最小の日付または時間値。
Input Option	必須。ユーザーアクションに基づく表示方法。許可される値は: closeRichMenu, openRichMenu, openKeyboard, openVoice です。
Fill In Text	必須。Input Option パラメータが openKeyboard に構成され、キーボードが開かれた場合、入力フィールドのデフォルト文字列。
Clipboard Text	必須。clipboard タイプのアクションの場合、クリップボードにコピーするテキスト。
Rich Menu Alias ID	必須。切り替えるリッチメニューのエイリアスID。

テンプレート - デフォルトアクション

パラメータ	説明
Type	必須。アクションのタイプ。許可される値は：postback、message、uri、datetimepicker、camera、cameraRoll、location、richmenuswitch、clipboard。
Label	必須。アクションのラベル。オブジェクトによって仕様が異なります。
Data	必須。postback.dataプロパティを通じてwebhookを介して返される文字列。
Display Text	必須。アクションが実行されたときにLINEチャット画面に表示されるテキスト。
Text	必須。messageタイプのアクションの場合、アクションが実行されたときに送信されるテキスト。
URI	必須。uriタイプのアクションの場合、アクションが実行されたときに開かれるURI。URLはHTTPSプロトコルを使用する必要があります。
Alternative URI - Desktop	必須。uriタイプのアクションの場合、アクションが実行されたときにLINE for macOSおよびWindowsで開かれるURI。
Mode	必須。datetimepickerタイプのアクションの場合、アクションモード。許可される値は：date、time、datetime。
Initial	必須。datetimepickerタイプのアクションの場合、日付または時間の初期値。
Max	必須。datetimepickerタイプのアクションの場合、選択可能な最大の日付または時間値。
Min	必須。datetimepickerタイプのアクションの場合、選択可能な最小の日付または時間値。
Input Option	必須。ユーザーアクションに基づく表示方法。許可される値は：closeRichMenu、openRichMenu、openKeyboard、openVoice。
Fill In Text	必須。Input OptionパラメータがopenKeyboardに構成され、キーボードが開かれたときの入力フィールドのデフォルト文字列。
Clipboard Text	必須。clipboardタイプのアクションの場合、クリップボードにコピーするテキスト。
Rich Menu Alias ID	必須。切り替えるリッチメニューのエイリアスID。

プッシュメッセージ - テンプレートメッセージ（確認テンプレート）

パラメータ

パラメータ	説明
Contact ID	必須。このパラメータは、Channel ConsoleのLINEビジネスセンターで構成されたwebhookから受け取ったIDです。アカウントの追加やメッセージの送信などのアクションが行われると、HTTPS POSTリクエストがwebhook URLに送信されます。
Alternative Text	必須。メッセージの代替テキスト。テキストは400文字を超えてはなりません。通知やチャットリストに表示されます。
Template - Text	必須。メッセージテキスト。画像やタイトルがないテキストは400文字を超えてはなりません。画像やタイトルがある場合のテキストは60文字を超えてはなりません。

テンプレート - アクション

すべてのテンプレート - アクションパラメータは配列です。

パラメータ	説明
Type	必須。アクションのタイプ。許可される値は：postback、message、uri、datetimepicker、camera、cameraRoll、location、richmenuswitch、clipboard。
Label	必須。アクションのラベル。オブジェクトによって仕様が異なります。
Data	必須。postback.dataプロパティを通じてwebhookを介して返される文字列。
Display Text	必須。アクションが実行されたときにLINEチャット画面に表示されるテキスト。
Text	必須。messageタイプのアクションの場合、アクションが実行されたときに送信されるテキスト。
URI	必須。uriタイプのアクションの場合、アクションが実行されたときに開かれるURI。URLはHTTPSプロトコルを使用する必要があります。
Alternative URI - Desktop	必須。uriタイプのアクションの場合、アクションが実行されたときにLINE for macOSおよびWindowsで開かれるURI。
Mode	必須。datetimepickerタイプのアクションの場合、アクションモード。許可される値は：date、time、datetime。
Initial	必須。datetimepickerタイプのアクションの場合、日付または時間の初期値。
Max	必須。datetimepickerタイプのアクションの場合、選択可能な最大の日付または時間値。
Min	必須。datetimepickerタイプのアクションの場合、選択可能な最小の日付または時間値。
Input Option	必須。ユーザーアクションに基づく表示方法。許可される値は：closeRichMenu、openRichMenu、openKeyboard、openVoice。
Fill In Text	必須。Input OptionパラメータがopenKeyboardに構成され、キーボードが開かれたときの入力フィールドのデフォルト文字列。
Clipboard Text	必須。clipboardタイプのアクションの場合、クリップボードにコピーするテキスト。
Rich Menu Alias ID	必須。切り替えるリッチメニューのエイリアスID。

プッシュメッセージ - テンプレートメッセージ（カルーセルテンプレート）

パラメータ

パラメータ	説明
Contact ID	必須。このパラメータは、Channel ConsoleのLINEビジネスセンターで構成されたwebhookから受け取ったIDです。アカウントの追加やメッセージの送信などのアクションが行われると、HTTPS POSTリクエストがwebhook URLに送信されます。
Alternative Text	必須。カルーセルテンプレートの代替テキスト。テキストの最大長は400文字です。通知やチャットリストに表示されます。
Image Aspect Ratio	必須。画像のアスペクト比。許可される値はrectangleまたはsquareです。デフォルト値はrectangleです。
Image Size	必須。画像のサイズ。許可される値はcoverまたはcontainです。デフォルト値はcoverです。

テンプレート - カラム

すべてのテンプレート - カラムパラメータは配列です。

パラメータ	説明
Text	必須。メッセージテキスト。画像やタイトルがないテキストは120文字を超えてはなりません。画像やタイトルがある場合のテキストは60文字を超えてはなりません。
Thumbnail Image URL	必須。画像のサムネイルのURL。URLは2,000文字を超えてはならず、HTTPSプロトコルを使用する必要があります。
Image Background Color	必須。画像の背景色を16進数形式で。デフォルト値は#FFFFFF（白）。
Title	必須。メッセージのタイトル。タイトルは40文字を超えてはなりません。
Actions	必須。項目がタップされたときに実行するアクション。
Templates	必須。Actionsパラメータのテンプレート - カラムセクションで参照されるテンプレートを提供します。詳細については、テンプレートガイドを参照してください。 テンプレートは名前で参照され、サポートされるフィールドに二重中括弧で挿入されます。例：{{SomeTemplateName}}。

テンプレート - 列 - デフォルトアクション

すべてのテンプレート - 列 - デフォルトアクションのパラメータは配列です。

パラメータ	説明
タイプ	必須。アクションのタイプ。許可される値は：postback、message、uri、datetimepicker、camera、cameraRoll、location、richmenuswitch、clipboardです。
ラベル	必須。アクションのラベル。オブジェクトによって仕様が異なります。
データ	必須。postback.dataプロパティを通じてwebhookを介して返される文字列。
表示テキスト	必須。アクションが実行されたときにLINEチャット画面に表示されるメッセージとしてユーザーに送信されるテキスト。
テキスト	必須。messageタイプのアクションの場合、アクションが実行されたときに送信されるテキスト。
URI	必須。uriタイプのアクションの場合、アクションが実行されたときに開かれるURI。URLはHTTPSプロトコルを使用する必要があります。
代替URI - デスクトップ	必須。uriタイプのアクションの場合、LINE for macOSおよびWindowsでアクションが実行されたときに開かれるURI。
モード	必須。datetimepickerタイプのアクションの場合、アクションモード。許可される値は：date、time、datetimeです。
初期値	必須。datetimepickerタイプのアクションの場合、日付または時間の初期値。
最大値	必須。datetimepickerタイプのアクションの場合、選択可能な最大の日付または時間の値。
最小値	必須。datetimepickerタイプのアクションの場合、選択可能な最小の日付または時間の値。
入力オプション	必須。ユーザーアクションに基づく表示方法。許可される値は：closeRichMenu、openRichMenu、openKeyboard、openVoiceです。
入力テキスト	必須。入力オプションパラメータがopenKeyboardに構成され、キーボードが開かれたときの入力フィールドのデフォルト文字列。
クリップボードテキスト	必須。clipboardタイプのアクションの場合、クリップボードにコピーするテキスト。
リッチメニューエイリアスID	必須。切り替えるリッチメニューのエイリアスID。
テンプレート変数	必須。データとしてテンプレート変数を提供します。これらのフィールドは属性を変数名にマッピングし、メッセージデータで使用されます。例えば、items.nameのようにドット表記でネストされたテンプレート変数を名前付けします。 詳細については、コネクターテンプレート変数を参照してください。

プッシュメッセージ - テンプレートメッセージ（イメージカルーセルテンプレート）

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、チャンネルコンソールに構成されたwebhookから受け取ったIDです。アカウントの追加やメッセージの送信などのアクションが行われると、HTTPS POSTリクエストがwebhook URLに送信されます。
代替テキスト	必須。基本画像の代替テキスト。最大テキスト長は400文字です。代替テキストは通知やチャットリストに表示されます。

テンプレート - 列のパラメータ

すべてのテンプレート - 列のパラメータは配列です。

パラメータ	説明
画像URL	必須。画像のサムネイルのURL。URLは2,000文字を超えてはならず、HTTPSプロトコルを使用する必要があります。
アクション - タイプ	必須。アクションのタイプ。許可される値は：postback、message、uri、datetimepicker、camera、cameraRoll、location、richmenuswitch、clipboardです。
アクション - ラベル	必須。アクションのラベル。オブジェクトによって仕様が異なります。
アクション - データ	必須。postback.dataプロパティを通じてwebhookを介して返される文字列。
アクション - 表示テキスト	必須。アクションが実行されたときにLINEチャット画面に表示されるメッセージとしてユーザーに送信されるテキスト。
アクション - テキスト	必須。messageタイプのアクションの場合、アクションが実行されたときに送信されるテキスト。
アクション - URI	必須。uriタイプのアクションの場合、アクションが実行されたときに開かれるURI。URLはHTTPSプロトコルを使用する必要があります。
アクション - 代替URI - デスクトップ	必須。uriタイプのアクションの場合、LINE for macOSおよびWindowsでアクションが実行されたときに開かれるURI。
アクション - モード	必須。datetimepickerタイプのアクションの場合、アクションモード。許可される値は：date、time、datetimeです。
アクション - 初期値	datetimepickerタイプのアクションの場合、日付または時間の初期値。
アクション - 最大値	必須。datetimepickerタイプのアクションの場合、選択可能な最大の日付または時間の値。
アクション - 最小値	必須。datetimepickerタイプのアクションの場合、選択可能な最小の日付または時間の値。
アクション - 入力オプション	必須。ユーザーアクションに基づく表示方法。許可される値は：closeRichMenu、openRichMenu、openKeyboard、openVoiceです。
アクション - 入力テキスト	必須。入力オプションパラメータがopenKeyboardに構成され、キーボードが開かれたときの入力フィールドのデフォルト文字列。
アクション - クリップボードテキスト	必須。clipboardタイプのアクションの場合、クリップボードにコピーするテキスト。
アクション - リッチメニューエイリアスID	必須。切り替えるリッチメニューのエイリアスID。

プッシュメッセージ - フレックス

パラメータ

パラメータ	説明
コンタクトID	必須。このパラメータは、チャンネルコンソールに構成されたwebhookから受け取ったIDです。アカウントの追加やメッセージの送信などのアクションが行われると、HTTPS POSTリクエストがwebhook URLに送信されます。
代替テキスト	必須。基本画像の代替テキスト。最大テキスト長は400文字です。代替テキストは通知やチャットリストに表示されます。
コンテンツ	必須。フレックスメッセージコンテナの内容。
テンプレート変数	これらのフィールドは属性を変数名にマッピングし、メッセージデータで使用されます。例えば、items.nameのようにドット表記でネストされたテンプレート変数を名前付けします。詳細については、コネクターテンプレート変数を参照してください。
テンプレート	必須。メッセージデータセクションで参照されるテンプレートを提供します。詳細については、テンプレートガイドを参照してください。 テンプレートは名前で参照され、サポートされるフィールドに二重中括弧で挿入されます。例えば、{{SomeTemplateName}}。

ベンダー文書

• LINE: Developers - Messaging API
• LINE: API Reference - Webhooks
• LINE: API Reference - Push Message
• LINE: API Reference - Send Message Object (Text, Image, Sticker, etc.)

追加の参考文献

• コネクターテンプレート変数.