2.1 KiB
2.1 KiB
接入 HashMall 商城
独立项目验证完成后,将 src/pages/customer-service、src/components/customer-service、src/api、src/services、src/config、src/adapters 和客服静态资源合入商城工程。
1. 注册页面
建议在商城 pages.json 中将客服页放入分包:
{
"root": "pages/customer_service_package",
"pages": [
{
"path": "chat/chat",
"style": {
"navigationBarTitleText": "在线客服",
"navigationBarBackgroundColor": "#FFFFFF",
"navigationBarTextStyle": "black"
}
}
]
}
合入分包时需要同步调整 hashmall.js 中的 CHAT_ROUTE 和页面内 @/ 引用路径。
2. 初始化商城适配
商城启动后设置登录页。应用级 Authorization 应由商城现有配置注入,不要复制到客服源码或提交 Git。
configureHashMallIntegration({
loginPage: '/pages/login_package/login/login',
appAuthorization: Authorization
})
客服请求会继续读取商城已有的:
- Token:
fcc-token - 用户缓存:
fcc-user-data - 用户详情接口:
/user/getUserInfo
3. “我的”页入口
把当前客服电话弹窗或第三方客服跳转替换为:
openCustomerService()
4. 商品详情入口
openProductConsultation({
goodsId: goods.id,
goodsName: goods.name,
goodsMainGraph: goods.mainGraph,
currentPrice: goods.currentPrice
})
页面只把该对象作为待发送预览。正式发送前后端仍需按 goodsId 校验并补齐可信商品信息。
5. 订单入口
openOrderConsultation({
id: order.id,
orderNo: order.orderNo,
goodsName: order.goodsName,
goodsMainGraph: order.goodsMainGraph,
payAmount: order.payAmount
})
正式发送前后端必须校验订单归属当前登录用户。
6. 小程序配置
微信公众平台需要配置测试或正式环境的:
- request 合法域名
- socket 合法域名
- uploadFile 合法域名
- downloadFile 合法域名
测试环境 API 为 https://api.o.tbmall.xin,Socket 使用对应的 wss://api.o.tbmall.xin。