Zendesk接入踩坑汇总(Android)

Zendesk简介:

Zendesk是国外一家第三方在线客服,主要功能包含工单,客服,机器人回复,support等。接入方式有统一接入,以及单一接入。

  • 统一接入:为了确保我们的产品外观和感觉相同,Zendesk 构建了一个统一的消息接口,称为统一 SDK。也就是说采用该方式,打开任何跟zendesk相关的页面,UI格式采用的都是同一套。参考接入文档
  • 单一接入:单独集成message,bot,support,chat,sell等功能,其中老版本support是基础,任何功能都基于support上实现,而新版本的话可以直接集成所需功能。参考接入文档
  • 注意事项:
    1、Messaging版zendesk跟经典zendesk(应该就是我理解的统一接入的那个版本)不兼容,不能共用
    2、zendesk是单例模式,意味着在APP全局用到的都是同一个zendesk
    3、zendesk是跟application绑定的,无法在APP使用过程中切换。除非从application层彻底重启应用
    4、zendesk不支持大幅修改UI,只能简单的修改下颜色值

接入流程

接入流程分为两个步骤,一是非技术方面的运营人员立项,二是技术人员的代码层面的接入
一、立项流程
1、先创建项目,得到带有公司域名的zendesk链接
2、通过上面的链接登入管理员账号,创建不同的channel(这里的channel一般指的是不同类型的功能以及客户端,比如说fb渠道安卓版)
3、设置channel的配置,比如说机器人自动答复,可设置不同语言下的机器人bot
4、将机器人跟channel关联起来
二、技术接入。
参考上面简介里的官方文档

  • 以messaging版本举例(单一接入)
    1、添加依赖
    2、检查权限
    3、初始化SDK,在channel选择需要的channel,在它的安装里拷贝channelKey
    4、在需要的地方调用Zendesk.getInstance().getMessaging().showMessaging(context);去显示zendesk的客服页面
  • 登入登出
Zendesk.getInstance().loginUser("从服务器获取到的jwt", new SuccessCallback<ZendeskUser>() {
            @Override
            public void onSuccess(ZendeskUser value) {
                Log.e(TAG, "onSuccess: "+value.getId() );
//                openChat();
            }
        }, new FailureCallback<Throwable>() {
            @Override
            public void onFailure(@NonNull Throwable error) {
                Log.e(TAG, "loginZendesk onFailure: " + error.getMessage());
//                    logoutZendesk();
            }
        });
Zendesk.getInstance().logoutUser(new SuccessCallback<Unit>() {
            @Override
            public void onSuccess(Unit value) {
                Log.e(TAG, "logoutZendesk onSuccess: " + value.toString());
            }
        }, new FailureCallback<Throwable>() {
            @Override
            public void onFailure(@NonNull Throwable error) {
                Log.e(TAG, "logoutZendesk onFailure: " + error.getMessage());
            }
        });
  • 接入messaging的通知功能(非必选)
    5、通知设置,将firebase的密钥以及id,填写在所选channel的通知选项里
    6、选择默认的通知接收的话就在AndroidManifest.xml里配置DefaultMessagingService,否则就自定义service继承FirebaseMessagingService ,调用PushNotifications.updatePushNotificationToken(newToken);

  • 隐藏方法(感谢我的同事替我找出来)

//重置zendesk,重置过后再次初始化zendesk可更换渠道
Zendesk.Companion.invalidate();

后记

由于zendesk相关介绍文档比较少,我之前接入过一次,较为简单就没有做系统化的整理,这次需求比较复杂,花了不少时间去理解国外人的使用习惯。理解的不一定对,如有zendesk大佬,欢迎私信探讨。

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

推荐阅读更多精彩内容