七鱼开发文档中心
总览服务端 APIWebiOSAndroid鸿蒙Uniapp微信小程序插件三方接入
常见问题

小程序webview嵌入

用户希望通过微信小程序 webview 的方式,嵌入网页端的七鱼客服,下面则提供完整的接入流程。

1.首先从 七鱼后台-在线客服-设置-会话流程-会话分配 中获取到访问企业客服的二级域名的 H5 链接如下:

2.在微信小程序后台下载校验文件

登录小程序管理后台,在开发-开发设置-业务域名,修改业务域名(点击修改,此时不需要添加七鱼二级域名),点击下载校验文件,请下载保存。

注意下载下来的校验文件,一定要传原始的文件给七鱼,有时候文件名已经存在,会被浏览器重命名这样是不行的,例如:1RvsgswGaM(1).txt,这样是不可以的

3.打开七鱼后台,在线客服-在线接入-网站-第三方认证文件设置中,将步骤2中的校验文件在该页面上传,并保存

4.添加七鱼业务域名(注意是二级域名)

登录小程序管理后台,在开发-开发设置-业务域名,修改业务域名,配置步骤1 中的H5链接,注意是添加二级域名,例如https://ysftest4.qiyukf.com

5.调整接入方式,新增 subdomain 参数将七鱼的一级域名转为二级域名

web-sdk 接入方式

<script>
	(function (w, d, n, a, j) {
		w[n] = w[n] || function () {
			(w[n].a = w[n].a || []).push(arguments);
		};
		j = d.createElement('script');
		j.async = true;
		j.src ='https://qiyukf.com/script/xxxxx.js?subdomain=1'; // 添加 subdomain 参数
		d.body.appendChild(j);
	})(window, document, 'ysf');
</script>

npm 接入方式

import YSF from '@neysf/qiyu-web-sdk';

YSF.init('xxxxx', {
	subdomain: 1, // 添加 subdomain 参数
}).then(ysf => {
	ysf('open');
}).catch(error => {
	console.log('sdk加载失败---', error);
});

6.配置完成

7.支付宝/抖音小程序操作类似,请参考以下官方文档进行配置

这篇文档有帮助吗?

目录