Panduan Android SDK

Halaman ini menjelaskan cara menggunakan Android SDK.

Mengakses aplikasi contoh

Untuk mendownload aplikasi contoh Android, klik Aplikasi contoh Android.

Untuk membuat aplikasi contoh menggunakan Android Mobile SDK, Anda memerlukan hal-hal berikut:

• Kunci Perusahaan dan Rahasia Perusahaan portal CCAI Platform.

• Android 5.0 (API level 21, Lollipop) atau yang lebih baru.

• Firebase Cloud Messaging atau Google Cloud Messaging untuk notifikasi push.

• Aplikasi dimigrasikan ke AndroidX.

Persyaratan upgrade SDK Twilio

Memerlukan Twilio SDK untuk mengikuti versi tertentu jika Android SDK diintegrasikan menggunakan paket kami secara langsung, jika tidak, hal ini dapat diabaikan.

// Twilio VoIP SDK
api 'com.twilio:voice-android:6.1.1'
// Twilio Conversations SDK
api 'com.twilio:conversations-android:3.1.0'

Selain itu, aturan ProGuard sudah disertakan dalam Android SDK untuk memastikan bahwa library Twilio Programmable Voice tidak dihapus oleh ProGuard dan dapat digunakan untuk memecahkan masalah jika ProGuard secara tidak sengaja menghapus library.

-keep class com.twilio.** { *; }
-keep class tvo.webrtc.** { *; }
-dontwarn tvo.webrtc.**
-keep class com.twilio.voice.** { *; }
-keepattributes InnerClasses

Untuk mendukung versi Twilio terbaru, mulai dari Android SDK versi 0.34.0, SDK tidak lagi kompatibel secara biner dengan aplikasi yang menargetkan Java 7. Untuk menggunakan rilis ini dan rilis mendatang, developer harus mengupgrade aplikasi mereka agar menargetkan Java 8. Lihat contoh kode berikut:

android {
    compileOptions {
        sourceCompatibility 1.8
        targetCompatibility 1.8
    }
}

Mendapatkan kunci perusahaan dan secret perusahaan

1. Login ke Admin Portal menggunakan kredensial Admin.

2. Buka Setelan > Setelan Developer > Kunci Perusahaan & Kode Rahasia.

3. Ambil Company Key dan Company Secret Code.

Penginstalan

Tambahkan repositori Android SDK ke setelan Gradle untuk project root.

build.gradle (Project)

allprojects {
    repositories {
        google()
        jcenter()
        maven {
            url "https://sdk.ujet.co/android/"
        }
    }
}

build.gradle (module: app)

dependencies {
    // Replace x.y.z with latest version of CCAI Platform SDK
    def ujetSdkVersion = "x.y.z"
    implementation "co.ujet.android:ujet-android:$ujetSdkVersion"

    // CCAI Platform supports co-browse for Web SDK version 0.46.0 or
    // higher.
    // To use co-browse, declare the following dependency.
    implementation "co.ujet.android:cobrowse:$ujetVersion"
}

Catatan: Jika Anda menggunakan Java versi yang lebih lama dari 11.0.2 dan tidak dapat membangun SDK kami, upgrade ke 11.0.2+ untuk menyelesaikan masalah ini.

Menyiapkan setelan perusahaan

Masukkan setelan perusahaan Anda sebagai metadata dalam file AndroidManifest.xml.

AndroidManifest.xml

<application>
    // ...
    <!-- Company Settings -->
    <meta-data android:name="co.ujet.android.subdomain" android:value="@string/ujet_subdomain"/>
    <meta-data android:name="co.ujet.android.companyKey" android:value="@string/ujet_company_key"/>
    <meta-data android:name="co.ujet.android.companyName" android:value="@string/ujet_company_name"/>
    // ...
</application>

strings.xml

<resources>
    <string name="ujet_subdomain">YOUR_SUBDOMAIN</string>
    <string name="ujet_company_key">YOUR_COMPANY_KEY</string>
    <string name="ujet_company_name">YOUR_COMPANY_NAME</string>
</resources>

Penandatanganan JWT

Informasi pengguna akhir harus ditandatangani sebagai JWT di server Anda untuk tujuan keamanan.

Aplikasi contoh berisi APIManager untuk pengujian dan Anda perlu memasukkan UJET_COMPANY_SECRET di mock/APIManager.java. APIManager harus menerapkan metode yang memulai panggilan asinkron untuk menandatangani token autentikasi JWT yang menampilkan token.

Dalam produksi, Anda harus menerapkan proses penandatanganan di server Anda.

public class APIManager {
    public static final String UJET_COMPANY_SECRET = "Please input your UJET_COMPANY_SECRET from Ujet developer admin page";
    // ...
}

Lakukan inisialisasi SDK

Lakukan inisialisasi SDK dalam metode onCreate class Aplikasi Android.

Perhatian: Pastikan Ujet.init() dipanggil di Application.onCreate() karena Android SDK dapat diluncurkan meskipun aplikasi host tidak berjalan oleh link SMS dan notifikasi push. Jika Ujet.init() tidak dipanggil dan Android SDK diluncurkan, Android SDK tidak akan berfungsi dengan benar dan dapat menyebabkan error.

public class ExampleApplication extends Application implements UjetRequestListener {
    @Override
    public void onCreate() {
        super.onCreate();

        Ujet.init(this);
    }
    // ...
}

Autentikasi pengguna akhir

Pengguna akhir adalah konsumen yang menghubungi tim dukungan pelanggan Anda melalui aplikasi.

Untuk mengautentikasi pengguna akhir di aplikasi, kami memperkenalkan mekanisme penandatanganan JWT.

Android SDK meminta untuk menandatangani payload saat memerlukan autentikasi. Jika penandatanganan berhasil, aplikasi akan menukar JWT yang ditandatangani dengan token autentikasi pengguna akhir.

Di ExampleApplication, Anda harus menerapkan antarmuka UjetRequestListener untuk menandatangani token autentikasi dan untuk data kustom.

public class ExampleApplication extends Application implements UjetRequestListener {
    @Override
    public void onCreate() {
        super.onCreate();

        Ujet.init(this);
    }

    @Override
    public void onSignPayloadRequest(Map<String, Object> payload, UjetPayloadType ujetPayloadType, UjetTokenCallback tokenCallback) {
        if (ujetPayloadType == UjetPayloadType.AuthToken) {

            // In production, you should implement this on your server.

            // The server must implement a method that initiates an asynchronous call
to sign and return a JWT auth token.
            APIManager.getHttpManager()
                .getAuthToken(payload, UjetPayloadType.AuthToken, new UjetTokenCallback() {
                    @Override
                    public void onSuccess(@Nullable final String authToken) {
                        tokenCallback.onToken(authToken);
                    }

                    @Override
                    public void onFailure(@Nullable final String authToken) {
                        tokenCallback.onError();
                    }
                });
        }
    }
}

Untuk mengetahui informasi selengkapnya, lihat autentikasi pengguna akhir.

Menyiapkan notifikasi push

Bagian ini menguraikan cara mengaktifkan notifikasi push seluler.

Siapkan Firebase

Anda harus menyiapkan project Firebase.

Jika sudah memiliki project, Anda dapat menggunakan project Anda sendiri dan melewati proses ini.

1. Buat project Firebase di Firebase console.

2. Download google-services.json dari Setelan > UMUM di Firebase console.

1. Dapatkan Kunci Server dari Setelan > CLOUD MESSAGING di Firebase console.

Menambahkan kunci akun layanan

Anda perlu menambahkan kunci akun layanan ke aplikasi seluler untuk menerima notifikasi push. Untuk mendapatkan kunci akun layanan, lihat Mengautentikasi dengan akun layanan.

Perhatian: Ikuti praktik terbaik Google untuk mengelola kunci akun layanan.

Untuk menambahkan kunci akun layanan ke aplikasi seluler Anda, ikuti langkah-langkah berikut:

