---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 가상 및 라이브 에이전트 채팅 구현

# 가상 및 라이브 에이전트 채팅 구현 {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 3분

이를 통해 Mobile SDK 애플리케이션 내에서 가상 및 라이브 에이전트 채팅 서비스를 쉽게 구현할 수 있습니다 Android .
[NowChatSDK](https://servicenow-prod.fluidtopics.net/l0t8W_UT~Qbjy01ycIEmYw#NowChatSDKAndroidAPI "NowChatService 클래스는 NowChat과 상호 작용하는 NowChatService를 만드는 데 필요한 기능을 제공합니다. NowChat은 애플리케이션 내에 포함 라이브 에이전트가상 에이전트 할 수 있는 기능을 제공합니다.") API를 사용하여 채팅 서비스를 생성합니다. 서비스가 생성되면 채팅 사용자 인터페이스를 시작해야 합니다.

다음은 채팅 서비스를 만들고 인터페이스를 시작하는 방법을 보여주는 스니펫입니다.

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

애플리케이션 내에서 채팅 기능을 활용하려면 먼저 인스턴스 내에서 채팅 기능을 구성 가상 에이전트 해야 합니다 ServiceNow . 자세한 내용은 [Virtual Agent](https://www.servicenow.com/docs/access?context=virtual-agent-landing-page&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) 문서를 참조하십시오.

## 채팅에 라이브 에이전트가상 에이전트 컨텍스트 변수 전달 {#mobsdk-and-imp-chat__section_tcq_3tj_k1c}

[NowChatService-start()](https://servicenow-prod.fluidtopics.net/1gp5tk7RtXFVey_fbPKIxw#NChatServA-start_O_O "지정된 NowChat 활동을 시작합니다.") 함수에 매개변수를 contextData 전달하여 채팅 세션을 시작할 때 채팅 컨텍스트 변수를 전달할 수 있습니다. 채팅 컨텍스트 변수에 대한 자세한 내용은 다음 문서를 참조하십시오 [Live agent chat context variables](https://www.servicenow.com/docs/access?context=live-agent-chat-context-vars&version=australia&pubname=australia-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)
        }
      }
    }

## 채팅 사용자 인터페이스 테마 지정

start() 호출에서 테마 객체를 전달하여 채팅 UI의 라이브 에이전트가상 에이전트 색상을 사용자 지정할 수 있습니다. 사용자 지정할 수 있는 요소 목록은 다음 문서를 참조하십시오 [NowChatService - launchIntent(context:Context, nowChatTheme:NowChatTheme):의도](https://servicenow-prod.fluidtopics.net/1gp5tk7RtXFVey_fbPKIxw#NChatServA-launchIntent_O_O "NowChat 활동을 여는 데 사용되는 의도를 시작합니다. 일반적으로 [android.app.PendingIntent]를 만드는 데 사용됩니다."). 기본적으로 채팅 UI는 모든 NowSDK UI 요소에 테마를 nowUIColor 사용합니다. 채팅 UI에 테마를 적용하는 방법에 대한 예제는 샘플 애플리케이션을 참조하십시오.