微信小程序对接使用指南
# 微信小程序接入指南
——通过这篇文章了解如何对接微信小程序，如何在管理工作台中管理微信小程序的对话
# 微信小程序渠道的作用
我们希望您在了解如何对接微信小程序渠道之前，了解接入该渠道的场景及用途：
● 客户关闭小程序后，客服依旧可以发送消息。
● 留言转工单功能，满足客服非及时沟通场景。
# 准备工作
在开始对接之前，您需要做一些准备工作，同时需要了解微信小程序渠道限制条件：
# ● 前提条件
拥有微信小程序
# ● 限制条件
1.客户关闭小程序后，支持客服在 48 小时之内发送 5 条消息给用户。
2.支持从微信小程序渠道发送文本、图片、文件、音频、视频、表情、小程序卡片和机器人消息
3.机器人消息不支持触发多轮问题
# 如何完成渠道对接
了解准备工作之后，我们需要实操来完成对接：
# ● 了解对接方式
1.微信小程序渠道对接方式分为两种：扫码接入和手动接入。
2.推荐扫码接入：扫码接入操作简单，不易出错。使用手动接入的客户同时对接了其他系统，会产生access token冲突，导致消息发不过来
# ● 扫码接入
1.登录智齿管理工作台，在对接渠道设置菜单中，点击【添加渠道】，找到微信小程序。
2.点击【微信小程序】，选择【扫码接入】方式。
3.进入扫码授权页面，点击【点击开始授权】。
4.进入扫码页面，使用手机微信扫码授权。
5.扫码授权后，将跳转回智齿管理工作台中，完成微信小程序扫码接入。
# ● 手动接入
1.点击【微信小程序】，选择【手动接入】方式。
2.进入参数配置页面，页面内容从微信公众平台获取。
3.使用小程序管理员账号扫码登录微信公众平台（登录地址：https://mp.weixin.qq.com/ ）。
4.从【开发管理-开发设置】中找到小程序ID与小程序密钥，将小程序ID填入智齿微信小程序配置页面中。
5.点击重置，获取小程序密钥，将密钥输入智齿微信小程序配置页面中。
6.找到微信公众平台的【开发管理-开发设置-消息推送】，开启消息推送。
7.将智齿管理工作台-微信小程序配置页面中的【API接受地址】，复制URL填写到微信公众平台消息推送页面。
8.Token需要管理员自己设置，随机生成EncodingAESKey，消息添加方式选择【安全模式】，数据格式选择【XML】
9.从微信公众平台消息推送页面中Token、EncodingAESKey填写到智齿微信小程序配置页面。
10.点击【确认并添加】，完成微信小程序手动接入。
# 微信小程序渠道支持的其他设置
以上步骤操作后，您将完成渠道对接，下面会为您介绍该渠道的其他设置：
注：如果您的企业已经升级并使用千人千面接待方案，请通过对应菜单进行接待模式的配置。详见：接待方案使用指南
| 序号 | 功能 | 能力介绍 |
|---|---|---|
| 1 | 对接渠道设置 > 客服接待模式 | 支持智能客服（人机配合方式）、仅人工客服、仅机器人客服。 |
| 2 | 对接渠道设置 > 机器人设置 | 机器人设置 支持切换渠道接待的机器人、未知回答说辞、未识别文件说辞。 |
| 3 | 对接渠道设置 > 转人工设置 | 支持机器人理解回答、引导回答、未知回答转人工，关键词转人工。 |
| 4 | 对接渠道设置 > 人工客服设置 | 支持分组接待、人工客服欢迎语、人工不在线说辞、客服昵称显示控制。 |
| 5 | 对接渠道设置 > 满意度评价 | 支持5星和10分评价模板，支持客服主动邀评、客户主动评价。 |
| 6 | 留言设置 > 留言转工单 | 留言转工单模式支持按该渠道配置留言模板；触发留言场景包括转人工场景没有“在线”状态客服消息提示留言、排队人数超限直接消息提示留言、排队中消息提示留言，非人工服务时间消息提示留言。 |
| 7 | 统计监控 > 渠道筛选 | 机器人统计与人工客服统计中支持按微信小程序渠道筛选。 |
| 8 | 开放接口 | 支持客户、客服发送小程序卡片接口，获取小程序用户昵称及头像、指定接待对接代码。 |
# FAQ
● 问：客服工作台如何获取客户的昵称和头像？
答：您需要代码嵌入的方式对接，才能获取。参考开发文档：小程序获取用户昵称和头像 (opens new window)
● 问：如何使用微信小程序卡片？
答：我们支持接口对接的方式发送小程序卡片。参考开发文档：小程序卡片对接文档 (opens new window)
● 问：两种对接方式有什么不同？
答：推荐使用扫码授权接入，原因有两点。第一扫码接入操作便捷，不易出错；第二手动接入的客户如果溶蚀对接了其他系统，会产生 access_token 冲突，导致消息发不出来。