网易云信客户端是由网易官方打造的即时通讯云服务产品，该软件设计非常美观，并以PaaS为服务模式，能够为广大开发者提供IM SDK和OPEN API，此外网易云信更是利用了全新的科学技术，可以带来更加全面的聊天功能，让即时通讯能够更加便利快捷。

本次提供的网易云信运行于Windows系统，是一款超实用的即时通讯云服务（PaaS）软件，该软件能够带来P2P聊天、群组聊天、消息推送、语音视频等强大的IM功能，并支持多重备份、层层加密功能，可以很好满足最高级数据安全需求。

网易云信特色

1、弱网络下稳定输出

拥有海外节点，全球高速访问。

CDN保障语音、图片等多媒体发送质量，网络适应性超强。。

移动网络定制优化，延迟和丢包不再是问题。

2G、3G、4G、Wifi无缝切换。

2、满足最高级数据安全需求

多重备份，硬件故障也不丢数据。

层层加密，确保数据安全。

不侵入用户体系，不保存个人、好友数据，无需担心数据被泄露。

顶级安全专家为APP保驾护航。

3、7*24小时专业运维。

维护流程规范，有效保障APP正常运转。

骨干节点自建机房，运营商深度合作，网络质量高人一筹。

对突发、偶发问题有完善成熟的快速应对机制。

4、海量并发，极致性能

拥有亿级高并发处理经验。

业内最大服务集群架构，稳定支持亿级用户同时在线。

自定义精简二进制协议，速度更快，性能更好。

网易云信功能

1、IM基础功能

支持单聊、群聊、聊天室，适用所有APP

2、实时音视频/教学白板

通过音视频通道和TCP通道实现实时会话

3、专线电话

一键呼叫，被叫方无需安装APP，无需网络

4、短信

提供短信送达服务，短信验证码、模板短信

5、直播

提供稳定、低延时、高并发在线直播平台

6、私有云服务

提供服务器隔离部署、高级专属服务

7、保障消息必达

已成功发送超1000亿条消息

8、承载海量并发

15年经验，已成功发送超1000亿条消息

私有精简二进制协议，速度更快，性能更好

9、全球节点覆盖

异地多机房服务集群，覆盖全球范围

架构灵活，支持水平自动伸缩

10、消息必达策略

采用动态智能DNS掉线快速重连机制

消息排重，持续重连直至到达

新手接入指南

一、简介

网易云通信IM服务基于网易 17 年的 IM 技术积累，致力于打造最稳定的即时通讯平台。 IM 服务提供了一整套即时通讯基础能力，通过该平台服务就可以将即时通讯、实时网络能力快速集成至企业自身应用中。

通过本篇文档，您可以快速了解如何将网易云通信IM集成到您的App中。

二、架构介绍

三、接入步骤

1、创建帐号

2、创建应用

登录成功后，点击左侧的创建应用按钮，创建一个新应用

创建应用成功后 ，可以在应用详情页下对 IM 功能进行如下所示的配置

您可以在 「App Key管理」内获得该应用的 App Key 和 App Secret 等重要信息

3、帐号集成

4、客户端集成

5、服务端集成

第三方回调功能

一、功能概述

第三方回调是云信一项基于客户需求开放的事件回调能力。简单来讲，就是由客户应用服务器干预事件处理的结果。例如在企业办公场景、接入第三方反垃圾服务场景下，客户需要在发送方发送消息时，不直接投递给接收方。而通过云信服务器向应用服务器发出请求，根据返回的回调结果，放行后方可投递。

第三方回调功能目前支持以下类型的事件回调：

1、单聊（点对点）消息回调

2、群聊消息回调

3、聊天室消息回调（仅专属云开放）

4、用户资料变更回调

5、好友关系变更回调

6、群组管理操作变更回调（仅专属云开放）

7、音视频通话回调

二、单聊/群聊/聊天室消息发送回调

用户发送消息时，不直接投递给接收方，而是先请求第三方服务器（通常为app的应用服务器），通过回调结果决定是否投递。app后台可以根据此功能监控用户的消息发送。包括：

