18 lines
1.1 KiB
Markdown
18 lines
1.1 KiB
Markdown
# Phase 6：转人工工单 + 手动回复（企业微信发消息）
|
||
|
||
## 新增内容
|
||
|
||
- **创建工单**：`POST /api/tickets`，body `session_id`、`reason`；插入 `tickets` 表并将对应会话 `status` 置为 `transferred`。
|
||
- **手动回复**：`POST /api/tickets/reply`，body `session_id`、`content`；根据会话查 `external_user_id`，调用企业微信「发送消息给外部联系人」API 下发文本。
|
||
- **WeCom API 封装**：`app/services/wecom_api.py`，`get_access_token`、`send_text_to_external`，带超时与重试。
|
||
|
||
## 验证
|
||
|
||
1. 在管理后台进入某会话详情，点击「转人工/创建工单」→ 应提示工单已创建。
|
||
2. 在输入框输入内容点「发送」→ 客户端（企微侧）应收到该条消息（需配置好 `WECOM_CORP_ID`、`WECOM_SECRET`、`WECOM_AGENT_ID`）。
|
||
|
||
## 配置与接口说明
|
||
|
||
- 发消息接口以当前实现为准（如 `externalcontact/message/send` 或 `externalcontact/send_message_to_user`）；若企微返回 4xx/5xx，请对照官方文档调整 URL 与参数。
|
||
- `sender` 当前使用 `WECOM_AGENT_ID`；若需指定客服成员，可后续增加 `WECOM_SENDER_USERID` 配置。
|