开发文档

如何使用?

展开对话窗口

*如果您需要按自己的需求展开对话窗口,比如点击网站中的某个按钮。调用JS函数_MICHAT.startChat()方法即可点击展开对话窗口

示例:

                                                
                                                    <body>
                                                    <input type=" button" onclick="_MICHAT.startChat()" value="展开对话窗口" />
                                                    </body>
                                                
                                            

展开迷你对话窗口

*如果您需要按自己的需求展开迷你对话窗口,比如点击网站中的某个按钮。调用JS函数_MICHAT.mini.startChat()方法即可展开迷你对话窗口

示例:

                                                
                                                    <body>
                                                    <input type=" button" onclick="_MICHAT.mini.startChat()" value="展开迷你对话窗口" />
                                                    </body>
                                                
                                            

最小化迷你窗口

*如果您需要将迷你窗口最小化,调用JS函数_MICHAT.mini.showBar()即可最小化迷你窗口

示例:

                                                
                                                    <body>
                                                    <input type=" button" onclick="_MICHAT.mini.showBar()" value="最小化迷你窗口" />
                                                    </body>
                                                
                                            

对话窗口语言设置

*如果您需要设置聊天窗口的语言,请在网页插件代码第三行后面编写JS函数_MICHAT("lng", "cn");来设置,cn为简体中文;big5为繁体中文;en为英文

示例:

                                                
                                                    <script type="text/javascript">
                                                        _MICHAT("lng", "cn"); // cn-简体中文;big5-繁体中文;en-英文 
                                                    </script>
                                                
                                            

指定客服或客服组

*如果您需要指定对话客服或分组,请在网页插件代码第三行后面编写JS函数_MICHAT("oid", "客服id"); 来设置指定客服,编写JS函数 _MICHAT("gid", "客服组id");来设置指定客服组

示例:

                                                
                                                     <script type="text/javascript">
                                                        _MICHAT("oid", "客服id"); // 指定客服

_MICHAT("gid", "客服组id"); // 指定客服组
</script>

传递访客资料

*如果需要指定访客id、头像、昵称等,可以通过页面输出指定JS变量来实现。

示例:

                                                
                                                     <script type="text/javascript">
                                                    var  _visitorid_ = ' 访客id ';   // 字母数字组成,长度大于6位
                                                    
var _visitorname_ = ' 访客名称 ';
var _avatar_ = ' 访客头像 ';
var _ctag_ = ' 自定义传参,主要应用于企业信息对接功能 ';
</script>

提交表单

*如果您需要将表单数据传递给客服端,显示聊天内容中,调用JS函数 _MICHAT.submitForm(form)将自定义表单数据提交即可。

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                             var form = {
                                                             " 姓名 ": " 访客填写的姓名 ",
                                                             " 电话 ": " 访客填写的电话 ",
                                                             " 备注 ": " 访客填写的备注 "
                                                             };
                                                             if (typeof _MICHAT != ' undefined ') {
                                                              _MICHAT.submitForm( form );
                                                             }
                                                         </script>
                                                    
                                                
                                            

自定义消息

*如果您希望客人在进入对话时自动推送一条消息,以便客服在后台及时预判访客需要咨询的内容,可以在网页插件代码之前输出JS变量_custommsg_

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                            // 文本消息
                                                            var  txt = { "type": 0, "content": encodeURIComponent(" 文本消息内容")};
                                                            var  _custommsg_  = encodeURIComponent( JSON .stringify( txt ));
                                                            // 或卡片消息
                                                            var  card = {"type": 6, "content": encodeURIComponent(JSON.stringify({"  Title":"标题","Description":"描述","Imgurl":"图片地址","Url":"跳转链接"}))};
                                                            var _custommsg_ = encodeURIComponent( JSON .stringify( card ));
                                                         </script>
                                                    
                                                
                                            

隐藏浮动图标

