未读消息

当客服人员回复了用户的消息后，用户可以收到未读消息的提醒，即使当前并没有展示 AIHelp 的页面。

你可以通过主动拉取或者第三方推送实现这个功能。

注意

AIHelp 默认使用随机生成的 deviceId 作为 userId 进行未读消息数量的轮询。

所以，在你将正确的 userId 同步给 AIHelp 之前，未读消息数量可能会不准确。

主动拉取

API

fetchUnreadMessageCount / fetchUnreadTaskCount

调用以上方法可分别拉取当前用户的未读客诉消息或未读工单的数量。

AIHelpSupport::fetchUnreadMessageCount();
AIHelpSupport::fetchUnreadTaskCount();

你可以在任意时间调用该 API 查询当前用户的未读信息，但请注意：

1. 上述方法内部都有默认的频率限制:

在限制期内的重复调用，会返回上一次的查询结果；在开发阶段，可以通过日志查看距离下一次有效调用的时间。

2. 该方法会在以下情况返回 0，以通知调用者当前用户没有未读消息：

• 用户没有进行中客诉或进行中工单时；
• 用户打开客服会话窗口或已读所有工单信息时；

事件

通过监听 MESSAGE_ARRIVAL 以及 UNREAD_TASK_COUNT 事件，你可以收到当前用户的未读消息情况：

AIHelpSupport::registerAsyncEventListener(EventType::MESSAGE_ARRIVAL,
    [](const char *jsonData, Acknowledge ignored) {
        // `jsonData`: { "msgCount": 1 }
    }
);
AIHelpSupport::registerAsyncEventListener(EventType::UNREAD_TASK_COUNT,
    [](const char *jsonData, Acknowledge ignored) {
        // `jsonData`: { "taskCount": 1 }
    }
);

推送方案

推送方案请参考 Android 以及 iOS 的具体说明。