集成Zendesk收集用户feedback

Zendesk 概述

项目集成Zendesk 可以让应用管理者更加轻松地管理终端客户的服务和支持需求,本文主要是针对iOS 项目集成 Zendesk SDK,收集用户feedback, 并集合到slack channel 实现实时接收用户反馈信息 展开的。

1. 集成Zendesk SDK

和大部分第三方SDK集成方法一样,集成Zendesk 同样有多种方法,包括常用的 CocoaPodsCarthage 以及 在Xcode里手动导入到项目 等方法,具体请参考:iOS 项目集成Zendesk SDK

创建APP

在正式使用sdk 之前,我们还需要到zendesk官方申请注册并创建我们自己的app, 因为这里是想实现收集用户Feedback,对应Zendesk的产品为support, 可以到这里创建我们的app: https://www.zendesk.com/support/

一旦创建完成app, Zendesk 并会为这个app生成 init SDK 需要用到 appId, clientId 以及 appUrl, 具体可在创建完app后到
https://yourApp.zendesk.com/agent/admin/mobile_sdk 里查看,如下图所示:

appId/clientId/appUrl

init SDK

以上工作完成后 可以在项目初始化 sdk了,参考: init zendesk support sdk

在AppDelegate 导入Zendesk并使用上一步获取到的必要参数进行初始化:

import SupportProvidersSDK
import ZendeskCoreSDK

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions:   [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    Zendesk.initialize(appId: "appId", clientId: "clientId",    zendeskUrl: "url")
    Support.initialize(withZendesk: Zendesk.instance)
}

创建一个身份

Zendesk需要一个用户身份,以便该应用可以作为Zendesk支持用户进行身份验证,然后将其设置为Zendesk单例:

let identity = Identity.createAnonymous(name: "\(userName)", email: "\(userEmail)")
Zendesk.instance?.setIdentity(identity)

Zendesk有两种 identity: anonymous 和 JWT. 更多细节参考 identity.

设置身份时注意

  1. 必须在Zendesk.initialize之后且在使用Zendesk API 请求之前设置一个身份。也可以在Support.initialize之前或之后进行设置,如果使用Support SDK而不设置身份将会导致所有网络请求失败,即发送feedback时无法发送成功。

  2. 如果设置身份时没有传入用户名等参数,则在Zendesk后台将会以 Mobile App User 名字显示该用户。

  3. 如果用户第一次发送feedback时没有设置名字或者发送完第一次后更改过名字,则往后发送的所有feedback 在zendesk后台用户名都显示为第一次时的那个(Zendesk后台是用email标记是否同一个用户的)。

  4. 多次设置同一个用户identity 是无效的,即多次调用 setIdentity ()无效,但只要identity不一样了,Zendesk则会认为这是一个新的用户。

2. 使用SDK发送feedback

这里使用自定义UI界面,因此在需要发送时直接调用Zendesk提供的api, 详细文档参考:
Working with API providers

UI
let provider = ZDKRequestProvider()
let request = ZDKCreateRequest()
request.subject = "subject string"
request.requestDescription = "detail string"
request.tags = ["iOS"]   // 作为zendesk 后台分类使用

zendesk支持 自定义字段,创建自定义字段,首先需要在后台添加自己想要的字段,并获取它的 FieldID

Custom Fields

然后 在代码上 进行配置

 let customFieldForAppVersion = CustomField(fieldId: 360028685191, value: "\(versionString)")
request.customFields = [ customFieldForAppVersion]

最后发送请求

provider.createRequest(request) { result, error in

}

发完之后则可以到zendesk后台管理平台查看该条feedback:

后台

如果需要发送附件,则需要在创建request时加入 UploadResponse类型的附件文件

request.attachments = UploadResponse

上传到到zendesk的附件不会被压缩,但有大小限制,根据收费不同可支持不同大小的附件体积上传。如果需要压缩建议在上传关本地压缩文件后再上传。

3. 集成到slack channel

参考文章:
https://support.zendesk.com

1. 在Slack上创建一个新的app

需要在Slack上创建一个新的app, 并拿到一个webhook url

2. 在Zendesk 的extension 中添加一个target:

image.png

3. 在Zendesk 添加一个trigger 触发这个extension.

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 216,544评论 6 501
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 92,430评论 3 392
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 162,764评论 0 353
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 58,193评论 1 292
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 67,216评论 6 388
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 51,182评论 1 299
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 40,063评论 3 418
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,917评论 0 274
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 45,329评论 1 310
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 37,543评论 2 332
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 39,722评论 1 348
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 35,425评论 5 343
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 41,019评论 3 326
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 31,671评论 0 22
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,825评论 1 269
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 47,729评论 2 368
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 44,614评论 2 353