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


---

# Now ChatKonfiguration -- Android

# Now ChatKonfiguration -- Android {#ariaid-title1}

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

Die Now ChatKonfiguration Mit der Klasse können Sie Optionen in einer Chatsitzung konfigurieren, z. B. das Anzeigen einer Eingabeaufforderung vor dem Schließen eines Chatfensters, das Deaktivieren von Funktionen während der Verwendung des Chats, das Anwenden verschiedener Konversationsoptionen bei Verwendung des Chats und das Konfigurieren von UI-Komponenten in Now Chat.

## NowChatConfiguration -- NowChatConfiguration(closePrompt: ClosePrompt? = null, disabledFeatures: List\<Feature\>? = Null, Konversationsoptionen: List\<ConversationOption\>? = null, uiConfiguration: UIConfiguration? = Null) {#ariaid-title2}

Konfiguriert Optionen für die aktuelle Chatsitzung. Mit dieser Methode können Sie vor dem Schließen eines Chatfensters eine Eingabeaufforderung anzeigen, Funktionen während der Verwendung des Chats deaktivieren, verschiedene Konversationsoptionen bei Verwendung des Chats anwenden und UI-Komponenten in Now Chat konfigurieren.
{#NChatOpA-NowChatOptions_O_O_B__table_ugs_wjd_kbc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| ClosePrompt | [Aufforderung schließen](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatOpA-ClosePrompt_S_S_S_S "Erstellt ein ClosePrompt-Objekt basierend auf den übergebenen Parametern und gibt es zurück. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Optionen zum Schließen der Eingabeaufforderung in der Chatsitzung.")Objekt | Aufforderung, die angezeigt werden soll, bevor das zugehörige Chatfenster geschlossen wird. Rufen Sie an [Now ChatConfiguration.ClosePrompt()](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatOpA-ClosePrompt_S_S_S_S "Erstellt ein ClosePrompt-Objekt basierend auf den übergebenen Parametern und gibt es zurück. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Optionen zum Schließen der Eingabeaufforderung in der Chatsitzung.")Unterklasse zum Definieren des Werts dieses Parameters. Zum Beispiel: closePrompt = NowChatConfiguration.ClosePrompt( header = null, message = "Are you sure you want to leave?", acceptButtonTitle = "Yes", declineButtonTitle = "No" ) Wenn Sie keine Aufforderung zum Schließen anzeigen möchten, übergeben Sie null. |
| DeaktiviertFeatures | Liste\<NowChatKonfiguration. Funktion\> | Liste der Chatfunktionen, die in der aktuellen Chatsitzung deaktiviert werden sollen. Gültiger Wert: START_NEW_CONVERSATION: Ausblenden/deaktivieren Starten Sie eine neue Konversation Schaltfläche, die in einem Chatfenster angezeigt wird. Die verfügbaren Chatfunktionen sind in definiert Now ChatConfiguration.Feature Aufzählungsklasse. Zum Beispiel: disabledFeatures = listOf(NowChatConfiguration.Feature.START_NEW_CONVERSATION) Wenn Sie keine Funktionen deaktivieren möchten, übergeben Sie null. |
| Konversationsoptionen | Liste\<Konversation Option\>? | Liste der Konversationsoptionen, die auf Now Chat angewendet werden sollen. Gültige Werte: * Die laufende END_CONVERSATION_ON_EXIT:-Konversation wird beendet, wenn das Now Chat-Fenster verlassen wird. * FORCE_NEW_CONVERSATION: Erzwingt eine neue Chat-Konversation, wenn Now Chat startet. Die verfügbaren Konversationsoptionen sind in definiert Now ChatKonfiguration.Konversationsoption Aufzählungsklasse. Zum Beispiel: conversationOptions = listOf(NowChatConfiguration.ConversationOption.FORCE_NEW_CONVERSATION), Wenn Sie keine Optionen anwenden möchten, übergeben Sie null. |
| UiKonfiguration | [UIKonfiguration?](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatCnfgA-UIConfig_S_S "Erstellt und gibt ein UIKonfigurationsobjekt basierend auf den übergebenen Parametern zurück. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Konstruktor zum Konfigurieren von UI-Komponenten in NowChat.") | UIKonfigurationswerte, die zum Konfigurieren von UI-Komponenten in NowChat verwendet werden sollen. Gültige Werte: * attachmentUploadButton: Konfiguration für `Schaltfläche „AnhangUpload" `Wird neben der Texteingabe angezeigt, während Sie mit einem Servicemitarbeiter sprechen. * closeButton: Konfiguration für `Schaltfläche „Schließen" `Wird für die Rücknavigation in der Now Chat-Symbolleiste verwendet. Zum Beispiel: uiConfiguration = NowChatConfiguration.UIConfiguration( closeButton = NowChatConfiguration.CloseButton( icon = myDrawable ), attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false) ) Übergeben Sie null, um die Standardkonfiguration zu verwenden. |
[Tabelle : 1. Parameter]

