====== 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{
//收到普通消息,格式:
}
- (void)cmdMessagesDidReceive:(NSArray *)aCmdMessages{
//收到命令消息,格式:，命令消息不存数据库，一般用来作为系统通知，例如留言评论更新，
//会话被客服接入，被转接，被关闭提醒
}
- (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:];
[_conversation loadMessagesStartFromId:<#messageId#> count:<#(int)count#> searchDirection:<#HDMessageSearchDirectionUp#> completion:^(NSArray *aMessages, HDError *aError) {
if (!aError && [aMessages count]) {
//获取到消息aMessages
}
}];
===== 会话 =====
==== 获取所有会话 ====
NSArray *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)#> delegateQueue:nil]; //queue默认为main
//移除实时通话回调
[[HDClient sharedClient].callManager removeDelegate:<#(id)#>];
//收到一个视频通话请求,参数为请求者昵称
- (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)#> delegateQueue:nil];
//queue默认为main //移除实时通话回调
[[HDClient sharedClient].callManager removeDelegate:<#(id)#>];
//收到一个视频通话请求,参数为加入房间 相关参数
- (void)onCallReceivedParameter:(HDKeyCenter *)keyCenter;
//第三方坐席进来 获取对应的坐席信息
- (void)onCallReceivedInvitation:(NSString *)thirdAgentNickName withUid:(NSString *)uid;
更多集成可以参考访客demo中Call模块中的实现。[[cs:300visitoraccess:iosdemo|CEC iOS UI]]
===== 欢迎语 =====
==== 获取机器人欢迎语 ====
//使用调用
// 获取机器人欢迎语 翻译使用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;
==== 获取企业欢迎语 ====
// 获取企业欢迎语 使用调用
- (void)getEnterpriseWelcomeWithCompletion:(void(^)(NSString *welcome, HDError *error))aCompletion;
// 获取企业欢迎语 设置语种 visitorUserName 访客登录用户名
- (void)getEnterpriseWelcomeWithVisitorUserName:(NSString *)visitorUserName WithCompletion:(void(^)(NSString *welcome, HDError *error))aCompletion;
==== 获取app关联中个性化会话设置的企业欢迎语 ====
// 获取企业欢迎语 使用调用
// 获取 APP关联设置：个性化会话设置增加企业欢迎语 visitorUserName 用户名 aServerNumber ： im服务号 也就是to
- (void)getAppRelevanceEnterpriseWelcomeWithVisitorUserName:(NSString *)visitorUserName withImServerNumber:(NSString *)aServerNumber Completion:(void(^)(NSString *welcome, HDError *error))aCompletion;
==== 获取技能组菜单 ====
// 获取技能组菜单 设置语种 visitorUserName 访客登录用户名 使用调用
- (void)getSkillGroupMenuWithVisitorUserName:(NSString *)visitorUserName Completion:(void (^)(NSDictionary *, HDError *))aCompletion
==== 获取app关联中个性化会话设置的欢迎语菜单指定技能组 ====
// 使用调用
// 获取 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, 表示当前无有效会话
*/
// 使用调用
- (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. 需要监听的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需要翻译的语言代码 使用调用
// 传递语言代码 可以参考 文档 http://docs.easemob.com/cs/100agentmode/10conversation#智能翻译
- (void)hd_SetVisitorLanguage:(NSString *)language withVisitorUserName:(NSString *)visitorUserName completion:(void (^)(id responseObject,HDError *aError))aCompletionBlock