1. Di portal Platform CCAI, klik Setelan > Setelan Developer. Jika Anda tidak melihat menu Setelan, klik Menu.

2. Buka panel Aplikasi Seluler.

3. Klik Edit di samping aplikasi Anda. Dialog Edit Aplikasi Seluler akan muncul.

4. Di Service Account Field, masukkan kunci akun layanan Anda, lalu klik Save.

Penyiapan klien Android

1. Salin google-services.json ke direktori aplikasi Anda, misalnya, PROJECT_ROOT/app/google-services.json.

2. Dapatkan token FCM menggunakan kode berikut:

   FirebaseMessaging.getInstance().getToken()
       .addOnCompleteListener(task -> {
           if (!task.isSuccessful() || task.getResult() == null) {
               Log.w("FCM", "Couldn't get FCM token");
               return;
           }
   
           String token = task.getResult();
           Log.i("FCM", "FCM token: " + token);
       });
   

   FirebaseMessagingService dipanggil, yang terdaftar di Manifes jika token diperbarui. Untuk mengetahui informasi selengkapnya, lihat Menyiapkan aplikasi klien Firebase Cloud Messaging di Android.

   public class YourFirebaseMessagingService extends FirebaseMessagingService {
      /**
          * There are two scenarios when onNewToken is called:
          * 1) When a new token is generated on initial app startup
          * 2) Whenever an existing token is changed
          * Under #2, there are three scenarios when the existing token is changed:
          * A) App is restored to a new device
          * B) User uninstalls/re-installs the app
          * C) User clears app data
          */
      @Override
      public void onNewToken(String token) {
          Log.i("FCM", "FCM token updated: " + token);
      }
   }
   

3. Terapkan UjetRequestListener.onRequestPushToken di class Application Anda. UjetRequestListener.onRequestPushToken akan menampilkan token FCM/GCM.

   public class YourApplication extends Application implements UjetRequestListener {
       /**
           * Return your FCM/GCM token
           */
       @Override
       public String onRequestPushToken() {
           return yourToken(); // As shown in the previous step, you can get your token using FirebaseMessaging.getInstance().getToken().addOnCompleteListener(task -> { })
       }
   }
   

4. Menangani notifikasi push. Jika Anda ingin Contact Center AI Platform (CCAI Platform) menangani pemrosesan pesan push-nya sendiri, Anda dapat meneruskan data langsung ke UjetPushHandler.handle().

   • Aplikasi hanya memproses pesan dengan kolom ujet_noti_type (atau noti_type, untuk kompatibilitas mundur) yang ditetapkan.

   • Atau, Anda dapat memilih untuk hanya mengirim pesan dengan ujet_noti_type ke UjetPushHandler.handle() untuk diproses.

   Berikut adalah contoh pesan notifikasi push:

   {
       "call_id"           : 12345,
       "ujet_noti_type"    : "connect_call",
       "noti_type"         : "connect_call",
       "call_type"         : "ScheduledCall",
       "fail_reason"       : "none",
       "fail_details"      : "none"
   }
   

Menangani pesan FCM

public class YourFirebaseMessagingService extends FirebaseMessagingService {
    private UjetPushHandler ujetPushHandler;

    @Override
    public void onCreate() {
        super.onCreate();
        this.ujetPushHandler = new UjetPushHandler(this);
    }

    @Override
    public void onMessageReceived(RemoteMessage remoteMessage) {
        if (ujetPushHandler.handle(remoteMessage)) {
            // Handled by CCAI Platform

        } else {
            // Handle your push notification message in here
        }
    }
}

Menangani pesan GCM

public class YourGcmListenerService extends GcmListenerService {
    private UjetPushHandler ujetPushHandler;

    @Override
    public void onCreate() {
        super.onCreate();
        this.ujetPushHandler = new UjetPushHandler(this);
    }

    @Override
    public void onMessageReceived(String s, Bundle bundle) {
        if (ujetPushHandler.handle(bundle)) {
            // Handled by CCAI Platform

        } else {
            // Handle your message
        }
    }
}

Menangani pesan GCM di GcmReceiver (Cara lama)

public class YourGcmReceiver extends WakefulBroadcastReceiver {
    private UjetPushHandler ujetPushHandler;

    @Override
    public void onReceive(Context context, Intent intent) {
        ujetPushHandler = new UjetPushHandler(context);
        if (ujetPushHandler.handle(intent.getExtras())) {
            // Handled by CCAI Platform

        } else {
            // Handle your message
        }
    }
}

Mulai aplikasi

Catatan: Semua metode memulai sebelumnya tidak digunakan lagi dan diganti dengan Ujet.start(@NonNull UjetStartOptions). Anda dapat menyetel parameter menggunakan UjetStartOptions.Builder() saat memulai aplikasi.

Tambahkan baris berikut di tempat Anda ingin memulai aplikasi (tanpa parameter apa pun):

Ujet.start(new UjetStartOptions.Builder().build());

Anda juga dapat memulai Android SDK tanpa layar pembuka.

UjetStartOptions ujetStartOptions = new UjetStartOptions.Builder()
        .setSkipSplashEnabled(true)
        .build();

Ujet.start(ujetStartOptions);

Anda juga dapat memulai Android SDK dari titik tertentu di menu dengan tombol ini menggunakan Titik Akses Langsung:

String menuKey = "MENU_KEY";
UjetStartOptions ujetStartOptions = new UjetStartOptions.Builder()
        .setMenuKey(menuKey)
        .build();

Ujet.start(ujetStartOptions);

menuKey dapat dibuat dengan Titik Akses Langsung di portal CCAI Platform (dengan peran Admin).

1. Buka Setelan > Antrean.

2. Pilih antrean apa pun dari struktur menu.

3. Centang Buat titik akses langsung.

4. Masukkan kunci di formulir teks.

5. Klik Simpan.

Anda juga dapat memulai Android SDK dengan ID tiket tertentu untuk meneruskannya ke CRM. ID tiket ini akan dibuka saat chat atau panggilan terhubung.

String ticketId = "TICKET_ID";
UjetStartOptions ujetStartOptions = new UjetStartOptions.Builder()
        .setTicketId(ticketId)
        .build();

Ujet.start(ujetStartOptions);

Mengirim data kustom ke CRM Anda

Data kustom dapat dikirim ke agen dukungan dan akan muncul di tiket dukungan untuk panggilan/chat masuk.

Ada dua metode untuk mengirim data kustom:

• Metode yang ditandatangani: Penandatanganan data yang telah ditentukan sebelumnya dengan JWT.

• Metode tidak bertanda tangan: Data yang telah ditentukan dengan JSON biasa (tidak direkomendasikan).

Menggunakan metode yang ditandatangani untuk mengirim data kustom

Untuk mengirim data kustom menggunakan metode bertanda tangan, terapkan metode penandatanganan.

Pertama, ambil data kustom ke aplikasi host Anda, lalu kirimkan ke server Anda untuk penandatanganan. Di server, Anda dapat menambahkan data tambahan menggunakan formulir yang ditentukan. Tandatangani dengan rahasia perusahaan Anda, lalu kembalikan dengan JWT.

public class ExampleApplication extends Application implements UjetRequestListener {
    @Override
    public void onCreate() {
        super.onCreate();

        Ujet.init(this);
    }

    @Override
    public void onSignPayloadRequest(Map<String, Object> payload, UjetPayloadType ujetPayloadType, UjetTokenCallback tokenCallback) {
        // ...
        if (ujetPayloadType == UjetPayloadType.CustomData) {
            /**
                * These codes are for providing signed custom data.
                * Add some data from app, and add more sensitive data from server and sign it.
                */
            UjetCustomData appCustomData = new UjetCustomData();
            appCustomData.put("model", "Model", "MODEL1234");
            appCustomData.put("customer_id", "Customer ID", 12345);
            appCustomData.put("temperature", "Temperature", 70.5f);
            appCustomData.put("purchase_date", "Purchase Date", new Date());
            appCustomData.put("battery", "Battery", "52%");
            appCustomData.put("location", "Location", "San Francisco, CA, United States");
            appCustomData.putURL("dashboard_url", "Dashboard URL", "https://internal.dashboard.com/12345");

            payload.put("custom_data", appCustomData.getData());

            tokenCallback.onToken(APIManager.getHttpManager().getSignedCustomData(payload));
        }
        // ...
    }
}

