Skip to main content

voice

present_status​

Check what is on the shared screen

Effects: read

Ask what the room is ACTUALLY seeing on the screen-share right now. Returns presenting plus the page_id, url and title read live from the shared tab. Use it before telling participants what is on screen, and whenever you are not certain the share still points at the tab you meant — pressing keys or scrolling does NOT change which tab is shared, only present_tab does.

Arguments​

No arguments.

present_tab​

Share a browser tab on the call

Effects: external_api

Put one of the agent's browser tabs on the live call's screen-share. Pass the page_id you got from browser.open. Only usable while the agent is in an active voice call. THIS IS THE ONLY WAY TO CHANGE WHAT THE ROOM SEES — scrolling or pressing keys changes the page, never which tab is shared. The shared tab stays the active share until you call present_tab with a different page_id, close the tab via browser.close, or the call ends. Returns the page_id, url and title actually on screen; check them before telling anyone what they are looking at, and use present_status to re-check later.

Arguments​

ArgumentTypeRequiredDescription
page_idstringyespage_id returned by browser.open for the tab you want to share. Must be a tab still open in the agent's browser context. (max 128.0)