Echat-访客发送图文消息
1.调用打开对话的api方法时传入visEvt参数
描述:如果访客在对话开始需要选择了某个需要指定的订单或者商品可以使用此方法以图文消息的形式发送给客服
调用api方法打开对话时(如小浮窗方法:ECHAT.customMiniChat(customObj)) 可以传入visEvt
示例代码:
function ECHATCustomMiniChat(visEvt) {
var customObj = {};
visEvt && (customObj.visEvt = JSON.stringify(obj));
ECHAT.customMiniChat(customObj)
}
2.使用对话链接打开对话追加visEvt参数
描述:如果访客在对话的过程中需要选择了某个需要指定的订单或者商品可以使用此方法以图文消息的形式发送给客服 visEvt为json对象。
示例代码:
https://es.echatsoft.com/visitor/pc/chat.html?companyId=#{公司id}&visEvt=#{visEvt}
3.调用方法:ECHAT.pushVisitorEvent(visEvt)
描述:如果访客在对话的过程中需要选择了某个需要指定的订单或者商品可以使用此方法以图文消息的形式发送给客服,
此方法是echat.js提供使用该方法时需要先加载
echat.js,visEvt为json对象。
visEvt图文消各属性描述:
属性名 | 类型 | 必须 | 描述 |
---|---|---|---|
eventId | String | 否 | 图文消息的ID,可自定义前缀或者其他格式来通知业务系统图文消息的消息类型:比如:prod-123 ,order-123等 |
title | String | 否 | 图文消息的标题,如:新款风衣 |
content | String | 否 | 图文消息的描述,支持div span style属性,如:产品的价格,优化信息等 |
imageUrl | String | 是 | 图文消息的图片地址 |
urlForVisitor | String | 否 | 图文消息提供给访客打开的url,可以为空。 url只允许为http[s]协议,支持新窗口打开以及对话窗口的互动窗口打开。协议格式:http(url,openType) 新窗口打开:http('http://m.echatsoft.com','blank') 互动窗口打开:http('http://m.echatsoft.com','inner') 小程序协议:小程序协议:支持保留对话窗口打开小程序页面,支持销毁对话窗口打开小程序页面。 协议格式:xcx(url,openType) 保留对话窗口打开小程序页面:xcx('/pages/addFunction/addFunction','navigateTo') 不保留对话窗口打开小程序页面:xcx('/pages/addFunction/addFunction','redirectTo') 跳转至小程序导航页:xcx('/pages/addFunction/addFunction','switchTab') |
urlForStaff | String | 否 | 图文消息提供给客服打开的url,可以为空。支持http[s]协议和apiUrl协议。 http协议和urlForVisitor参数中的http协议一致. apiUrl协议:apiUrl(pageId,openType). pageId:业务系统的页面ID openType:打开类型 reload:重载打开 hash:不刷新已有的业务系统页面. 重载打开:apiUrl(123,'reload'); hash打开:apiUrl(123,'hash'); |
memo | String | 否 | 图文消息的描述,如:产品评价等 |
visibility | int | 否 | 图文消息的可见范围. 1:访客客服都可见(默认) 2:只有客服可见,访客不可见 |
customizeMsgType | int | 否 | 此消息的类型,关系到消息响应时长和访客会话条数指标。 1:访客/客服消息 2:系统消息 默认:首次打开对话窗口时携带的图文消息为系统消息 |
question | String | 否 | 访客问题,需要发送给机器人的问题,如果是访客消息那么question不能为空,此字段只有给机器人发送消息时有效 |
图文消息效果图示如下:
示例代码:
{
"eventId": "cook1005",
"title": "2016秋冬新品复古欧式感大花苞袖宽松毛衣",
"content": "<div style='color:#666;line-height:20px'>原价:<span style='text-decoration:line-through'>¥414.99</span></div><div style='color:#666;line-height:20px'>促销:<span style='color:red'>¥211.64</span></div><div style='color:#666;line-height:20px'>运费:<span style='color:#ccc'>卖家承担运费</span></div>",
"imageUrl": "https://app.echatsoft.com/getUrl/images/0.jpg",
"urlForVisitor": "http('https://app.echatsoft.com/web/html/demoMall/url/staffUrl/myproduct/?eventId=cook1000','inner')",
"urlForStaff": "http('https://app.echatsoft.com/web/html/demoMall/url/staffUrl/myproduct/?eventId=cook1000','inner')",
"memo": "评价(299)",
"visibility": 1,
"customizeMsgType": 1
}