最近联系人

拉取会话列表

支持分页拉取会话列表。

使用示例：

GetRecentContactListRequest request = GetRecentContactListRequest.builder()
        .fromAccount("doocs")
        .timestamp(0)
        .startIndex(0)
        .topTimestamp(0)
        .topStartIndex(0)
        .assistFlags(AssistFlags.BIT_0)
        .build();

GetRecentContactListResult result = client.recentContact.recentContactList(request);

删除单个会话

删除指定会话，支持同步清理漫游消息。

使用示例：

DeleteRecentContactRequest request = DeleteRecentContactRequest.builder()
        .fromAccount("doocs_1")
        .type(RecentContactType.C2C)
        .toAccount("doocs_2")
        .clearRamble(ClearRamble.YES)
        .build();

DeleteRecentContactResult result = client.recentContact.deleteRecentContact(request);

创建会话分组数据

会话分组标记数据独立于最近联系人，RestAPI 支持会话分组、会话标准标记、会话自定义标记等字段增删改查。会话分组标记最多支持 1000 个会话，而一个用户最多支持 20 个会话分组。本接口支持会话分组数据的创建，仅旗舰版支持会话分组数据操作。

使用示例：

List<GroupContactItem> items = new ArrayList<>();
GroupContactItem item = new GroupContactItem();
item.setGroupName("groupName");

List<ContactItem> contactItems = new ArrayList<>();
ContactItem contactItem = new ContactItem();
contactItem.setToAccount("ccc");
contactItem.setToGroupId("group1");
contactItem.setType(1);
contactItems.add(contactItem);
item.setContactItem(contactItems);
items.add(item);
CreateContactGroupRequest request = CreateContactGroupRequest.builder()
        .fromAccount("test1")
        .groupContactItem(items).build();

CreateContactGroupResult result = client.recentContact.createContactGroup(request);

更新会话分组数据

会话分组标记数据独立于最近联系人，RestAPI 支持会话分组、会话标准标记、会话自定义标记等字段增删改查。会话分组标记数据最多支持 1000 个会话。本接口支持会话分组数据的更新，仅旗舰版支持会话分组数据操作。

使用示例：

UpdateGroup updateGroup = UpdateGroup.builder().updateGroupType(1)
        .newGroupName("hh").oldGroupName("cc").build();
UpdateContactGroupRequest request = UpdateContactGroupRequest.builder()
        .updateType(1)
        .fromAccount("test1")
        .updateGroup(updateGroup)
        .build();

UpdateContactGroupResult result = client.recentContact.updateContactGroup(request);

删除会话分组数据

本接口支持删除用户的会话分组数据，仅旗舰版支持会话分组数据操作。

使用示例：

List<String> groupName = new ArrayList<>();
groupName.add("hh");
DelContactGroupRequest request = DelContactGroupRequest.builder()
        .groupName(groupName)
        .fromAccount("test1")
        .build();

DelContactGroupResult result = client.recentContact.delContactGroup(request);

创建或更新会话标记数据

会话分组标记数据独立于最近联系人，RestAPI 支持会话分组、会话标准标记、会话自定义标记等字段增删改查。会话分组标记最多支持 1000 个会话。本接口支持会话标准标记以及会话自定义标记的创建或更新，仅旗舰版支持会话标准标记数据操作，自定义会话标记数据无限制。

使用示例：

List<MarkContactItem> items = new ArrayList<>();
MarkContactItem item = new MarkContactItem();
item.setClearMark(Collections.singletonList(1));
item.setSetMark(Collections.singletonList(2));
item.setOptType(1);
items.add(item);
MarkContactRequest request = MarkContactRequest.builder()
        .fromAccount("test1")
        .markItem(items)
        .build();

MarkContactResult result = client.recentContact.markContact(request);

搜索会话分组标记

本接口根据指定的会话来查询对应会话分组标记数据。

使用示例：

SearchContactGroupRequest request = new SearchContactGroupRequest();
request.setFromAccount("test1");
ContactItem contactItem = new ContactItem();
contactItem.setType(1);
contactItem.setToAccount("test2");
contactItem.setToGroupId("123");
request.setContactItem(Collections.singletonList(contactItem));

SearchContactGroupResult result = client.recentContact.searchContactGroup(request);

拉取会话分组标记数据

本接口支持批量获取用户的会话分组标记数据。

使用示例：

GetContactGroupRequest request = new GetContactGroupRequest();
request.setFromAccount("test1");
request.setStartIndex(1);

GetContactGroupResult result = client.recentContact.getContactGroup(request);