LINEコマンドBOT mini V0.2 正式仕様書

2026年5月11日

1. 文書概要

1-1. システム名

LINEコマンドBOT mini V0.2

1-2. 目的

LINE公式アカウントに届くメッセージに対して、
Google Cloud Run 上のWebhook受け口で受信し、
Googleスプレッドシートのコマンド辞書を参照して、
FAQ対応・案内・資料請求導線・問い合わせ導線を自動返答する。

1-3. V0.2の位置づけ

V0.1は、Webhook受信、本文取得、固定文返信、スプレッドシート辞書参照、ログ追記までを確認した動作確認版である。
V0.2はそこから発展し、顧客対応の質向上、営業時間外の取りこぼし防止、導線強化、運用改善を狙う実務利用版のファーストバージョンとする。

1－4　仕様リソース

そのタイミングで

現在の main.py
requirements.txt
Procfile
仕様書
記事メモ

2. システムコンセプト

2-1. 基本コンセプト

本システムは、単なるテキスト応答BOTではなく、以下を実現する。

よくある質問への一次自動応答
資料請求・問い合わせ・相談への導線提供
顧客対応の即時性向上
営業時間外の取りこぼし防止
未登録質問の収集によるBOTの継続改善

2-2. 想定価値

本システムの導入によって、以下の価値を提供する。

基本的な質問に自動対応できる
スタッフの定型対応負荷を減らせる
顧客の迷いを減らせる
購入・問い合わせ意欲が高い利用者を逃しにくくなる
利用ログから顧客ニーズを把握できる

3. 対象範囲

3-1. V0.2で実装するもの

LINE公式アカウントからのテキストメッセージ受信
commands シートを使った辞書型返信
enabled による有効/無効切り替え
別名コマンド登録
help / ヘルプ による案内
FAQ向け基本応答
資料請求・問い合わせ・相談向けURL返答
fallback応答
クイックリプライ
logs シートへのログ追記
未登録語句の記録
Cloud Run 上での実行

3-2. V0.2で実装しないもの

ユーザー状態管理
シナリオ分岐型会話
画像返信
PDFファイル送信そのもの
複数ユーザー属性ごとの出し分け
AIによる自然言語解釈
LINE以外のチャネル連携
STEPmini連携本体
MySQL移行

4. 想定利用シーン

4-1. 想定業種

小規模事業者
教室・スクール
サロン
B2Bサービス事業者
Web制作会社
システム会社
士業
相談型サービス業

4-2. 利用目的

FAQの一次回答
営業時間・所在地・料金等の案内
資料請求導線
問い合わせ導線
相談申込導線
よくある問い合わせの自動化

5. システム構成

5-1. 使用サービス

LINE Official Account
LINE Messaging API
Google Cloud Run
Google Sheets API
Googleスプレッドシート

5-2. 構成概要

LINE → Cloud Run → commandsシート参照 → LINE返信 → logsシート追記

5-3. 採用理由

Webhook受信口はCloud Runの方がLINEのWebhook要件に適合しやすい
辞書・ログはスプレッドシートで運用性を確保しやすい
初期構築と将来拡張のバランスがよい

6. スプレッドシート設計

6-1. 使用シート

commands
logs

6-2. `commands` シート仕様

6-2-1. 用途

返信辞書を管理するメインシート。

6-2-2. カラム定義

列	項目名	必須	内容
A	command	必須	受信語句
B	reply_text	必須	一致時の返信文
C	enabled	必須	TRUE/FALSE
D	note	任意	管理用メモ
E	category	任意	FAQ、資料請求、問い合わせ等の分類
F	quick_reply_group	任意	クイックリプライ表示用グループ名
G	aliases	任意	別名コマンド。カンマ区切りを想定
H	sort_order	任意	help表示順の制御

6-2-3. 基本運用

enabled=TRUE の行だけ有効
command は原則重複不可
aliases に別名を持てる
category により分類可能
V0.2では aliases がある場合、別名でも一致判定する