Menggunakan metode yang tidak ditandatangani untuk mengirim data kustom

Perhatian: Metode ini tidak direkomendasikan, karena berpotensi menciptakan kerentanan yang dapat membuat aplikasi Anda rentan terhadap serangan man-in-the-middle. Jika Anda memilih untuk menggunakan metode ini, Anda bertanggung jawab atas eksposur keamanan dan potensi kerusakan yang mungkin terjadi.

Google merekomendasikan Anda untuk menggunakan metode bertanda tangan guna mengirim data kustom di aplikasi Anda. Untuk mengetahui informasi selengkapnya, lihat Menggunakan metode yang ditandatangani untuk mengirim data kustom.

Anda dapat mengirim data yang tidak ditandatangani dengan memulai Android SDK dengan opsi mulai untuk menetapkan data kustom menggunakan UjetStartOptions.Builder#setUnsignedCustomData dan UjetTokenCallback harus memanggil onToken(null).

HashMap<String, Object> jsonData = new HashMap<>();
// Convert json string into hashmap object and store it in jsonData
UjetCustomData customData = new UjetCustomData();
customData.putObject("external_chat_transfer", jsonData); // Use `external_chat_transfer` key to send chat transcript data

UjetStartOptions ujetStartOptions = new UjetStartOptions.Builder()
        .setUnsignedCustomData(customData)
        .build();

Ujet.start(ujetStartOptions);

Menggunakan data kustom yang tidak bertanda untuk mengirim transkrip chat eksternal

Anda dapat mengirim transkrip chat eksternal ke Platform CCAI menggunakan data kustom yang tidak ditandatangani saat dimulai. Gunakan UjetCustomData.putObject("external_chat_transfer", hashMapObject) untuk menetapkan data transkrip dalam format JSON sebagai berikut:

HashMap<String, Object> jsonData = new HashMap<>();
// Convert json string into hashmap object and store it in jsonData
UjetCustomData customData = new UjetCustomData();
customData.putObject("external_chat_transfer", jsonData); // Use `external_chat_transfer` key to send chat transcript data

UjetStartOptions ujetStartOptions = new UjetStartOptions.Builder()
        .setUnsignedCustomData(customData)
        .build();

Ujet.start(ujetStartOptions);

Format JSON:

• greeting_override: string

• agent: kamus

  • name: string

  • avatar: string [url avatar agen, opsional]

• transcript: array

  • sender: string ["end_user" atau "agent"]

  • timestamp: string [yaitu "2021-03-15 12.00.00Z"]

  • content: array

    • type: string [salah satu dari text, media]

    • text: string [wajib untuk jenis teks]

    • media: dictionary [wajib untuk jenis media]

      • type: string [salah satu dari image, video]

      • url: string [URL publik yang mengarah ke file media]

Contoh JSON:

{
    "greeting_override": "Please hold while we connect you with a human agent.",
    "agent": {
        "name": "Name",
        "avatar": "avatar url"
    },
    "transcript": [
        {
        "sender": "agent",
        "timestamp": "2021-03-15 12:00:15Z",
        "content": [
            {
            "type": "text",
            "text": "**Suggestions shown:**\n\n* Help with batch or delivery\n* Help with metrics or order feedback\n* Help with Instant Cashout"
            }
        ]
        },
        {
        "sender": "end_user",
        "timestamp": "2021-03-15 12:00:16Z",
        "content": [
            {
            "type": "text",
            "text": "Help with batch or delivery"
            }
        ]
        }
    ]
}

Anda dapat menggunakan Markdown pada jenis teks. Format berikut didukung:

• Tebal

• Miring

• Menggarisbawahi

• Jeda baris

• Daftar berbutir

• Daftar bernomor

• Link

Format data kustom

Bagian ini menunjukkan format data kustom yang dapat diteruskan dalam JWT.

JSON dienkode ke JWT

JSON harus menyertakan iat dan exp untuk memvalidasi JWT. Objek data kustom adalah nilai kunci custom_data.

{
    "iat" : 1537399656,
    "exp" : 1537400256,
    "custom_data" : {
        "location" : {
            "label" : "Location",
            "value" : "1000 Stockton St, San Francisco, CA, United States",
            "type" : "string"
        },
        "dashboard_url" : {
            "label" : "Dashboard URL",
            "value" : "http://(company_name)/dashboard/device_user_ID",
            "type" : "url"
        },
        "contact_date" : {
            "label" : "Contact Date",
            "value" : 1537399655992,
            "type" : "date"
        },
        "membership_number" : {
            "label" : "Membership Number",
            "value" : 62303,
            "type" : "number"
        },
        "model" : {
            "label" : "Model",
            "value" : "iPhone",
            "type" : "string"
        },
        "os_version" : {
            "label" : "OS Version",
            "value" : "12.0",
            "type" : "string"
        },
        "last_transaction_id" : {
            "label" : "Last Transaction ID",
            "value" : "243324DE-01A1-4F71-BABC-3572B77AC487",
            "type" : "string"
        },
        "battery" : {
            "label" : "Battery",
            "value" : "-100%",
            "type" : "string"
        },
        "bluetooth" : {
            "label" : "Bluetooth",
            "value" : "Bluetooth not supported",
            "type" : "string"
        },
        "wifi" : {
            "label" : "Wi-Fi",
            "value" : "Wi-Fi not connected",
            "type" : "string"
        },
        "ssn" : {
            "invisible_to_agent" : true,
            "label" : "Social Security Number",
            "value" : "102-186-1837",
            "type" : "string"
        }
    }
}

Kunci adalah ID unik untuk data. Jenisnya adalah jenis nilai.

• string

  • String JSON

• number

  • integer, float

• date

  • Format stempel waktu Unix UTC dengan 13 digit. (berisi milidetik)

• url

  • Format URL HTTP

Label adalah nama tampilan di halaman CRM.

Mencegah tampilan data kustom

Anda dapat menggunakan properti invisible_to_agent dengan objek data kustom untuk mencegah data kustom bertanda atau tidak bertanda ditampilkan di adaptor agen. Dalam contoh sebelumnya, nomor jaminan sosial pengguna akhir tidak ditampilkan di adaptor agen karena "invisible_to_agent" : true disertakan dalam objek ssn.

Catatan: Properti invisible_to_agent tidak mencegah properti data yang dicadangkan ditampilkan di adaptor agen.

Jika Anda menyertakan properti "invisible_to_agent" : true dengan objek data kustom, Anda dapat mengharapkan perilaku berikut:

• Data kustom disertakan dalam file metadata sesi.
• Data kustom tidak disertakan dalam catatan CRM.

Untuk mengetahui informasi selengkapnya, lihat Melihat data sesi di adaptor agen.

Properti data yang dicadangkan

Anda dapat mengirim properti data yang dicadangkan ke Contact Center AI Platform (CCAI Platform) sebagai data kustom bertanda tangan saat sesi dimulai. Untuk mengetahui informasi selengkapnya, lihat Mengirim properti data yang dicadangkan.

Berikut adalah contoh properti data yang dicadangkan dalam data kustom:

  {
    "custom_data": {
      "reserved_verified_customer": {
        "label": "Verified Customer",
        "value": "VERIFIED_CUSTOMER_BOOLEAN": ,
        "type": "boolean"
      },
      "reserved_bad_actor": {
        "label": "Bad Actor",
        "value": "VERIFIED_BAD_ACTOR_BOOLEAN": ,
        "type": "boolean"
      },
      "reserved_repeat_customer": {
        "label": "Repeat Customer",
        "value": "REPEAT_CUSTOMER_BOOLEAN": ,
        "type": "boolean"
      }
    }
  }
  

