常见问题
H5 在微信环境中常见问题
微信环境接入问题
近期（2025年10月23日）由于微信升级了微信外部链接内容管理规范，导致在微信生态下打开七鱼访客端页面（类似这种地址 https://[七鱼企业code].qiyukf.com/client?k=[your_app_key]&wp=1&[其他参数]）时会出现安全警告提示：
可能受到影响的有微信公众号（菜单地址为七鱼访客端H5页面地址）和微信小程序（以Webview方式嵌入七鱼访客端H5页面地址）。
提示：点击【继续访问】时可以正常使用，功能未受到影响。
以下解决方案，供大家参考
解决方案一（推荐）
改对接方式为 微信小程序插件 SDK 接入
解决方案二
- 使用客户自己域名的页面，以 iframe 方式嵌入七鱼访客端页面。
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>demo</title>
<script src="https://qiyukf.com/script/xxx.js"></script>
</head>
<body>
<iframe
id="kfContent"
style="
width: 100%;
height: 100%;
border: none;
margin: 0;
padding: 0;
display: block;
"></iframe>
<script type="text/javascript">
var iframe = document.getElementById('kfContent');
ysf('onready', function() {
ysf('config', {
uid: 'xxx', // 用户唯一标识，必填
success: function() {
// 配置成功后，设置iframe的src
iframe.src = ysf('url');
}
})
});
</script>
</body>
</html>- 也可以使用【浮层模式】，原理和效果与用 iframe 方式嵌入一致：
- 在管理后台可以配置【浮层模式】，如下图所示
- 需要谨慎确认【浮层模式】是否契合用户交互体验，若不契合，请用上述方案1
这篇文档有帮助吗？