Implémenter Virtual et Agent actif la messagerie instantanée

Cela Mobile SDK vous permet 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 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 dans votre ServiceNow instance. Pour plus de détails, voir Virtual Agent.

Transmission de variables de contexte à la Agent actifAgent virtuel messagerie instantanée

Vous pouvez transmettre des variables de contexte 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( ). Pour plus d’informations sur les variables de contexte de messagerie instantanée, reportez-vous à la section Live agent chat context variables.

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 de la Agent actif messagerie instantanée en Agent virtuel transmettant 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, nowChatTheme :NowChatTheme) :Intent. Par défaut, l’interface utilisateur de la messagerie instantanée utilise le thème pour tous les éléments d’interface nowUIColor utilisateur de 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.