Ganti kode berikut:

• VERIFIED_CUSTOMER_BOOLEAN: Benar (True) jika Anda menganggap pengguna akhir ini sebagai pelanggan yang sah.
• VERIFIED_BAD_ACTOR_BOOLEAN: Benar jika Anda menganggap pengguna akhir ini berpotensi menjadi pihak tidak bertanggung jawab.
• REPEAT_CUSTOMER_BOOLEAN: Benar (True) jika Anda telah menentukan bahwa pengguna akhir ini telah menghubungi pusat kontak Anda sebelumnya.

Konfigurasi SDK

Anda dapat mengonfigurasi beberapa opsi sebelum memulai Android SDK. Lihat class UjetOption. Opsi Nomor Telepon Cadangan dan Sensitivitas Jaringan yang dijelaskan dalam tabel berikut hanya berfungsi jika tombol Aktifkan Pengalihan PSTN diaktifkan di portal Platform CCAI di Setelan > Setelan Developer > MMA > Edit. Jika tombol Aktifkan Pengalihan ke PSTN dinonaktifkan, kami tidak akan melakukan pengalihan ke PSTN. CCAI Platform menggunakan sensitivitas jaringan default (0,85) untuk memeriksa koneksi jaringan.

Opsi	Deskripsi	Nilai	Nilai default
Tingkat Log	Level log yang akan dicetak di Logcat.	Bilangan bulat. Sama dengan Level log untuk Log Android. (Min: 2, Maks: 7)	5 (Log.Warn)
Bahasa Default	Kode bahasa default.	String. Kode bahasa ISO 639. (misalnya, en untuk bahasa Inggris)	null
Nomor Telepon Cadangan	Nomor telepon digunakan sebagai pengganti saat internet tidak tersedia atau nomor telepon perwakilan untuk perusahaan tidak ada dari portal Admin.	String. Nomor telepon.	null
Pengendali Pengecualian yang Tidak Tertangkap Diaktifkan	Aktifkan pengendali pengecualian yang tidak tertangkap. Jika true, aplikasi menangani semua pengecualian SDK yang tidak tertangkap saat runtime menggunakan Thread.setDefaultUncaughtExceptionHandler. Namun, jika pengecualian yang sama terjadi dua kali, aplikasi akan error.	Boolean.	true
Sensitivitas Jaringan	Sensitivitas untuk memeriksa status jaringan.	Ganda antara 0 dan 1, dengan 0 adalah yang paling tidak sensitif dan 1 adalah yang paling sensitif. Nilai 1 akan selalu melakukan panggilan PSTN sebagai pengganti. Jika digunakan, sebaiknya mulai dengan nilai .97. Nilai dari Portal di bagian Setelan > Setelan Developer > Aplikasi Seluler > Threshold nomor telepon pengganti akan menggantikan nilai ini.	0.85
Mode Gelap Diaktifkan	Aktifkan tema mode gelap. Jika true, SDK akan menerapkan tema mode gelap saat pengguna mengaktifkan mode gelap, dan mengabaikan tindakan tersebut jika tidak.	Boolean.	false
Saluran Tunggal Diaktifkan	Opsi konfigurasi untuk menampilkan atau melewati layar pemilihan channel untuk satu channel. Jika true, SDK akan menampilkan layar pemilihan saluran tunggal, bukan memilih saluran secara otomatis meskipun hanya satu saluran yang diaktifkan dalam antrean menu.	Boolean.	false
Meminimalkan Tampilan Panggilan Otomatis	Opsi konfigurasi untuk meminimalkan UI layar panggilan awal secara otomatis secara default atau menunggu pengguna meminimalkannya.	Boolean.	false
Batas Ikon Agen Diaktifkan	Opsi konfigurasi untuk menampilkan atau menghapus batas melingkar di sekitar ikon agen.	Boolean.	false
Ukuran Font Statis di Tampilan Pemilih	Opsi konfigurasi untuk menyesuaikan atau menonaktifkan ukuran teks item pemilih secara otomatis.	Boolean.	false
Menyembunyikan Lampiran Media dalam Chat	Opsi konfigurasi untuk menampilkan atau menyembunyikan ikon lampiran media di UI chat.	Boolean.	false
Abaikan Izin READ_PHONE_STATE	Jika disetel ke true, SDK tidak akan meminta izin READ_PHONE_STATE. Jika Anda tidak ingin menggunakan panggilan IVR dalam aplikasi, tetapkan tanda ini ke true untuk menghindari permintaan izin ini dan aplikasi Anda juga harus menghapus izin android.permission.READ_PHONE_STATE secara eksplisit untuk CCAI Platform SDK. Perhatikan bahwa sebaiknya Anda tidak menyetelnya ke true, karena izin ini diperlukan agar panggilan IVR dalam aplikasi berfungsi.	Boolean	false
Kunci Lisensi Cobrowse.io (jika ada)	Opsi konfigurasi untuk menyiapkan library Cobrowse.io. Anda dapat menemukan Kunci Lisensi Cobrowse dengan login ke https://cobrowse.io/dashboard/settings dan membuka bagian Kunci Lisensi.	String	null
Judul header chat kustom	Opsi konfigurasi untuk menyesuaikan teks judul header chat di UI chat.	String	null
Menyesuaikan balasan cepat UI chat	Opsi konfigurasi untuk menyesuaikan balasan cepat agen virtual di UI chat. Balasan cepat agen virtual dikelompokkan secara default, tetapi jika Anda ingin menampilkannya satu per satu, Anda dapat menggunakan opsi konfigurasi ini untuk menyetel QuickReplyButtonsStyle.INDIVIDUAL	UjetStylesOptions	QuickReplyButtonsStyle.GROUPED
Menyesuaikan berbagai atribut UI chat	Opsi konfigurasi untuk menyesuaikan berbagai atribut seperti font, warna latar belakang, ikon, dll.	UjetStylesOptions	null
Menyembunyikan status bar	Opsi konfigurasi untuk menampilkan atau menyembunyikan status bar. Jika nilainya benar, SDK akan menyembunyikan status bar.	Boolean	false
Menetapkan res drawable indikator pemuatan	Opsi konfigurasi untuk menyesuaikan tampilan spinner pemuatan di seluruh aplikasi. Jika tidak tersedia atau null, kita akan menggunakan tampilan pemuatan default.	Bilangan bulat	null
Orientasi lanskap dinonaktifkan	Nonaktifkan orientasi lanskap. Jika nilainya benar (true), orientasi lanskap tidak diterapkan.	Boolean	false
Menyembunyikan tombol inline mulai percakapan baru di chat	Opsi konfigurasi untuk menampilkan atau menyembunyikan tombol sebaris mulai percakapan baru di UI chat.	Boolean	false
Menampilkan tombol lewati CSAT	Opsi konfigurasi untuk menampilkan atau menyembunyikan tombol lewati di dialog CSAT	Boolean	false
Memblokir penghentian chat oleh pengguna akhir	Opsi konfigurasi untuk menampilkan atau menyembunyikan tombol akhiri chat di UI chat	Boolean	false
Menyembunyikan download transkrip chat	Menampilkan atau menyembunyikan tombol download transkrip chat di menu tindakan chat dan di antarmuka pengguna chat. Jika Anda menambahkan spasi ke string ujet_common_hide, teks Hide akan menghilang dan hanya panah kembali yang muncul.	Bilangan bulat. Nilai: 0 = Tampilkan di mana saja 1 = Sembunyikan dari menu opsi 2 = Sembunyikan dari layar chat pasca-percakapan 3 = Sembunyikan dari menu opsi dan layar chat pasca-percakapan.	0 UjetOption.setBlockChatTerminationByEndUser
Menonaktifkan notifikasi push di tingkat global	Menyetel UjetOption.setPushNotificationsAllowed ke false akan melewati semua dependensi notifikasi push dan mencegah notifikasi push mencapai pengguna akhir.	Boolean	true

