IM 北极星

概述

IM 北极星主要为开发者提供了终端用户连接及消息发送状态查询功能：

1. 通过查看用户的连接日志，判断用户某时间段内是否可以正常使用融云服务，如：用户反馈消息发送不成功，可能是因为该用户在此时间段内没有成功连接融云。

2. 通过查看消息的整个发送过程状态，分析出收不到消息的原因，帮助开发者定位问题，提高问题解决效率。

登录融云开发者后台，在 数据统计 中，北极星 部分，点击 IM 即时通讯查询，即可查看应用内，用户最近 7 天的连接及消息发送情况。

连接状态监控

支持查看用户 7 天内连接融云状态情况及消息发送情况，消息需要在发送 5 分钟后才能查看完整状态数据。

输入用户 ID 查询该用户的连接情况，用户 ID 为获取过融云 Token 用户唯一标识。

连接状态内容

• 显示内容包括：连接时间范围、使用的 SDK 版本、平台、手机型号、终端用户连接时的 IP 地址

• 消息监控：点击“查看”后，显示该连接时间段内的该用户的消息发送情况

消息状态监控

查看指定用户的消息发送状态，目前支持查看单聊、群聊、系统会话类型，默认为查看单聊会话类型消息。

查询条件：

支持根据以下查询条件，查询已发送的消息：

• 发送用户 ID：融云获取过 Token 的 UserID，查看此 ID 发送的所有消息，必填项

• 消息 ID：为融云全局消息唯一标识 msgUID，可通过融云消息路由服务或服务端消息历史日志服务获取，非必填项

• 目标 ID：根据不同的会话类型，对应为单聊用户 ID、群组 ID、聊天室 ChatRoomID

• 会话类型：支持查看单聊、群聊、聊天室、系统消息会话

• 消息类型：支持融云所有内置消息及用户自定义消息，用户在消息类型中选择自定义消息时，需要手动输入自定义消息的 ObjectName 进行查询，自定义消息一次只能查询一个。

• 消息来源：包括：Android、iOS、Web、PC、小程序、Server API。默认查询全部平台的消息。

• 时间范围：消息发送时间范围，默认显示当天零点到当前时间

消息发送列表

• 消息 ID：融云消息的全局唯一标识 msgUID

• 发送用户 ID：该消息的发送用户 ID

• 目标会话 ID：根据不同的会话类型，对应为单聊用户 Id、群组 Id、系统消息 Id

• 发送时间：消息在融云服务端的发送时间

• 会话类型：单聊、群聊、系统消息会话

• 消息类型：当前消息的消息类型，包括客户自定义消息（ObjectName）

• 消息来源：包括：Android、iOS、Web、PC、小程序

• 接收状态：点击查看该条消息的目标用户接收状态

消息接收状态

查看一条消息目标用户的接收情况，消息是否发送成功、敏感词、黑名单过滤情况及目标用户未在线时的消息 Push 状态。

用户在线接收消息，消息发送成功显示

消息状态包括：发送成功、消息未下发

• 发送成功：目标用户在线情况下接收到该消息，显示为发送成功

• 消息未下发：目标用户有大量消息需要接收时，融云服务端通知目标客户端有新消息需要接收，目标用户在获取新消息前因网络问题断开连接或用户主动退出登录，显示为消息未下发，此状态的消息在用户下次登录时会重新获取到

用户未在线情况下，转为 Push 推送

• Push 通道：发送 Push 时使用的通道类型，包括：融云 Android Push、APNs、小米、华为、魅族、vivo、OPPO

• Push 发送时间：该消息转为发送 Push 时的融云服务器时间

• Push 是否成功：成功/不成功，在使用第三方 Push 通道时，调用第三方 Push 通道接口，第三方 Push 服务返回成功后，融云默认 Push 成功

• 错误描述：Push 失败后，将返回错识码，开发者可根据错误描述修复错误或提交工单联系融云处理

黑名单、白名单过滤提示

1. 在使用融云黑名单服务状态下，如发送消息用户在目标用户的黑名单中时，消息发送失败，此时消息 ID 为空，提示如下：

白名单服务与黑名单服务相反，如使用的是白名单服务，发送消息用户未在目标用户的白名单中时，消息发送失败消息 ID 为空

群成员被禁言提示

群禁言服务包括群整体禁言、群成员禁言，如群成员在群组中被禁言时，该用户向群组中发送消息失败，此时消息 ID 为空，提示如下：

安全审核过滤提示

发送有文本消息中含有敏感信息审核不通过时，消息被融云服务端屏蔽发送失败，此时消息 ID 为空，提示如下：

• 如消息含有替换敏感词时，消息可正常下发，提示“含有替换敏感词，已完成替换操作”

• 如已开通云净网图片过滤功能，因涉及到图片人工审核影响，暂不支持显示图片消息的审核状态，可在云净网后台查看图片消息审核结果