6-3. `logs` シート仕様

6-3-1. 用途

受信内容と応答結果を保存する。

6-3-2. カラム定義

列	項目名	必須	内容
A	timestamp	必須	処理日時
B	user_id	任意	LINEユーザーID
C	received_text	必須	受信した文字列
D	matched_command	任意	一致したコマンド
E	reply_text	任意	実際に返した文章
F	status	必須	matched / fallback / error
G	note	任意	備考・エラー内容

6-3-3. 役割

利用傾向の確認
未登録語句の確認
よくある質問の抽出
運用改善の材料化

7. コマンド処理仕様

7-1. 対象メッセージ

LINEのテキストメッセージのみ対象
画像、動画、音声、位置情報等は対象外

7-2. 入力正規化

受信文字列に対して以下を行う。

前後空白除去
改行除去または単一スペース化
英数字は必要に応じて小文字化

7-3. 一致判定

優先順位は以下のとおり。

command 完全一致
aliases 内の別名一致
一致なしなら fallback

7-4. fallback時の返答

一致しない場合は、固定のfallbackメッセージを返す。

例

その言葉は未登録です。help と送ると、使える言葉を確認できます。

7-5. fallback時のログ

未登録語句として logs に記録する。

8. help / ヘルプ機能仕様

8-1. 役割

初回利用者が何を送ればよいかを理解できるようにする。

8-2. 応答内容

help または ヘルプ を受けた際、以下の形式で返す。

例

`使えるご案内：
・営業時間
・所在地
・資料請求
・問い合わせ
・相談

知りたい言葉をそのまま送ってください。`

8-3. 表示対象

enabled=TRUE の中から、ヘルプに出したいものを抽出
将来 category や sort_order により制御可能とする

9. FAQ機能仕様

9-1. 最低限の対象

V0.2では最低5〜10件程度のFAQを想定する。

例

営業時間
所在地
料金
対応内容
導入方法
資料請求
問い合わせ

9-2. 目的

基本質問の即時対応
電話やメールの一次負荷軽減
営業時間外対応

10. 顧客導線機能仕様

10-1. 資料請求導線

資料請求 に対し、資料ページURLや案内ページURLを返す。

10-2. 問い合わせ導線

問い合わせ に対し、問い合わせフォームURL等を返す。

10-3. 相談導線

相談 や 見積 に対し、相談申込ページや予約導線を返す。

10-4. 目的

購入意欲の高い利用者を取りこぼさない
その場で次アクションへ進ませる
BOTをCV導線にする

11. クイックリプライ仕様

11-1. V0.2での導入目的

入力負荷を減らし、初心者でも使いやすくする。

11-2. 対象

まずは help 実行時に使用する。

11-3. 候補例

営業時間
所在地
資料請求
問い合わせ

11-4. 制約

最大候補数はLINE仕様に従う
V0.2では固定候補または簡易生成とする

12. ログ・分析仕様

12-1. 保存内容

受信語句
一致コマンド
返答文
成功/未登録/エラー

12-2. 活用方法

よく使われたコマンドの把握
未登録質問の追加
FAQ改善
顧客ニーズ把握

12-3. V0.2の範囲

保存のみ
集計表示は手動確認ベース
将来版で集計シートやダッシュボード化を検討

13. Cloud Run 側処理仕様

13-1. 役割

Webhook受信
本文抽出
commands 読込
一致判定
LINE返信
logs 追記

13-2. 認証

LINE返信用：LINE_CHANNEL_ACCESS_TOKEN
Sheets用：Cloud Runのサービスアカウント

13-3. 環境変数

LINE_CHANNEL_ACCESS_TOKEN
SPREADSHEET_ID

14. エラー時の扱い

14-1. 想定エラー

LINE返信失敗
スプレッドシート読込失敗
スプレッドシート追記失敗
トークン不正
権限不足

14-2. 方針