{#NChatOpA-NowChatOptions_O_O_B__table_ugs_wjd_kbc} {#NChatOpA-NowChatOptions_O_O_B__table_vgs_wjd_kbc__entry__2}

| Typ | Beschreibung |
|-|-|
| Now ChatKonfiguration | Gibt ein NowChatConfiguration-Objekt zurück, das Sie beim Aufrufen von übergeben können [NowChatService -- Start(activity: Activity, themeColors: NowChatTheme = object: NowChatTheme{}, contextData: Map\<String, Any\> = mapOf(), chatConfiguration: NowChatConfiguration? = Null)](https://servicenow-prod.fluidtopics.net/ApQFuXqSgjlGlPSUc7Y83g#NChatServA-start_O_O "Startet die angegebene Now Chat-Aktivität.")Methode. |
[Tabelle : 2. Rückgaben]

{#NChatOpA-NowChatOptions_O_O_B__table_vgs_wjd_kbc}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird.

    suspend fun launchChat() {
      val chatService = getNowChatService()
     
      //Drawable to use instead of the default NowChat back button.
      val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable)
         
      val chatConfiguration = NowChatConfiguration(
        closePrompt = NowChatConfiguration.ClosePrompt(
          header = null,
          message = "Are you sure you want to leave?",
          acceptButtonTitle = "Yes",
          declineButtonTitle = "No"
        ),
        disabledFeatures = listOf(NowChatConfiguration.Feature.START_NEW_CONVERSATION),
        conversationOptions = listOf(NowChatConfiguration.ConversationOption.FORCE_NEW_CONVERSATION),
        uiConfiguration = NowChatConfiguration.UIConfiguration(
          closeButton = NowChatConfiguration.CloseButton(
            icon = myDrawable
          ),
          attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false)
        )
      )

      chatService?.start(activity, chatConfiguration)
    }

## Now ChatConfiguration -- AttachmentUploadButton(isVisible: Boolescher Wert = wahr) {#ariaid-title3}

Definiert die UI-Konfigurationen, die auf die Schaltfläche „Anhang hochladen" angewendet werden sollen, die neben der Texteingabe angezeigt wird, während Sie mit einem Servicemitarbeiter sprechen.
Schaltfläche „AnhangUpload" Ist eine Unterklasse von Now ChatKonfiguration Klasse.
{#NChatCnfgA-AttachUploadButton_B__table_b2d_4yr_ddc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| isVisible | Boolean | Kennzeichnung, die die Sichtbarkeit der Schaltfläche „Anhang hochladen" angibt. Gültige Werte: * Wahr: Schaltfläche „Anhang hochladen" ist sichtbar. * Falsch: Schaltfläche „Anhang hochladen" ist ausgeblendet. Standard: Wahr |
[Tabelle : 3. Parameter]

{#NChatCnfgA-AttachUploadButton_B__table_b2d_4yr_ddc} {#NChatCnfgA-AttachUploadButton_B__table_c2d_4yr_ddc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | UI-Konfigurationsobjekt. |
[Tabelle : 4. Rückgaben]

{#NChatCnfgA-AttachUploadButton_B__table_c2d_4yr_ddc}  
Das folgende Codebeispiel zeigt, wie die Schaltfläche „AttachmentUpload" ausgeblendet wird.

    suspend fun launchChat() {
      val chatService = getNowChatService()

      val chatConfiguration = NowChatConfiguration(
        uiConfiguration = NowChatConfiguration.UIConfiguration(
          attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false)
        )
      )
     
      chatService?.start(activity, chatConfiguration)
    }

## Now ChatConfiguration -- CloseButton(Symbol: Ziehbar?) {#ariaid-title4}

Definiert die Konfiguration der Schaltfläche „Schließen", die für die Rücknavigation in der Now Chat-Symbolleiste verwendet wird. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Schaltfläche „Schließen" zur Verwendung in der Chatsitzung.
Schaltfläche schließen() Ist eine Unterklasse von Now ChatKonfiguration Klasse.
{#NChatCnfgA-CloseButton_S__table_sbp_zwr_ddc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| icon | Ziehbar? | Ziehbares Objekt, das für die Schaltfläche „Schließen" (zurück) verwendet werden soll. Sie können verwenden ContextCompat.getDrawable() Methode zum Abrufen dieses abziehbaren Objekts. Zum Beispiel: val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable) Um das standardmäßige ziehbare Element zu verwenden, übergeben Sie null. Standard: Schaltfläche „Now Chat zurück" |
[Tabelle : 5. Parameter]

{#NChatCnfgA-CloseButton_S__table_sbp_zwr_ddc} {#NChatCnfgA-CloseButton_S__table_tbp_zwr_ddc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Konfigurationsobjekt für Schaltfläche „Schließen". |
[Tabelle : 6. Rückgaben]

{#NChatCnfgA-CloseButton_S__table_tbp_zwr_ddc}  
Das folgende Codebeispiel zeigt, wie ein anwenderdefiniertes Symbol für die Schaltfläche „Schließen" in der Now Chat-Symbolleiste festgelegt wird.

    suspend fun launchChat() {
      val chatService = getNowChatService()
     
      //Drawable to use instead of the default NowChat back button.
      val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable)

      val chatConfiguration = NowChatConfiguration(
        uiConfiguration = NowChatConfiguration.UIConfiguration(
          closeButton = NowChatConfiguration.CloseButton(
            icon = myDrawable
          )
        )
      )

      chatService?.start(activity, chatConfiguration)
    }

## NowChatConfiguration -- ClosePrompt(Header: Zeichenfolge, Nachricht: Zeichenfolge, akzeptButtonTitle: Zeichenfolge, declineButtonTitle: Zeichenfolge) {#ariaid-title5}

Erstellt ein ClosePrompt-Objekt basierend auf den übergebenen Parametern und gibt es zurück. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Optionen zum Schließen der Eingabeaufforderung in der Chatsitzung.
{#NChatOpA-ClosePrompt_S_S_S_S__table_tts_2qz_ddc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| header | Zeichenfolge | Text, der im Header des Prompts angezeigt werden soll. Wenn Sie keinen Prompt-Header anzeigen möchten, übergeben Sie null. |
| Nachricht | Zeichenfolge | Text, der als Haupttext der Eingabeaufforderung angezeigt werden soll. |
| Accept ButtonTitle | Zeichenfolge | Text, der auf der primären Schaltfläche des Prompts zum Schließen des Chatfensters angezeigt werden soll. |
| DelineButtonTitle | Zeichenfolge | Text, der auf der sekundären Schaltfläche des Prompts angezeigt werden soll, die den Prompt verschließt. Wenn Sie keine sekundäre Schaltfläche anzeigen möchten, übergeben Sie null. |
[Tabelle : 7. Parameter]

{#NChatOpA-ClosePrompt_S_S_S_S__table_tts_2qz_ddc} {#NChatOpA-ClosePrompt_S_S_S_S__table_uts_2qz_ddc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Aufforderung, die angezeigt werden soll, bevor das zugehörige Chatfenster geschlossen wird. |
[Tabelle : 8. Rückgaben]

{#NChatOpA-ClosePrompt_S_S_S_S__table_uts_2qz_ddc}  
Das folgende Codebeispiel zeigt, wie diese Methode aufgerufen wird, um den Prompt zum Schließen zu konfigurieren.

    suspend fun launchChat() {
      val chatService = getNowChatService()
     
      val chatConfiguration = NowChatConfiguration(
        closePrompt = NowChatConfiguration.ClosePrompt(
          header = null,
          message = "Are you sure you want to leave?",
          acceptButtonTitle = "Yes",
          declineButtonTitle = "No"
        )
      )
      chatService?.start(activity, chatConfiguration)
    }

## Now ChatConfiguration -- UIConfiguration(closeButton: CloseButton? = null, attachmentUploadButton: AttachmentUploadButton? = Null) {#ariaid-title6}

Erstellt und gibt ein UIKonfigurationsobjekt basierend auf den übergebenen Parametern zurück. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Konstruktor zum Konfigurieren von UI-Komponenten in NowChat.
UIKonfiguration Ist eine Unterklasse von Now ChatKonfiguration Klasse.
{#NChatCnfgA-UIConfig_S_S__table_p2y_2vr_ddc__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Schaltfläche „Schließen" | [Schaltfläche schließen?](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatCnfgA-CloseButton_S "Definiert die Konfiguration der Schaltfläche „Schließen“, die für die Rücknavigation in der Now Chat-Symbolleiste verwendet wird. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Schaltfläche „Schließen“ zur Verwendung in der Chatsitzung.") | Konfiguration für `Schaltfläche „Schließen" `Wird in der Now Chat-Symbolleiste angezeigt und für die Rücknavigation verwendet. Rufen Sie an [Now ChatConfiguration -- CloseButton(Symbol: Ziehbar?)](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatCnfgA-CloseButton_S "Definiert die Konfiguration der Schaltfläche „Schließen“, die für die Rücknavigation in der Now Chat-Symbolleiste verwendet wird. Sie übergeben dieses Objekt dann an Now ChatConfiguration() Methode zum Konfigurieren der Schaltfläche „Schließen“ zur Verwendung in der Chatsitzung.")Unterklasse zum Definieren des Werts dieses Parameters. Zum Beispiel: val chatConfiguration = NowChatConfiguration( uiConfiguration = NowChatConfiguration.UIConfiguration( closeButton = NowChatConfiguration.CloseButton( icon = myDrawable ) ) |
| AttachmentUploadButton | [Schaltfläche „AnhangUploadButton"?](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatCnfgA-AttachUploadButton_B "Definiert die UI-Konfigurationen, die auf die Schaltfläche „Anhang hochladen“ angewendet werden sollen, die neben der Texteingabe angezeigt wird, während Sie mit einem Servicemitarbeiter sprechen.") | Konfiguration für `Schaltfläche „AnhangUpload" `Wird neben der Texteingabe angezeigt, während Sie mit einem Servicemitarbeiter sprechen. Rufen Sie an [Now ChatConfiguration -- AttachmentUploadButton(isVisible: Boolescher Wert = wahr)](https://servicenow-prod.fluidtopics.net/GQ3APLhylv7QFYRvCUutRA#NChatCnfgA-AttachUploadButton_B "Definiert die UI-Konfigurationen, die auf die Schaltfläche „Anhang hochladen“ angewendet werden sollen, die neben der Texteingabe angezeigt wird, während Sie mit einem Servicemitarbeiter sprechen.")Unterklasse zum Definieren des Werts dieses Parameters. Zum Beispiel: val chatConfiguration = NowChatConfiguration( uiConfiguration = NowChatConfiguration.UIConfiguration( attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false) ) ) |
[Tabelle : 9. Parameter]

{#NChatCnfgA-UIConfig_S_S__table_p2y_2vr_ddc} {#NChatCnfgA-UIConfig_S_S__table_q2y_2vr_ddc__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | UI-Konfigurationsobjekt. |
[Tabelle : 10. Rückgaben]

{#NChatCnfgA-UIConfig_S_S__table_q2y_2vr_ddc}  
Das folgende Codebeispiel zeigt, wie aufgerufen wird UIKonfiguration Unterklasse zum Festlegen des Symbols für die closeButton und zum Ausblenden der Schaltfläche zum Hochladen von Anhängen.

    suspend fun launchChat() {
      val chatService = getNowChatService() 
         
      //Drawable to use instead of the default NowChat back button. 
      val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable) 
     
      val chatConfiguration = NowChatConfiguration( 
        uiConfiguration = NowChatConfiguration.UIConfiguration( 
          closeButton = NowChatConfiguration.CloseButton( 
            icon = myDrawable 
          ), 
          attachmentUploadButton = NowChatConfiguration.AttachmentUploadButton(isVisible = false)
        ) 
      ) 
     
      chatService?.start(activity, chatConfiguration) 
    } 