UjetOption ujetOption = new UjetOption.Builder()
        .setLogLevel(Log.INFO)
        .setDefaultLanguage("en")
        .setFallbackPhoneNumber("[phone]")
        .setUncaughtExceptionHandlerEnabled(false)
        .setNetworkSensitivity(0)
        .setDarkModeEnabled(true)
        .setShowSingleChannelEnabled(true)
        .setAutoMinimizeCallView(true)
        .setShowAgentIconBorderEnabled(true)
        .setStaticFontSizeInPickerView(true)
        .setHideMediaAttachmentInChat(true)
        .setIgnoreReadPhoneStatePermission(true)
        .setCobrowseLicenseKey("COBROWSE_IO_LICENSE_KEY_HERE")
        .setCobrowseURL("COBROWSE_IO_API_URL_HERE")
        .setCustomChatHeaderTitle("CHAT_HEADER_TITLE_TEXT")
        .setUjetStylesOptions(
             new UjetStylesOptions.Builder()
            .setChatQuickReplyButtonsStyle(QuickReplyButtonsStyle.INDIVIDUAL)
            .setChatStyles(new ChatStyles(...)) // See `Content Cards Theme` item
            .build()            )
        .setBlockChatTerminationByEndUser(true)
        .setHideStatusBar(true)
        .setLoadingSpinnerDrawableRes(R.drawable.RESOURCE_NAME)
        .setLandscapeOrientationDisabled(true)
        .setShowCsatSkipButton(false)
        .setHideDownloadChatTranscript(0) // 0 to 3. 0 = Show everywhere, 1 = Hide from the options menu, 2 = Hide from the post chat screen, 3 = Hide from both the options menu and the post chat screen.
        .setPushNotificationsAllowed(true)
        .build();

//The following customizes various attributes in chat UI
ChatStyles chatStyles = new ChatStyles();
chatStyles.setBackButton(new BackButtonStyle(false, "ujet_agent_sample")); //customizes back button styles
chatStyles.setHeader(...); //customizes chat header styles
chatStyles.setAgentMessageBubbles(...); //customizes agent messages styles
chatStyles.setConsumerMessageBubbles(...); //customizes consumer messages styles
chatStyles.setSystemMessages(...); //customizes system messages styles
chatStyles.setEndChatButton(...); //customizes end chat button styles
chatStyles.setTimeStamps(...); //customizes timestamp styles
chatStyles.setUserInputBar(...); //customizes user input bar styles

UjetOption ujetOption = new UjetOption.Builder()
        .setUjetStylesOptions(
            new UjetStylesOptions.Builder()
            .setChatStyles(chatStyles)
            .build()
        )

//The following customizes various attributes in chat UI using json file. Store json file in assets folder
//and create a method to read json file contents and convert it into json string.
String chatStylesFromJson = parseJsonContentsFromAssetsFolder();

UjetOption ujetOption = new UjetOption.Builder()
        .setUjetStylesOptions(
            new UjetStylesOptions.Builder()
            .setChatStyles(chatStylesFromJson)
            .build()
        )

Pengganti

Anda dapat menggunakan UjetErrorListener untuk penggantian error yang tidak terduga. Jika Anda tidak menyetel pemroses ini atau menampilkan nilai salah (false), Android SDK akan menangani error.

Android SDK akan mengalihkan pengguna ke aplikasi telepon dengan nomor penggantian hanya jika tombol Aktifkan Penggantian PSTN disetel ke AKTIF di Setelan > Setelan Developer > MMA > Edit pop-up, keluar dari SDK jika tidak.

Jenis Error	Kode Error	Pemicu
NETWORK_ERROR	1	Jaringan tidak tersedia. Perhatikan bahwa error ini tidak dipicu saat jaringan tidak tersedia selama chat atau panggilan atau layar penilaian.
AUTHENTICATION_ERROR	100	Terjadi error tidak terduga selama autentikasi.
AUTHENTICATION_JWT_ERROR	101	Terjadi error tak terduga selama validasi JWT (misalnya, error penguraian).
VOIP_CONNECTION_ERROR	1000	Gagal membuat koneksi ke penyedia VoIP. Proses ini ditangani melalui callback VoIP SDK.
VOIP_LIBRARY_NOT_FOUND	1001	Panggilan diharapkan terhubung menggunakan penyedia VoIP, tetapi tidak dapat ditemukan. Hal ini dapat terjadi saat developer mengintegrasikan SDK yang salah atau tidak menambahkan library penyedia VoIP dalam dependensinya.
CHAT_LIBRARY_NOT_FOUND	1.100	Terjadi saat tidak dapat menemukan library chat. Hal ini dapat terjadi saat developer mengintegrasikan SDK yang salah atau tidak menambahkan library Twilio Chat dalam dependensinya.

Ujet.setUjetEventListener(new UjetEventListener() {
    @Override
    public void onEvent(UjetEventType eventType, HashMap<String, Object> eventData) {
        // eventType specifies the event type and eventData holds the data related to the event.
        // You can parse the eventData and here we are just logging the event type and event data.
        Log.i("CCAI Platform Event Type", eventType.getValue());

        StringBuilder builder = new StringBuilder();
        for (Map.Entry<String, Object> entry : eventData.entrySet()) {
            builder.append(entry.getKey()).append(" : ").append(entry.getValue()).append("\n");
        }

        Log.i("CCAI Platform Event Data", builder.toString());
    }
});

Izin aplikasi

Aplikasi memerlukan izin berikut dan meminta izin ini dari pengguna jika diperlukan.

Izin	Deskripsi
KAMERA	Digunakan untuk tindakan smart untuk mengambil foto dan merekam video
MIKROFON	Mengizinkan aplikasi menggunakan panggilan VoIP melalui Twilio
STORAGE	Mengizinkan aplikasi menyimpan foto dan video

Penyiapan deep linking (opsional)

Jika ingin menggunakan tindakan smart untuk panggilan IVR (PSTN), Anda harus menyiapkan deep linking di project Anda.

Format deep linking adalah URI unik seperti:

ujet:// <package_name>/smartchannel.

Selain itu, Anda harus menyetel link ini atau URL apa pun yang akan dialihkan ke link ini di Admin Portal (Setelan > Pengelolaan Operasi > Aktifkan Kirim SMS untuk Mendownload Aplikasi).

Anda harus menambahkan filter intent yang berisi deep link di manifes Anda.

<activity android:name="co.ujet.android.activity.UjetActivity">
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />
        <data android:host="<package_name>"
                android:scheme="ujet"
                android:path="/smartchannel" />
    </intent-filter>
</activity>

Saluran pilihan

Dengan parameter Channel Pilihan, Anda dapat mengarahkan konsumen langsung ke channel tertentu. Pengguna akhir kemudian melewati langkah pemilihan saluran dan langsung memulai kontak melalui saluran yang ditentukan dalam parameter Saluran Pilihan.

UjetStartOptions.preferredChannel

Ujet.start(new)
UjetStartOptions.Builder().setPreferredChannel
(UjetPreferredChannel.UjetPreferredChannelChat).build());

Notifikasi Acara

Anda dapat secara opsional menyetel UjetEventListener untuk menerima notifikasi peristiwa aplikasi.

Jenis dan deskripsi acara yang tersedia tercantum di sini.

Ujet.setUjetEventListener(new UjetEventListener() {
    @Override
    public void onEvent(UjetEventType eventType, HashMap<String, Object> eventData) {
        // eventType specifies the event type and eventData holds the data related to the event.
        // You can parse the eventData and here we are just logging the event type and event data.
        Log.i("CCAI Platform Event Type", eventType.getValue());

        StringBuilder builder = new StringBuilder();
        for (Map.Entry<String, Object> entry : eventData.entrySet()) {
            builder.append(entry.getKey()).append(" : ").append(entry.getValue()).append("\n");
        }

        Log.i("CCAI Platform Event Data", builder.toString());
    }
});

