> ## Documentation Index
> Fetch the complete documentation index at: https://docs.navtalk.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# conversation.connected.insufficient_balance

> Insufficient account balance error

Triggered when the account balance is insufficient to establish or continue the connection. This event is sent during connection setup or during an active session when balance runs out.

## Event Properties

<ResponseField name="type" type="string">
  Event type. Always `"conversation.connected.insufficient_balance"` for this event.
</ResponseField>

<ResponseField name="data" type="object">
  Event data object. May be empty or contain additional metadata.
</ResponseField>

<ResponseField name="message" type="string">
  Optional message describing the insufficient balance error.

  **Example**: `"Insufficient balance to continue service"`
</ResponseField>

<ResponseExample>
  ```json Example theme={null}
  {
    "type": "conversation.connected.insufficient_balance",
    "data": {},
    "message": "Insufficient balance to continue service"
  }
  ```
</ResponseExample>

## Usage Example

```javascript theme={null}
const NavTalkMessageType = Object.freeze({
    INSUFFICIENT_BALANCE: "conversation.connected.insufficient_balance",
    // ... other event types
});

async function handleReceivedMessage(data) {
    switch (data.type) {
        case NavTalkMessageType.INSUFFICIENT_BALANCE:
            const errorMessage = data.message || "Insufficient balance";
            showError(errorMessage);
            // Stop service and prompt user to recharge
            stopRecording();
            showRechargePrompt();
            break;
    }
}
```

<Warning>
  When this event is received, the service will stop. You should inform the user and provide a clear path to recharge their account.
</Warning>