腾讯元宝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. 微信小程序后台配置

在微信小程序后台添加关联:

  1. 登录 微信小程序后台
  2. 进入"开发" → "开发管理" → "开发设置"
  3. 找到"关联小程序"部分
  4. 点击"关联小程序",填写腾讯元宝小程序的 AppID

4. 配置须知

⚠️ 重要提示

  1. AppID 配置

    • 必须使用实际的元宝小程序 AppID
    • 格式:wx 开头 + 18位字符
  2. 路径配置

    • 根据元宝小程序实际页面路径填写
    • 如果跳转到首页,通常为 pages/index/index
    • 可通过元宝小程序的技术文档确认
  3. envVersion 参数

    • release:正式版
    • trial:体验版
    • develop:开发版
  4. 测试验证

    • 配置完成后,在真机上测试跳转功能
    • 确保能正常打开元宝小程序

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