• 服务端集成 >
 
• 消息类型 >
 
• 消息类型概述

即时通讯服务提供丰富的预定义消息类型（或“内置消息类型），以简化即时通讯应用的开发，提高开发效率。

一个预定义消息类型（或“内置消息类型）具有唯一的类型标识（ObjectName），且消息内容必须符合预定义的内容体结构。不同消息类型在服务端和客户端具有不同的处理逻辑。

消息属性

不同消息类型在服务端和客户端具有不同的处理逻辑，具体体现为是否存储、是否计入未读数、是否支持离线消息机制、是否支持推送等几个属性。

• 客户端计数与存储策略：计数策略是指是否影响未读消息数。如接收的消息影响会话未读数，则会话列表中会话的未读消息数 +1。存储策略是指发送、接收该消息后，客户端本地数据库是否存储该消息。
• 离线消息缓存：即时通讯服务端在接收者不在线时，是否对单聊、群聊、系统会话中的消息进行缓存，默认最长缓存 7 天。接收人在 7 天内上线，均可接收到该消息。超过 7 天后，消息被离线缓存淘汰。如果消息类型不支持离线消息缓存，则只有接收人在线时，才可收到该消息。
• 远程推送通知：在接收者不在线时，是否默认为该条消息触发远程推送通知。支持远程推送通知的一个必要条件是该条消息设置了推送通知标题和推送通知内容。即时通讯服务为部分用户常用的消息类型预置了推送通知标题和通知内容。除非已明确声明不支持推送，其他消息类型如果在发送消息时主动设置了推送通知标题和通知内容，则可在接收者不在线时触发远程推送通知。

消息分类

为了便于理解，我们将预定义的消息类型大致分为以下几类：

• 用户内容类消息：用户内容类消息包含了用户之间可能发送的消息内容，包含文本、图片、GIF、语音、文件、小视频、位置、引用、合并转发等类型。
• 通知类消息：表示一个通知信息，可能需要展现在聊天界面上，如提示条通知。
• 状态类消息：表示一个状态，用来实现输入状态（提示“对方正在输入”）、单聊会话已读通知等功能。
• 信令类消息：即时通讯服务在实现自身业务功能时使用的，应用程序一般不需要对其做任何处理。

每个分类下均提供了多种预定义的消息类型。如果客户端 SDK 发送预定义的消息类型，可直接构建消息对象，设置相应类型的消息内容体并发送。如果使用服务端 API，需要指定需要发送的消息类型的类型标识（Object Name），并严格按照预定义的消息类型内容体结构要求传入消息内容。

用户内容类消息

用户内容类消息包含了用户之间可能发送的消息内容，包含文本、图片、GIF、语音、文件、小视频、位置、引用、合并转发等类型。

即时通讯服务端为用户内容类的消息类型预置了推送通知标题和通知内容。如果发送消息时未提供自定义的推送通知标题和通知内容，则默认使用预置的推送通知标题和通知内容。默认的推送通知标题与内容可参见下表中各消息类型文档。

通知类消息

通知信息一般需要展示在聊天界面上，如“张三加入了群组”。此类消息不增加未读消息计数。

即时通讯服务端没有为通知类的消息类型预置推送通知标题和通知内容。如果发送消息时未提供自定义的推送通知标题和通知内容，即使收件人不在线，默认也不会触发远程推送。如需支持推送，请传入自定义的推送通知内容。

状态类消息及属性

表示的是即时的状态，例如输入状态，仅当用户在线时可以接收。因为状态消息在客户端与服务端均不会存储，如果接收方不在线，则无法再收到该状态消息。如果使用即时通讯服务端 API 发送，请使用发送状态消息接口：发送单聊状态消息、发送群聊状态消息。

信令类消息

一般为需要确保收到，但不需要展示的消息，例如运营平台向终端发送的指令信息。如果消息接收方不在线，再次上线时可通过离线消息收到。全量消息路由数据中会包含这些类型的消息。消息回调服务支持配置这些消息类型。

信令类消息

即时通讯服务端为部分信令类的消息类型预置了推送通知标题和通知内容。如果发送消息时未提供自定义的推送通知标题和通知内容，则默认使用预置的推送通知标题和通知内容。默认的推送通知标题与内容可参见下表中各消息类型文档。

音视频信令类消息

即时通讯服务端为音视频信令类的消息类型预置了推送通知标题和通知内容。如果发送消息时未提供自定义的推送通知标题和通知内容，则默认使用预置的推送通知标题和通知内容。

消息扩展功能消息

消息扩展功能消息 ObjectName 为 RC:MsgExMsg。在超级群消息业务中，设置、删除消息扩展信息时，可通过消息回调或全量消息路由接收到消息扩展功能类消息。客户端无法收到该类消息。