エラー時も可能な限りHTTP 200は返す
Cloud Runログに詳細を出す
logs に status=error で記録を試みる

14-3. エラーメモ

note にエラー概要を残す

15. 非機能要件

15-1. 性能

commands はリクエスト単位でまとめ読み
1件ごとの行検索ではなく、辞書化して照合
logs は末尾追記のみ

15-2. 運用性

辞書編集はスプレッドシートで可能
非エンジニアでも文言更新可能
ログを視覚的に確認可能

15-3. 拡張性

将来の MySQL 移行を見据えた項目構成
STEPmini統合、画像返信、資料リンク強化を見据える

16. 導入効果

16-1. 顧客向け効果

質問への即時回答
営業時間外の案内
資料請求・問い合わせの機会損失低減
顧客満足度向上

16-2. 運営側効果

定型質問の削減
スタッフ負荷軽減
BOT改善の材料収集
ニーズ把握

17. V0.2の成功条件

V0.2は、以下を満たせば成功とする。

commands シートの内容どおりに返信できる
enabled によるON/OFFが機能する
help が実用的な案内になる
資料請求・問い合わせ導線を返せる
logs に履歴が残る
未登録語句を拾える
クイックリプライで基本導線を補助できる

18. 今後の拡張候補

V0.3候補

画像返信
PDF・資料リンク強化
複数メッセージ返信
カテゴリ別ヘルプ
未登録語句ランキング集計

V0.4候補

STEPmini統合
LINE入口 → メール育成導線
タグ付けや関心別分岐
管理ダッシュボード

本格版候補

MySQL移行
状態管理
複雑検索
本格的な問い合わせ受付BOT化

19. 結論

V0.2は、
「FAQ＋一次受付＋CV導線＋改善ログ」
を一体化した、実務利用のファーストバージョン とする。

V0.1が技術実証版であったのに対し、V0.2は
顧客サービス向上、取りこぼし防止、運用改善につながる業務ツール
として位置づける。

バックアップ　CODE　　BOT　V0.1　パイソンとrequirements Procfile

apicecorp@cloudshell:~/line-webhook (mythic-rain-317213)$ cat main.py
cat requirements.txt
cat Procfile
from flask import Flask, request, jsonify
import os
import json
import requests
from googleapiclient.discovery import build
import google.auth
from datetime import datetime, timezone

app = Flask(__name__)

LINE_CHANNEL_ACCESS_TOKEN = os.environ.get("LINE_CHANNEL_ACCESS_TOKEN")
SPREADSHEET_ID = os.environ.get("SPREADSHEET_ID")

COMMANDS_RANGE = "commands!A2:D"
LOGS_RANGE = "logs!A:G"

def get_sheets_service():
    credentials, _ = google.auth.default(
        scopes=["https://www.googleapis.com/auth/spreadsheets"]
    )
    return build("sheets", "v4", credentials=credentials)

def load_commands():
    service = get_sheets_service()
    result = service.spreadsheets().values().get(
        spreadsheetId=SPREADSHEET_ID,
        range=COMMANDS_RANGE
    ).execute()

    values = result.get("values", [])
    commands = {}

    for row in values:
        command = row[0].strip() if len(row) > 0 else ""
        reply_text = row[1] if len(row) > 1 else ""
        enabled = row[2].strip().upper() if len(row) > 2 else "FALSE"
        note = row[3] if len(row) > 3 else ""

        if command and enabled == "TRUE":
            commands[command] = {
                "reply_text": reply_text,
                "note": note
            }

    return commands

def append_log(user_id, received_text, matched_command, reply_text, status, note=""):
    service = get_sheets_service()
    timestamp = datetime.now(timezone.utc).astimezone().strftime("%Y-%m-%d %H:%M:%S")

    values = [[
        timestamp,
        user_id,
        received_text,
        matched_command,
        reply_text,
        status,
        note
    ]]

    body = {"values": values}

    service.spreadsheets().values().append(
        spreadsheetId=SPREADSHEET_ID,
        range=LOGS_RANGE,
        valueInputOption="RAW",
        insertDataOption="INSERT_ROWS",
        body=body
    ).execute()

