#前言
近期，环信热心开发者-穿裤衩闯天下使用环信IM开发了一款实时聊天应用，包含简单的服务器端，现在正式开源给小伙伴们。感兴趣的同学可以一起搞一下哦，详细介绍请往下看。






  上代码
服务器：VMServer
客户端：VMMatch
 
 #VMMatch
猿匹配 —— 国内首个程序猿非严肃婚恋交友应用，让我们一言不合就来场匹配吧
 
#介绍#
首先说下中文名：为什么叫这个名字呢，因为这是一个程序猿(媛)之间匹配交流的应用啊其实这是一个使用环信 IM 开发的一款开源聊天项目，涵盖了时下流行的一些聊天元素，同时已将 IM 功能封装为单独库，可以直接引用，方便使用
项目还处在初期阶段，还有许多功能需要实现，有兴趣的可以一起来
项目资源均来自于互联网，如果有侵权请联系我
 
 #下载体验
猿匹配 小米商店 审核中
猿匹配 Google Play
 
  #项目截图

























  
 #开发环境
项目基本属于在最新的Android开发环境下开发，使用Java8的一些新特性，比如Lambda表达式，
然后项目已经适配Android6.x以上的动态权限适配，以及7.x的文件选择，和8.x的通知提醒等；
· Mac OS 10.14.4
· Android Studio 3.3.2
  #项目模块儿
本项目包含两部分：
一部分是项目主模块app，这部分主要包含了项目的业务逻辑，比如匹配、信息修改、设置等
另一部分是封装成library的vmim，这是为了方便大家引用到自己的项目中做的一步封装，不用再去复杂的复制代码和资源等，
只需要将vmim以module导入到自己的项目中就行了，具体使用方式参见项目app模块儿；
 
  #功能与 TODO
IM部分功能
· [x] 链接监听
· [x] 登录注册
· [x] 会话功能
      。[x] 置顶
      。[x] 标为未读
      。[x] 删除与清空
      。[x] 草稿功能
· [x] 消息功能
      。[x] 下拉加载更多
      。[x] 消息复制（仅文字类消息）
      。[x] 消息删除
      。[x] 文本+Emoji消息收发
      。[x] 大表情消息收发
      。[x] 图片消息
        ~[x] 查看大图
        ~[ ] 保存图片
      。[x] 语音消息
        ~[x] 语音录制
        ~[x] 语音播放（可暂停，波形待优化）
        ~[x] 听筒和扬声器播放切换
      。[x] 语音实时通话功能
      。[x] 视频实时通话功能
      。[x] 通话过程中的娱乐消息收发
        ~[x] 骰子
        ~[x] 石头剪刀布
        ~[x] 大表情
      。[x] 昵称头像处理（通过回调实现）
App部分功能
· [x] 登录注册（包括业务逻辑和 IM 逻辑）
· [x] 匹配
      。[x] 提交匹配信息
      。[x] 拉取匹配信息
· [x] 聊天（这里直接加载 IM 模块儿）
· [x] 我的
      。[x] 个人信息展示
      。[x] 上传头像
      。[x] 设置昵称
      。[x] 设置签名
· [x] 设置
      。[x] 个人信息设置
      。[x] 通知提醒
      。[x] 聊天
      。[ ] 隐私（随业务部分一起完善）
      。[ ] 通用（随业务部分一起完善）
      。[ ] 帮助反馈（随业务部分一起完善）
      。[x] 关于
      。[x] 退出
· [ ] 社区
      。[ ] 发布
      。[ ] 评论
      。[ ] 收藏
      。[ ] 关注
发布功能
· [x] 多渠道打包
· [x] 签名配置
· [x] 开发与线上环境配置
· [x] 敏感信息保护
 
  #配置运行
1.首先复制config.default.gradle到config.gradle
2.配置下config.gradle环信appkey以及bugly统计Id
3.正式打包需要配置下签名信息，同时将签名文件放置在项目根目录
 
  #参与贡献
如果你有什么好的想法，或者好的实现，可以通过下边的步骤参与进来，让我们一起把这个项目做得更好，欢迎参与
1.Fork本仓库
2.新建feature_xxx分支 (单独创建一个实现你自己想法的分支)
3.提交代码
4.新建Pull Request
5.等待我们的Review & Merge
 
 #关联项目
服务器端由nodejs实现，地址见这里 VMServer
 
  #VMServer
是为Android开源项目VMMatch项目（中文名猿匹配）实现的服务端
 
  #简介
这个项目包含两部分
· 根目录：服务逻辑及API接口实现
· client目录：前端界面，和服务器端代码端放置在同一仓库下（暂未实现）
 
 #使用
简单介绍下运行环境及部署方法
1.安装nodejs开发时使用的是v10.16.0版本
2.需要安装mongodb并启动，开发使用版本4.0.10
3.下载项目到服务器，可以下载压缩包，或者用git clone命令
4.复制config_default.js到config.js，可根据自己需要修改配置文件
5.安装依赖npm install
6.全局安装pm2npm install pm2 -g 
7.运行 vmshell.sh
 




扫码备注【开源项目】邀你加入环信开源社群
 
转载自https://blog.melove.net/develop-open-source-im-match-and-server/ 
  查看全部

npm install

npm install pm2 -g

第一次搞小程序，老板让我实现一个聊天室功能，压力山大啊。
花了几天时间研究比较了一下方案，最后基于环信的小程序SDK 开发了一个聊天室。
 
