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() {
            @Override
            public void onSuccess(ZendeskUser value) {
                Log.e(TAG, "onSuccess: "+value.getId() );
//                openChat();
            }
        }, new FailureCallback() {
            @Override
            public void onFailure(@NonNull Throwable error) {
                Log.e(TAG, "loginZendesk onFailure: " + error.getMessage());
//                    logoutZendesk();
            }
        });

Zendesk.getInstance().logoutUser(new SuccessCallback() {
            @Override
            public void onSuccess(Unit value) {
                Log.e(TAG, "logoutZendesk onSuccess: " + value.toString());
            }
        }, new FailureCallback() {
            @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大佬，欢迎私信探讨。