POST /api/v1/voice/calls/{callId}/browser-monitor attaches a supervisor’s browser listener to the active salesperson audio leg of a Trackly-managed call. This route does not dial a supervisor telephone number. It supports listening only: there is no microphone transmission, coaching, DTMF, or conference-role change. The listener cannot remain on the recipient’s audio after the salesperson or call ends. For a phone supervisor, use Monitor a Call.
Requires voice_calls.write, the Voice Calls product entitlement, and an API key created by a current account owner. Your authenticated backend must also authorize the supervisor and derive their externalSubject; the browser’s target call ID is not authorization. The target must be an established managed call with one active browser agent leg.
Sequence
- Create or reuse a WebRTC agent for the authenticated supervisor under the issuing API key.
- Create a browser session with
POST /browser-sessions,{externalSubject, purpose: "monitor", targetCallId: callId}, and a stableIdempotency-Key. The response includes{session, transport};session.purposeismonitor,session.targetCallIdis the primary call ID, andsession.receiveIncomingisfalse. The session is bound to that call’s active agent leg. - Connect a separate SDK helper configured with
monitorCallId: callId. ItscreateSessioncallback performs step 2;connect()prepares receive-only playback without requesting microphone access. - Start one listener attempt with
startMonitoring({idempotencyKey}). ItscreateMonitorCallcallback calls this route with the returnedsessionIdand the same target call ID. - Read the returned child with
GET /browser-calls/{id}.POST /browser-calls/{id}/hanguprequests listener-only cleanup and revokes its monitor session.DELETE /browser-sessions/{id}also revokes that session. Create a new session for another listening attempt.
202 accepts a durable listener attempt; it does not prove audio is attached. Read child state and use the SDK’s verified media status before showing listening as active. Reuse the same idempotency key and body after an uncertain response.
Path Parameters
Body Parameters
Active monitor-purpose browser session issued for this call and API key. No other fields are accepted.
Headers
Response Fields
The monitor child call. Its
id identifies only the listener, purpose is monitor, targetCallId is the primary call ID, and sessionId identifies the monitor session. state and revision describe the child lifecycle; agentSipCallId identifies the browser invitation. Use id to read or end only the listener.Location header points to /api/v1/voice/browser-calls/{call.id}.
Example
Error Codes
Browser listening requires a compatible deployed API, media service, SDK bundle, and account activation. Source support alone does not establish live availability for your account.