meiqia_sdk_flutter
Android | |
iOS |
安装
dependencies:
meiqia_sdk_flutter: ^1.0.5
使用美洽
1.初始化
String? errorMsg = await MQManager.init(appKey: '开发者自己的 appKey');
if(errorMsg == null) {
// success
}
2.启动对话界面
MQManager.instance.show();
常见使用场景
开发者的 App 有自己的账号系统,希望每个账号对应不同的顾客,有不同的聊天记录。那就需要开发者在启动对话的时候,绑定账号:
MQManager.instance.show(customizedId:'开发者自己系统的用户 id'); // 相同的 id 会被识别为同一个顾客
开发者希望顾客上线的时候,能够上传(或者更新)一些用户的自定义信息:
Map<String,String> info = {
'name': '富坚义博',
'avatar': 'https://s3.cn-north-1.amazonaws.com.cn/pics.meiqia.bucket/1dee88eabfbd7bd4',
'gender': '男',
'tel': '13888888888',
'技能1': '休刊'
};
// 设置顾客信息 PS: 这个接口只会生效一次,如果需要更新顾客信息,需要设置 update = true
// PS: 如果客服在工作台更改了顾客信息,更新顾客信息覆盖之前的内容
ClientInfo clientInfo = ClientInfo(info: info, update: false);
MQManager.instance.show(clientInfo: clientInfo);
指定客服分配
// agentId 可以从工作台查询
MQManager.instance.show(scheduledAgent: agentId );
指定客服分组分配
// groupId 可以从工作台查询
MQManager.instance.show(scheduledGroup: groupId);
设置预发送消息
// 预发送文字消息
MQManager.instance.show(preSendTextMessage: '我是预发送文字消息');
// productCard 构造
ProductCard productCard = ProductCard(
title: '商品的标题',
pictureUrl: 'https://file.pisen.com.cn/QJW3C1000WEB/Product/201701/16305409655404.jpg', // 商品图片的链接
description: '商品描述的内容',
productUrl: 'https://meiqia.com', // 商品链接
salesCount: 50); // 销量
// 预发送文字消息
MQManager.instance.show(preSendProductCard: productCard);
设置链接点击监听
// ios 目前只支持商品卡片的点击回调
// 开发者自己处理 url 点击,注意:设置监听回调后,将不再跳转网页.如果需要跳转,开发者需要自行处理
MQManager.instance.show(linkTapCallback: (url) {
debugPrint('clicked url = $url');
});
配置聊天页面 UI 样式
Style style = Style(
navBarBackgroundColor: '#ffffff', // 设置导航栏的背景色
navBarTitleTxtColor: '#ffffff', // 设置导航栏上的 title 的颜色
enableShowClientAvatar: false, // 是否支持当前用户头像的显示
enableSendVoiceMessage: true, // 是否支持发送语音消息
);
MQManager.instance.show(style: style);
关闭聊天页面
MQManager.instance.dismiss();