*如果您想禁止显示浮动图标,请在网页插件代码第三行后面编写JS函数_MICHAT("floatdisabled", 1);

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                        _MICHAT("floatdisabled", 1);  // 隐藏浮动图标
                                                         </script>
                                                    
                                                
                                            

隐藏邀请框

*如果您想禁止显示邀请框,请在网页插件代码第三行后面编写JS函数_MICHAT("invitedisabled", 1);

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                            _MICHAT("invitedisabled", 1);  // 隐藏邀请框
                                                         </script>
                                                    
                                                
                                            

隐藏显示迷你对话窗口

*如果您想隐藏显示迷你对话窗口,请在网页插件代码第三行后面编写JS函数_MICHAT("minidisabled", 1);

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                            _MICHAT("minidisabled", 1);  // 隐藏显示迷你对话窗口
                                                         </script>
                                                    
                                                
                                            

反复弹出迷你窗口

*如果您想开启迷你框反复弹出,请在网页插件代码第三行后面编写JS函数_MICHAT("repeatmini", 5); ,设置 >0 表示迷你关闭后多久再次弹出,单位秒;

示例:


                                                
                                                    
                                                         <script type="text/javascript">
                                                        _MICHAT("repeatmini", 5);  // 反复弹出迷你窗口 >0 表示迷你关闭后多久再次弹出,单位秒;
                                                         </script>
                                                    
                                                
                                            

当前页面弹出窗口

*如果您希望点击浮动图标或邀请框始终在当前页面显示迷你对话窗口,请在网页插件代码第三行后面编写JS函数_MICHAT("alwaysmini", 1);

示例:

                                                
                                                    
                                                         <script type="text/javascript">
                                                        _MICHAT("alwaysmini", 1);  // 单击浮动图标或邀请框时,在当前页面弹出迷你窗口
                                                         </script>
                                                    
                                                
                                            

指定客服或客服组

*您可以通过添加 URL 参数,实现对话链接由指定客服或客服组来接待。oid 参数,参数值为客服id,gid 参数,参数值为客服组id

示例:

                                                
                                                     // oid参数,参数值为客服id 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&oid=客服id 
                                                     // gid参数,参数值为客服组id 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&gid=客服组id 
                                                
                                            

传递访客资料

*如果您想在聊天链接上传递访客资料的话可以添加以下参数 visitoridvisitornameavatarctag

示例:

                                                
                                                      // visitorid参数,参数值为访客id ,由字母数字组成,长度大于6位 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&visitorid=访客id 

                                                     // visitorname参数,参数值为访客名称 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&visitorname=访客名称 

                                                     // avatar参数,参数值为访客头像 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&avatar=访客头像 

                                                     // ctag参数,参数值为参数值为自定义传参,主要应用于企业信息对接功能 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&ctag=自定义参数值 
                                                
                                            

指定对话窗口语言

*如果您需要指定对话窗口的语言,可以添加语言参数。 cn 为简体中文; big5 为繁体中文; en 为英文

示例:

                                                
                                                      // 例如设置简体中文  
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&cn 
                                                
                                            

自定义消息

*如果您想实现发送自定义消息功能,可以通过添加URL参数custommsg,参数值为自定义消息内容

示例:

                                                
                                                     // custommsg参数,参数值为自定义文本消息内容 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&custommsg=encodeURIComponent(txt) 
                                                     // 自定义文本消息 
                                                    var  txt = { "type": 0, "content": encodeURIComponent(" 文本消息内容")};

                                                     // custommsg参数,参数值卡片消息 
                                                    http://www.域名.net/Web/im.aspx?_=t&accountid=######&custommsg=encodeURIComponent(card) 
                                                     // 自定义卡片消息 
                                                    var  card = {"type": 6, "content": encodeURIComponent(JSON.stringify({"  Title":"标题","Description":"描述","Imgurl":"图片地址","Url":"跳转链接"}))};