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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Implementieren Sie virtuelles und ServicemitarbeiterChat

# Implementieren Sie virtuelles und ServicemitarbeiterChat {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Die Mobile SDKErmöglicht Ihnen die einfache Implementierung von Virtual und ServicemitarbeiterChat-Services in Ihrem AndroidAnwendung.
Sie verwenden [Jetzt ChatSDK](https://servicenow-prod.fluidtopics.net/Y5PXmJphDZDMkITXpruoyw#NowChatSDKAndroidAPI "Die Now Chatservice Die Klasse bietet die Funktion, die zum Erstellen eines NowChatservice erforderlich ist, der mit NowChat interagiert. Now Chat bietet die Möglichkeit zum Einbetten ServicemitarbeiterUnd Virtual AgentIn Ihrer Anwendung.")API zum Erstellen des Chatservice. 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 AgentIn Ihrem ServiceNowInstanz. Details finden Sie unter [Virtual Agent](https://www.servicenow.com/docs/access?context=virtual-agent-landing-page&version=yokohama&pubname=yokohama-conversational-interfaces&ft:locale=en-US).

## Kontextvariablen werden an übergeben ServicemitarbeiterUnd Virtual AgentChat {#mobsdk-and-imp-chat__section_tcq_3tj_k1c}

Sie können Chat-Kontextvariablen beim Starten einer Chatsitzung übergeben, indem Sie übergeben contextDataParameter in [Now ChatService-Start()](https://servicenow-prod.fluidtopics.net/ApQFuXqSgjlGlPSUc7Y83g#NChatServA-start_O_O "Startet die angegebene Now Chat-Aktivität.")Funktion. 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=yokohama&pubname=yokohama-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)
        }
      }
    }

## Design der Chat-Anwenderoberfläche

Sie können die Farben von anpassen ServicemitarbeiterUnd Virtual AgentChat-UI, indem ein Designobjekt in übergeben wird Start() Rufen Sie an. Eine Liste der Elemente, die Sie anpassen können, finden Sie unter [NowChatservice -- launchIntent(context:context, themeColors:NowChatTheme):Absicht](https://servicenow-prod.fluidtopics.net/ApQFuXqSgjlGlPSUc7Y83g#NChatServA-launchIntent_O_O "Startet die Absicht, die zum Öffnen der Now Chat-Aktivität verwendet wird. Wird normalerweise zum Erstellen von verwendet [android.App.Ausstehende Absicht] ."). Standardmäßig verwendet die Chat-UI nowUIColorDesign für alle Now SDK-UI-Elemente. In der Beispielanwendung finden Sie ein Beispiel dafür, wie Sie ein Design auf Ihre Chat-UI anwenden.

