SMS送信管理
概要
顧客へのSMS送信、テンプレート管理、送信ログの確認を行う画面。口コミ促進やアンケート配信に利用する。
SMS送信フォーム
| 項目 | 種別 | 必須 | 備考 |
|---|---|---|---|
| 電話番号 | テキスト | YES | 送信先電話番号 |
| メッセージ | テキストエリア | YES | 送信メッセージ内容 |
| テンプレート | セレクトボックス | NO | 保存済みテンプレートから選択 |
| ロケーション | セレクトボックス | YES | 送信元GBPロケーション |
送信ログ一覧
| No | 表示項目 | 表示形式 | 説明 |
|---|---|---|---|
| 1 | 送信日時 | YYYY/MM/DD HH:mm | created_at |
| 2 | 電話番号 | 文字列 | phone_number |
| 3 | メッセージ | テキスト | message（一部表示） |
| 4 | ステータス | バッジ | 送信成功/失敗 |
| 5 | SMSタイプ | バッジ | sms_type |
| 6 | フィードバック | バッジ | feedback_type |
| 7 | ロケーション名 | 文字列 | 紐付きGBPロケーション |
テンプレート管理
| 項目 | 種別 | 必須 | 備考 |
|---|---|---|---|
| テンプレート名 | テキスト | YES | テンプレートの識別名 |
| メッセージ本文 | テキストエリア | YES | テンプレート本文 |
操作
- SMS送信: メッセージを送信
- テンプレート作成/編集/削除
- 送信ログの閲覧・削除
- 残クォータ確認
- 送信統計の表示
データベース
| No | 表示項目 | テーブル名（論理） | テーブル名（物理） | カラム名（物理） |
|---|---|---|---|---|
| 1 | 電話番号 | SMSログ | mappy_sms_logs | phone_number |
| 2 | メッセージ | SMSログ | mappy_sms_logs | message |
| 3 | ステータス | SMSログ | mappy_sms_logs | status |
| 4 | ロケーション | GBPロケーション | mappy_gbp_locations | title |
| 5 | ユーザー | ユーザ | mappy_users | login_id |
API
| メソッド | エンドポイント | 説明 |
|---|---|---|
| POST | /api/mappy/sms/send | SMS送信 |
| GET | /api/mappy/sms/logs | 送信ログ取得 |
| DELETE | /api/mappy/sms/logs/{smsLog} | 送信ログ削除 |
| GET | /api/mappy/sms/remaining-quota | 残クォータ確認 |
| GET | /api/mappy/sms/templates | テンプレート取得 |
| POST | /api/mappy/sms/templates | テンプレート保存 |
| POST | /api/mappy/sms/statistic | 送信統計取得 |