system
ra_call_control
A VICIdial API function that controls a call for a remote agent — one who takes calls on an outside phone instead of the browser softphone.
ra_call_control is an API (Application Programming Interface) function aimed at the Remote agent — an agent whose calls land on an outside phone number rather than the in-browser softphone. It lets an outside program move a remote agent's live call through a few set stages without the agent touching a screen.
It sits inside the broader Agent API, but it is purpose-built for the phone-only case. When a call from an Ingroup or an outbound campaign reaches a remote agent, ra_call_control can connect them to the caller, step the call to a transfer stage, or hang it up. That makes it handy for mobile apps that give a phone-based agent the buttons a browser agent would normally see.
One real limit to plan around: the function only supports a small number of fixed stages for a remote agent. A simple Warm transfer or a clean hangup fits inside those stages, but anything richer — a true three-way add, a closer hand-off with custom prompts — falls outside what ra_call_control alone can do, and you end up scripting the rest through deeper Asterisk Manager calls.
In practice you pair it with the rest of the Agent API so the same outside tool can pause the agent, set a disposition, and control the call from one place. It is also the cleanest way to keep a phone-only Agent session in step with what the dialer thinks is happening. Like every API call, send credentials server-side and never let the raw URL reach a browser, or someone could hijack a live call.
Related terms
Agent API
A set of VICIdial URL commands that control an agent's session from outside the screen, letting you pause, dial, hang up, or set a disposition programmatically.
Agent session
The stretch of time from when an agent logs in to when they log out, during which VICIdial tracks every call, pause, and status change they make.
Ingroup
An inbound group in VICIdial that routes incoming calls to a pool of agents, the inbound counterpart to an outbound campaign.
Non-agent API
The non-agent API is a VICIdial web interface that lets outside systems read data and trigger actions, like adding leads or pulling stats, without an agent logged in.
Remote agent
An agent who logs into VICIdial from outside the office — usually from home — connecting their phone and screen over the internet.
Warm transfer
A transfer where the agent stays on the line to introduce the customer to the next person before handing the call over and dropping off.