Jenis peristiwa	Deskripsi	Data yang disertakan dalam acara
EmailClicked	Dipicu saat pengguna akhir mengklik saluran email.	Data menu antrean
EmailSubmitted	Dipicu saat pengguna akhir mengirim email.	Data menu antrean, data yang dikirim melalui email
SessionPaused	Dipicu saat pengguna akhir meminimalkan sesi chat atau panggilan.	Data sesi
SessionResumed	Dipicu saat pengguna akhir beralih kembali ke sesi chat atau panggilan dari latar belakang.	Data sesi
SessionCreated	Dipicu saat sesi chat atau panggilan dibuat.	Data menu antrean, data sesi dibuat
SessionEnded	Dipicu saat sesi chat atau panggilan berakhir.	Data menu antrean, data sesi dibuat, data sesi berakhir
SdkTerminated	Dipicu saat SDK ditutup, termasuk saat SDK ditutup secara tidak terduga.	Data SDK yang dihentikan
ContentCardClicked	Dipicu saat kartu konten diklik.	Data kartu konten yang diklik
ContentCardButtonClicked	Dipicu saat tombol kartu konten diklik.	Data tombol kartu konten yang diklik
QuickReplyClicked	Dipicu saat balasan cepat diklik.	Data klik balasan cepat
MessageLinkClicked	Dipicu saat link diklik.	Data link pesan yang diklik

Data menu antrean

Kunci	Jenis	Deskripsi
event_name	String	Berisi nama acara. Contoh, "Email Diklik".
application	String	Berisi nama aplikasi. Contoh, "Android".
app_id	String	Berisi ID aplikasi yang sama dengan Context.getPackageName().
app_version	String	Berisi nama versi dan kode versi aplikasi. Contoh, "0.32.0 (123)".
sdk_version	String	Berisi versi SDK. Contoh, "0.32.0".
timestamp	String	Berisi stempel waktu dalam UTC (dalam format yyyy-MM-dd'T'HH:mm:ss'Z').
device_model	String	Berisi model perangkat pengguna. Contoh, "Google Pixel".
device_version	String	Berisi versi perangkat pengguna. Contoh, "10, Q, SDK 29".
company	String	Berisi nama perusahaan. Contoh, "Perusahaan".
menu_name	String	Berisi nama node daun (pilihan menu terakhir pengguna). Contoh, "Sub Menu".
menu_id	String	Berisi ID node daun (pilihan menu terakhir pengguna). Contoh, "123".
menu_path	String	Berisi urutan lengkap menu yang dipilih oleh pengguna. Contoh, "Parent / Child / Sub Menu".
menu_key	String	Berisi kunci DAP dan bersifat opsional. Contoh, "special_user_menu".

Data yang dikirimkan melalui email

Kunci	Jenis	Deskripsi
has_attachments	Boolean	Menampilkan True jika email memiliki lampiran, False jika tidak.

Data sesi

Kunci	Jenis	Deskripsi
event_name	String	Berisi nama acara. Contoh, "Email Diklik".
type	String	Berisi jenis sesi. Misalnya, "chat" atau "panggilan".
timestamp	String	Berisi stempel waktu dalam UTC (dalam format yyyy-MM-dd'T'HH:mm:ss'Z').

Data sesi dibuat

Kunci	Jenis	Deskripsi
session_id	String	Berisi ID sesi. Contoh, "100".
type	String	Berisi jenis sesi. Misalnya, "chat" atau "panggilan".
end_user_identifier	String	Berisi ID pengguna akhir. Misalnya, "John".
messages_end_user	String	Berisi jumlah pesan pengguna akhir dan hanya disertakan untuk sesi chat. Contoh, "3".
messages_agent	String	Berisi jumlah pesan agen dan hanya disertakan untuk sesi chat. Contoh, "3".

Data sesi berakhir

Kunci	Jenis	Deskripsi
agent_name	String	Berisi nama agen. Misalnya, "John".
ended_by	String	Berisi detail siapa yang mengakhiri sesi. Nilai yang mungkin adalah "agent" (saat agen mengakhiri sesi) atau "end_user" (saat pengguna akhir mengakhiri sesi) atau "timeout" (saat chat berakhir karena waktu habis) atau "dismissed" (saat chat ditutup).
duration	String	Berisi durasi sesi dalam detik dan hanya disertakan untuk sesi panggilan. Contoh, "30 detik".

Data SDK yang dihentikan

Kunci	Jenis	Deskripsi
event_name	String	Berisi nama acara. Contoh, "Email Diklik".

Data kartu konten yang diklik

Kunci	Jenis	Deskripsi
title	string	Judul kartu.
title	string	Judul kartu.
subtitle	string	Subjudul kartu.
body	string	Deskripsi kartu konten.
link	string	Link halaman web atau deep link. SDK menggunakan kemampuan OS untuk membukanya.
event_params	kamus	Kamus yang berisi informasi tambahan tentang peristiwa klik. SDK menggunakan ini.

Data tombol kartu konten yang diklik

Kunci	Jenis	Deskripsi
title	string	Judul kartu.
title	string	Judul kartu.
link	string	Link halaman web atau deep link. SDK menggunakan kemampuan OS untuk membukanya.
event_params	kamus	Kamus yang berisi informasi tambahan tentang peristiwa klik. SDK menggunakan ini.

Data klik balasan cepat

Kunci	Jenis	Deskripsi
title	string	Judul kartu.
title	string	Judul kartu.
link	string	Link halaman web atau deep link. SDK menggunakan kemampuan OS untuk membukanya.
event_params	kamus	Kamus yang berisi informasi tambahan tentang peristiwa klik. SDK menggunakan ini.

Data link pesan yang diklik

Kunci	Jenis	Deskripsi
event_name	String	Berisi nama peristiwa—misalnya, "Message Link Clicked".
link	String	Link halaman web atau deep link. SDK menggunakan kemampuan OS untuk membukanya.

Perubahan perilaku panggilan masuk

Mulai perangkat versi Android 10, panggilan masuk tidak akan diterima langsung oleh pengguna akhir saat aplikasi host berada di latar belakang. Sebagai gantinya, kami menggunakan notifikasi untuk memberi tahu pengguna tentang panggilan masuk (bahkan saat ponsel dikunci) dan memberi mereka opsi untuk menerima atau menolak panggilan.

Kami menampilkan notifikasi yang sama saat aplikasi host di latar belakang dan layar dikunci sebelum panggilan masuk tiba. Perubahan perilaku ini dilakukan untuk mematuhi batasan terbaru Google dalam memulai aktivitas saat aplikasi berada di latar belakang. Perilaku tidak terpengaruh saat aplikasi host berada di latar depan atau berjalan di perangkat dengan versi Android di bawah 10.

Menyesuaikan sesi SDK

Bagian ini menguraikan cara SDK dapat disesuaikan lebih lanjut.

Memeriksa sesi yang ada

Sebelum memulai sesi, gunakan metode yang dijelaskan untuk memeriksa apakah ada sesi yang sudah ada atau sedang berlangsung. Selain itu, jika ada, Anda dapat meminta pengguna akhir untuk melanjutkan atau membatalkannya.

Hal ini sangat penting saat pengguna diganti.

if (Ujet.getStatus() != UjetStatus.None) {
    // Display alert to cancel login or resume existing session
}

Putuskan koneksi sesi

Lihat metode ini jika Anda ingin menghentikan koneksi sesi yang sedang berlangsung.

