**Source URL:** https://limited.veevavault.dev/medical/omnichannel/api-reference/25.2/methods/onagentstatuschange.md

# onAgentStatusChange()

Notifies Vault when an agent's status has changed and sets the `AgentStatus`.

## Parameters {#parameters}

<FieldTable>
| Name | Type | Description |
| --- | --- | --- |
| `agentStatus` | `AgentStatus` | The user's telephony status.Allowed values are `AgentStatus.AVAILABLE` and `AgentStatus.OFFLINE`.If not provided, the default is `AgentStatus.OFFLINE`. |
</FieldTable>

## Example {#example}

<CodeExample title="">
```
import { omniconnectEvent, AgentStatus} from "./vault-medical-omniconnect-25.1.2-release12649.js";


// Agent status set to OFFLINE
function userStatusChangeToOffline() {
    omniconnectEvent.onAgentStatusChange()
}


// Agent status set to AVAILABLE
function userStatusChangeToAvailable() {
    omniconnectEvent.onLogin(AgentStatus.AVAILABLE)
}

```
</CodeExample>

---

**Previous:** [onLogout()](/medical/omnichannel/api-reference/25.2/methods/onlogout)