开发者平台

信息通知推送

云客服移动SDK 通知普通用户工单被客服公开回复，或即时交谈的离线消息。

目前集成推送通知的唯一方法是使用一个回调的API，在使用该API前，您必须保证您的应用开启了远程推送服务。

在这里，你需要做三件事：

1、 在你的账号里配置您的移动SDK应用程序启动推送通知

2、 设置回调URL支持我们的回调

3、 在您的应用程序处理用户的唯一标示和推送请求

回调的API

当有消息发送时，云客服SDK将通知您设置的回调URL。之后，您的服务必须处理发送推送通知到最终用户的设备。

当我们想要发送一个通知给最终用户,我们会发送一个POST请求的URI设置应用程序配置。示例请求:

POST <回调URL>
Content-Type: application/json
Accept: application/json
{
"device":[
{ 
"device_token":"1234567890",
"type":"IOS"
}
],
"notification": {
"ticket_id":"123",
}
}

同样，在聊天中发送离线消息中，向设置的回调URL发送的数据示例:

POST <回调URL>
Content-Type: application/json
Accept: application/json
{
"device":[
{ 
"device_token":"1234567890",
"type":"IOS"
}
],
"notification": {
"message":"hello",
}
}

他请求主体是一个JSON对象包含以下参数:

devices

将要推送的设备

notification

推送的信息(推送工单消息时)

推送的信息(推送聊天离线消息时)

通知

给您的应用程序注册通知

通过 [KFPushUtil enablePush:ktoken withSuccess:^(id result) { } andError:^(NSError *error) {}];发送最终用户的唯一标示，即可完成推送设置。

建议：最好在用户退出登录或不需要推送的时候，通过[KFPushUtil disablePush:ktoken withSuccess:^(id result) { } andError:^(NSError *error) {}];将用户的唯一标示删除。

KFPushUtil.h

注：推送通知配置

方法说明

1、 发送设备的deviceToken

+ (void)enablePush:(NSString *)deviceToken withSuccess:(KFAPISuccess)success
          andError:(KFAPIError)error;

2、 删除设备的deviceToken

+ (void)disablePush:(NSString *)deviceToken withSuccess:(KFAPISuccess)success
         andError:(KFAPIError)error;

注：在用户退出登录或更换用户时，建议将上一用户的token删除，以免发生推送冲突，如果已经调用[[KFConfig shareConfig]logoutOfUser]，则无需再次调用此接口。