96 lines
2.3 KiB
Markdown
96 lines
2.3 KiB
Markdown
# 常用语功能说明
|
||
|
||
## 功能概述
|
||
在聊天页面添加了常用语功能，医生可以快速选择并发送预设的常用语内容。
|
||
|
||
## 功能特性
|
||
|
||
### 1. 常用语列表页面 (`common-phrases.vue`)
|
||
- 支持分类管理（文字随访、语音随访、常用回复等）
|
||
- 支持添加、编辑、删除常用语
|
||
- 支持添加自定义分类
|
||
- 点击常用语直接发送到聊天
|
||
|
||
### 2. 聊天输入框集成
|
||
- 在聊天输入框的"更多"面板中添加"常用语"入口
|
||
- 点击后跳转到常用语列表页面
|
||
- 选择常用语后自动返回并发送
|
||
|
||
### 3. 数据持久化
|
||
- 常用语数据存储在MongoDB的`common-words`集合中
|
||
- 支持机构级别和个人级别的常用语
|
||
- 与PC端管理后台数据互通
|
||
|
||
## 文件结构
|
||
|
||
```
|
||
ykt-wx-app/pages/message/
|
||
├── common-phrases.vue # 常用语列表页面
|
||
├── components/
|
||
│ └── chat-input.vue # 聊天输入框组件（已更新）
|
||
├── index.vue # 聊天主页面（已更新）
|
||
└── README.md # 本文档
|
||
|
||
ykt-wx-app/utils/
|
||
└── api.js # API配置（已添加常用语接口）
|
||
|
||
ytk-customer-service/knowledgeBase/common-words/
|
||
└── index.js # 后端常用语接口（已添加小程序接口）
|
||
```
|
||
|
||
## API接口
|
||
|
||
### 1. 获取常用语列表
|
||
```javascript
|
||
api('getCommonPhrases', { corpId })
|
||
```
|
||
|
||
### 2. 保存常用语
|
||
```javascript
|
||
api('saveCommonPhrase', {
|
||
id, // 可选，更新时传入
|
||
corpId,
|
||
userId,
|
||
categoryId,
|
||
content
|
||
})
|
||
```
|
||
|
||
### 3. 删除常用语
|
||
```javascript
|
||
api('deleteCommonPhrase', {
|
||
id,
|
||
corpId
|
||
})
|
||
```
|
||
|
||
### 4. 获取分类列表
|
||
```javascript
|
||
api('getCommonPhraseCategories', { corpId })
|
||
```
|
||
|
||
### 5. 保存分类
|
||
```javascript
|
||
api('saveCommonPhraseCategory', {
|
||
corpId,
|
||
userId,
|
||
name
|
||
})
|
||
```
|
||
|
||
## 使用流程
|
||
|
||
1. 用户在聊天页面点击输入框右侧的"+"按钮
|
||
2. 在弹出的功能面板中点击"常用语"
|
||
3. 跳转到常用语列表页面
|
||
4. 可以切换分类查看不同类型的常用语
|
||
5. 点击任意常用语，自动返回聊天页面并发送该内容
|
||
6. 在编辑模式下可以添加、编辑、删除常用语
|
||
|
||
## 注意事项
|
||
|
||
1. 常用语功能需要用户已登录并有有效的corpId
|
||
2. 如果后端API调用失败，会使用本地模拟数据
|
||
3. 常用语内容最多500字
|
||
4. 分类名称最多6个字
|