Sebelum menggunakan metode ini, pastikan untuk memeriksa apakah sesi tersebut ada menggunakan Ujet.getStatus(). Jika Anda ingin melakukan tindakan setelah SDK menghentikan sesi, misalnya, menampilkan pesan atau menutup aplikasi, Anda dapat menggunakan callback respons onFinished() seperti yang dibahas di bagian berikutnya, atau menetapkan callback ke null.

Ujet.disconnect(new UjetResponseCallback() {
    @Override
    public void onFinished() {
        // `onFinished()` is triggered after CCAI Platform disconnects the session.
        finish(); // Finishes the activity.
    }
});

Menghapus data pengguna akhir dari cache

Anda bertanggung jawab untuk menghapus cache saat data terkait pengguna akhir telah diperbarui atau diubah dari aplikasi Anda. Misalnya, jika pengguna akhir telah logout, panggil metode untuk menghapus cache pengguna tersebut sehingga sesi baru dimulai untuk pengguna akhir baru saat SDK dimulai berikutnya.

Ujet.clearUserData();

Menyembunyikan SDK

Anda dapat menyembunyikan SDK menggunakan metode Ujet.hideSDK(). Hal ini berguna saat SDK mengganggu antarmuka pengguna aplikasi Anda, misalnya. Lakukan inisialisasi SDK menggunakan Ujet.init() sebelum memanggil metode ini. Ujet.init() menampilkan true jika SDK berhasil disembunyikan, dan false jika tidak. Setelah menyembunyikan SDK, Anda dapat memulainya lagi menggunakan metode Ujet.start().

Contoh berikut menyembunyikan SDK:

Ujet.hideSDK();

Preferensi bahasa

Android SDK akan menggunakan urutan prioritas berikut untuk menentukan bahasa.

1. Bahasa yang dipilih dari layar pembuka dalam aplikasi.

2. Bahasa default dipilih menggunakan UjetOptions. Anda dapat menyetel bahasa default menggunakan setDefaultLanguage("en") di UjetOptions. Lihat Bahasa Default di bagian konfigurasi SDK untuk mengetahui detail selengkapnya.

3. Bahasa perangkat yang dipilih di perangkat (menggunakan Setelan > Umum > Bahasa) akan digunakan, jika didukung oleh aplikasi.

4. Dialek yang paling dekat dengan bahasa perangkat akan digunakan saat aplikasi tidak mendukung bahasa perangkat, tetapi mendukung dialek induk terdekatnya. Misalnya, jika pengguna memilih bahasa Spanyol Kuba sebagai bahasa di perangkat dan aplikasi tidak mendukung bahasa Spanyol Kuba, tetapi mendukung bahasa Spanyol induk, maka bahasa Spanyol akan digunakan.

5. Bahasa Inggris akan digunakan sebagai bahasa default, jika bahasa perangkat tidak didukung oleh aplikasi.

Mengonfigurasi ikon link pengalihan eksternal

Sesuaikan ikon di saluran Link Pengalihan Eksternal dengan mengupload ikon ke folder drawable aplikasi Anda dan pastikan Anda menggunakan nama ikon yang sama saat membuat link pengalihan eksternal di portal Platform CCAI di Setelan > Chat > Link Pengalihan Eksternal > Lihat link > Tambahkan Link Pengalihan.

Jika nama ikon di portal Platform CCAI tidak cocok dengan ikon yang diupload ke aplikasi, Android SDK akan menggunakan ikon default.

Mengonfigurasi ikon Terima Kasih survei

Anda dapat menyesuaikan atau mengganti ikon di halaman ucapan terima kasih survei dengan mengupload ikon ke folder drawable aplikasi Anda dan menggunakan nama file ujet_survey_thank_you_icon sebagai nama ikon.

Menyesuaikan (Opsional)

Bagian ini menguraikan cara menyesuaikan nilai tertentu dalam SDK.

String

Anda dapat menyesuaikan string yang digunakan dalam aplikasi dengan mengganti kunci untuk setiap string di strings.xml.

<resources>
    <!--Greeting title and message in splash screen-->
    <string name="ujet_greeting_title">Customer Support</string>
    <string name="ujet_greeting_description">runs on UJET</string>
</resources>

Penyesuaian ukuran teks

Sesuaikan ukuran teks judul, deskripsi, dan pemilih yang digunakan dalam aplikasi dengan mengganti kunci berikut di dimens.xml.

Ukuran teks yang dapat disesuaikan diuraikan:

<resources>
    <!-- Don't include the following tags if you don't want to customize any of these keys and prefer to use the CCAI Platform default values instead. -->

    <!-- You can customize title text size by updating value here. -->
    <dimen name="ujet_title">10sp</dimen>

    <!-- You can customize description text size by updating value here. -->
    <dimen name="ujet_description">10sp</dimen>

    <!-- You can customize picker text size by updating value here. -->
    <dimen name="ujet_picker_item_text_size">10sp</dimen>
</resources>

Tema

Sesuaikan tema dan latar belakang dengan langkah-langkah berikut. Langkah 1 adalah untuk tema dan langkah 2 adalah untuk latar belakang.

1. Sesuaikan tema dengan mengganti kunci untuk setiap item gaya di style.xml. Misalnya,

   <!--Default style applies to both Light and Dark Mode Themes-->
   <style name="Ujet">
       <item name="ujet_typeFace">ProximaNova-Reg.otf</item>
       <item name="ujet_colorPrimary">@color/primaryDefault</item>
       <item name="ujet_colorPrimaryDark">@color/primaryDarkDefault</item>
       <item name="ujet_buttonRadius">10dp</item>
       <item name="ujet_companyLogo">@drawable/your_company_logo_default</item>
   
       <!-- You can customize the avatar in waiting UI before call or chat is connected by using the following option. -->
       <item name="ujet_defaultAvatar">@drawable/your_default_avatar</item>
   </style>
   
   <!--This is optional and can be used to update style in Light Mode Theme only-->
   <style name="Ujet.Light">
       <item name="ujet_typeFace">ProximaNova-Reg.otf</item>
       <item name="ujet_colorPrimary">@color/primaryLightMode</item>
       <item name="ujet_colorPrimaryDark">@color/primaryDarkLightMode</item>
       <item name="ujet_buttonRadius">10dp</item>
       <item name="ujet_companyLogo">@drawable/your_company_logo_light_mode</item>
   
       <!-- You can customize the avatar in waiting UI before call or chat is connected by using the following option. -->
       <item name="ujet_defaultAvatar">@drawable/your_default_avatar</item>
   </style>
   
   <!--This is optional and can be used to update style in Dark Mode Theme only-->
   <style name="Ujet.Dark">
       <item name="ujet_typeFace">ProximaNova-Reg.otf</item>
       <item name="ujet_colorPrimary">@color/primaryDarkMode</item>
       <item name="ujet_colorPrimaryDark">@color/primaryDarkForDarkMode</item>
       <item name="ujet_buttonRadius">10dp</item>
       <item name="ujet_companyLogo">@drawable/your_company_logo</item>
   
       <!-- You can customize the avatar in waiting UI before call or chat is connected by using the following option. -->
       <item name="ujet_defaultAvatar">@drawable/your_default_avatar</item>
   </style>
   

2. Anda dapat menyesuaikan warna latar belakang di aplikasi dengan mengganti kunci untuk setiap item gaya di style.xml. Warna latar belakang yang dapat disesuaikan ditampilkan dalam screenshot.

   <style name="Ujet">
       <!-- Don't include the following tags if you don't want to customize any of these keys and prefer to use the CCAI Platform default values instead. -->
       <!-- You can customize light mode theme background color by updating value here in hex. -->
       <item name="ujet_colorBackground">@color/backgroundDefault</item>
       <!-- You can customize dark mode theme background color by updating value here in hex. -->
       <item name="ujet_colorBackgroundDark">@color/backgroundDefaultDark</item>
   </style>
   

Menyesuaikan judul header chat

Ada opsi yang tersedia untuk menyesuaikan teks judul header chat dalam chat di UI Anda.

