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

# Live calls: listen in, guide the agent or take over

> Watch calls as they happen, listen in without the caller hearing you, send the agent instructions, end a call, or take the call over and talk to the caller.

Live calls shows the calls your agents are on right now. From any of them you can listen in, send the agent an instruction it acts on straight away, end the call, or take the call over and talk to the caller yourself.

![The Live now view of the Conversation log: six calls in progress as cards, each with the Live pill, the caller, the running length, the start time and the version](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/monitor/live-calls-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=62c2938df58da418c104aaf5765c7a75)

## Before you start

Watching the board needs the **View** permission on the **Conversation log**. Listening in, sending instructions, ending a call and taking over need **Monitor (live)** ("Listen in on calls while they happen."). Owners and Admins have it by default; Users don't. See [Roles and permissions](https://docs.tryhamsa.com/overview/projects/roles-and-permissions.md).

Listening needs no microphone. Taking over needs a microphone, a browser that allows it, and a secure (HTTPS) connection. Use headphones so the caller doesn't hear an echo.

## See the calls going on now

Click **Live calls** in the sidebar. The [Conversation log](https://docs.tryhamsa.com/agents/monitor/conversation-log.md) opens on its **Live now** view, which shows calls in progress as a board, "Calls going on now".

Each card shows the agent (or the caller, when you're looking at one agent's calls), the **Live** pill, the caller, any flags, how long the call has run, when it started, and the version that answered. The board shows up to 30 calls, longest running first. With more, it says how many of the total it shows.

The board refreshes every 20 seconds. The agent filter still applies, so you can watch one agent's calls only. With no calls in progress, it says "No calls right now".

Click a card to open the call.

## Listen in on a call

**1. Open the call**

Click its card on the board, or its row in the Conversation log.

**2. Start listening**

Under **Monitor the call**, click **Start live monitoring**. You see "Joining as listener..." and then **Live call**.

![A live call open beside the board, with Monitor the call, Start live monitoring and Terminate call](https://mintcdn.com/hamsa-452fa79a/2654KIaxnTY04VOj/images/agents/monitor/live-call-monitor-light.webp?fit=max\&auto=format\&n=2654KIaxnTY04VOj\&q=85\&s=9dc2f10612a63b76da7efef5c2688989)

**3. Follow the conversation**

You hear the call, and the **Transcript** tab fills in as people speak ("Live transcription active").

**4. Leave when you're done**

Click **Leave call**. The call goes on without you.

Nobody on the call hears you: as a listener you can't send audio. **Mute** and **Unmute** turn the call's sound off and on for you only.

When the call ends, listening stops and the call closes.

For a chat, the same area says **Observe the chat**. Click **Start observing** to watch the chat as it happens (read-only), and **Leave chat** to stop.

## Send the agent an instruction

While you listen, you can tell the agent what to do. Type in **Send instruction to agent...** and press Enter, or click the send button. You see "Instruction sent to agent".

The agent acts on it straight away. It treats your message as an instruction from a supervisor, and replies to the caller at once, following it. The caller hears that reply, never your instruction. For example:

* "Offer the caller a 10% discount on the renewal."
* "Ask for the order number before you look anything up."
* "Wrap up politely and end the call."

The instruction stays in the agent's memory for the rest of the call, so it keeps following it. In the transcript, your instruction shows as a **Moderator** line.

Write each instruction as something the agent should do now. Every instruction makes the agent speak, so send one at a time and let it finish its reply.

You can send instructions in a chat you observe as well.

## End a call

Click **Terminate call** while you listen, or on the call's card on the board, and confirm. The call ends at once and the caller is disconnected. The call gets the status **Terminated**.

For a chat, click **End conversation**.

## Take over a call

Taking over puts you on the call in the agent's place. The agent stops at once, and you talk to the caller with your microphone until the call ends.

> [!WARNING]
>
> Taking over can't be undone. Once you take over, the agent doesn't come back to this call: you finish the call yourself.

**1. Listen in first**

Open the call and click **Start live monitoring**.

**2. Click Take over**

Click **Take over**. The dialog **Take over this call?** reminds you that the agent leaves the call and can't be brought back, the caller hears you as soon as you connect, and your microphone is turned on.

**3. Confirm**

Click **Take over call**. Allow the microphone if your browser asks. You see "Checking microphone…", "Taking over…", "Connecting you to the caller…" and then "You are live with the caller".

**4. Talk to the caller**

The banner says "You have taken over this call. The AI agent has left." Speak normally.

**5. End the call**

When you're done, click **Terminate call**. While you hold the call, you can't leave it without ending it, so the caller is never left alone.

While you hold the call:

| Control | What it does |
| - | - |
| **Mute my microphone** / **Unmute my microphone** | Stops or restarts sending your voice. While muted, a warning reminds you the caller can't hear you. |
| **Change input device** | Picks another microphone. The **Microphone level** meter shows whether you're heard. |
| **Mute call audio** / **Unmute call audio** | Turns the caller's sound off and on for you. |

Afterwards, the call is flagged **Human took over** in the Conversation log.

### If takeover doesn't work

| Message | What to do |
| - | - |
| "Microphone access was blocked. ..." | Allow the microphone in your browser's address bar, then try again. |
| "No microphone was found. ..." | Connect a microphone and try again. |
| "Microphone access requires a secure (HTTPS) connection." | Open the app over HTTPS. |
| "... has already taken over this call." | Another member holds the call. A call can be taken over once only. |
| "This call has already ended." | Nothing to take over. |
| "This call is being transferred and cannot be taken over right now." | Wait for the transfer to finish. |
| "Takeover is only available for voice calls." | Chats can't be taken over. |
| "You don't have permission to take over calls." | Ask the owner for **Monitor (live)**. |
| "Takeover failed. The AI agent is still handling the call." | Nothing changed on the call. Try again. |

## How it works on a call

* **Listening** is silent. The caller and the agent carry on as before.
* **An instruction** reaches the agent between turns. The agent replies right away as if the caller had just spoken, following your instruction. If the agent is still starting up, the instruction is kept and applied on its first turn.
* **Ending a call** disconnects everyone at once.
* **Taking over** stops the agent at once, even in the middle of a sentence, including speech that callers normally can't interrupt. From then on the agent doesn't hear the caller, doesn't reply, and doesn't check in when the caller goes quiet. Instructions are no longer offered, because the agent has stood down.

## Good to know

* The board has no time limit: a call shows as long as it is in progress. The "live now" count on [Analytics](https://docs.tryhamsa.com/agents/monitor/analytics.md) only counts calls that started in the last 10 minutes, so the two can differ.
* A call's reply time, analysis and outcome fill in after it ends, not while you listen.

## Related

> [card] [Call details](https://docs.tryhamsa.com/agents/monitor/call-details.md)
>
> Transcript, recording and analysis once the call ends.

> [card] [Conversation log](https://docs.tryhamsa.com/agents/monitor/conversation-log.md)
>
> Find calls, including ones a member took over.

> [card] [Transfer call step](https://docs.tryhamsa.com/agents/flow/steps/transfer-call.md)
>
> Let a flow agent hand calls to a person on its own.

> [card] [Roles and permissions](https://docs.tryhamsa.com/overview/projects/roles-and-permissions.md)
>
> Who can listen in and take over.


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