准备工作
下载环信 小程序demo+sdkgit clone https://github.com/easemob/webim-weixin-xcx创建一个文件夹，将 demo 中的文件 comps、images、sdk、utils 拷贝到新的文件，文件目录说明



集成
登录环信没什么可说的，这里选择的是使用 username/password 登录，和demo中的一样，文件没有进行任何更改


在app.js 中注册的 WebIM.conn.listen, 然后在 登陆成功的回调 onOpened 设置的跳转页面，并将登陆的 username 赋给 myName，传到新的页面中使用


修改 roomlist.js 获取聊天室列表，是分页获取的，这里先偷个懒，获取了第一页 20 个聊天室


然后将listChatrooms() 分别在onLoad、onShow 内，更改下，将原有的 listGroups() 替换掉然后在roomlist.wxml 修改对应的 变量绑定名称





demo中的group.js 中，获取到的是当前登陆账号已加入的群组，咱们做的是聊天室功能，所以需要有一个加入的操作，找roomlist.js 中找到 into_room: function (event)，然后填写加入聊天室的方法， 我是直接在当前这个里面加的跳转到聊天页面，并将当前登陆的IDmyName，聊天室IDgroupID，聊天室名称your 传给新页面


Ex：监听是否加入聊天室成功的回调是在 onPresence 中，type:memberJoinChatRoomSuccess，正常是监听这个回调跳转页面，有点麻烦就直接这样吧到会话页面后，需要修改一下对应的消息格式，在comps/chat/suit 目录下，将里面的文件对应的 js 文件根据文档给聊天室发送消息 格式进行修改，聊天室消息和群组消息不同，所以我目前是直接将getSendToParam()、isGroupChat() 注释，改成下面这样，demo 中下面还有代码的，这里就用 …… 代替了





就这样了，简单集成聊天室功能，demo中的UI 是开源的，可以根据自己的需求更改~下面是具体实现过程。代码也放在github 上了，有需要的兄弟自取。demo下载地址：https://github.com/lizgDonkey/room-xcx 查看全部

今天你看直播了吗？拥有10亿微信生态用户的小程序已经成为了继移动互联后的又一个现象级风口，随着微信小程序对外开放实时音视频录制及播放等更多连接能力，小程序与直播强强联合，在各行各业找到了非常多的玩法，小程序直播相比微信直播和APP直播更加简洁、流畅、低延时、多入口等众多优势迅速向商业直播领域及泛娱乐直播领域蔓延。从小游戏、内容付费、工具、大数据、社交电商创业者到传统品牌商们，都在努力搭上小程序直播这辆快车，以免错过微信生态里新的流量洼地。
 





作为一名环信生态圈资深开发者，本着对技术的热衷，对环信的眷恋和对党的忠诚，基于环信即时通讯云写了“直播购物小程序”，目前项目源码已全部免费开放，希望对有需求的企业和开发者提供一个思路和参考。
直播购物小程序源码github地址：https://github.com/YuTongNetworkTechnology/wechat_live/tree/master 
git打不开可直接点下面链接下载


小程序直播demo_2018-06-21.zip







直播购物小程序运行预览图 
 
小程序体验指南（仅需两步）：
 
1、下载微信小程序开发工具，下载地址：https://developers.weixin.qq.c ... .html 
 




2、导入源码：将附件的源码解压直接导入 







环信小程序直播技术文档
一、 使用的技术
1、 环信IM直播室。
2、 微信小程序实时音视频播放组件live-player。
3、 推流软件（obs、易推流）等推流。
4、 视频流服务器（UCLOUD、七牛、腾讯）等视频流服务器。
二、 系统使用流程。
1、 视频推流软件将视频流推到流服务器。
2、 打开视频直播demo小程序注册环信账号。
3、 进入软件直播室进行测试。
三、 技术流程及使用的SDk
1、 注册环信账号
打开https://www.easemob.com/ 环信官网，点击右上角注册按钮，选择[注册即时通讯云]




填写对相关信息进行注册





注册成功后进行登录




注：新注册用户需进行账号的认证。
2、 直播应用创建
登录成功点击应用列表选择创建应用




输入应用名称等信息
 





创建成功后点击应用进入





需要注意的是应用的OrgName 和AppName这两个是以后都需要用到的两个参数变量




3、 直播创建
1）在创建直播之前需要对应用进行设置首先需要设置应用的直播流地址
第一步获取应用管理员的Tokencurl -X POST "https://a1.easemob.com/[应用OrgName]/[应用AppName]/token" -d '{"grant_type":"client_credentials","client_id":"[应用client_id]","client_secret":"[应用] client_secret"}'返回格式{
"access_token":"YWMtWY779DgJEeS2h9OR7fw4QgAAAUmO4Qukwd9cfJSpkWHiOa7MCSk0MrkVIco",
"expires_in":5184000,
"application":"c03b3e30-046a-11e4-8ed1-5701cdaaa0e4"












第二步设置直播流地址curl -X POST -H "Authorization: Bearer [管理员Token]" " https://a1.easemob.com/[应用OrgName]/[应用AppName]/liverooms/stream_url -d '{"pc_pull":"[pc拉流地址]","pc_push":"[pc推流地址]","mobile_pull":"[手机拉流地址]","mobile_push":"[手机推流地址]"}'"成功返回格式：{
"action": "post",
"application": "e1a09de0-0e03-11e7-ad8e-a1d913615409",
"uri": "http://127.0.0.1:8080/easemob- ... ot%3B,
"entities": [ ],
"data": {
"pc_pull": true,
"mobile_push": true,
"mobile_pull": true,
"pc_push": true
},
"timestamp": 1494084474885,
"duration": 1,
"organization": "easemob-demo",
"applicationName": "chatdemoui"
}












2)创建主播
点击IM用户





