LINE Harnessの導入方法｜公式CLI・Webhook・LIFF設定を順番に解説
LINE Harnessの導入に必要なLINE側の情報、公式CLI、Webhook・LIFF設定、実機スモークテストまでを公式実装に沿って解説します。 Messaging APIとLINE Login／LIFFの必要情報だけを揃えます。 AIに事前点検とログ監視をさせ、1コマンドで導入します。 CLI出力のURLをLINE側へ戻し、実通信を成立させます。
この記事はHarness Academyの教材データを基に、各Harnessの公式リポジトリにある実装箇所と照合して構成しています。秘密情報や本番データを記事・AIチャットへ貼らず、外部送信は必ず検証対象を限定してください。
この記事の目次
最初に確認すること
- LINE側で必要な4項目を準備する: 公式CLIの対話入力で迷わない
- 公式CLIで一括インストールする: D1、R2、Worker、Admin、Secrets、Ownerを公式手順で作る
- Webhook・LIFF・管理画面を仕上げる: LINEイベントがWorkerへ届き、LIFFが本番URLで開く
- LINE導入のスモークテスト: 「画面が開く」ではなく主要動線が実際に動くと確認する
LINE側で必要な4項目を準備する
Messaging APIとLINE Login／LIFFの必要情報だけを揃えます。
この工程のゴール: 公式CLIの対話入力で迷わない
必要なのはMessaging APIのChannel ID、Channel Secret、長期Access Token、LINE Login Channel ID、そしてLIFF IDです。
LIFFはFull、scopeはopenid/profile/chat_message.write、友だち追加オプションはAggressive、公開済みにします。
手順
1. Messaging API
LINE Official Account ManagerとDevelopers Consoleで3項目を取得します。
2. LINE Login
同じProviderへLINE Login channelを作り、Channel IDを控えます。
3. LIFF
仮URLで作成し、LIFF IDを控えます。実URLはCLI完了後に更新します。
完了条件
- 5項目の取得場所が順番に案内される
- Messaging APIとLINE LoginのChannel IDを混同しない
- LIFFが公開済み
注意: Access TokenとChannel Secretはこの学習サイトやAIチャットへ貼りません。公式CLIへ直接入力します。
Academy教材: LINE Harnessを導入する / Lesson 3-1
公式CLIで一括インストールする
AIに事前点検とログ監視をさせ、1コマンドで導入します。
この工程のゴール: D1、R2、Worker、Admin、Secrets、Ownerを公式手順で作る
LINE公式の入口は npx create-line-harness@latest です。CLI自身がGitHubから本家をcloneし、公式releaseへ固定し、依存関係とCloudflare資源を作成します。
失敗しても同じコマンドを再実行すればstateから再開します。途中で別の手動デプロイを混ぜないことが重要です。
手順
1. 事前点検
Node、Wrangler login、R2有効化、LINEの5項目を確認します。
2. CLI実行
AIにターミナルを監視させ、秘密情報の入力時だけ自分で入力します。
3. 完了情報を保存
Worker URL、Admin URL、初回Owner情報、設定ファイルの場所を安全に控えます。
完了条件
- D1・R2・Worker・Admin Pagesが作成される
- ~/.line-harnessに公式releaseと設定が保存される
- 管理画面URLが表示される
Academy教材: LINE Harnessを導入する / Lesson 3-2
Webhook・LIFF・管理画面を仕上げる
CLI出力のURLをLINE側へ戻し、実通信を成立させます。
この工程のゴール: LINEイベントがWorkerへ届き、LIFFが本番URLで開く
デプロイ後にLINE Developers ConsoleへWorkerのWebhook URLとLIFF endpointを設定します。URLは推測せずCLI出力または保存済みconfigから取得します。
Webhookの検証成功だけで終わらず、友だち追加→D1登録→管理画面表示まで確認します。
手順
1. URLを取得
.line-harness-config.jsonから公開URLのキーだけを確認します。
2. LINEへ設定
Webhook URLとLIFF endpointを更新し、Webhook利用をONにします。
3. 管理画面へログイン
OwnerでログインしLINEアカウントが表示されることを確認します。
完了条件
- LINEのWebhook検証が成功
- LIFFがLINE内で開く
- 管理画面にLINEアカウントが表示される
Academy教材: LINE Harnessを導入する / Lesson 3-3
LINE導入のスモークテスト
本物の検証用アカウントで、受信・保存・返信を一件ずつ追います。
この工程のゴール: 「画面が開く」ではなく主要動線が実際に動くと確認する
最低限、友だち追加、メッセージ受信、プロフィール登録、タグ、テスト送信を確認します。
送信操作は外部作用があるため、必ず検証用の自分のLINEだけを対象にします。
手順
1. 検証対象を限定
自分のテスト用LINE userだけを使います。
2. イベントを発生
友だち追加とテストメッセージを一件送ります。
3. 3地点で照合
Worker log、D1／API、管理画面を照合します。
完了条件
- Webhook受信ログがある
- 友だちが管理画面へ表示される
- 指定した1名だけにテスト送信される
Academy教材: LINE Harnessを導入する / Lesson 3-4
公式ソース
- LINE Harness / packages/create-line-harness/src/steps/prompt.ts — CLIが要求するLINE credentials
- LINE Harness / packages/create-line-harness/src/commands/setup.ts — LIFF設定値
- LINE Harness / README.md — 1コマンドセットアップ
- LINE Harness / apps/worker/src/index.ts — Webhook/API route
- LINE Harness / apps/worker/src/routes — Worker API routes
- LINE Harness / apps/worker/wrangler.toml — D1/R2/Cron bindings
関連ガイド
Academy会員はコピペ実行用プロンプトと演習を開くと、同じ手順をAIへ渡して実機で進められます。