腾讯元宝AI接入说明.md
3.81 KB
腾讯元宝AI小程序接入说明
📌 功能说明
点击底部导航栏的"AI答疑"按钮,将跳转到腾讯元宝AI的小程序进行智能问答。
🔧 配置步骤
1. 获取腾讯元宝小程序 AppID
联系公司技术团队或腾讯元宝AI客服,获取:
-
小程序 AppID:格式如
wxXXXXXXXXXXXXXXXX
2. 配置跳转参数
在 src/components/TabBar.vue 文件中,找到 AI 答疑按钮的点击处理函数:
// 文件位置: src/components/TabBar.vue
// 行数: 约第 96 行
} else if (item.key === 'ai') {
Taro.navigateToMiniProgram({
appId: 'wxXXXXXXXXXXXXXXXX', // 👈 替换这里为实际的元宝小程序 AppID
path: 'pages/index/index', // 👈 根据元宝小程序实际路径填写
extraData: {
// 如果需要传递参数,在这里配置
// from: 'manulife-weapp'
},
envVersion: 'release', // 打开正式版
success: (res) => {
console.log('跳转元宝小程序成功', res)
},
fail: (err) => {
console.error('跳转元宝小程序失败', err)
Taro.showToast({
title: '跳转失败,请稍后重试',
icon: 'none'
})
}
})
}
3. 微信小程序后台配置
在微信小程序后台添加关联:
- 登录 微信小程序后台
- 进入"开发" → "开发管理" → "开发设置"
- 找到"关联小程序"部分
- 点击"关联小程序",填写腾讯元宝小程序的 AppID
4. 配置须知
⚠️ 重要提示:
-
AppID 配置
- 必须使用实际的元宝小程序 AppID
- 格式:
wx开头 + 18位字符
-
路径配置
- 根据元宝小程序实际页面路径填写
- 如果跳转到首页,通常为
pages/index/index - 可通过元宝小程序的技术文档确认
-
envVersion 参数
-
release:正式版 -
trial:体验版 -
develop:开发版
-
-
测试验证
- 配置完成后,在真机上测试跳转功能
- 确保能正常打开元宝小程序
5. 常见问题
Q1: 跳转失败,提示"不存在的小程序"
原因: AppID 配置错误或小程序未关联 解决:
- 检查 AppID 是否正确
- 确认已在微信小程序后台关联元宝小程序
Q2: 跳转成功但页面显示错误
原因: path 路径配置错误 解决:
- 联系元宝技术团队确认正确的页面路径
- 或跳转到首页:
pages/index/index
Q3: 用户没有使用过元宝小程序,能否跳转?
答: 可以。微信会自动打开目标小程序。
Q4: 跳转后用户还能返回吗?
答: 可以。用户点击返回按钮会回到本小程序。
📝 配置模板
// 在 TabBar.vue 中的配置示例
Taro.navigateToMiniProgram({
appId: 'wx1234567890abcdef', // 👈 替换为实际 AppID
path: 'pages/chat/index', // 👈 替换为实际路径
extraData: {
source: 'manulife-weapp', // 来源标识
userId: 'xxx', // 如果需要传递用户ID
},
envVersion: 'release',
success: (res) => {
// 跳转成功
console.log('跳转成功', res)
},
fail: (err) => {
// 跳转失败
console.error('跳转失败', err)
Taro.showToast({
title: '跳转失败',
icon: 'none'
})
}
})
✅ 配置检查清单
完成以下步骤后,AI答疑功能即可正常使用:
- 获取腾讯元宝小程序的实际 AppID
- 确认元宝小程序的页面路径
-
修改
src/components/TabBar.vue中的配置 - 在微信小程序后台关联元宝小程序
- 真机测试跳转功能
📞 技术支持
如有问题,请联系:
- 公司技术团队: [联系方式]
- 腾讯元宝AI客服: [官方客服渠道]
文档版本: v1.0 创建日期: 2026-01-30 最后更新: 2026-01-30