点击注册IM用户





填写用户信息





创建用户的过程同样也可以通过REST API形式进行curl -X POST -i " https://a1.easemob.com/[应用OrgName]/[应用AppName]/users" -d '{"username":"[用户名]","password":"[密码]"}'
注：应用必须为开放注册





将注册的用户添加为主播curl -X POST -H "Authorization: [管理员Token]" https://a1.easemob.com/[应用OrgName]/[应用AppName]/super_admin -d'{"superadmin":"[IM用户名]"}'返回结果示例：{
"action": "post",
"application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
"uri": "http://127.0.0.1:8080/easemob- ... ot%3B,
"entities": [ ],
"data": {
"result": "success"
},
"timestamp": 1496236798886,
"duration": 0,
"organization": "easemob-demo",
"applicationName": "chatdemoui"
}












3）创建直播
点击直播





点击新建房间





填写房间信息




创建房间同时也可以使用REST API形式进行详情可以查看http://docs.easemob.com/im/live/server-integration环信官方文档。
4、 小程序demo集成使用
小程序直播购物demo集成官方WebIM SDK详情请查看https://github.com/easemob/webim-weixin-xcx
Demo具体配置如下
打开demo 下sdk配置文件





修改appkey为自己应用的appkey





打开pages/live/index.js修改房间默认拉流地址及直播间房间号





四、 扩展说明
Demo中房间为固定测试房间,实际使用中应获取环信直播的房间信息及房间列表。具体如下：
获取直播间列表：curl -X GET -H "Authorization: Bearer [用户Token]" https://a1.easemob.com/[应用OrgName]/[应用AppName]/liverooms?ongoing=true&limit=[获取数量]&cursor=[游标地址（不填写为充开始查询）]
响应：{
"action": "get",
"application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
"params": {
"cursor": [
"ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MzE"
],
"ongoing": [
"true"
],
"limit": [
"2"
]
},
"uri": "http://127.0.0.1:8080/easemob- ... ot%3B,
"entities": [ ],
"data": [
{
"id": "1924",
"chatroom_id": "17177265635330",
"title": "具体了",
"desc": "就咯",
"startTime": 1495779917352,
"endTime": 1495779917352,
"anchor": "wuls",
"gift_count": 0,
"praise_count": 0,
"current_user_count": 8,
"max_user_count": 9,
"status": "ongoing",
"cover_picture_url": "",
"pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1",
"pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1",
"mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1",
"mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1"
},
{
"id": "1922",
"chatroom_id": "17175003856897",
"title": "香山",
"desc": "随便",
"startTime": 1495777760957,
"endTime": 1495777760957,
"anchor": "sx001",
"gift_count": 0,
"praise_count": 8,
"current_user_count": 1,
"max_user_count": 3,
"status": "ongoing",
"cover_picture_url": "http://127.0.0.1:8080/easemob- ... ot%3B,
"pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1",
"pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1",
"mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1",
"mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1"
}
],
"timestamp": 1496303336669,
"duration": 0,
"organization": "easemob-demo",
"applicationName": "chatdemoui",
"cursor": "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6NDk",
"count": 2
}












获取直播间详情：curl -X GET -H "Authorization: Bearer [用户Token]" " https://a1.easemob.com/[应用OrgName]/[应用AppName]/[房间id]/status"响应：{
"action": "get",
"application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5",
"uri": "http://127.0.0.1:8080/easemob- ... ot%3B,
"entities": [ ],
"data": {
"liveRoomID": "1946",
"status": "ongoing"
},
"timestamp": 1496234759930,
"duration": 0,
"organization": "easemob-demo",
"applicationName": "chatdemoui",
"count": 0
}














 
使用环信直播购物小程序遇到任何问题欢迎跟帖讨论。 查看全部

今天你看直播了吗？

curl -X POST "https://a1.easemob.com/[应用OrgName]/[应用AppName]/token" -d '{"grant_type":"client_credentials","client_id":"[应用client_id]","client_secret":"[应用] client_secret"}'

