---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Implémenter le virtuel et Agent actif la messagerie instantanée

# Implémenter le virtuel et Agent actif la messagerie instantanée {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Ils Mobile SDK vous permettent d'implémenter facilement des services virtuels et Agent actif de messagerie instantanée au sein de votre Android application.
Vous utilisez l'API [NowChatSDK](https://servicenow-prod.fluidtopics.net/S2aUsaw3vDTpDAJtve4iiw#NowChatSDKAndroidAPI "La classe NowChatService fournit la fonction nécessaire pour créer un NowChatService qui interagit avec NowChat. NowChat offre la possibilité d’intégrer Agent actif et Agent virtuel dans votre application.") pour créer le service de messagerie instantanée. Une fois le service créé, vous devez démarrer l'interface utilisateur de la messagerie instantanée.

Voici un extrait qui montre comment créer le service de messagerie instantanée et démarrer l'interface.

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

Avant de pouvoir exploiter la fonctionnalité de messagerie instantanée au sein de votre application, vous devez effectuer la configuration Agent virtuel au sein de votre ServiceNow instance. Pour plus de détails, voir [Virtual Agent](https://www.servicenow.com/docs/access?context=virtual-agent-landing-page&version=xanadu&pubname=xanadu-conversational-interfaces&ft:locale=en-US).

## Transmission de variables de contexte à et Agent virtuel messagerie Agent actif instantanée {#mobsdk-and-imp-chat__section_tcq_3tj_k1c}

Vous pouvez transmettre des variables contextuelles de messagerie instantanée lors du démarrage d'une session de messagerie instantanée en transmettant le contextData paramètre dans la fonction [NowChatService-start().](https://servicenow-prod.fluidtopics.net/_rtk68vzAt2xotyUTMIzUQ#NChatServA-start_O_O "Lance l’activité Now Chat spécifiée.") Pour en savoir plus sur les variables de contexte de la messagerie instantanée, reportez-vous à la section [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)
        }
      }
    }

## Thème de l'interface utilisateur de la messagerie instantanée

Vous pouvez personnaliser les couleurs de l'interface utilisateur et Agent virtuel de la Agent actif messagerie instantanée en passant un objet de thème dans l'appel start(). Pour obtenir la liste des éléments que vous pouvez personnaliser, reportez-vous à la section [NowChatService : launchIntent(context :Context, themeColors :NowChatTheme) :Intent](https://servicenow-prod.fluidtopics.net/_rtk68vzAt2xotyUTMIzUQ#NChatServA-launchIntent_O_O "Lance l’intention utilisée pour ouvrir l’activité Now Chat. Généralement utilisé pour créer un [android.app.PendingIntent]."). Par défaut, l'interface utilisateur de la messagerie instantanée utilise le thème pour tous les éléments de l'interface nowUIColor utilisateur NowSDK. Consultez l'exemple d'application pour obtenir un exemple sur la façon d'appliquer un thème à votre interface utilisateur de messagerie instantanée.