Live view

Live view lets you see the bot screen in real time while it runs a process, directly from the Zoan Cloud portal. It’s like looking at the monitor of the machine where the automation runs, without having to connect to it.

It’s especially useful for unattended processes, which run on a server with no one in front of you: with the live view you confirm that the bot is doing the right thing, diagnose where it’s stuck when something goes wrong, and demonstrate to a client or your team what’s happening — all without interrupting execution.

What exactly does it show?

Shows the bot session desktop: the same isolated screen where the robot opens applications and moves the mouse, which creates the robot session in unattended runs. You see what an operator sitting in front of that machine would see.

Requisitos

Live view is not available to everyone by default; requires two conditions:

Requisito	Detalle
Plan with function	Feature execution.live-view comes on the Pro plan (not the Free/Starter plans).
Permiso del rol	Your user needs the View live screen (execution:view-screen) permission. See Users and roles.

If you don’t do both, the live view button does not appear.

How to open it

1. Enter the environment and open the Executions tab.
2. Opens a run that is in progress (state running). Live view only works while the bot is running; When finished, it closes by itself.
3. Click See live bot screen.
4. The Live View panel opens with the stream. Close it whenever you want; The execution continues.

The panel displays a Live badge while receiving image, the resolution and frames per second (default 1280×720 · 20 FPS) and a counter for frames received.

How it works

You don’t need to install anything extra: Agent already comes with the capture component.

flowchart LR
  B["Pantalla del bot<br/>(sesión de robot)"] --> A["Agent<br/>captura y comprime"]
  A -->|frames JPEG| N["Zoan Cloud<br/>/ws/live-view"]
  N -->|tiempo real| P["Tu navegador<br/>(portal)"]

While the execution is running, the Agent captures the monitor of the bot session, compresses it as a sequence of JPEG images and sends them to Zoan Cloud, which retransmits them to your browser over a real-time connection. It’s a read-only stream: you see the screen, but you don’t control the bot’s mouse or keyboard.

It is efficient, but designed to observe

The stream is optimized (reduced resolution and compression), so the impact on performance is low. Even so, it is designed to observe punctually —verify a process, diagnose a failure—, not to leave it permanently open on dozens of bots at the same time.

Si no ves imagen

Situation	Causa probable
The button does not appear	Your plan doesn’t include the feature or your role doesn’t have execution:view-screen permission.
”Agent offline”	The Agent lost connection to Zoan Cloud; check Agent Monitoring.
The panel closes by itself	The execution terminated (completed/failed). Live view only exists while running is present.

Next steps

• Execution Logs — the detailed log of what the bot did, step by step.
• States and life cycle — what each state of a run means.
• Robot Sessions — the Windows session whose desktop you see in the stream.