uniapp对接美洽
uniapp 对接美洽客服系统
美洽(MeiQia)是一款在线客服系统,支持多渠道接入。以下是在 uniapp 中对接美洽客服的具体方法:
准备工作
确保已在美洽官网注册账号并创建应用,获取到 App Key。美洽官方提供了 Web SDK 和移动端 SDK,uniapp 可通过 Web SDK 或原生插件方式集成。
Web SDK 集成方式
适用于 H5 平台,通过引入美洽 Web SDK 实现客服功能。
在 index.html 中引入美洽 Web SDK:

<script src="https://sdk.meiqia.com/js/meiqia.js"></script>
在需要调用客服的页面中初始化:
onLoad() {
// 替换为你的美洽 App Key
const appKey = 'YOUR_APP_KEY';
// 初始化美洽
window._MEIQIA('init', appKey);
// 设置用户信息(可选)
window._MEIQIA('metadata', {
name: '用户昵称',
tel: '用户电话'
});
}
调用客服窗口:
openChat() {
window._MEIQIA('showPanel');
}
原生插件集成方式
适用于 iOS 和 Android 平台,需通过原生插件实现。

安装美洽原生 SDK:
- iOS:通过 CocoaPods 集成
MeiqiaSDK - Android:在
build.gradle中添加依赖implementation 'com.meiqia:meiqiasdk:3.+'
创建原生插件:
- 参考 uniapp 原生插件开发文档,封装美洽 SDK 的初始化、登录、打开聊天窗口等方法。
在 uniapp 中调用插件:
const meiQiaModule = uni.requireNativePlugin('MeiQiaModule');
// 初始化
meiQiaModule.init({
appKey: 'YOUR_APP_KEY'
});
// 设置用户信息
meiQiaModule.setUserInfo({
userId: '123',
name: '用户昵称'
});
// 打开客服窗口
meiQiaModule.show();
注意事项
- Web SDK 仅适用于 H5 平台,原生插件方式可覆盖 iOS 和 Android。
- 用户信息设置建议在登录后调用,便于客服识别用户身份。
- 美洽 SDK 支持自定义 UI,可根据需求调整界面样式。
通过以上方法,可在 uniapp 项目中实现美洽客服系统的接入,满足网页和移动端的客服需求。






