NowVoiceSDK object - Android
concept australia Updated Sep 10, 2026 1 min read NowVoiceSDKAndroidAPI.md
The NowVoiceSDK factory object creates NowVoiceService instances.
Use NowVoiceService to start and manage voice agent sessions.
For more information about configuring NowVoice, including prerequisites and call order, see Embed an AI voice agent with NowVoice.
Parent Topic:Mobile SDK - Android
NowVoiceSDK - makeVoiceService(instanceURL: URL)
Creates a NowVoiceService instance for the specified ServiceNow instance. This is a suspend function.
Call from a coroutine after NowSDK.configure() has been called. This function fetches instance settings over the network, validates that voice is enabled on the instance, and retrieves available voice endpoint configurations.
Throws NowServiceError on failure.
| Name | Type | Description |
|---|---|---|
| instanceURL | URL | URL of the ServiceNow instance, for example URL("https://instancename.service-now.com"). |
| Type | Description |
|---|---|
| Result<NowVoiceService> | Result.success(NowVoiceService) if initialization succeeds, or Result.failure(NowServiceError) if setup fails. |
The following code example creates an instance of NowVoiceService.
JavaScript
import com.servicenow.nowsdk.voice.NowVoiceSDKimport kotlinx.coroutines.launchimport java.net.URL
lifecycleScope.launch { val result = NowVoiceSDK.makeVoiceService( instanceURL = URL("https://your-instance.service-now.com") )
result .onSuccess { voiceService -> // Service is ready; proceed to select an endpoint } .onFailure { error -> // Handle NowServiceError Log.e("NowVoice", "Service creation failed: $error") }}64 lines · 3.3 KB
---
title: NowVoiceSDK object - Android
description: The NowVoiceSDK factory object creates NowVoiceService instances.Creates a NowVoiceService instance for the specified ServiceNow instance. This is a suspend function.
locale: en-US
canonical_url: https://www.servicenow.com/docs/r/australia/api-reference/cllent-mobile-api-reference/NowVoiceSDKAndroidAPI.html
release: australia
product: Cllent Mobile API Reference
classification: cllent-mobile-api-reference
topic_type: concept
last_updated: "2026-09-10"
reading_time_minutes: 1
breadcrumb: [Mobile SDK - Android, Mobile SDK API reference, API reference, API implementation and reference]
---
# NowVoiceSDK object- Android
The NowVoiceSDK factory object creates NowVoiceService instances.
Use [`NowVoiceService`](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/NowVoiceServiceAndroidAPI.md) to start and manage voice agent sessions.
For more information about configuring NowVoice, including prerequisites and call order, see [Embed an AI voice agent with NowVoice](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/developer-guides/mobsdk-and-nowvoice.md).
**Parent Topic:**[Mobile SDK - Android](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/MobileSDKAndroidAPI.md)
## NowVoiceSDK - makeVoiceService\(instanceURL: URL\)
Creates a NowVoiceService instance for the specified ServiceNow instance. This is a suspend function.
Call from a coroutine after [NowSDK.configure\(\)](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/NowSDKAndroidAPI.md) has been called. This function fetches instance settings over the network, validates that voice is enabled on the instance, and retrieves available voice endpoint configurations.
Throws [NowServiceError](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/NowServiceErrorAndroidAPI.md) on failure.
|Name|Type|Description|
|----|----|-----------|
|instanceURL|[URL](https://developer.android.com/reference/kotlin/java/net/URL.html)|URL of the ServiceNow instance, for example `URL("https://instancename.service-now.com")`.|
|Type|Description|
|----|-----------|
|Result<[NowVoiceService](https://raw.githubusercontent.com/ServiceNow/ServiceNowDocs/australia/markdown/australia/api-reference/cllent-mobile-api-reference/NowVoiceServiceAndroidAPI.md)>|`Result.success(NowVoiceService)` if initialization succeeds, or `Result.failure(NowServiceError)` if setup fails.|
The following code example creates an instance of NowVoiceService.
```
import com.servicenow.nowsdk.voice.NowVoiceSDK
import kotlinx.coroutines.launch
import java.net.URL
lifecycleScope.launch {
val result = NowVoiceSDK.makeVoiceService(
instanceURL = URL("https://your-instance.service-now.com")
)
result
.onSuccess { voiceService ->
// Service is ready; proceed to select an endpoint
}
.onFailure { error ->
// Handle NowServiceError
Log.e("NowVoice", "Service creation failed: $error")
}
}
```
| title | NowVoiceSDK object - Android |
| description | The NowVoiceSDK factory object creates NowVoiceService instances.Creates a NowVoiceService instance for the specified ServiceNow instance. This is a suspend function. |
| locale | en-US |
| canonical_url | https://www.servicenow.com/docs/r/australia/api-reference/cllent-mobile-api-reference/NowVoiceSDKAndroidAPI.html |
| release | australia |
| product | Cllent Mobile API Reference |
| classification | cllent-mobile-api-reference |
| topic_type | concept |
| last_updated | 2026-09-10 |
| reading_time_minutes | 1 |
| breadcrumb | Mobile SDK - AndroidMobile SDK API referenceAPI referenceAPI implementation and reference |