CEC iOS SDK API

消息
会话
留言
满意度评价
实时音视频
集成声网音视频
欢迎语
高级功能
初始化访客语种

消息

发送文本消息

//toUser 为IM服务号
      HDMessage *message = [HDMessage createTxtSendMessageWithContent:text to:toUser];
    [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送文件消息

//filePath为本地文件路径，toUser为IM服务号
      HDMessage *message = [HDMessage createFileSendMessageWithLocalPath:filePath displayName:@"123" to:toUser];
    [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress){
        //发送消息进度
    }completion:^(HDMessage *aMessage, HDError *aError){
        //发送消息完成，aError为空则为发送成功    
    }];

发送语音消息

// duration为语音时长， toUser为IM服务号
    HDMessage *message = [HDMessage createVoiceSendMessageWithLocalPath:localPath duration:duration to:toUser];
    [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送图片消息

// toUser为IM服务号
     HDMessage *message =[HDMessage createImageSendMessageWithData:imageData displayName:@"image" to:toUser];
    [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送地理位置

//toUser为IM服务号  address为地址信息  latitude为纬度 longitude为经度
     HDMessage *message = [HDMessage createLocationSendMessageWithLatitude:latitude longitude:longitude address:address to:toUser];
    [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送透传消息

//机器人转人工的地方有用到,参数为具体的action
   EMCmdMessageBody *body = [[EMCmdMessageBody alloc] initWithAction:@"TransferToKf"];
   HDMessage *message = [[HDMessage alloc] initWithConversationID:<#conversationId#> from:<#环信username#> to:<#IM 服务号#> body:body];
   //参数为type；服务器传过来的参数中的id和serviceSessionId
   ControlType *type = [[ControlType alloc] initWithValue:[weichat valueForKey:@"ctrlType"] ];
   ControlArguments *arguments = [ControlArguments new]; 
   arguments.identity = [ctrlArgs valueForKey:@"id"]; 
   arguments.sessionId = [ctrlArgs valueForKey:@"serviceSessionId"];
   ControlMessage *hcont = [ControlMessage new];
   hcont.type = type; //需要时赋值
   hcont.arguments = arguments; //需要时赋值
   [message addCompositeContent:hcont];
   [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送扩展消息

任何消息类型，均可发送扩展消息，某些功能是通过扩展消息实现（例如：指定技能组、指定客服、传递访客的昵称电话等）。

说明：为不同的消息类型指定扩展消息时，需要避免冲突。例如：如果为轨迹消息和透传消息消息指定不同的技能组，而当两种消息同时为一位访客发送时，则会出现技能组指定错误。

message (HDMessage *);
      NSDictionary *dic = @{@"key1":@"value1",
                            @"key2":@"value2"};
      [message addAttributeDictionary:dic];
      [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送带访客属性的消息

当需要为客服提供访客属性(昵称，电话等)时，需要为消息带上访客属性扩展。例如：当发送文本消息时。

//属性可以缺省
HDVisitorInfo *visitor = [[HDVisitorInfo alloc] init];
visitor.name = @"小明儿";
visitor.qq = @"12345678";
visitor.phone = @"13636362637";
visitor.companyName = @"环信";
visitor.nickName = @"风口上的猪";//必填
visitor.email = @"abv@126.com";
visitor.desc = @"环信客服云";
//自定义字段传参集成用户信息 userDefineColumn 是 json 字符串 如下格式：
visitor.userDefineColumn = @"{"WQQ":"帅哥","QAZ":"LLLLLLLTTTTTTTT"}"
HDMessage *message = [....];//构造相关消息
[message addContent:visitor]; //传访客的属性
[[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
        } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
}];

发送轨迹消息

// toUser为IM服务号
  HDMessage *message = [HDMessage createTxtSendMessageWithContent:@"" to:toUser];
  HDVisitorTrack *vst = [HDVisitorTrack new];
  vst.title = title;  //标题
  vst.price = price; //价格
  vst.desc = desc;//描述
  vst.imageUrl = imageUrl; //图片url
  vst.itemUrl = itemUrl; //点击图片的链接
  NSDictionary *dic2 = @{@"ios":@"我是ios表单预填写的值"};
  [vst.customDic addEntriesFromDictionary:dic2];
  [message addContent:vst];
  
  //预填工单功能 一定要添加如下代码 不然没有这个功能
  NSDictionary *dic1 = @{@"createTicketEnable":@"true"};
  [message addMsgTypeDictionary:dic1];
  
  [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

发送订单消息

//toUser为IM服务号
  HDMessage *message = [HDMessage createTxtSendMessageWithContent:@"" to:toUser];
  HDOrderInfo *ord = [HDOrderInfo new];
  ord.title = title;
  ord.orderTitle = orderTitle;
  ord.price = price;
  ord.desc = desc;
  ord.imageUrl = imageUrl;
  ord.itemUrl = itemUrl;
  //预填工单功能 填写如下方法 一定要在 addContent 方法前添加自定义字段 要不添加不上去
  NSDictionary *dic2 = @{@"ios":@"我是ios表单预填写的值"};
  [ord.customDic addEntriesFromDictionary:dic2];
  //添加订单信息
  [message addContent:ord];
  
   //预填工单功能 一定要添加如下代码 不然没有这个功能
  NSDictionary *dic1 = @{@"createTicketEnable":@"true"};
  [message addMsgTypeDictionary:dic1];
  
  [[HDClient sharedClient].chatManager sendMessage:message progress:^(int progress) {
        //发送消息进度
    } completion:^(HDMessage *aMessage, HDError *aError) {
        //发送消息完成，aError为空则为发送成功
    }];

指定客服消息

调度时，指定某个客服。

客服账号为客服的登录邮箱地址。

HDMessage *message = [....];//构造文字消息
[message addContent:[[HDAgentIdentityInfo alloc] initWithValue:@"客服账号"]];

指定技能组消息

调度时，指定某个技能组。

技能组名称须和客服系统设置的技能组名称完全一致，中英文均可。

HDMessage *message = [....];//构造文字消息
   [message addContent:[[HDQueueIdentityInfo alloc] initWithValue:@"技能组名称"]];

接收消息

通过注册消息监听来接收消息。

//添加消息监控，第二个参数是执行代理方法的队列，默认是主队列
[[HDClient sharedClient].chatManager addDelegate:self delegateQueue:nil];
//移除消息监控
[[HDClient sharedClient].chatManager removeDelegate:self];
- (void)messagesDidReceive:(NSArray *)aMessages{
     //收到普通消息,格式:<HDMessage *>
}
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages{
     //收到命令消息,格式:<HDMessage *>，命令消息不存数据库，一般用来作为系统通知，例如留言评论更新，
     //会话被客服接入，被转接，被关闭提醒
}
- (void)messageStatusDidChange:(HDMessage *)aMessage error:(HDError *)aError{
     //消息的状态修改，一般可以用来刷新列表，显示最新的状态
}
- (void)messageAttachmentStatusDidChange:(HDMessage *)aMessage error:(HDError *)aError{
    //发送消息后，会调用，可以在此刷新列表，显示最新的消息
}

检测消息类型

message.body.type == EMMessageBodyTypeText;  //文本消息
message.body.type == EMMessageBodyTypeImage; //图片消息
message.body.type == EMMessageBodyTypeVoice; //语音消息
message.body.type == EMMessageBodyTypeFile;  //文件消息
message.body.type == EMMessageBodyTypeCmd;   //命令消息

//当文本消息时，需要其他其他的检测，可能为其他类型的消息
[HDjudgeTextMessageSubType isTrackMessage:<#HDMessage *#>] == YES;   //轨迹消息
[HDjudgeTextMessageSubType isOrderMessage:<#HDMessage *#>] == YES;   //订单消息
[HDjudgeTextMessageSubType isMenuMessage:<#HDMessage *#>] == YES;    //菜单消息
[HDjudgeTextMessageSubType isTransferMessage:<#HDMessage *#>] == YES;//转接客服
[HDjudgeTextMessageSubType isEvaluateMessage:<#HDMessage *#>] == YES;//满意度评价

获取聊天记录

*  从数据库获取指定数量的消息，取到的消息按时间排序，并且不包含参考的消息，如果参考消息的ID为空，则从最新消息取
 *
 *  @param aMessageId       参考消息的ID
 *  @param count            获取的条数
 *  @param aDirection       消息搜索方向
 *  @param aCompletionBlock 完成的回调
_conversation = [[HDClient sharedClient].chatManager getConversation:<IM 服务号>];
[_conversation loadMessagesStartFromId:<#messageId#> count:<#(int)count#> searchDirection:<#HDMessageSearchDirectionUp#> completion:^(NSArray *aMessages, HDError *aError) {
        if (!aError && [aMessages count]) {
            //获取到消息aMessages
        }
    }];

会话

获取所有会话

NSArray<HDConversation *> *conversastions = [[HDClient sharedClient].chatManager loadAllConversations];

删除会话及聊天记录

//删除一个会话;参数:会话ID,是否删除相关的消息
[[HDClient shareClient].chatManager deleteConversation:<#conversationId#> deleteMessages:YES];
HDConversation *conversation = [[HDConversation alloc] initWithConversation:<#conversationId#>];
//删除会话中的一条消息记录;参数：消息Id,错误指针
[conversation deleteMessageWithId:<#messageId#> error:<#(HDError **)#>];
//删除会话中的所有消息（不删除会话）
[conversation deleteAllMessages:<#(HDError **)#>];

获取会话未读消息数

HDConversation *conversation = [[HDClient sharedClient].chatManager getConversation:<#IM 服务号#>];
 int unreadCount = conversation.unreadMessagesCount; //获取指定会话的未读消息数

未读消息数清零

HDConversation *conversation = [[HDClient sharedClient].chatManager getConversation:<#IM 服务号#>];
  [conversation markAllMessagesAsRead:nil];

更新会话为已读

[[HDClient sharedClient].chatManager markAllMessagesAsRead:@'需要标记已读的会话id' Completion:^(id responseObject, HDError *error) {
                            
 }];

关闭CEC会话

[[HDClient sharedClient].chatManager cec_closeServiceSessionId:@"会话id" withImServiceNum:@"im服务号" Completion:^(id responseObject, HDError *error) {
                    
                }];

获取访客id

[[HDClient sharedClient].chatManager fetchCurrentVisitorId:@"im服务号" completion:^(HDError *aError, NSString *visitorId) {
                    
            NSLog(@"=====visitorId=%@",visitorId);
        }];

满意度评价

判断是否为评价消息

HDExtMsgType extMsgType = [HDMessageHelper getMessageExtType:{message}];
//如类型为HDExtEvaluationMsg则为满意度评价消息

评价此会话

NSMutableDictionary *ctrlArgs = [NSMutableDictionary dictionaryWithDictionary:[weichat objectForKey:kMesssageExtWeChat_ctrlArgs]];
            NSLog(@"ctrlArgs--%@", ctrlArgs);
            NSMutableArray *evaluationDegree = [ctrlArgs objectForKey:kMesssageExtWeChat_ctrlArgs_evaluationDegree];
            NSDictionary *appraiseTagsDict = [evaluationDegree objectAtIndex:0];

详见：SatisfactionViewController.m类

主动发起满意度评价邀请

// conversation 是HDConversationManager类型对象
[conversation sendSatisfactionEvaluationCompletion:^(BOOL send, HDError *error) {}];

获取配置对应的接口

typedef NS_ENUM (NSInteger, HDOptionConfig) {
/**< 问题解决评价 开关    */
 HDOption_Satisfaction_ProblemSolvingEvaluationOn = 1,
/**< 请对我的服务做出评价 文案   */    
HDOption_Satisfaction_GreetingMsgEnquiryInvite,   
/**< 问题解决评价引导语    */
HDOption_Satisfaction_EvaluteSolveWord,    
};   
/*
 *  获取配置接口对应参数
 * option ： HDOptionConfig 枚举类型
 * serviceSessionId 会话id
 */
[[HDClient sharedClient].chatManager getOptionsConfig: option  WithServiceSessionId: Completion:^(id responseObject, HDError *error) {
             
        NSLog(@"返回对应的值%@",responseObject);
}];

获取满意度评价解决未解决标签接口

// ServiceSessionId 是 当前会话ID
[[HDClient sharedClient].chatManager getResolutionParamServiceSessionId:@"当前会话id" Completion:^(id responseObject, HDError *error) {
                     
}];

留言

获取所有留言

/**
 @brief 获取留言列表
 @discussion 失败返回NSError,成功返回responseObject

 @param projectId 留言ProjectId  进入“管理员模式 → 留言”，可以看到这个Project ID
 @param targetUser IM 服务号
 @param page 第几页从0开始
 @param pageSize 每页显示个数
 @param completion 返回结果
 */
- (void)getLeaveMsgsWithProjectId:(NSString *)projectId
                           targetUser:(NSString *)imCustomerService
                            page:(NSInteger)page
                        pageSize:(NSInteger)pageSize
                      completion:(void(^)(id responseObject,NSError *error))completion;

创建一个新的留言

/**
 @brief 创建一个留言
 @discussion 失败返回NSError,成功返回responseObject
 @param projectId 留言ProjectId  进入“管理员模式 → 留言”，可以看到这个Project ID
 @param imCustomerService im服务号
 @param requestBody 留言参数
 @param completion 返回结果
 */
- (void)createLeaveMsgWithProjectId:(NSString *)projectId
                         targetUser:(NSString *)imCustomerService
                        requestBody:(LeaveMsgRequestBody *)requestBody
                         completion:(void(^)(id responseObject,NSError *error))completion;

获取留言详情

/**
 @brief 获取留言详情
 @discussion 失败返回NSError,成功返回responseObject

 @param projectId 留言的Project ID
 @param targetUser im服务号
 @param ticketId  留言ID
 @param completion 返回结果 通过error判断成败
 */
- (void)getLeaveMsgDetailWithProjectId:(NSString *)projectId
                                    targetUser:(NSString *)imCustomerService
                              ticketId:(NSString*)ticketId
                            completion:(void(^)(id responseObject,NSError *error))completion;

获取一个留言的所有评论

/**
 @brief 获取留言下所有评论
 @discussion 失败返回NSError,成功返回responseObject
 @param targetUser im服务号
 @param projectId 留言ProjectId  进入“管理员模式 → 留言”，可以看到这个Project ID
 @param ticketId 留言ID
 @param page 第一页从0开始
 @param pageSize 每页显示的个数
 @param completion 返回结果 通过error判断成败
 */

- (void)getLeaveMsgCommentsWithProjectId:(NSString*)projectId
                                        targetUser:(NSString *)imCustomerService
                                ticketId:(NSString *)ticketId
                                    page:(NSUInteger)page
                                pageSize:(NSUInteger)pageSize
                              completion:(void(^)(id responseObject,NSError *error))completion;

给一个留言添加评论

/**
 @brief 给一个留言添加评论
 @discussion 失败返回NSError,成功返回responseObject
 @param targetUser im服务号
 @param projectId 留言ProjectId  进入“管理员模式 → 留言”，可以看到这个Project ID
 @param ticketId 留言ID
 @param requestBody 请求体
 @param completion 返回结果block
 */
- (void)createLeaveMsgCommentWithProjectId:(NSString*)projectId
                                     targetUser:(NSString *)imCustomerService
                                  ticketId:(NSString *)ticketId
                               requestBody:(LeaveMsgRequestBody*)requestBody
                                completion:(void(^)(id responseObject,NSError *error))completion;

获取工作状态

/**
  @brief 获取当前是否是留言状态

 @param imServiceNumber im服务号
 @param completion 返回结果 true or false
 */
- (void)getWorkStatusWithToUser:(NSString *)imServiceNumber completion:(void (^)(BOOL,NSError *))completion;

实时音视频

基本设置

//接受视频邀请的设置
HDCallOptions *options = [[HDCallOptions alloc] init];
options.videoOff = NO; //是否关闭视频传输
options.mute = NO; //是否静音
options.nickName = <#(NSString *)#>; //昵称
options.previewView = <#(HCallLocalView*)#>; //本地预览View
[[HDClient sharedClient].callManager setCallOptions:options];

监听呼入通话

//注册实时通话回调
 [[HDClient sharedClient].callManager addDelegate:<#(id<HDCallManagerDelegate>)#> delegateQueue:nil]; //queue默认为main
 //移除实时通话回调
 [[HDClient sharedClient].callManager removeDelegate:<#(id<HDCallManagerDelegate>)#>];
 //收到一个视频通话请求,参数为请求者昵称
- (void)onCallReceivedNickName:(NSString *)nickName;
//有成员进入会话
- (void)onMemberJoin:(HDCallMember *)member;
//成员离开
- (void)onMemberExit:(HDCallMember *)member;
//有视频流进来
- (void)onStreamAdd:(HDCallStream *)stream;
//视频流被移除[不包括自己]
- (void)onStreamRemove:(HDCallStream *)stream;
//视频流刷新
- (void)onStreamUpdate:(HDCallStream *)stream;
//视频通话结束
- (void)onCallEndReason:(int)reason desc:(NSString *)desc;
- (void)onNotice:(HMediaNoticeCode)code arg1:(NSString *)arg1 arg2:(NSString *)arg2 arg3:(id)arg3;

接听通话

[[HDClient sharedClient].callManager acceptCallCompletion:^(id obj, HDError *error) {
        if (error == nil) { //接受成功
        }
}];

拒绝接听

[[HDClient sharedClient].callManager endCall];

挂断通话

[[HDClient sharedClient].callManager endCall];

暂停和恢复语音或视频数据传输

//关闭麦克风
[[HDClient sharedClient].callManager pauseVoice];
//打开麦克风
 [[HDClient sharedClient].callManager resumeVoice];
//关闭本地视频传输
[[HDClient sharedClient].callManager pauseVideo];
//打开本地视频传输
[[HDClient sharedClient].callManager resumeVideo];

切换摄像头

//切换镜头
[[HDClient sharedClient].callManager switchCameraPosition:YES]; //默认前置摄像头(YES)

视频通话订阅对方的流和显示图像

// topView 用于显示的view
[[HDClient sharedClient].callManager subscribeStreamId:streamId view:topView completion:^(id obj, HDError *error) {
    if (error == nil) {
    } else {
    }
}];

取消订阅

[[HDClient sharedClient].callManager unSubscribeStreamId:streamId completion:^(id obj, HDError *error) {
    if (error == nil) {
    } else {
    }
}];

取消视频邀请

[[HDClient sharedClient].callManager asyncCancelVideoInviteWithImId:<#im服务号#> completion:^(HDError *error) {
        
    }];

共享桌面

// view 为需要共享的view
[[HDClient sharedClient].callManager publishWindow:view completion:^(id obj, HDError * error) {}];

⚠️注：因为ios系统比较特殊，系统级别的共享方案在ios10推出，ios11才完善，您也可以公告自定义数据流的方式通过系统api获取桌面流，然后传入sdk中，具体参考如下：

[[HDClient sharedClient].callManager publishWindow:nil completion:^(id obj, HDError * error) {
  [[RPScreenRecorder sharedRecorder] startCaptureWithHandler:^(CMSampleBufferRef  _Nonnull sampleBuffer, RPSampleBufferType bufferType, NSError * _Nullable error)
  {
    if (CMSampleBufferDataIsReady(sampleBuffer) && bufferType == RPSampleBufferTypeVideo)
    {
      [[HDClient sharedClient].callManager inputCustomVideoSampleBuffer:sampleBuffer rotation:UIDeviceOrientationPortrait publishId:obj completion:^(HDError *error) {}];
    }
  } 
  completionHandler:nil];
}];

集成声网音视频

监听呼入通话

//注册实时通话回调 
[[HDClient sharedClient].callManager addDelegate:<#(id<HDCallManagerDelegate>)#> delegateQueue:nil]; 
//queue默认为main //移除实时通话回调 
[[HDClient sharedClient].callManager removeDelegate:<#(id<HDCallManagerDelegate>)#>]; 
//收到一个视频通话请求,参数为加入房间 相关参数
- (void)onCallReceivedParameter:(HDKeyCenter *)keyCenter;
//第三方坐席进来 获取对应的坐席信息
- (void)onCallReceivedInvitation:(NSString *)thirdAgentNickName withUid:(NSString *)uid;

更多集成可以参考访客demo中Call模块中的实现。CEC iOS UI

欢迎语

获取机器人欢迎语

//使用<HDClient.sharedClient.chatManager>调用
// 获取机器人欢迎语 翻译使用api  aServerNumber：im服务号 visitorUserName：访客用户名
- (void)getRobotWelcomeWithImServerNumber:(NSString *)aServerNumber withVisitorUserName:(NSString *)visitorUserName
                               completion:(void(^)(NSDictionary *info, HDError *error))aCompletion;
// 获取机器人欢迎语 aServerNumber：im服务号
- (void)getRobotWelcomeWithImServerNumber:(NSString *)aServerNumber
                               completion:(void(^)(NSDictionary *info, HDError *error))aCompletion;

获取企业欢迎语

// 获取企业欢迎语 使用<HDClient.sharedClient.chatManager>调用
- (void)getEnterpriseWelcomeWithCompletion:(void(^)(NSString *welcome, HDError *error))aCompletion;
// 获取企业欢迎语 设置语种 visitorUserName 访客登录用户名
- (void)getEnterpriseWelcomeWithVisitorUserName:(NSString *)visitorUserName WithCompletion:(void(^)(NSString *welcome, HDError *error))aCompletion;

获取app关联中个性化会话设置的企业欢迎语

// 获取企业欢迎语 使用<HDClient.sharedClient.chatManager>调用
// 获取 APP关联设置：个性化会话设置增加企业欢迎语 visitorUserName 用户名 aServerNumber ： im服务号 也就是to
- (void)getAppRelevanceEnterpriseWelcomeWithVisitorUserName:(NSString *)visitorUserName withImServerNumber:(NSString *)aServerNumber Completion:(void(^)(NSString *welcome, HDError *error))aCompletion;

获取技能组菜单

// 获取技能组菜单 设置语种 visitorUserName 访客登录用户名 使用<HDClient.sharedClient.chatManager>调用 
- (void)getSkillGroupMenuWithVisitorUserName:(NSString *)visitorUserName Completion:(void (^)(NSDictionary *, HDError *))aCompletion

获取app关联中个性化会话设置的欢迎语菜单指定技能组

// 使用<HDClient.sharedClient.chatManager>调用 
// 获取 APP关联设置：个性化会话设置增加获取技能组菜单界面skillgroup-menu visitorUserName 用户名 aServerNumber ： im服务号 也就是to
- (void)getAppRelevanceSkillGroupMenuWithVisitorUserName:(NSString *)visitorUserName withImServerNumber:(NSString *)aServerNumber Completion:(void(^)(NSDictionary *info, HDError *error))aCompletion;

获取当前会话id

/**
 * 获取当前会话id
 * @param aUsername         IM服务号
 * @param aCompletionBlock  发送完成回调block,如果当前有会话，则返回，没有时，返回nil, 表示当前无有效会话
 */

// 使用<HDClient.sharedClient.chatManager>调用
- (void)fetchCurrentSessionId:(NSString *)aUsername
                   completion:(void(^)(NSString *sessionId, HDError *aError))aCompletionBlock;
// 当返回sessionId为空时，则代表此会话不存在，也就是未咨询或者咨询已结束，下次咨询可先发欢迎语
// 当返回value不为空时，则返回的当前会话的会话ID，也就是说会话正在咨询中，不需要发送欢迎语

高级功能

显示排队人数

首先，初始化时，需要调用option.visitorWaitCount = YES;打开待接入访客排队人数功能。完成以下设置，之后实现HDChatManagerDelegate中的visitorWaitCount方法。

1、在sdk初始化时开始设置：

HDOptions *option = [[HDOptions alloc] init];
...
option.visitorWaitCount = YES; 
HDError *initError = [[HDClient sharedClient] initializeSDKWithOptions:option];

2、调用方法：

[[HDClient sharedClient].chatManager bindChatWithConversationId:<#会话id#>];

3、当调用以上方法后，排队人数会开启查询模式，每隔3秒左右会回调HDChatManagerDelegate#visitorWaitCount:方法上报排队人数。

-(void)visitorWaitCount:(int)count;

// 其中：count为前面有多少人正在排队， 一般大于0时，显示排队人数，当等于0，需要隐藏掉提示。在非等待状态，count均为0

获取坐席的输入状态

1. 初始化时设置需要监听输入状态：

options.showAgentInputState = YES;

2. 需要监听<HDChatManagerDelegate>的agentInputStateChange:方法

/**
 坐席输入状态变化

 @param content 内容
 */
- (void)agentInputStateChange:(NSString *)content;

[[HDClient sharedClient].chatManager addDelegate:self delegateQueue:nil];

3. 在聊天页面调用以下方法后，可以收到agentInputStateChange: 回调

[[HDClient sharedClient].chatManager bindChatWithConversationId:self.conversation.conversationId];

初始化访客语种

// 获取企业欢迎语 设置语种 visitorUserName 访客登录用户名 language需要翻译的语言代码  使用<HDClient.sharedClient>调用
//   传递语言代码 可以参考 文档 http://docs.easemob.com/cs/100agentmode/10conversation#智能翻译
- (void)hd_SetVisitorLanguage:(NSString *)language withVisitorUserName:(NSString *)visitorUserName  completion:(void (^)(id responseObject,HDError *aError))aCompletionBlock

目录

CEC iOS SDK API

消息

发送文本消息

发送文件消息

发送语音消息

发送图片消息

发送地理位置

发送透传消息

发送扩展消息

发送带访客属性的消息

发送轨迹消息

发送订单消息

指定客服消息

指定技能组消息

接收消息

检测消息类型

获取聊天记录

会话

获取所有会话

删除会话及聊天记录

获取会话未读消息数

未读消息数清零

更新会话为已读

关闭CEC会话

获取访客id

满意度评价

判断是否为评价消息

评价此会话

主动发起满意度评价邀请

获取配置对应的接口

获取满意度评价解决未解决 标签接口

留言

获取所有留言

创建一个新的留言

获取留言详情

获取一个留言的所有评论

给一个留言添加评论

获取工作状态

实时音视频

基本设置

监听呼入通话

接听通话

拒绝接听

挂断通话

暂停和恢复语音或视频数据传输

切换摄像头

视频通话订阅对方的流和显示图像

取消订阅

取消视频邀请

共享桌面

集成声网音视频

监听呼入通话

欢迎语

获取机器人欢迎语

获取企业欢迎语

获取app关联中个性化会话设置的企业欢迎语

获取技能组菜单

获取app关联中个性化会话设置的欢迎语菜单指定技能组

获取当前会话id

高级功能

显示排队人数

获取坐席的输入状态

初始化访客语种

获取满意度评价解决未解决标签接口