# LINE

独自の**LINE公式アカウント**を接続すると、LINEの会話がアプリに流れ込み、AIエージェントが返信できるようになります。LINE Messaging APIの認証情報（チャネルシークレットとアクセストークン）を貼り付け、Webhook URLを1つ設定するだけで接続でき、コーディングは不要です。

---

## LINE連携とは？

LINE連携機能を使用すると、所有する**LINE公式アカウント（OA）**をプラットフォームにリンクできます。これには、LINEアプリで手動で入力する代わりに、メッセージを自動的に送受信するためのLINE公式システムである「LINE Messaging API」を利用します。OAを友だち追加したユーザーとの1対1のチャットがアプリ内で利用可能になり、AIエージェント、一斉配信、共有インボックスがそれらのチャット上で機能します。

TelegramやWhatsApp Webとは異なり、これは**公式**の連携です。LINE独自のMessaging APIを使用しているため安定しており、LINEの規約にも準拠しています。LINEにはサードパーティ製ツール用のワンクリック「接続」ボタンがないため、セットアップ時に一度だけ公式アカウントの認証情報を貼り付ける必要があります。

> **利用可能性について。** LINE公式アカウントは日本、台湾、タイ、インドネシアで最も一般的であり、**EUでは利用できません**。このチャネルを使用するには、サポートされている地域で登録されたLINE公式アカウントが必要です。

---

## 始める前に

LINEのコンソールで3つのものを作成（または使用）します。これは約5分で完了する一度限りのセットアップです。