def send_reply(reply_token, text):
    url = "https://api.line.me/v2/bot/message/reply"
    headers = {
        "Content-Type": "application/json",
        "Authorization": f"Bearer {LINE_CHANNEL_ACCESS_TOKEN}"
    }
    payload = {
        "replyToken": reply_token,
        "messages": [
            {
                "type": "text",
                "text": text
            }
        ]
    }

    response = requests.post(url, headers=headers, json=payload)
    print("reply status:", response.status_code)
    print("reply body:", response.text)

@app.route("/", methods=["GET", "POST"])
def webhook():
    if request.method == "GET":
        return "LINE webhook server is running", 200

    body = request.get_json(silent=True) or {}
    print(json.dumps(body, ensure_ascii=False, indent=2))

    events = body.get("events", [])
    if not events:
        return jsonify({"status": "ok", "message": "no events"}), 200

    event = events[0]

    if event.get("type") != "message":
        return jsonify({"status": "ok", "message": "not message event"}), 200

    message = event.get("message", {})
    if message.get("type") != "text":
        return jsonify({"status": "ok", "message": "not text message"}), 200

    user_text = (message.get("text") or "").strip()
    reply_token = event.get("replyToken")
    user_id = event.get("source", {}).get("userId", "")

    try:
        commands = load_commands()

        if user_text in commands:
            reply_text = commands[user_text]["reply_text"]
            matched_command = user_text
            status = "matched"
        else:
            reply_text = "その言葉は未登録です。help と送ると、使える言葉を確認できます。"
            matched_command = ""
            status = "fallback"

        send_reply(reply_token, reply_text)
        append_log(user_id, user_text, matched_command, reply_text, status)

    except Exception as e:
        error_message = f"error: {str(e)}"
        print(error_message)
        try:
            append_log(user_id, user_text, "", "", "error", error_message)
        except Exception as log_error:
            print(f"log error: {log_error}")

    return jsonify({"status": "ok"}), 200



======  以上が　Python  V01
======   requirements.txt  =====
flask==3.0.3
gunicorn==22.0.0
requests==2.32.3
google-api-python-client==2.149.0
google-auth==2.35.0


=======  Procfile
web: gunicorn -b :$PORT main:app

👤 筆者プロフィール｜DXジュン（Apice Technology 代表）

「tecn」を運営している DXジュン です。
Apice Technology株式会社の代表として、20年以上にわたり Web制作・業務改善DX・クラウドシステム開発に携わっています。

普段は企業の現場課題に寄り添いながら、
在庫管理システム／予約システム／求人管理／受発注システム／クラウドソーシング など、中小企業の仕事を“ラクにするツール”を作っています。

tecn では、業務改善のリアルや、Webシステムの仕組み、そして「技術が生活をちょっと楽しくしてくれる」ような日常×デジタルのヒントをゆるく発信しています。

現在の注力テーマは 在庫管理のDX化。 SKU・JAN・棚卸・リアルタイム連携など、現場で役立つ情報を発信しつつ、自社のクラウド在庫管理システムも開発・提供しています。
無料在庫管理システムの提供も行っております。
下記より申し込んでください。

小規模店舗・倉庫向けのシンプルな在庫管理ツールを無料公開中

無料在庫管理システムを申し込む

🔗 Apice Technology（会社HP）
🔗 tecn トップページ
🔗 在庫管理システムの機能紹介
🔗 無料在庫管理システムのご提供

記事があなたの仕事や生活のヒントになれば嬉しいです。コメント・ご相談があればお気軽にどうぞ！

よかったらシェアしてね！

URLをコピーしました！

URLをコピーしました！

アピス　LINEコマンドBOTmini V0.1 の次の展開とV0.2 の予定機能