Transmettre NowChatConfiguration pour modifier le comportement de NowChat

  • Rversion finale: Zurich
  • Mis à jour 31 juil. 2025
  • 1 minute de lecture
  • Vous pouvez transmettre un paramètre facultatif NowChatConfiguration lors du démarrage d’une session de messagerie instantanée pour modifier certains comportements de NowChat.

    L’objet NowChatConfiguration contient les options suivantes :
    • closePrompt: texte d’invite qui s’affiche avant de quitter une fenêtre de messagerie instantanée. Vous définissez ce texte d’invite via les paramètres suivants :
      • header: valeur de chaîne pouvant être nullée qui apparaît dans l’en-tête de l’invite.
      • message: valeur de chaîne qui s’affiche dans le corps principal de l’invite.
      • acceptButtonTitle: valeur de chaîne qui apparaît sur le bouton primaire de l’invite. Ce bouton ferme la fenêtre de messagerie instantanée.
      • declineButtonTitle: valeur de chaîne qui apparaît sur le bouton secondaire de l’invite. Ce bouton permet d’ignorer l’invite sans fermer la fenêtre de messagerie instantanée.
    • disabledFeatures: liste des fonctionnalités Now Chat à désactiver. Reportez-vous à la classe d’énumération NowChatConfiguration.Feature pour obtenir la liste des fonctionnalités que vous pouvez désactiver.
    • conversationOptions: liste des options de conversation à appliquer à Now Chat. Reportez-vous à la classe d’énumération NowChatConvestation.ConversationOption pour obtenir la liste des options que vous pouvez appliquer.
    • uiConfiguration: valeur UIConfiguration utilisée pour configurer les composants d’interface utilisateur dans Now Chat.

    L’exemple de code suivant montre comment utiliser NowChatConfiguration() pour configurer Now Chat.

    class MainActivity : AppCompatActivity() {
      @Inject
    
      lateinit var sdkManager: SdkManager
     
      override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
     
        //Drawable to use instead of the default NowChat back button.
        val myDrawable = ContextCompat.getDrawable(activity, R.drawable.my_drawable)
     
        val nowChatConfiguration = 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)
          )
        )
     
        //Start NowChat 
        lifecycleScope.launch { 
          sdkManager.getNowChatService()?.start(this@MainActivity, nowChatConfiguration = nowChatConfiguration) 
        }
      }
    } 

    Pour plus d’informations, reportez-vous à la section NowChatConfiguration : Android et NowChatService - start(activity : Activity, themeColors : NowChatTheme = object : NowChatTheme{}, contextData : Map<String, Any> = mapOf(), chatConfiguration : NowChatConfiguration ? = null).