---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Implementieren Sie Virtual und Service Desk-Mitarbeiter den Chat

# Implementieren Sie Virtual und Service Desk-Mitarbeiter den Chat {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Mit Mobile SDK können Sie virtuelle und Chat-Services für \[ Service Desk-Mitarbeiter in Ihrer Anwendung Android ganz einfach implementieren.
Sie verwenden die [NowChatSDK-](https://servicenow-prod.fluidtopics.net/WkoqVdEsxzoemIzJIme3yQ#NowChatSDKAndroidAPI "Die NowChatService -Klasse bietet die Funktion, die zum Erstellen eines NowChatService erforderlich ist, der mit NowChat interagiert. NowChat bietet die Möglichkeit, Service Desk-Mitarbeiter und Virtual Agent in Ihre Anwendung einzubetten.") API, um den Chatservice zu erstellen. Sobald der Service erstellt wurde, müssen Sie die Chat-Anwenderoberfläche starten.

Im Folgenden finden Sie einen Codeausschnitt, der zeigt, wie Sie den Chatservice 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 -Chatfunktion in Ihrer -Anwendung nutzen können, müssen Sie Virtual Agent in Ihrer ServiceNow -Instanz konfigurieren. Details finden Sie unter [Virtual Agent](https://www.servicenow.com/docs/access?context=virtual-agent-landing-page&version=xanadu&pubname=xanadu-conversational-interfaces&ft:locale=en-US).

## Übergabe von Kontextvariablen an Service Desk-Mitarbeiter - und Virtual Agent -Chat {#mobsdk-and-imp-chat__section_tcq_3tj_k1c}

Sie können Chat-Kontextvariablen beim Starten einer Chatsitzung übergeben, indem Sie den Parameter contextData in der Funktion [NowChatService-start() übergeben](https://servicenow-prod.fluidtopics.net/R5uYSmYu6OfwQpSIrSajpw#NChatServA-start_O_O "Startet die angegebene NowChat-Aktivität."). Weitere Informationen zu Chat-Kontextvariablen finden Sie unter [Live agent chat context variables](https://www.servicenow.com/docs/access?context=live-agent-chat-context-vars&version=xanadu&pubname=xanadu-conversational-interfaces&ft:locale=en-US).  

    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)
        }
      }
    }

## Designieren Sie die Chat-Anwenderoberfläche

Sie können die Farben der Chat-UI Service Desk-Mitarbeiter und Virtual Agent anpassen, indem Sie ein Designobjekt im Aufruf von start() übergeben. Eine Liste der Elemente, die Sie anpassen können, finden Sie unter [NowChatService -- launchIntent(Kontext:Kontext, ThemaFarben:NowChatTheme):Absicht](https://servicenow-prod.fluidtopics.net/R5uYSmYu6OfwQpSIrSajpw#NChatServA-launchIntent_O_O "Startet die Absicht, die zum Öffnen der NowChat-Aktivität verwendet wird. Wird normalerweise zum Erstellen eines [android.app.PendingIntent]verwendet."). Standardmäßig verwendet die Chat-UI das Design nowUIColor für alle NowSDK-UI-Elemente. In der Beispielanwendung finden Sie ein Beispiel dafür, wie Sie ein Design auf Ihre Chat-UI anwenden können.