LINE Harness セットアップガイド

Lステップ・Utageの代替となるオープンソースLINE CRM。 Cloudflare Workers + D1で動作し、無料枠で約5,000友だちまで対応できます。

---

必要なもの

項目	備考
Node.js 20+
pnpm 9+	npm install -g pnpm
Cloudflare アカウント	無料プランOK
LINE Developers アカウント	developer.line.biz
LINE Messaging API チャネル	Bot用
LINE Login チャネル	UUID取得用（必須）

重要: LINE Login チャネルがないとUUID追跡ができません。必ず2つのチャネルを作成してください。

---

Step 1: LINE Developers でチャネルを作成

Messaging API チャネル

1. LINE Developers Console にログイン
2. プロバイダーを選択（なければ新規作成）
3. 新規チャネル → Messaging API を選択
4. チャネル名・説明を入力して作成
5. 以下をメモ:
   • Channel Secret（基本設定タブ）
   • Channel Access Token（Messaging API タブで発行）

📸 スクショ反映中: LINE Developers Console の Messaging API チャネル作成画面

LINE Login チャネル

1. 同じプロバイダー内で 新規チャネル → LINE Login を選択
2. アプリタイプ: ウェブアプリ を選択
3. 以下をメモ:
   • Channel ID
   • Channel Secret

📸 スクショ反映中: LINE Login チャネルの設定画面

---

Step 2: リポジトリをクローン

git clone https://github.com/nicepkg/line-harness.git
cd line-harness
pnpm install

---

Step 3: Cloudflare D1 データベースを作成

npx wrangler d1 create line-crm

出力される database_id をメモしてください。

apps/worker/wrangler.toml の database_id を更新:

[[d1_databases]]
binding = "DB"
database_name = "line-crm"
database_id = "ここに貼り付け"

スキーマを適用

npx wrangler d1 execute line-crm --remote --file=packages/db/schema.sql

---

Step 4: シークレットを設定

# LINE Messaging API
npx wrangler secret put LINE_CHANNEL_SECRET
npx wrangler secret put LINE_CHANNEL_ACCESS_TOKEN

# LINE Login
npx wrangler secret put LINE_LOGIN_CHANNEL_ID
npx wrangler secret put LINE_LOGIN_CHANNEL_SECRET

# ダッシュボード認証用
npx wrangler secret put API_KEY

各コマンド実行後、対応する値を入力してください。 API_KEY はダッシュボードのログインに使うパスワードです（自分で決めてOK）。

---

Step 5: Worker をデプロイ

cd apps/worker
npx wrangler deploy

デプロイ後に表示されるURLをメモ（例: https://line-crm-worker.your-account.workers.dev）

---

Step 6: LINE Webhook を設定

1. LINE Developers Console → Messaging API チャネル → Webhook設定
2. Webhook URL: https://your-worker.workers.dev/webhook
3. Webhookの利用 をオン
4. 検証 ボタンで疎通確認

📸 スクショ反映中: Webhook URL設定画面と検証成功の表示

---

Step 7: 動作確認

友だち追加テスト

ブラウザで以下のURLにアクセス:

https://your-worker.workers.dev/auth/line?ref=test

LINEログイン画面が表示され、友だち追加が完了します。

注意: QR直追加ではなく、必ず /auth/line 経由で追加してください。これによりUUIDが自動取得されます。

API テスト

curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://your-worker.workers.dev/api/friends/count

{"count": 1} が返ればOK！

---

次のステップ

• ダッシュボードのデプロイ — apps/web をCloudflare Pagesにデプロイ
• シナリオ配信の設定 — ステップ配信でフォローアップ自動化
• リッチメニューの作成 — 顧客状態に応じたUI切り替え
• プラグイン開発 — 外部サービスとの連携

---

よくあるトラブル

問題	対処
Webhook検証が失敗する	URLの末尾が /webhook になっているか確認
友だち追加してもD1に入らない	LINE Login チャネルが正しく設定されているか確認
API_KEYが通らない	wrangler secret put で再設定
デプロイエラー	wrangler login で再認証