Virtuelles und implementieren Servicemitarbeiter Chat

Die Mobile SDK Ermöglicht Ihnen die einfache Implementierung von Virtual und Servicemitarbeiter Chat-Services in Ihrem Android Anwendung.

Sie verwenden NowChatSDK API zum Erstellen des Chat-Service. Sobald der Service erstellt wurde, müssen Sie die Chat-Anwenderoberfläche starten.

Im Folgenden finden Sie ein Fragment, das zeigt, wie Sie den Chat-Service erstellen und die Schnittstelle starten.

/**
 * Helper class used to handle different Now service instances.
 */
@Singleton
class SdkManager @Inject constructor() {

    private var chatService: NowChatService? = null

    /**
     * Create the NowChatService once in the lifetime of the application, inside the Application class or another manager class
     * that will be injected into other classes via dagger/hilt.
     * NowChatService should be created after initializing the NowSDK.
     */
    suspend fun getNowChatService(): NowChatService? {
        if (chatService != null) return chatService

        return NowChatSDK.makeChatService(URL("https://instance-name.service-now.com"),
            object : NowChatSdkCallbacks {})
            .getOrThrow()
            .also { this.chatService = it }
    }
}

//Activity that will start the NowChat
class MainActivity : AppCompatActivity() {

    @Inject
    lateinit var sdkManager: SdkManager

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        //Start NowChat using the activity
        lifecycleScope.launch {
            sdkManager.getNowChatService()?.start(this@MainActivity)
        }
    }
}

Bevor Sie die Chat-Funktionalität in Ihrer Anwendung nutzen können, müssen Sie konfigurieren Virtual Agent In Ihrem ServiceNow Instanz. Details finden Sie unter Virtual Agent.

Kontextvariablen werden an übergeben Servicemitarbeiter Und Virtual Agent Chat

Sie können Chat-Kontextvariablen beim Starten einer Chatsitzung übergeben, indem Sie übergeben contextDataParameter in NowChatService-Start() Funktion. Weitere Informationen zu Chat-Kontextvariablen finden Sie unter Live agent chat context variables.

class MainActivity : AppCompatActivity() {
  @Inject

  lateinit var sdkManager: SdkManager

  override fun onCreate(savedInstanceState: Bundle?) { 
    super.onCreate(savedInstanceState)

    val contextData = mapOf("sys_id" to "123456789", "table" to "wm_task")
    //Start NowChat using the activity 
    lifecycleScope.launch {
      sdkManager.getNowChatService()?.start(this@MainActivity, contextData = contextData)
    }
  }
}

Design der Chat-Anwenderoberfläche

Sie können die Farben von anpassen Servicemitarbeiter Und Virtual Agent Chat-UI durch Übergabe eines Designobjekts in Start () Rufen Sie an. Eine Liste der Elemente, die Sie anpassen können, finden Sie unter NowChatService – launchIntent(context:context, nowChatTheme:NowChatTheme):Intent. Standardmäßig verwendet die Chat-UI nowUIColorDesign für alle NowSDK-UI-Elemente. In der Beispielanwendung finden Sie ein Beispiel dafür, wie Sie ein Design auf Ihre Chat-UI anwenden.