信息通知推送
云客服移动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",
}
}
他请求主体是一个JSON对象包含以下参数:
参数名称 | 类型 | 说明 |
---|---|---|
device | array | 设备的列表 |
notification | object | 推送通知信息 |
devices
将要推送的设备
参数名称 | 类型 | 说明 |
---|---|---|
device_token | string | 设备的唯一标示 |
type | string | 设备的类型 |
notification
推送的信息
参数名称 | 类型 | 说明 |
---|---|---|
ticket_id | string | 工单编号 |
通知
给您的应用程序注册通知
通过 [KFPushUtil enablePush:ktoken withSuccess:^(id result) { } andError:^(NSError *error) {}];发送最终用户的唯一标示,即可完成推送设置。
建议:最好在用户退出登录或不需要推送的时候,通过[KFPushUtil disablePush:ktoken withSuccess:^(id result) { } andError:^(NSError *error) {}];将用户的唯一标示删除。
KFPushUtil.h
注:推送通知配置
方法说明
1、 发送设备的deviceToken
+ (void)enablePush:(NSData *)deviceToken withSuccess:(KFAPISuccess)success
andError:(KFAPIError)error;
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
deviceToken | NSData | 是 | 设备的deviceToken |
success | Block | 无 | 成功时回调函数 |
error | Block | 无 | 失败时回调函数 |
2、 删除设备的deviceToken
+ (void)disablePush:(NSData *)deviceToken withSuccess:(KFAPISuccess)success
andError:(KFAPIError)error;
参数名称 | 类型 | 是否必填 | 说明 |
---|---|---|---|
deviceToken | NSData | 是 | 设备的deviceToken |
success | Block | 无 | 成功时回调函数 |
error | Block | 无 | 失败时回调函数 |