{

  "access_token":"YWMtWY779DgJEeS2h9OR7fw4QgAAAUmO4Qukwd9cfJSpkWHiOa7MCSk0MrkVIco",

  "expires_in":5184000,

  "application":"c03b3e30-046a-11e4-8ed1-5701cdaaa0e4"

curl -X POST -H "Authorization: Bearer [管理员Token]"  " https://a1.easemob.com/[应用OrgName]/[应用AppName]/liverooms/stream_url -d '{"pc_pull":"[pc拉流地址]","pc_push":"[pc推流地址]","mobile_pull":"[手机拉流地址]","mobile_push":"[手机推流地址]"}'"

{

    "action": "post", 

    "application": "e1a09de0-0e03-11e7-ad8e-a1d913615409", 

    "uri": "http://127.0.0.1:8080/easemob- ... ot%3B, 

    "entities": [ ], 

    "data": {

        "pc_pull": true, 

        "mobile_push": true, 

        "mobile_pull": true, 

        "pc_push": true

    }, 

    "timestamp": 1494084474885, 

    "duration": 1, 

    "organization": "easemob-demo", 

    "applicationName": "chatdemoui"

}

curl -X POST -i " https://a1.easemob.com/[应用OrgName]/[应用AppName]/users" -d '{"username":"[用户名]","password":"[密码]"}'

curl -X POST -H "Authorization: [管理员Token]"  https://a1.easemob.com/[应用OrgName]/[应用AppName]/super_admin -d'{"superadmin":"[IM用户名]"}'

{

    "action": "post", 

    "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", 

    "uri": "http://127.0.0.1:8080/easemob- ... ot%3B, 

    "entities": [ ], 

    "data": {

        "result": "success"

    }, 

    "timestamp": 1496236798886, 

    "duration": 0, 

    "organization": "easemob-demo", 

    "applicationName": "chatdemoui"

}

curl -X GET -H "Authorization: Bearer  [用户Token]"  https://a1.easemob.com/[应用OrgName]/[应用AppName]/liverooms?ongoing=true&limit=[获取数量]&cursor=[游标地址（不填写为充开始查询）]

{

    "action": "get", 

    "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", 

    "params": {

        "cursor": [

            "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6MzE"

        ], 

        "ongoing": [

            "true"

        ], 

        "limit": [

            "2"

        ]

    }, 

    "uri": "http://127.0.0.1:8080/easemob- ... ot%3B, 

    "entities": [ ], 

    "data": [

        {

            "id": "1924", 

            "chatroom_id": "17177265635330", 

            "title": "具体了", 

            "desc": "就咯", 

            "startTime": 1495779917352, 

            "endTime": 1495779917352, 

            "anchor": "wuls", 

            "gift_count": 0, 

            "praise_count": 0, 

            "current_user_count": 8, 

            "max_user_count": 9, 

            "status": "ongoing", 

            "cover_picture_url": "", 

            "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", 

            "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", 

            "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1", 

            "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1924_1"

        }, 

        {

            "id": "1922", 

            "chatroom_id": "17175003856897", 

            "title": "香山", 

            "desc": "随便", 

            "startTime": 1495777760957, 

            "endTime": 1495777760957, 

            "anchor": "sx001", 

            "gift_count": 0, 

            "praise_count": 8, 

            "current_user_count": 1, 

            "max_user_count": 3, 

            "status": "ongoing", 

            "cover_picture_url": "http://127.0.0.1:8080/easemob- ... ot%3B, 

            "pc_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", 

            "pc_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", 

            "mobile_pull_url": "rtmp://vlive3.rtmp.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1", 

            "mobile_push_url": "rtmp://publish3.cdn.ucloud.com.cn/ucloud/easemob-demo_chatdemoui_1922_1"

        }

    ], 

    "timestamp": 1496303336669, 

    "duration": 0, 

    "organization": "easemob-demo", 

    "applicationName": "chatdemoui", 

    "cursor": "ZGNiMjRmNGY1YjczYjlhYTNkYjk1MDY2YmEyNzFmODQ6aW06Y2hhdHJvb206ZWFzZW1vYi1kZW1vI2NoYXRkZW1vdWk6NDk", 

    "count": 2

}

curl -X GET -H "Authorization: Bearer [用户Token]" " https://a1.easemob.com/[应用OrgName]/[应用AppName]/[房间id]/status"

{

    "action": "get", 

    "application": "4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5", 

    "uri": "http://127.0.0.1:8080/easemob- ... ot%3B, 

    "entities": [ ], 

    "data": {

        "liveRoomID": "1946", 

        "status": "ongoing"

    }, 

    "timestamp": 1496234759930, 

    "duration": 0, 

    "organization": "easemob-demo", 

    "applicationName": "chatdemoui", 

    "count": 0

}

   这里整理了集成环信的常见问题和一些功能的实现思路，希望能帮助到大家。感谢热心的开发者贡献，大家在观看过程中有不明白的地方欢迎直接跟帖咨询。
 
ios篇
APNs证书创建和上传到环信后台头像昵称的简述和处理方案音视频离线推送Demo实现环信服务器聊天记录保存多久？离线收不到好友请求IOS中环信聊天窗口如何实现文件发送和预览的功能ios集成常见问题环信推送的一些常见问题实现名片|红包|话题聊天室等自定义cell
 
Android篇
Android sdk 的两种导入方式环信3.0SDK集成小米推送教程EaseUI库中V4、v7包冲突解决方案Android EaseUI里的百度地图替换为高德地图android扩展消息（名片集成）关于会话列表的置顶聊天java.lang.UnsatisfiedLinkError: 的问题android 端 app 后台被杀死收不到消息的解决方案
昵称头像篇
android中如何显示开发者服务器上的昵称和头像 Android中显示头像（接上一篇文章看）环信(Android)设置头像和昵称的方法（最简单暴力的基于环信demo的集成）IOS中如何显示开发者服务器上的昵称和头像【环信公开课第12期视频回放】-所有关于环信IM昵称头像的问题听这课就够了
 
直播篇
一言不合你就搞个直播APP
 
客服集成
IM-SDK和客服SDK并存开发指南—Android篇IM-SDK和客服SDK并存开发指南—iOS篇
 
开源项目
Android简版demoios简版demo凡信2.0：超仿微信的开源项目 凡信3.0：携直播和红包而来高仿微信：Github 3,515 Star方圆十里：环信编程大赛冠军项目泛聊：定一个小目标写一个QQSlack聊天机器人：一天时间做一个聊天机器人TV视频通话：在电视上视频通话视频通话：Android手机视频通话酷信：ios高仿微信公众号助手：与订阅用户聊天沟通
 
持续更新ing...小伙伴们还有什么想知道欢迎跟帖提出。
  查看全部

一、SDK 介绍
      HelpDesk.framework 为 客服SDK（带实时音视频）
      HelpDeskLite.framework 为 客服SDK（不带实时音视频）
      Hyphenate.framework 为 IM SDK（带实时音视频）
      HyphenateLite.framework 为 IM SDK（不带实时音视频）
      环信客服SDK 基于 IM SDK 3.x , 如果同时使用客服SDK和IM SDK，只需要在初始化、登录、登出操作时使用客服访客端 SDK 提供的相应 API ，IM 的其他API 均不受影响。
      UI 部分集成需要分别导入 HelpDeskUI 和 IM demo 中的UI文件（也可以自定义UI）。 下面详细介绍IM 和 客服共存的开发步骤。

二、注意事项
      1、开发过程中，初始化、登录和登出，务必只使用客服访客端SDK的API。
      2、需要联系商务开通客服长链接。
      3、IM SDK 和客服SDK 都包括了模拟器的CPU 架构，在上传到app store时需要剔除模拟器的CPU 架构，保留  armv7、arm64。 

三、资源准备
      到环信官网下载客服访客端的开源的商城Demo源码 + SDK，下载链接:http://www.easemob.com/download/cs  选  择“iOS SDK”下载（如下图）。
      



      到环信官网下载IM的开源的Demo源码 + SDK ，下载链接：http://www.easemob.com/download/im 选择 iOS SDK（如下图）。
      



 
下载的 IM SDK+Demo 和 客服SDK+Demo 中都有 IM 的 Hyphenate.framework 或 HyphenateLite.framework，为了保持版本的匹配，我们只使用 IM Demo 中的 UI， 而不使用 IM SDK 中 的 Hyphenate.framework 或 HyphenateLite.framework 文件。

四、集成步骤
      1、阅读客服访客端SDK集成文档，集成客服，地址：http://docs.easemob.com/cs/300visitoraccess/iossdk。 
      2、阅读 IM 的集成文档，地址：http://docs-im.easemob.com/im/ios/sdk/prepare 
      3、将 IM Demo 中的 UI 文件按照自己的需求分模块导入到工程中
      4、将 IM 的 UI 所依赖的第三方库集成到项目中（IM集成文档内有说明）
      5、在pch文件中引入 EMHeaders.h 
#ifdef __OBJC__ //包含实时音视频功能 #import <HelpDesk/HelpDesk.h> //若不包含实时音视频，则替换为 #import <HelpDeskLite/HelpDeskLite.h> #import "HelpDeskUI.h" #import "EMHeaders.h" #endif
      6. 由于HelpDeskUI 和 IM UI 中都使用了 第三方库，如果工程中出现三方库重复的问题，可将重复文件删除，如果部分接口已经升级或弃用可自行升级、调整。

提供的兼容Demo介绍：
     1、Demo集成了初始化sdk、登录、退出登录、IM单聊、联系客服的简单功能，处理了第三方库冲突的问题。
     2、pch文件中的appkey等信息需要换成开发者自己的。
     3、Demo源码下载地址： 查看全部

                                                                   设置机器人自定义菜单
1》管理员模式---智能机器人 新建机器人




2》管理员模式----设置----会话分配规则  渠道指定，添加访客发起会话的渠道（例如APP和网页），全天指定机器人




 
     修改路由规则后，需要在管理员模式--当前会话  手动关闭旧会话，新会话才能重新调度
3》 企业版机器人：管理员模式---智能机器人  点击【机器人管理】，新页面跳转到企业版机器人管理平台  
     知识管理模块----菜单管理
    旧版机器人：管理员模式--智能机器人  点击自定义菜单页签
























 
4》机器人的自定义菜单需要设置为默认回复或者欢迎语才能触发
以下是设置为默认回复：点击蓝色 添加默认回复按钮，选择类型为菜单














 
以下是配置为机器人的欢迎语





 
点击蓝色添加按钮，同样选择为菜单类型，选择刚创建的自定义菜单，最后保存（注意设置为机器人欢迎语后:只有网页会生效显示，APP需要单独代码集成，微信和微博不支持机器人欢迎语）









 
注意：如果新建自定义菜单的时候只新建了菜单名，没有设置菜单项，上图界面是无法点击保存按钮的。需到自定义菜单页面给菜单添加菜单项。









 
以上是配置好的截图，就可以发起新会话测试了
5》测试：以下是网页测试截图 
h5链接在：管理员模式--渠道管理-网站 接入方式  页面 ，点击直接打开h5链接按钮即可




 
 附：企业版机器人基础配置文档：http://docs-ai.easemob.com/cs/preliminary    
        客服系统旧版机器人文档：http://docs.easemob.com/cs/200 ... %25BA
  查看全部

                                                  访客端发送订单或者轨迹消息后不显示
默认是发送后访客端删除本条消息，可以修改 
Android
ChatrowOrder 查找removeMessage





网页修改   
管理员模式--设置--系统开关 访客端同步展示轨迹消息 开关打开




  查看全部

****1.新建自定义角色
管理员模式----设置---权限管理 页面右上角 添加角色





需要填写角色名称，角色权限 分为两大类：管理员模式 和客服模式
这两种模式的展开项分别对应两种模式下的所有功能模块（按需勾选）
 以下操作以新建一个角色权限为：客服模式下所有功能，管理员模式下只有质检功能 为例：
   **第一:客服模式根目录直接勾选




   **第二：管理员模式  点击 展示所有功能模块，只需要勾选 质检功能的3个复选框




       同时可以规则新角色的数据权限：租户或者客服





 
   **第三：最后操作保存（tips：创建的自定义角色不能超过20个）
****2.给客服修改权限
管理员模式---成员管理--客服 
进入客服列表页面，选择要修改的客服，选项 一列点击编辑按钮




 
弹出客服信息修改对话框，滑动到底部
修改角色，最后保存




 
客服如果是登录状态，会自动给客服发送通知，客服需重新登录系统，新角色权限可以生效。 查看全部

                                                                                         启用坐席
1》管理员可以启用或禁用其他管理员和客服账户。一个租户下，在同一时间，最大启用数即为该租户的“购买坐席数”。
注：可以进入“管理员模式 > 设置 > 企业信息”页面，查看您的租户的“购买坐席数”和“账户到期日”。 
2》如果您的租户只购买了一个坐席，就只能使用当前管理员账号，不能操作禁用当前启用其他账号，一个租户至少 得有一个管理员权限的账号
3》管理员账号也占用一个坐席，可以切换到客服模式接会话
管理员模式--成员管理--客服列表 账户启用一列 可以启用或者禁用坐席账号（见下图）




  查看全部

****管理员模式--智能机器人 新建机器人，从机器人信息页面，点击蓝色字体：机器人管理，可跳转到机器人操作平台





****管理员模式----设置----会话分配规则  渠道：添加访客发起会话的渠道，可修改为全天机器人接入




****跳转到机器人平台添加知识规则或自定义菜单
1》添加知识规则





2》添加自定义菜单




 
注意：添加自定义菜单后，需要将该自定义菜单设置为机器人 的默认回复才可能触发（添加默认回复，选择为菜单类型，之后选择刚新建的自定义菜单，最后保存）






     更多机器人配置文档参见：
http://docs-ai.easemob.com/cs/ ... %259C
****发起会话测试
修改路由规则的配置后，新会话才能生效。可以先到管理员模式--当前会话手动关闭旧会话， 新会话测试




  查看全部

*****修改客服系统语言********
  客服系统切换语言（支持中英文切换）

1.登录的时候
浏览器打开 https://kefu.easemob.com/
界面右上角可以切换语言





2.如果是已登录状态，切换到客服模式
客服模式--客服信息 语言一栏可以切换，最后需点击右下角保存




*********************************************************************
************网页集成切换到英文**************
webim 后面添加/en-US/





切换后界面如下




  查看全部

                                                                              网页下班留言配置
网页渠道：如果下班时间的路由规则是指定的技能组，可以从网页插件页面配置 下班时间让访客直接进入留言界面，这样下班时间访客无法发起会话，只能提交留言（注意：网页端访客暂时无法收到客服和管理员对留言的评论，需要通过电话或邮箱联系访客。 ）
如需修改，客服系统 切换到管理员模式--渠道管理--网站 --- 功能设置页签，找到 下班留言配置：可修改为 展示默认消息或进入聊天窗，最后保存。访客端需重新加载页面





  查看全部

                              访客发送的消息客服系统看不到
1. 先到 管理员模式--搜索  点击消息按钮，输入访客发送的消息内容 查询看下，默认是搜索的近7天的消息，如果时间不在7天内，可以重新点击筛选排序，放大时间范围筛选 。若可以查询到，点击会话后查看是哪一个客服接入的




如果直接无法看到是哪一个客服接入的，复制会话ID 到历史会话 ID一栏，查询出具体会话，点击进入会话详情页，看右侧记录一栏的数据，可以看出是哪一个客服接入的没有回复造成的





注：如果是该客服没有上线造成的没有回复消息。需要客服前一天退出登录前手动关闭自己进行中所有会话，这样才能保证新会话能自动调度给上线的客服
也可以通过配置 不活跃会话超时结束 或 访客超时未回复结束会话实现关闭会话（管理员模式--设置--系统开关 页面）
2.排查访客是否被加入黑名单
管理员模式---客户中心--客户信息 黑名单列表可以查看。
黑名单中的客户可以再次发送消息，但系统不会为其创建会话；客户被移除黑名单后，再次发送消息时可以成功创建会话。 
如果用户是在黑名单中，可以先移除黑名单后再测试。





3.如果搜索模块无法查询到，黑名单中也没有任何数据。可以工作时间发起会话咨询在线客服解决，感谢配合 查看全部

                                                                          查看会话的满意度评价
两种情况：查看具体某一个会话的评分或者是查看系统对所有会话评分的统计结果
1》查看具体某一个会话的评分
结束的会话才能到历史会话看评分。先把会话关闭掉，之后可以到管理员模式---历史会话模块，列表直接有评分一列的数据。如果列表不显示关闭的会话，可以点击右上角筛选排序，重新指定条件筛选出会话（可选择按会话结束时间筛选）




或者点击一个会话，进入会话详情页，看右侧指标一栏（如下图）





2》查看系统对会话的评价总统计结果
管理员模式--会话统计--工作质量 页面，页面顶部的满意度评分是系统的会话评价统计，页面底部是对每一个客服服务的评分统计（见下图）









  查看全部

1》添加客服
管理员模式--成员管理--客服 右上角 添加客服按钮
添加时可以设置 客服账号邮箱密码、昵称、最大接待人数、权限等信息。如果需要重置坐席密码也可在此页面操作。




2》修改客服状态
管理员可以修改客服或其他管理员的在线状态，支持在空闲、忙碌、隐身、离开状态之间切换。在客服列表中点击“在线状态”一列的下拉按钮，修改客服的在线状态。
注：若客服离线，则不可强行修改其状态为在线。暂不支持自定义角色修改管理员或客服的在线状态。




 
3》设置客服最大接待人数
最大接待人数可以由管理员统一操作也可以由每一个客服自行调整自己的数量（二者只能选其一）
 ----1---统一由管理员调整
管理员模式--设置--系统开关 客服自定义最大接待人数 需要关闭。之后管理员在 成员管理--客服 页面点击编辑按钮，弹窗后可以修改客服的最大接待人数 ，最后保存





----2---每一个客服自行修改自己的最大接待人数
管理员模式--设置--系统开关 客服自定义最大接待人数 需要开启。修改后客服模式 最大接待人数为可调状态




 
客服更多配置操作参见以下文档：
http://docs.easemob.com/cs/200 ... %2586 查看全部

                                                                   配置系统自动结束会话
注意：修改配置后针对新创建的会话生效，旧会话还是需要手动关闭
1》机器人名下的会话自动结束配置：
        管理员模式---智能机器人 会话超时设置页签 
可以设置超时时间和超时提示语
可以设置超时时间（1~30分钟）和1~5条超时回复。当访客超过设定时间仍没有回复消息时，机器人将随机从超时回复中选择1条回复访客，1分钟后访客仍没有回复，会话将被自动结束。 




 
2》人工客服名下的会话自动结束配置
        i. 会话在待接入排队的情况 
            管理员模式--设置--系统开关 待接入超时结束会话




 
       ii.会话由人工客服接入的情况（在人工客服的进行中会话列表）
           管理员模式--设置--系统开关 访客超时未回复自动结束会话                不活跃会话超时自动结束 两个配置项










注意：如果同时打开了“访客超时未回复自动结束会话”和“不活跃会话超时自动结束”开关，当满足任意开关的超时条件时，会话将会被自动结束。
配置文档可参考以下链接
http://docs.easemob.com/cs/200 ... %259D
注意：修改配置后针对新创建的会话生效，旧会话还是需要手动关闭
 
 
  查看全部

                                                             问候语的配置
（注意：问候语只有上班时间才会 自动发送，下班时间不会触发，上班时间是走的时间计划页面的配置）
客服系统可以同时配置三种问候语：企业问候语 技能组问候语 客服问候语三种，触发条件不同

1.  企业问候语（管理员模式--设置--系统开关 企业问候语）：当访客发送首条消息后，收到系统自动发送的企业问候语。





2.技能组问候语（管理员模式--成员管理--在线技能组 基础设置 技能组问候语）：会话调度给某个技能组后会触发该技能组的问候语




3.客服问候语（客服模式--客服信息 客服问候语 每一个客服配置自己的问候语）：会话成功分配或转接给当前客服/管理员时，访客会收到系统自动发送的客服问候语




如果同时配置三个，可能都会触发。根据需求配置即可，一般情况只需要配置企业问候语。其他的不使用可以把对应开关关闭 查看全部

                                       机器人转人工配置 
1》旧版机器人：
     管理员模式--智能机器人 自动回复--转人工设置。
     可以规定转人工时间（全时间段允许 全时间段禁止 自定义时间<仅上班 或者仅下班允许转接>）
     配置限制转接提示语
指定转人工技能组（如果是不指定，会话是转接到未分组。如果要实现机器人转接不同的技能组，此处选择为不指定，之后配合 会话分配规则页面的 关联指定 来实现机器人转接到不同技能组）












2》企业版机器人转人工配置
    1）管理员模式--智能机器人 点击机器人信息页面的蓝色字体 机器人管理 进入到机器人平台






    2）




上图是配置转人工时间段和指定技能组的
机器人设置模块--转人工设置 
默认情况可以把转人工指令和转人工意图开启即可





转人工指令可以自定义修改，默认的指令有：
中文：转人工、转坐席、转人工客服、转人工坐席、转人工服务；英文：chat with agent
   企业版机器人的转人工更多配置可以参见以下文档：
http://docs-ai.easemob.com/cs/ ... %25A5 查看全部

                                            技能组操作
设置技能组下班提示语 
          管理员模式--成员管理--在线技能组 切换到基础设置页签 
          有技能组下班提示语 开关（需要 打开）配置下班提示语，最后保存（见下图）
          如果下班时间路由规则直接指定技能组，下班时间访客发起会话时，系统自动发送下班提示语给访客




      2.配置技能组问候语
        同上界面，基础设置页签 有问候语开关 需要打开，配置问候语，最后保存（注：问候语只有上班时间才会发送下班时间不会发送。这里的上班时间是时间计划页面的配置）

       更多技能组配置可以参见以下文档：
http://docs.easemob.com/cs/200 ... %2586
  查看全部

                                                           客服发送知识库中附件给访客
发送知识时，图文消息仅包含知识标题和知识内容，不包含知识的附件。若发送知识中的附件，需打开知识详情，并点击附件右上角的“发送”按钮。





设置知识库附件发送个访客的方式：
管理员模式--知识库  点击发送方式设置按钮










  查看全部

                                                               待接入不自动分配问题
         查看待接入列表的数据（管理员模式---待接入 可以看到租户所有的待接入数据） 




        看截图框选 技能组和 坐席名两列的数据 i..如果坐席名列有数据，例如截图中第一条，说明有指定客服，需要保证指定的坐席上线后系统才能自动调度给该指定的客服
ii..如果坐席名一列没有数据，看技能组一列显示的技能组名称
之后对照到 （管理员模式--成员管理--在线技能组 ） 查看该技能组内客服状态分布
需要保证技能组内有 空闲状态的客服同时该客服的进行中会话数量不能超过最大接待人数




例如上图，是因为技能组内没有空闲的客服存在
     解决：
让该客服调整状态为空闲
如果仍不能自动调度，查看该空闲客服的当前进行中会话是否达到最大接待量（最大接待量不能是0）




客服的进行中会话数量可以到（管理员模式--当前会话 右上角 指定客服筛选看数量，对比进行中和最大接待量）




如果是因为超过最大接待量导致的，需要该客服手动关闭部分进行中会话，使其数量小于最大接待量
注意：另外后续不想客服手动关闭，可以配置系统自动结束会话
可以到  管理员模式----设置--系统开关 页面  
   访客超时未回复自动结束会话
   不活跃会话超时自动结束。配置后针对的是新会话生效，旧会话还是需要手动结束

配置文档：
http://docs.easemob.com/cs/200 ... %259D



如果按照上述条件均排查都符合正常，可以看下不会自动调度的时间是非工作时间，有个系统开关控制 
（管理员模式--设置--系统开关 只有技能组的上班时间才自动分配会话）如果是开启需要关闭可解决不自动调度的问题




  查看全部

 i..如果坐席名列有数据，例如截图中第一条，说明有指定客服，需要保证指定的坐席上线后系统才能自动调度给该指定的客服

 ii..如果坐席名一列没有数据，看技能组一列显示的技能组名称

 之后对照到 （管理员模式--成员管理--在线技能组 ） 查看该技能组内客服状态分布

 需要保证技能组内有 空闲状态的客服同时该客服的进行中会话数量不能超过最大接待人数

                                          代码指定客服（APP，网页渠道都可以实现）
1》注意：代码指定针对新会话生效，需要到（管理员模式--当前会话） 手动关闭旧会话，访客端发起新会话测试
指定客服说明：指定客服之后，若指定客服在线，不受接待量和状态的限制（无论什么状态，无论接待量是多少），都直接分配给该客服指定客服之后，若指定客服不在线，有个灰度功能可以控制客服不在线时，会话是否分配给客服开关关闭时，客服不在线，则会话在待接入中排队（开关默认为关闭状态）开关开启时，客服不在线，则会话直接分配给该坐席开关为灰度功能，客户不能自己控制，需要联系环信开通，开通功能联系商务即可
2》相关代码 安卓文档：
http://docs.easemob.com/cs/300 ... %258D
ios：
http://docs.easemob.com/cs/300 ... %258D
网页（h5链接）
http://docs.easemob.com/cs/300 ... 258D1
网页（引入js）
http://docs.easemob.com/cs/300visitoraccess/web-widget#%E6%8C%87%E5%AE%9A%E5%AE%A2%E6%9C%8D 

     参数中的客服账号可以到（管理员模式--成员管理--客服 列表）邮箱一列数据 为指定的客服账号





  
   验证方法： 如果某一个会话没有生效，先手动关闭掉，之后到到管理员模式---历史会话  找到该会话，点击后 查看右侧记录页面的数据：确认下 是否有该坐席被指定发起会话的记录，如果有说明成功，没有的话，请检查下代码和是否是新会话测试的
    查看全部

                                                                  历史会话的筛选和导出
   tips:
    结束的会话才能到历史会话模块进行导出。（历史会话记录默认保存6个月，如需延长，请联系环信商务经理。 ）    客服模式和管理员模式都可以进行导出，数据权限不同    历史会话模块默认显示的是本周数据，从周日开始    在客服模式的“历史会话”页面，客服和管理员仅可查看自己参与并结束的会话；    在管理员模式的“历史会话”页面，管理员可以查看所有客服的历史会话。
 第一：筛选
      进入历史会话模块，点击右上角筛选排序，可以重新指定时间段，根据会话标签，访客昵称，环信ID等条件筛选






 ​第二：导出
     直接点击界面右下角导出按钮，生成的文件需要到导出管理进行下载











     更多历史会话操作 文档地址：
http://docs.easemob.com/cs/100 ... %259D 查看全部

代码传访客属性（例如访客资料页的：昵称，名字，公司，描述等字段）
代码传客户信息 针对自定义字段不生效
客服系统以下开关需要打开
          管理员模式--设置--系统开关 允许访客端修改客户信息  开关保持开启状态，见下图







      2.APP和网页集成都需要对应的代码传值   相关代码文档：
Android 
http://docs.easemob.com/cs/300 ... %25AF
ios
http://docs.easemob.com/cs/300 ... %25AF
网页（引入js）
http://docs.easemob.com/cs/300 ... %25AF

   代码传值针对新创建的会话生效，需要到管理员模式--当前会话 找到旧会话，手动关闭。（手动关闭会话见下图）





 
  之后访客端发送新消息，要求新会话第一条消息扩展必须有访客属性
  查看全部