1. **LINE公式アカウント**（[LINE Official Account Manager](https://manager.line.biz)で作成）。まだお持ちでない場合は、LINEビジネスIDでログインし、**新しいアカウントを作成**してください。名前を入力し、簡単なフォームに記入します。
2. そのOA用の**Messaging APIチャネル**。最も簡単な方法は、OAマネージャー内から有効にすることです（以下のステップ1を参照）。最初に開発者コンソールで手動でチャネルを作成する必要はありません。プロンプトが表示されたら、既存の**プロバイダー**を選択するか、新しく作成してください。
3. そのチャネルから、アプリに貼り付けるための3つの値を取得します。
   - **チャネルID**（[基本設定]タブ）— 任意、情報のみ
   - **チャネルシークレット**（[基本設定]タブ）
   - **チャネルアクセストークン** — [Messaging API]タブで発行する長期有効なトークン

標準（未認証）の公式アカウントの場合、ビジネス書類は不要で、LINEビジネスIDがあれば作成できます。認証済みアカウント（青いバッジ）は任意であり、一部の地域でのみ提供されています。

---

## LINEのセットアップ

### ステップ1：公式アカウントでMessaging APIを有効にする

1. [LINE Official Account Manager](https://manager.line.biz)にログインします（または、先に新しい公式アカウントを作成します）。
2. OAを開きます。
3. 右上の**[設定]**をクリックします。
4. 設定メニューで**[Messaging API]**をクリックします。
5. ステータスが**[無効]**になっているので、クリックして有効にします。
6. このチャネルの**プロバイダー**（所有する企業や開発者）を選択します。まだお持ちでない場合は、**新しいプロバイダーを作成**してから確定します。

### ステップ2：LINE Developersコンソールから認証情報を取得する

Messaging APIを有効にすると、[LINE Developers Console](https://developers.line.biz/console/)のプロバイダー配下にチャネルが作成されます。

1. **開発者アカウント / プロバイダー**を開きます。
2. **Messaging APIチャネル**をクリックします。
3. **[基本設定]**タブを開き、**チャネルID**と**チャネルシークレット**をコピーします。
4. **[Messaging API]**タブを開き、長期有効な**チャネルアクセストークン**を発行（または再発行）してコピーします。

> これらの値は手元に控えておいてください。次にアプリに貼り付けます。

### ステップ3：アプリでLINEを接続する

1. 左側のサイドバーで、下部付近にある **Settings** をクリックします。
2. Settingsの左側のレールで、**Channels** の下にある **Channels** をクリックします。
3. **LINE** カードを見つけて、**Connect** をクリックします。
4. 必要に応じて、**Channel ID** を貼り付けます（情報提供のみ）。
5. **Channel secret** を貼り付けます。
6. **Channel access token** を貼り付けます。
7. **Connect** をクリックします。
8. アプリがLINEで認証情報を検証し、**"Connected to: \<your OA name\>"** と表示されます。認証情報が間違っている場合はエラーが表示されます。その際は、LINE Developers Consoleでアクセストークンを再発行して、もう一度試してください。


### ステップ4：LINEでWebhook URLを設定する

接続後、アプリに**[LINEでの設定を完了]**セクションが表示され、**Webhook URL**が表示されます。これをコピーしてください。（Webhook URLは単なるWebアドレスです。これをLINEに貼り付けることで、新しいメッセージをどこに自動送信すべきかをLINEに伝えます。）次に、Messaging APIチャネルの**LINE Developers Console**で以下を行います。

1. **[Messaging API]**タブを開きます。
2. URLを**[Webhook URL]**に貼り付けます。
3. **[更新]**をクリックします。
4. **[Webhookの利用]**を**[オン]**にします。

### ステップ5：公式アカウントマネージャーの設定を修正する（重要）

デフォルトでは、LINE公式アカウントはチャットや*自動応答*を自身で処理するため、メッセージがAIに届かなくなります。[LINE Official Account Manager](https://manager.line.biz)に戻り、OA設定を開いて以下のように設定してください。

| 設定 | 必要な値 | 理由 |
|---|---|---|
| **チャット** | **オン** | チャットをオンにして会話が流れるようにします（チャットフィルターを使用可能にします）。 |
| **応答モード** | **Bot** | API（AIエージェント）がメッセージを処理できるようにします。「チャット」のみのモードではメッセージが吸収されてしまいます。 |
| **応答時間 / 自動応答メッセージ** | **オフ** | LINE独自の自動応答を無効にし、AIが応答を処理するようにします（「二重返信」の最大の原因です）。 |
| **あいさつメッセージ** | **オフ** | LINE独自のあいさつメッセージがAIと競合するのを防ぎます。 |
| **Webhook** | **オン** | LINEがメッセージをアプリに転送できるようにします。 |

> アプリでアカウントが**チャットモード**であるという警告が表示された場合は、ここで**Botモード**に切り替えてください。切り替えないと、ボットはメッセージの受信や送信ができません。

### ステップ6：ボットをテストする

1. 別の電話（自分のLINEアプリなど）から、公式アカウントを友だち追加して**メッセージを送信**します。
2. アプリを開き、**[チャット]**に移動します。受信したメッセージが会話リストに表示されます。
3. AIエージェントがこのチャネルを処理している場合、テストメッセージに対して**自動的に返信**するのが確認できます。

Webhookが設定され、上記のトグルが正しく設定されて接続が完了すると、LINEアカウントは[チャネル]ページで**接続済み**と表示され、AIが受信メッセージに応答するようになります。

---

## 料金

LINEはアプリ内で**無料**のチャネルです。メッセージごとの料金や、当社からの月額接続料は発生しません。ただし、**LINE独自のプラン**には、地域やアカウントタイプによって異なる、*プッシュ*メッセージ（能動的な送信）の月間制限があることに注意してください。顧客からメッセージが届いた直後に送信される返信はLINE上で無料ですが、能動的な送信や一斉配信はLINEプランの割り当て分としてカウントされます。

---

## メディアメッセージ

受信した写真、動画、ボイスメッセージ、ファイル、スタンプ、位置情報は認識されるため、AIはメディアが送信されたことを把握します（会話に短い注釈が追加されます）。このバージョンでは、AIからの送信返信は**テキストと画像**となります。長い返信は、LINEの5,000文字制限に合わせて自動的に切り詰められます。

---

## セッション管理

### 接続ステータスの確認

LINEの接続ステータスは、**Channels**ページの**LINE**カードに表示されます：

| ステータス | 意味 |
|---|---|
| **接続済み** | LINE公式アカウントがこのアカウントにリンクされています |
| **未接続** | 接続が設定されていません |

このカードは、チャンネルページを開くたびに、アカウントの**チャットモード**設定を再確認します。LINEアカウントがチャットモードに戻っている場合（ボットの送受信が停止します）、カードに黄色の警告が表示され、LINE Official Account Managerで**ボットモード**に戻すよう促されます。そこでステップ5のトグルを再確認すると、次回のアクセス時に警告が消えます。

### 切断

**LINE**カードを開いて**管理**をクリックし、開いたパネルで**切断**をクリックして、**LINEを削除しますか？**を確認します。これにより、当方側の接続が削除されます。LINEからのイベント送信を完全に停止するには、LINE Developersコンソールで**Webhookの使用**をオフにする（またはWebhook URLを削除する）必要もあります。

---

## 制限事項

- **1つの接続につき1つの公式アカウント。** 各公式アカウントは個別に接続してください。1つの公式アカウントは1つのアカウントにのみリンク可能です。
- **テキストと画像の送信。** AIはテキストと画像で返信します。リッチな「Flex」メッセージ、テンプレート、カルーセルメッセージはこのバージョンでは送信されません。
- **地域。** LINE公式アカウントはEUでは利用できません。サポートされている地域（日本、台湾、タイ、インドネシアなど）の公式アカウントが必要です。
- **返信タイミング。** LINEの無料即時返信には短い有効期限があります。期限を過ぎて送信されたメッセージは、自動的に（クォータを消費する）プッシュメッセージとして配信されます。

---

## トラブルシューティング

### 接続時に認証情報が拒否される

- **Messaging API**チャネルを作成したことを確認してください（「LINEログイン」ではありません）。
- Messaging APIタブで**チャネルアクセストークン（ロングターム）**を再発行し、新しい値を貼り付けてください。
- 基本設定タブから**チャネルシークレット**をコピーしたことを確認してください（チャネルIDではありません）。

### ボットが応答しない

- デベロッパーコンソールとOAマネージャーの両方で**Webhook**が**オン**になっていることを確認してください。
- **Webhook URL**がアプリに表示されているものと一致していることを確認してください。
- OAマネージャーで**応答モード**が**チャット**ではなく**Bot**になっていることを確認してください。

### 顧客に2回返信が届く

- OAマネージャーで**自動応答メッセージ**と**あいさつメッセージ**を**オフ**にしてください。LINEの組み込み自動応答がAIの返信と同時に送信されています。

### アプリにメッセージが届かない

- 連絡先が**公式アカウントを友だち追加**していることを確認してください（LINEは友だちからのメッセージのみを配信します）。
- Webhook URLを再確認し、**Webhookの利用**がオンになっていることを確認してください。

---

## ベストプラクティス

- **OAマネージャーの設定を完了する**（Botモード、Webhookオン、あいさつ・自動応答オフ）— セットアップの問題のほとんどはこれらが原因です。
- **迅速に返信する** — LINEの無料枠内で返信を行い、プッシュ枠を節約しましょう。
- **アクセストークンを安全に保管する** — トークンを持つ者は誰でもあなたの公式アカウントとしてメッセージを送信できます。漏洩した場合はデベロッパーコンソールで再発行してください。