#10 アンケート→口コミAI自動生成
既存アンケート機能
全体フロー
SMS経由のフロー
管理者がSMSを送信 → ハッシュ付きリンク生成 → お客様がリンクを開く → アンケート回答 → SMS状態更新
SMSステータス遷移:
| ステータス | コード | 説明 |
|---|---|---|
| 送信済み | 0 | SMSが送信された |
| アンケート開封 | 5 | お客様がアンケートリンクを開いた |
| アンケート回答完了 | 6 | お客様がアンケートに回答した |
| Google口コミへリダイレクト | 7 | お客様が口コミボタンをクリックした |
アンケート画面（既存）
実際のアンケートフォームの動作を確認できます。★評価の平均に応じて口コミボタンの表示/非表示が切り替わります。
1QR読取
2アンケート
3完了
4クチコミ
店舗に設置されたQRコードをスキャン
https://example.com/questionnaire/abc123
設問テンプレート（デフォルト）
| No | 設問 | 種別 | 選択肢 |
|---|---|---|---|
| 1 | お客様の性別をお選びください | 選択式 | 男性 / 女性 |
| 2 | 当店のサービスで改善点が御座いましたら | 選択式 | 店内の清潔感 / 接客 / 値段 / 雰囲気 / 質 / その他 |
| 3 | 当店を何で知りましたか | 選択式 | Googleマップ / HP / SNS / ホットペッパー / チラシ / 看板を見て / 知人からの紹介 |
| 4 | 本日ご利用されたサービスをお選びください | 選択式 | Aプラン / Bプラン / Cプラン |
| 5 | スタッフの接客はいかがでしたか | ★評価 | 1〜5 |
| 6 | 店内の清潔感はいかがでしたか | ★評価 | 1〜5 |
| 7 | サービスの価格はいかがでしたか | 選択式 | 安い / 高い / ちょうどいい |
| 8 | サービスを受けられてみて、ご満足いただけましたか | ★評価 | 1〜5 |
| 9 | また来店したいと思いますか | 選択式 | はい / いいえ / わからない |
| 10 | ご意見、ご要望がございましたらお申し付けください | 記述式 | — |
口コミボタン表示ロジック
- ★評価の設問（設問5, 6, 8）の平均値を計算
- 平均値 ≥
display_google_review_button_at（デフォルト: 3）の場合、口コミボタンを表示 - サンクス画面のデフォルトテキスト:
- ヘッダー: 「アンケートにご協力いただきありがとうございました。」
- 本文: 「またのご利用・ご来店を心よりお待ちしております。」
- 口コミ依頼: 「よろしければ、Googleのページにクチコミをお願いできますか？」
- ボタン: 「クチコミを書く」
分析機能
| 指標 | SMS経由 | QRコード経由 |
|---|---|---|
| 表示回数 | views_by_sms | views_by_qr_code |
| 回答数 | answers_by_sms | answers_by_qr_code |
| 口コミボタンクリック | clicks_on_review_button_by_sms | clicks_on_review_button_by_qr_code |
新機能: AI口コミ自動生成
概要
| 項目 | 内容 |
|---|---|
| 課題ID | ISS-010 |
| 課題名 | アンケート結果からAIで口コミ内容を自動生成 |
| カテゴリ | AI |
| 優先度 | 中 |
| ステータス | 未着手 |
背景
既存のアンケート機能では、高評価のお客様にGoogleレビューページへの誘導を行っているが、実際に口コミを書いてもらえる率は低い。アンケート回答内容をもとにAIが口コミ文を下書き生成し、お客様の手間を軽減することで口コミ投稿率の向上を目指す。
拡張フロー
AI生成画面モック
アンケート選択→AI生成→トーン変更→投稿の一連のフローが動作します。
アンケート
ご来店ありがとうございますスタッフの接客はいかがでしたか
★★★★★
店内の清潔感はいかがでしたか
★★★★★
サービスにご満足いただけましたか
★★★★★
また来店したいと思いますか
ご意見・ご要望
要件
| No | 要件 | 詳細 |
|---|---|---|
| 1 | AI口コミ生成 | アンケート回答データを入力としてAIで口コミ文を生成 |
| 2 | 編集・確認UI | 生成された口コミ文の編集・確認画面 |
| 3 | トーン調整 | 生成文のトーン・スタイル調整オプション（丁寧/カジュアル/ビジネス） |
| 4 | 投稿フロー | 生成後にそのまま口コミとして投稿できるフロー |
技術検討
| 項目 | 検討内容 |
|---|---|
| AI API | Claude / OpenAI の選定 |
| プロンプト設計 | アンケート項目→自然な口コミ文への変換 |
| トーン制御 | プロンプトでのトーン指定方法 |
| 品質管理 | 生成文のクオリティチューニング |
トーン例
| トーン | 特徴 | 使用シーン |
|---|---|---|
| 丁寧 | 敬語、フォーマル | 一般的な口コミ |
| カジュアル | 口語、親しみやすい | 若年層向け店舗 |
| ビジネス | 簡潔、客観的 | ビジネスサービス |
影響範囲
画面
| 画面名 | 変更内容 |
|---|---|
| アンケートサンクス画面 | AI口コミ生成セクション追加 |
| 口コミ生成画面 | 新規画面（トーン選択、プレビュー、編集） |
API
| エンドポイント | 変更内容 |
|---|---|
| AI生成API | 口コミ文生成エンドポイント新設 |
| ゲストAPI | アンケート回答後のAI生成フロー対応 |
DB
| テーブル | 変更内容 |
|---|---|
mappy_questionnaire_screen_contents | AI生成設定の追加 |
| AI生成ログテーブル（新規） | 生成履歴の保存 |