# 常用功能管理

本文将介绍坐席常用的基础功能。

# 获取随路参数

访客呼叫时携带的额外信息。

_agent.extraStr;

# 透明通道

给通话中的成员发送文字消息。

/**
 * 发送消息
 * @param type 消息类型
 * @param content 消息内容
 * @return 接口调用结果
 */
- (bool)sendMessage:(NSString *)type content:(NSString *)content;
/**
 * 发送消息 (一对一)
 * @param type 消息类型
 * @param content 消息内容
 * @param userId 接收者id
 * @return 接口调用结果
 */
- (bool)sendMessage:(NSString *)type content:(NSString *)content toUserId:(nullable NSString *)userId;

文字内消息通过实现 JCAgentCallback 中的 onMessageReceive (opens new window) 接口上报。

- (void)onMessageReceive:(NSString *)type content:(NSString *)content fromUserId:(NSString *)fromUserId;

# 文本消息

由于会议内透明通道接口要用来处理很多业务流程,故单独封装了用于通话中进行文字交流的接口。

接口原型:

/// 发送文本消息,消息内容不能大于4K
/// @note 通话中的其他成员会收到{@link JCGuestCallback#onTextMessageRecvNotify:fromUserId: onTextMessageRecvNotify}事件
/// @param content 消息内容
/// @param userId 三人及三人以上时可以指定要发送的ID,传空即发送给所有人
- (void)sendTextMessage:(NSString *)content toUserId:(NSString *)userId;

对方收到消息之后会收到回调:

/// 收到文本消息
/// @param content 消息内容
/// @param userId 发送方的ID
- (void)onTextMessageRecvNotify:(NSString *)content fromUserId:(NSString *)userId;

onTextMessageRecvNotify (opens new window) 调用示例:

[_agent sendTextMessage:@"1111" toUserId:NULL];

- (void)onTextMessageRecvNotify:(NSString *)content fromUserId:(NSString *)userId {
    // 收到消息,内容content,发送者userId
}

# 获取通话唯一ID

每一通通话的唯一ID,可用于 portal 第三方接口查询录像文件等.

_agent.serialNumber;

# 排队人数

排队人数通过实现 JCAgentCallback 中的 onCallQueueCount (opens new window) 接口上报(5s自动上报一次)

- (void)onCallQueryWaitCount:(int)count;

# 获取坐席对象

通过JCAgent.guestParticipant (opens new window)获取访客对象。

# 处理加急

收到加急请求以后是否同意加急。

/**
 * 应答加急请求
 * @param serilaNumber serilaNumber
 * @param callerNumber callerNumber
 * @param agree 是否同意
 * @return 操作id
 */
- (int)responseUrgentWithSeialNumber:(NSString *)serilaNumber callerNumber:(NSString *)callerNumber agree:(BOOL)agree;

# 在线消息

只要登录到 Juphoon Cloud平台就可以通过 JCClient 实现在线消息的收发。

/**
 * 发送在线消息
 *
 * @param message 消息内容
 * @param userId 对方的 id
 * @return 成功返回整型的相应的 消息 id,收到{@link JCClientCallback#onOnlineMessageSendResult:messageId: onOnlineMessageSendResult}的通知
 * 失败返回 -1 不会收到{@link JCClientCallback#onOnlineMessageSendResult:messageId: onOnlineMessageSendResult}的通知
 */
- (int)sendOnlineMessage:(NSString* __nonnull)message userId:(NSString* __nonnull)userId;
/**
 * 在线消息发送结果
 *
 * @param result 发送结果是否成功
 * - true:发送成功
 * - false:发送失败
 * @param messageId 消息 id
 */
- (void)onOnlineMessageSendResult:(BOOL)result messageId:(int)messageId;
/**
 * 收到在线消息
 *
 * @param message 消息内容
 * @param userId  对方 id
 */
- (void)onOnlineMessageReceived:(NSString *)message userId:(NSString *)userId;

调用示例:

发送在线消息。

[_client sendOnlineMessage:messageField.text userId:userIdField.text];

接收在线消息发送结果。

- (void)onOnlineMessageSendResult:(BOOL)result messageId:(int)messageId {
    if (result) {
        // 在线消息发送成功
    } else {
        // 在线消息发送失败
    }
}

收到在线消息通知。

- (void)onOnlineMessageReceived:(NSString *)message userId:(NSString *)userId {
    NSLog(@"收到在线消息,内容:%@, 发送方id:%@", message, userId);
}

# 电子签名

调用 requestSign (opens new window) 发起电子签名:

/// 请求访客签名
/// @note 访客会收到{@link JCGuestCallback#onSignRequestRecvNotify: onSignRequestRecvNotify}事件
- (void)requestSign;

#