Transmettre NowChatConfiguration pour modifier le comportement de NowChat

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 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 Now Chat.

    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 s’affiche dans l’en-tête de l’invite.
      • message: valeur de chaîne qui apparaît 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 de fermer l’invite sans fermer la fenêtre de messagerie instantanée.
    • disabledFeatures: liste des fonctionnalités de NowChat à 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. Consultez 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 de l’interface utilisateur dans Now Chat.

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

    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 Classe NowChatConfiguration : Android et NowChatService - start(activity : Activity, themeColors : NowChatTheme = object : NowChatTheme{}, contextData : Map<String, Any> = mapOf(), chatConfiguration : NowChatConfiguration ? = null).