Calls
Transfer a live call to a human
Transfers an active in-progress call to a human phone number via Plivo. The bot announces the transfer, then Plivo bridges the caller directly to the destination number. The call’s session.completed webhook will include transfer metadata when the full call ends.
If to is omitted, the agent’s configured transferNumber is used. The agent must have transferEnabled: true.
POST
Transfer a live call to a human
Documentation Index
Fetch the complete documentation index at: https://docs.vocobase.com/llms.txt
Use this file to discover all available pages before exploring further.
Authorizations
API key in format: rg_live_xxxx. Pass as a Bearer token in the Authorization header.
Path Parameters
The call ID.
Body
application/json
E.164 phone number to transfer to. If omitted, the agent's configured transferNumber is used.
Example:
"+919876543210"
Previous
Start a browser WebRTC sessionCreates a browser voice session and returns a room URL plus a one-time access token your browser uses to connect to the agent in real time.
The session is fully tracked on the platform — when the session ends, the same `session.completed` partner webhook fires (transcript, recording_url, extraction). The webhook payload's `call` field is omitted for these sessions because there is no associated phone call. See [Web Voice Testing](/web-voice-testing) for end-to-end browser integration code.
**Auth + limits:** Bearer API key (`rg_live_*`). Bound by the API key's concurrency limit. Rate-limited to 10 starts/minute per key.
Next
Transfer a live call to a human