1、记录所有用户的单聊消息，例如记录日志场景；

2、拦截部分用户的发言请求，例如在发言需要鉴权的场景；

3、消息发送反垃圾，例如在用户已接入第三方反垃圾服务的情况下。

单聊/群聊/聊天室消息发送回调的整体流程类似，以单聊消息为例：

注意事项：

1、要启用回调，首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。

2、启用回调后，由于引入了回调消息发送的链路比不启用回调时更长，会影响消息发送的实时性。

3、回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。

4、用户可以在管理后台配置回调超时时的默认策略，有默认放行和默认不放行两种方式。

5、聊天室消息第三方回调功能仅对专属云客户开放。

三、用户资料变更回调

用户调整自己的昵称、头像、签名、Email、生日、手机号、性别等信息时，云信将操作请求传递给第三方服务器，通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的修改资料行为。应用场景包括：

1、限制用户修改资料行为的场景

2、识别筛选异常用户的场景

回调流程可参考消息发送的回调流程。相关注意事项包括：

1、要启用回调，首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。

2、启用回调后，由于引入了回调消息发送的链路比不启用回调时更长，会影响操作的实时性。

3、回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。

4、用户可以在管理后台配置回调超时时的默认策略，有默认放行和默认不放行两种方式。

四、添加/删除好友回调

用户添加/删除好友时，云信将操作请求传递给第三方服务器，通过服务器的回调结果决定是否生效。应用服务器可以根据此功能监控并干预用户的增删好友行为。应用场景包括：

1、用户添加、删除好友需要扣费鉴权的场景

2、识别并避免异常用户恶意添加、删除好友的场景

3、统计用户增删好友的数量，识别并筛选活跃用户

回调流程可参考消息发送的回调流程。相关注意事项包括：

1、要启用回调，首先需要在管理后台进行第三方回调配置。下文中有配置方法的介绍。

2、启用回调后，由于引入了回调消息发送的链路比不启用回调时更长，会影响操作的实时性。

3、回调的方向是由云信服务器向app应用服务器发起HTTP POST请求。

4、用户可以在管理后台配置回调超时时的默认策略，有默认放行和默认不放行两种方式。

网易云信抄送服务配置

若需要使用消息抄送功能，需要先配置接受抄送的URL地址。具体步骤如下：

1、登录网易云控制台：http://app.netease.im/login

2、点击需要开启抄送服务的应用，进入应用管理页，点击「消息抄送配置」，下拉找到消息抄送配置模块

3、输入消息抄送配置地址，点击校验按钮，校验成功后，即可开启消息抄送功能。校验说明请参见：抄送地址检验说明

4、配置成功后，可以在下方勾选所需要的抄送类型。目前部分抄送类型暂不支持自助开通配置，如有需要，请联系您的客户经理。

其他说明

1、抄送消息时，若开发者服务器处于离线状态或者由于其他原因导致连接不上消息接收地址，网易云通信会根据一定策略再尝试抄送一定次数，若开发者服务器仍然无法连接，默认情况下，网易云通信将会丢弃抄送失败的消息。若有特殊需求不能丢弃消息，请联系客户经理以获得帮助。

2、考虑到网络环境的不稳定，为了确保开发者的消息接口能收到抄送的消息，网易云通信可能会重复发送同一条消息，建议开发者对所收到的消息进行一定的去重操作；

3、网易云通信消息抄送服务对于一条消息是否抄送成功具有超时判定机制（超时时间为 5s ），若超时，将会尝试重新抄送一定次数。如果第三方消息接收接口在接收到消息之后，会做比较耗时的操作（例如 DB 入库等操作）的话，建议将该接口做成异步机制（例如可以将消息先存到 MQ 中），以免被网易云通信判定为超时。

更新日志

新增：

1、超大群增加消息撤回功能

2、超大群支持自定义系统通知

3、超大群增加离线消息处理

4、查询指定数量的最后会话数据