Call a lead now
Ring a lead the moment they enquire. The agent calls from the Twilio number attached to it, usually within a few seconds of this request, so a lead form, a CRM or an automation tool can hand every new lead straight to the agent.
Each agent keeps one standing campaign named Instant leads, visible on the Outbound page, and every lead is a recipient in it. The do-not-call list, the 09:00 to 20:00 Riyadh calling window, answering-machine hang-up and retries all apply: a lead outside the window is called when it opens, and one who does not answer is tried twice more, 15 minutes apart. Sending the same number again while a call to it is under way does not place a second call.
Billed per connected minute at the live call rate, like any call Voho holds.
Authorizations
API token from the Voho console. Begins with voho_sk_live_.
Path Parameters
The agent's ID, from /v1/agents.
Body
The lead's phone number, in international format.
"+966512345678"
The lead's name. Also available to the agent as {{name}}.
"سارة"
What the lead asked about, filled into the agent's instructions and greeting as {{unit}} and the like, so it opens knowing why it is calling. Up to 10 keys, letters, digits and underscores.
Call from this number instead of the agent's own. Must be a Twilio number on your account.
"+966112345678"
Response
The lead was accepted.
calling: the phone is ringing now. queued: it will be called at the next opportunity, see reason. skipped: it will not be called, see reason.
calling, queued, skipped The agent's Instant leads campaign.
Why the lead was queued or skipped.
From receiving the request to placing the call, when status is calling.

