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

# Agent Billing: Live, Demo, Off

> Choose whether each agent takes calls and how it is billed

Every agent has one billing state. Set it under **Customers → Agents**, in the **Billing** column, or in the **Billing** card on the agent's edit page.

| State | Takes calls | Monthly agent fee | Call costs |
| - | - | - | - |
| **Live** | Yes | Charged | Charged |
| **Demo** | Yes | None within your plan's demo slots | Refunded nightly within the slots, except calls covered by included minutes |
| **Off** | No | None | None |

## How billing works

* Each plan includes a set number of demo slots, shown on the [Billing](https://docs.telzino.com/admin-guide/dashboard/billing.md) page. Demo agents fill them oldest first.
* If more agents are Demo than your plan includes, the extra ones are billed at the normal per-agent rate and their calls are not refunded. A warning above the table says how many to move out of Demo.
* Moving an agent out of Demo frees its slot and stops refunds for its calls that have not been refunded yet.
* An agent starts or stops taking calls as soon as you confirm. Billing updates within 24 hours, at the next daily billing sync.
* Agents under an inactive reseller are not billed.

## The Agents page

At the top of **Customers → Agents**:

* **Demo slots: N of M used** shows how many of your plan's demo slots are taken. Reseller users don't see it.
* **Est. monthly agent fees** estimates the monthly agent fee: Live agents, plus any Demo agents past your plan's limit, times your plan's per-agent fee.
* **All · Live · Demo · Off** filters the table by billing state and shows how many agents are in each.
* **Search by agent name or ID** narrows the table.
* **Billing history** opens the list of every billing state change.

| Column | Description |
| - | - |
| **Agent Name** | The agent's name and ID |
| **Reseller** | The reseller the agent belongs to |
| **Organization** | The organization the agent belongs to |
| **Extension** | The agent's extension |
| **Billing** | The **Live / Demo / Off** control, with a short line on what the agent costs |

## Changing one agent

1. Pick **Live**, **Demo** or **Off** in the agent's **Billing** column, or in the **Billing** card on its edit page.
2. Read the confirmation. It says what changes: the monthly fee, refunds and demo slots.
3. Click **Confirm change**.

An option you can't pick is greyed out. Hover over it to see why; on the edit page the reason is also shown under the control.

## Changing several agents

1. Select agents with the checkboxes. A bar shows **N selected · Set billing state:**.
2. Pick **Live** or **Off**. Telzino Admin and Super User also see **Demo**.
3. Read the confirmation. It says how many agents the change applies to and why the rest are skipped: already in that state, cancelled, no free demo slot, or a Demo change you can't make.
4. Click **Confirm change**. If none of the selected agents can be changed, only **Cancel** is available.

Demo is applied up to the free demo slots, in the order the agents appear in the table.

## Who can change what

| Role | Live ↔ Off | Into Demo, or Demo → Live | Demo → Off |
| - | - | - | - |
| Telzino Admin, Super User | Yes | Yes | Yes |
| Telzino Member | Yes | No | Yes |
| Reseller users (their own agents only) | Yes | No | Yes |

Cancelled agents can't be changed here.

## Billing history

**Billing history** lists every billing state change, newest first: when it happened, the agent, the change, and who made it. Reseller users see only changes to their own agents. One agent's billing changes are also listed in its [Change History](https://docs.telzino.com/admin-guide/dashboard/customer-management.md#change-history) tab.

> [!NOTE]
>
> To change the billing state through the API, set `billing_state` with [Update Agent](https://docs.telzino.com/api-reference/agents/update.md). To limit usage reports to Demo agents, use **Demo agents only** in [Billing Report and Minutes by Reseller](https://docs.telzino.com/admin-guide/dashboard/reports.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.