未读消息数回调

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

你可以通过每五分钟一次的轮询作业或者第三方推送实现这个功能。

提示

此功能默认为关闭状态，如有需要，请联系 AIHelp 运营人员开启此功能。

轮询方案

注意

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

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

API

startUnreadMessageCountPolling

调用此方法可以启动未读消息数量的轮询作业，请确保初始化成功之后再调用此方法。

bool AppDelegate::applicationDidFinishLaunching() {
    AIHelpSupport::setOnAIHelpInitializedCallback(AIHelp_onAIHelpInit);
}

void AIHelp_onAIHelpInit() {
    // Sync userId info to AIHelp via updateUserInfo API
    AIHelpSupport::updateUserInfo(new UserConfigBuilder().setUserId("uid").build());
    
    // Start polling
    AIHelpSupport::startUnreadMessageCountPolling(AIHelp_unreadMessageArrived);
}

static void AIHelp_unreadMessageArrived(const int unreadCount) {
    // write your code here
}

方法内部每 5 分钟主动拉取一次当前用户的未读消息数量，并在以下两种情况时将结果返回给调用者：

1、有进行中客诉的用户收到新消息时，返回该用户累计未读的消息数量；

2、用户打开客服会话窗口时，返回数字 0 以标记用户已读当前消息。

参数释义

onUnreadMessageCountCallback

• 类型：void (*OnMessageCountArrivedCallback)(int unreadCount)
• 详情：必传参数。 未读消息数量的回调。