七鱼提供微信小程序SDK,可由对接企业前端开发人员通过集成开发实现七鱼访客端的接入。详细开发指南可查看:查看详情
接入说明:
在微信小程序后台 – 设置 – 第三方设置 – 插件管理中申请使用七鱼小程序sdk插件,七鱼提供的微信小程序插件名称为 QIYUSDK。七鱼对外提供名字为chat的页面插件,请确保在配置企业appKey后再跳转到chat页面申请客服。接入代码示例引入插件代码包:使用插件前,使用者要在 app.json 中声明需要使用的插件
{
"plugins": {
"myPlugin": {
"version": "1.1.12", // 推荐使用最新版
"provider": "wxae5e29812005203f"
}
}
}
初始化企业appKey配置企业的appKey采用接口插件对外接口的形式,使用requirePlugin引用插件后调用 _$configAppKey(appKey) 方法。#_$configAppKey(appKey)该接口接受一个appkey参数,支持Promise化使用。
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
appKey | String | 是 | 企业appKey的查看方法见注1 |
var myPluginInterface = requirePlugin('myPlugin');
var appId = '由七鱼后台-微信小程序接入绑定后自动生成,请确认appId在您的绑定列表中。';
myPluginInterface.__configAppId(appId); // 不是微信的appId,是七鱼后台生成的appId
myPluginInterface._$configAppKey('3858be3c20ceb6298575736cf27xxxxxxxx'); // 申请企业的appKey
#_$configAppKeySync(appKey)
_$configAppKey的同步方法。
[注1] 企业appKey的查看方法: 七鱼管理后台 — 在线系统 — 在线接入中查看。
[注2] 此方法为必须调用,请确保在跳转到插件的聊天界面之前配置了正确的appKey。
[注3] 在对接之前请确定在 七鱼管理后台 — 在线系统 — 微信小程序 界面绑定您的微信小程序,否则可能会出现连接不到客服的情况。
[注4] 请注意目前七鱼管理后台appId为自动生成,解绑后重新绑定会生成新的appId,对应的微信小程序插件配置的appId也需要更新。
其中初始化企业appkey和appId获取方式分别如下:
appkey获取:

此处获取的appkey为企业全局唯一接入key,所有接入方式使用的是同一个值。
appid获取方式如下:


跳转客服页面七鱼提供一个名称为chat的插件页面
<navigator url="plugin://myPlugin/chat">
联系客服
</navigator>
此方式接入成功后,访客点击小程序内“联系客服”按钮后会跳转至七鱼的聊天窗口实现与客服的沟通。