环信IM即时通讯（小程序） - 消息管理
文档简介：
功能描述：
环信即时通讯 IM 支持多种消息类型，开发者可以方便地对本地会话、消息进行管理，可以从服务端获取历史会话和消息，提供送达回执和已读回执能力。
咨询热线：400-826-7010，为您提供专业的售前咨询，让您快速了解云产品，助您轻松上云！
微信咨询
免费试用、价格特惠
功能描述
环信即时通讯 IM 支持多种消息类型，开发者可以方便地对本地会话、消息进行管理，可以从服务端获取历史会话和消息，提供送达回执和已读回执能力。
消息：环信即时通讯 IM 中消息（Message）表示发送方给接收方发送的内容，消息包括多种类型，如：文本、图片、语音等。
会话：环信即时通讯 IM 中会话（Conversation）分为 3 种，单聊、群聊、聊天室会话。单聊是指 2 个用户建立的会话，双方可以在会话中收发消息。群聊会话是由群成员发送消息所组成的，群成员可以在群会话中收发消息。聊天室会话与群聊会话类似。
消息类型
|
类型
|
描述 |
|---|---|
| 文本消息 |
文本消息的内容是文本，可以包含超链接、emoji 表情符号等。表情消息是基于文本消息实现的。 文本消息大小限制为 3 KB。 |
| 图片消息 |
图片消息是附件消息，需要先将图片上传至消息服务器。接收方收到图片时自动下载图片缩略图。 图片消息大小限制为 10 MB。 |
| 语音消息 |
语音消息是附件消息，需要先将语音上传至消息服务器。接收方收到语音时自动下载语音。 语音消息大小限制为 10 MB。 |
| 视频消息 |
视频消息是附件消息，需要先将视频上传至消息服务器。接收方收到视频时自动下载视频缩略图，点击下载视频消息。 视频消息大小限制为 10 MB。 |
| 文件消息 |
文件消息是附件消息，需要先将文件上传至消息服务器。接收方收到文件时自动下载文件。 文件消息大小限制为 10 MB。 |
| 位置消息 | 位置消息需要第三方的地图服务提供经纬度信息。接收方接收到位置消息，通过经纬度信息可以在第三方的地图服务中显示位置。 |
| 透传消息 |
透传消息可视为命令消息，通过发送这条命令给对方，通知对方要执行的操作，对方收到消息后系统可以自定义处理。透传消息不会在 UI 上展示。 消息大小显示为 3 KB。 透传消息的使用场景：头像、昵称的更新、状态同步等。 透传消息不会存入本地数据库。 |
| 消息自定义扩展 |
当基础的消息类型不满足需求时，可以使用消息自定义扩展增强基础消息类型。 使用扩展后，消息大小不能超过原类型消息的大小。 消息自定义扩展的使用场景：消息中需要携带被回复的消息内容和图文消息等。 |
| 自定义消息 |
开发者自定义的消息类型。自定义消息支持设置类型名称，开发者可以添加多种自定义消息。 自定义消息大小限制为 3 KB。 自定义消息的使用场景：红包消息、模板消息等。 |
消息功能
管理本地消息数据
Web 端暂无相关功能。
从服务器获取消息
环信即时通讯 IM 在消息服务器保存历史消息，方便用户在新设备上获取历史消息。 历史消息存储时间与套餐版本相关：专业版 7 天，旗舰版版 90 天， 尊享版 180 天。
| 功能 | 描述 |
|---|---|
| 从服务器获取会话 | 从服务端获取会话。 |
| 分页获取指定会话的历史消息 | 从服务端分页获取会话的历史消息。 |
获取消息的已读回执和送达回执
环信即时通讯 IM 消息投递成功会返回送达回执，而且提供消息已读功能，接收方查看消息后会返回已读回执。
| 功能 | 描述 |
|---|---|
| 单聊消息送达回执 | 消息下发成功后，返回消息送达回执。 |
| 单聊消息已读回执 | 接收方查看消息后，返回消息已读回执。 |
| 单聊会话已读回执 | 接收方查看单聊会话后，返回会话已读回执。 |
| 群组消息已读回执 | 提供群组消息已读回执能力。 |