Anda dapat menyesuaikan teks judul header chat menggunakan opsi berikut:

<item name="ujet_chatCustomHeaderTextColor">@color/chatHeaderTextLightMode</item>
<item name="ujet_chatCustomHeaderTextColowDark">@color/chatHeaderTextDarkMode</item>
<item name="ujet_chatCustomHeaderTextSize">16sp</item>
<item name="ujet_chatCustomHeaderTextStyle">bold</item>

Anda dapat menyesuaikan balasan cepat Agen Virtual di UI chat menggunakan opsi berikut:

<item name="ujet_colorChatQuickReplyButtonBackground">@color/chatQuickReplyButtonBackgroundLightMode</item>
<item name="ujet_colorChatQuickReplyButtonBackgroundDark">@color/chatQuickReplyButtonBackgroundDarkMode</item>
<item name="ujet_colorChatQuickReplyButtonPressedBackground">@color/chatQuickReplyButtonPressedBackgroundLightMode</item>
<item name="ujet_colorChatQuickReplyButtonPressedBackgroundDark">@color/chatQuickReplyButtonPressedBackgroundDarkMode</item>
<item name="ujet_colorChatQuickReplyButtonText">@color/chatQuickReplyButtonTextLightMode</item>
<item name="ujet_colorChatQuickReplyButtonTextDark">@color/chatQuickReplyButtonTextDarkMode</item>
<item name="ujet_colorChatQuickReplyButtonPressedText">@color/chatQuickReplyButtonPressedTextLightMode</item>
<item name="ujet_colorChatQuickReplyButtonPressedTextDark">@color/chatQuickReplyButtonPressedTextDarkMode</item>
<item name="ujet_colorChatQuickReplyButtonStroke">@color/chatQuickReplyButtonStrokeLightMode</item>
<item name="ujet_colorChatQuickReplyButtonStrokeDark">@color/chatQuickReplyButtonStrokeDarkMode</item>
<item name="ujet_chatQuickReplyButtonTypeFace">Kreon-Regular.ttf</item>
<item name="ujet_chatQuickReplyButtonStrokeWidth">3dp</item>
<item name="ujet_chatQuickReplyButtonCornerRadius">3dp</item>
<item name="ujet_chatQuickReplyButtonVerticalMargin">0dp</item>
<item name="ujet_chatQuickReplyButtonHorizontalPadding">10dp</item>
<item name="ujet_chatQuickReplyButtonVerticalPadding">1dp</item>
<item name="ujet_chatQuickReplyButtonAlignment">right</item>

Kartu konten

Anda dapat menambahkan penyesuaian untuk kartu konten bersama dengan penyesuaian chat. Anda dapat melakukannya dengan menggunakan file JSON (lihat content_card property di file app/src/main/assets/json/ujet_styles.json) atau dengan menggunakan class ContentCardStyle.

ChatStyles(
    ...
    contentCard = ContentCardStyle(
        backgroundColor = "color_reference",
        cornerRadius = 8,
        font = FontStyle(
            colorReference = "color_reference",
            size = 16,
            style = "bold|italic",
            family = "Roboto-Black.ttf",
        ),
        border = BorderStyle(
            color = "color_reference",
            width = 2,
        ),
        title = TextStyle(
            FontStyle(
                colorReference = "color_reference",
                size = 18,
                style = "bold|italic",
                family = "Roboto-Black.ttf",
            )
        ),
        subtitle = TextStyle(
            FontStyle(
                colorReference = "color_reference",
                size = 16,
                style = "bold|italic",
                family = "Roboto-Black.ttf",
            )
        ),
        body = TextStyle(
            FontStyle(
                colorReference = "color_reference",
                size = 16,
                style = "bold|italic",
                family = "Roboto-Black.ttf",
            )
        )
    )
)

Tema formulir web

Anda dapat menyesuaikan kartu formulir web bersama dengan penyesuaian chat. Anda dapat melakukannya dengan menggunakan file JSON (lihat properti form_card dalam file app/src/main/assets/json/ujet_styles.json) atau dengan menggunakan class FormCardStyle.

ChatStyles(
    ...
    formCard = FormCardStyle(
        backgroundColor = "color_reference",
        cornerRadius = 8,
        font = FontStyle(
            colorReference = "color_reference",
            size = 16,
            style = "bold|italic",
            family = "Roboto-Black.ttf",
        ),
        border = BorderStyle(
            color = "color_reference",
            width = 2,
        ),
        title = TextStyle(
            FontStyle(
                colorReference = "color_reference",
                size = 18,
                style = "bold|italic",
                family = "Roboto-Black.ttf",
            )
        ),
        subtitle = TextStyle(
            FontStyle(
                colorReference = "color_reference",
                size = 16,
                style = "bold|italic",
                family = "Roboto-Black.ttf",
            )
        ),
        image = ImageStyle (
           height = 94,
        ),
    )
)

Survei

Anda dapat mengubah ikon di halaman ucapan terima kasih survei dengan mengupload ikon ke folder drawable aplikasi Anda.

Pastikan Anda menggunakan ujet_survey_thank_you_icon sebagai nama ikon.

Pemecahan masalah

Memulai percakapan baru memerlukan waktu lebih dari 30 detik

Periksa apakah Anda merespons metode delegasi data kustom. Anda harus menampilkan data kustom yang valid saat diminta atau hanya menampilkan null dengan callback. Gunakan kode berikut sebagai referensi.

    @Override
    public void onSignPayloadRequest(Map<String, Object> payload, UjetPayloadType ujetPayloadType, UjetTokenCallback tokenCallback) {
        if (ujetPayloadType == UjetPayloadType.CustomData) {
            tokenCallback.onToken(null);
        }
    }

Penjelasan pernyataan kebijakan

Jika Anda menerima notifikasi di Konsol Google Play yang meminta Anda menyatakan kebijakan untuk layanan atau izin yang digunakan oleh Android SDK, gunakan salah satu penjelasan berikut.

Menyatakan layanan latar depan yang digunakan oleh Android SDK

Google memperkenalkan jenis layanan latar depan di Android 14 dan mewajibkan penentuan jenis layanan saat memulai layanan latar depan, sesuai dengan https://developer.android.com/about/versions/14/changes/fgs-types-required#remote-messaging. Android SDK Contact Center AI Platform (CCAI Platform) menggunakan layanan latar depan untuk memulai chat dan panggilan, jadi kami menggunakan jenis layanan FOREGROUND_SERVICE_REMOTE_MESSAGING untuk chat karena kami menangani pesan teks dan jenis layanan FOREGROUND_SERVICE_MICROPHONE untuk panggilan. Tanpa jenis layanan ini, SDK akan error saat memulai chat atau panggilan mulai dari perangkat versi Android 14.

Mendeklarasikan izin intent layar penuh yang digunakan oleh Android SDK

Izin USE_FULL_SCREEN_INTENT diperlukan untuk menampilkan notifikasi push panggilan masuk saat perangkat terkunci. Aplikasi ini akan memberi tahu pengguna akhir dan menampilkan notifikasi panggilan masuk dalam layar penuh (ini adalah cara aplikasi telepon bawaan memberi tahu panggilan masuk kepada pengguna akhir).

Mendukung Android 15

Untuk mendukung Android 15, ikuti langkah-langkah berikut:

1. Tetapkan compileSdkVersion = 35 dan targetSdkVersion = 35 di build.gradle(:app) Anda.

2. Pastikan versi Plugin Android Gradle (AGP) project Anda adalah 8.5.1 atau yang lebih baru. Untuk mengetahui informasi selengkapnya, lihat Memperbarui pengemasan library bersama.

3. Instal Java Development Kit (JDK) versi 17 atau yang lebih baru untuk membangun project Android menggunakan AGP 8.0 atau yang lebih baru. Untuk mengetahui informasi selengkapnya, lihat JDK 17 diperlukan untuk menjalankan AGP 8.0.