Интегрируйте Zoho SDK в Android-приложение

Введение

Используя ASAP SDK для Android, вы можете предложить удобную помощь пользователям вашего приложения для Android. Этот SDK позволяет установить и персонализировать надстройку, встроенную в ваше приложение, предоставляя пользователям легкий доступ к следующему:

Ваша служба поддержки клиентов (для создания заявок в службу поддержки или общения с представителями службы поддержки)
Ваша база знаний (для доступа к справочным статьям)
Ваше сообщество пользователей (для взаимодействия с другими пользователями приложения) Эта функция имеет большое значение для пользователей, поскольку им больше не нужно выходить из приложения, переходить на ваш веб-сайт или отправлять электронное письмо, чтобы обратиться за помощью. Получая доступ к справке из приложения, пользователи могут сэкономить время и повысить качество обслуживания клиентов.

Настройка SDK в ZOHO

Чтобы добавить надстройку ASAP в свое приложение для Android, вы должны сначала создать и зарегистрировать надстройку в Zoho Desk. Чтобы создать надстройку, выполните шаги, описанные ниже:

Перейдите к разделу ASAP в Zoho Desk, выбрав «Настройка» в верхнем меню, затем выбрав «Каналы» и, наконец, выбрав «Как можно скорее».
На панели «Настройка», расположенной слева, нажмите кнопку «+» рядом с «Мобильный телефон» в разделе «Как можно скорее». Это действие приведет вас на страницу «Создать мобильное дополнение».

3. В разделе Сведения о дополнении настройте следующие параметры:

Имя: дайте имя надстройке ASAP (это только для справки и не будет отображаться в пользовательском интерфейсе приложения).
ДоступноДля: выберите, для каких отделов будет включена надстройка ASAP.
Идентификатор пакета. Введите идентификатор пакета (applicationId) своего приложения для Android. Эту информацию можно найти в файле build.gradle вашего приложения. Это обязательно для включения Live Chat и push-уведомлений.
Живой чат. Используйте переключатель, чтобы включить или отключить живой чат. Параметры канала чата должны быть настроены на портале службы поддержки.
Push-уведомления. Используйте переключатель, чтобы включить или отключить push-уведомления. Если вы хотите включить push-уведомления, вы должны ввести ключ сервера GCM/FCM в поле «Введите ключ GCM/FCM». Вы можете получить этот ключ из консоли Firebase. Для включения уведомлений требуется аутентификация пользователя на основе JWT, а push-уведомления, связанные с заявками, не отправляются анонимным пользователям.
Аутентификация. Выберите между анонимной (для гостей, которые могут отправлять заявки, просматривать сообщения сообщества пользователей и общаться с агентом поддержки) или JWT (для аутентифицированных пользователей, которые могут делать все которые могут делать гостевые пользователи, а также просматривать и отслеживать статус своих заявок, отвечать/комментировать заявки и участвовать в сообществе пользователей с дополнительными действиями).

Интеграция SDK в ваше приложение

Чтобы интегрировать SDK в ваше приложение для Android, выполните следующие действия:

Добавьте следующий фрагмент на уровень проекта build.gradle.

allrepositories { 
    ......
    jcenter()
    maven { url 'https://maven.google.com/' }
    maven { url 'http://maven.zohodl.com/' }
}

2. Добавьте следующий фрагмент в файл build.gradle уровня module.

dependencies { compile 'com.zoho.desk:asapsdk:<latest_version>' }

Итак, вы установили SDK в свое приложение для Android.

Настройка Progaurd

Если включены minify и progaurd, необходимо добавить следующие правила в набор progaurd-rules.

-keep class com.zoho.** {*;} -keep interface android.support.v7.** { *; } -keep class android.support.v7.** { *; } -keep interface android.support.v4.** { *; } -keep class android.support.v4.** { *; } -keepattributes Signature -keepattributes Annotation -keep class okhttp3.* { *; } -keep interface okhttp3.* { *; } -dontwarn okhttp3.** -dontwarn okio.** -dontwarn com.zoho.accounts.** -dontwarn com.squareup.okhttp.** -dontwarn okio.** -dontwarn retrofit2.**

Инициализируйте SDK в своем приложении

Для инициализации SDK в вашем приложении необходимы следующие поля.

Идентификатор организации
Идентификатор приложения
Центр обработки данных

Значения этих ключей отображаются в разделе Фрагмент кода на странице настройки надстройки ASAP в Zoho Desk.

Чтобы инициализировать SDK в своем приложении, добавьте следующий фрагмент кода в подкласс класса Application.
Вот как выглядит класс приложения.

import android.app.Application;
import com.zoho.deskportalsdk.DeskConfig;
import com.zoho.deskportalsdk.ZohoDeskPortalSDK;
public class MyApplication extends Application {

    public static ZohoDeskPortalSDK deskInstance;

    @Override public void onCreate() { 
          super.onCreate();
          ZohoDeskPortalSDK.Logger.enableLogs();
          DeskConfig config = new DeskConfig.Builder().build();
          deskInstance = ZohoDeskPortalSDK.getInstance(this);
          // Paste your OrgId, AppId and DataCenter
          deskInstance.initDesk(orgId, appId, dataCenterValue, config);
   } 

}

Отображение компонентов справки

Это почти все. Теперь вы можете приступить к отображению компонентов ZOHO .

Панель инструментов SDK

.....

public class MainActivity extends AppCompatActivity {

    @Override
    public void onCreate(){
      super.onCreate();
    
      // Displaying the Dashboard
      MyApplication.deskInstance.showHome(this);
    }

}

База знаний

public class MainActivity extends AppCompatActivity {

    @Override
    public void onCreate(){
      super.onCreate();
    
      // Displaying the Dashboard
      MyApplication.deskInstance.showKB(this);
    }

}

Отправить заявку

public class MainActivity extends AppCompatActivity {

    @Override
    public void onCreate(){
      super.onCreate();
    
      // Displaying the Dashboard
      MyApplication.deskInstance.submitTicket(this);
    }

}

Заключение

В заключение следует отметить, что интеграция надстройки ASAP SDK в ваше приложение для Android может значительно улучшить работу службы поддержки для ваших конечных пользователей. Благодаря возможности быстрого доступа к вашей команде поддержки, базе знаний и сообществу пользователей, не выходя из вашего приложения, пользователи могут сэкономить время и получить более удобную поддержку. Выполняя шаги, описанные для настройки надстройки в Zoho Desk, вы можете легко настроить и включить функции, которые лучше всего подходят для вашего приложения и его пользователей, создавая более персонализированную и эффективную поддержку.