```
public final class EmilyChatOptions

                    
```
Configuration passed to EmilyChat.configure. Mirrors the JS EmilyInitOptions shape — the bridge serializes this straight into the INIT.payload object the web SDK consumes.
```
EmilyChat.configure(
    EmilyChatOptions(
        serviceSid = "LV3-...",
        locale = "zh-Hans",
        metadata = mapOf("plan" to "pro", "tenantId" to 42),
    )
)
```
Note: there is no visual/branding option here. The widget's appearance (brand color, theme, header title, logos…) comes from the tenant's chat configuration on the Level3AI server, fetched by the web bundle at boot — nothing for the host app to pass.
Note: metadata and attributes must contain only JSON-compatible values (String, Boolean, numeric types, null, or Map / List / org.json.JSONObject / org.json.JSONArray of the same). Non-JSON values surface as an EmilyChatEvent.BridgeError at open-time rather than crashing.

Field Summary

Fields
Modifier and Type	Field	Description
`private final String`	`serviceSid`
`private final String`	`userToken`
`private final String`	`locale`
`private final Map<String, Object>`	`metadata`
`private final Map<String, Object>`	`attributes`
`private final EmilyChatEnvironment`	`environment`

Constructor Summary

Constructors
Constructor	Description
`EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata, Map<String, Object> attributes, EmilyChatEnvironment environment)`
`EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata, Map<String, Object> attributes)`
`EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata)`
`EmilyChatOptions(String serviceSid, String userToken, String locale)`
`EmilyChatOptions(String serviceSid, String userToken)`
`EmilyChatOptions(String serviceSid)`

Method Summary

Modifier and Type	Method	Description
`final String`	`getServiceSid()`	The Emily service identifier issued to your tenant.
`final String`	`getUserToken()`	Opaque end-user token used by the backend to identify / authenticate the conversation owner.
`final String`	`getLocale()`	BCP-47 language tag (e.g.
`final Map<String, Object>`	`getMetadata()`	Free-form key/value bag forwarded to the backend on every message.
`final Map<String, Object>`	`getAttributes()`	User-attribute map (name, email, avatarUrl, customFields…).
`final EmilyChatEnvironment`	`getEnvironment()`	Environment / CDN the WebView should load.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata, Map<String, Object> attributes, EmilyChatEnvironment environment)
```
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata, Map<String, Object> attributes)
```
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid, String userToken, String locale, Map<String, Object> metadata)
```
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid, String userToken, String locale)
```
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid, String userToken)
```
  - EmilyChatOptions
```
EmilyChatOptions(String serviceSid)
```
- Method Detail
  - getServiceSid
```
 final String getServiceSid()
```
    The Emily service identifier issued to your tenant. Required.
  - getUserToken
```
 final String getUserToken()
```
    Opaque end-user token used by the backend to identify / authenticate the conversation owner. Optional for anonymous chats.
  - getLocale
```
 final String getLocale()
```
    BCP-47 language tag (e.g. "en", "zh-Hans"). null → auto-detect.
  - getMetadata
```
 final Map<String, Object> getMetadata()
```
    Free-form key/value bag forwarded to the backend on every message. Must be JSON-safe.
  - getAttributes
```
 final Map<String, Object> getAttributes()
```
    User-attribute map (name, email, avatarUrl, customFields…). Merged flat into the conversation's attributes — the same shape the web SDK's Emily.setAttributes() takes, so App and browser integrations land identical data on the backend. Keys that collide with Emily's own init options (serviceSid, userToken, locale, metadata, style, showLauncher, fullscreen) are dropped and reported as an EmilyChatEvent.BridgeError with stage "init.attributes". Must be JSON-safe.
  - getEnvironment
```
 final EmilyChatEnvironment getEnvironment()
```
    Environment / CDN the WebView should load. Defaults to EmilyChatEnvironment.Production.

Class EmilyChatOptions

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

EmilyChatOptions

EmilyChatOptions

EmilyChatOptions

EmilyChatOptions

EmilyChatOptions

EmilyChatOptions

Method Detail

getServiceSid

getUserToken

getLocale

getMetadata

getAttributes

getEnvironment