Best way seriesNovember 16, 2026
The best way to have an AI agent make a phone call
Use voice/call: your agent sends a number and a goal, caps the minutes, then polls result for the outcome, transcript and summary. 20¢ per connected minute.
Have your agent place the call with voice/call, then poll the free result tool for the outcome, a transcript and a summary. You give it a phone number and a one-sentence goal, Vaaya dials from its own number, and an AI caller works that goal with whoever answers. The price is 20¢ per connected minute, and a call that never connects costs nothing.
What "best" means for a phone call
- A record you can check. You were not on the line, so you need the words that were said as well as a verdict.
- A cost fixed before the phone rings. A cap in minutes, a price per minute, and nothing owed when nobody answers.
- A caller that behaves. It says it is an AI and ends the call when asked.
- Reach. The number has to be one the service will dial.
The options in the catalog
Prices are as listed on 16 November 2026. The catalog has current prices.
| Tool | What it returns | Price per call | When to pick it |
|---|---|---|---|
voice/call |
A job_id at once, then the outcome, transcript, summary and duration |
20¢ per connected minute. Holds max_minutes × 20¢, charges whole minutes used, 0¢ if the call never connects |
The call itself. It is the one catalog action that places a voice call |
vaaya/result |
Job status, then the result and charged_cents |
Free | Every check on a call in progress |
openwebninja/yelp-search |
Local businesses with phone, address and a business_id |
1¢ | You need the number |
openwebninja/yelp-business |
Hours, phone and website for a business_id |
1¢ | You want the opening hours before dialing |
mailbox/send |
One email from your own connected mailbox | 1¢ | The number is outside the supported regions |
The default path
Start with one voice/call and a low max_minutes. The default cap is 5 minutes and the maximum is 10. For a single question, set 2 or 3, which shrinks the hold and the worst case.
Write the goal as one outcome. Put the facts the caller may use in context, along with anything it must refuse. Set on_behalf_of so the opening sentence names you.
Step up when the job needs it:
- Raise
max_minutestoward 10 for a booking with some back and forth. - Add
language: "hi"for a call in Hindi. Without it, Hindi replies are misheard as English. - Spend 1¢ on a lookup when you lack the number or the opening hours.
When a destination is not supported, Vaaya's guidance to agents is to say so plainly and offer email instead. For an approval step before the agent dials, see how to prepare agent email and phone outreach.
One call, priced
Arithmetic at listed prices on 16 November 2026, for a dinner booking with a 3-minute cap.
{
"service": "voice",
"action": "call",
"params": {
"to": "+14155550123",
"goal": "Ask if there is a table for two at 8pm tonight and book it under the name Priya.",
"context": "Any time from 7:30pm to 9pm works. Do not agree to a deposit.",
"on_behalf_of": "Priya",
"max_minutes": 3
},
"max_cost_cents": 60
}
- The hold is 3 × 20¢ = 60¢, taken when the job is queued. Your balance and
max_cost_centsboth have to cover it, so a ceiling under 60 refuses the call before anything is dialed. - If the call connects and runs 100 seconds, the charge is 2 minutes × 20¢ = 40¢ and 20¢ returns to your balance. Connected time is rounded up to whole minutes.
- If nobody answers or the line is busy, the charge is 0¢ and the hold is released.
- If it reaches voicemail, the caller leaves one short message, which counts as connected: 20¢ for a message under a minute.
- Looking up the number and hours first with the two Yelp actions adds 2¢. Polling
resultis free.
The most this plan can cost is 62¢.
How to run it
Connect your agent with the install guide, then ask in plain English:
Use Vaaya to call +14155550123 for me (Priya). Ask for a table for two at 8pm tonight; any time from 7:30 to 9 works. Do not agree to a deposit or give card details. Cap the call at 3 minutes. When it ends, tell me the outcome and show me the transcript.
The agent can ask Vaaya's consult tool to plan this. consult returns the exact call, and every use call carries a max_cost_cents ceiling. voice/call answers at once with a job_id, and Vaaya dials within about a minute. From then on the agent polls result with that id. It must never send voice/call again to check progress, because that places a second phone call.
Consent and conduct
The service enforces these on every call:
- It opens with a sentence saying it is an AI assistant, naming who it is calling for when
on_behalf_ofis set. A customfirst_messageis added after that sentence and cannot replace it. - The caller does not ask for or accept full card numbers, one-time passcodes, government ID numbers or passwords.
- If the person asks not to be called, it apologizes once, says they will not be called again and ends the call.
The rest is your judgment. Vaaya's guidance to agents says not to place bulk unsolicited marketing calls (it names TCPA and DND exposure), to respect the called party's time zone, and to prefer business numbers over personal ones for a cold ask. In practice: call a business during its opening hours, and do not call a person who has not agreed to be called. Calling rules differ by place, so check yours.
voice/call keeps no do-not-call list for you. When the caller promises not to ring again, record the number and keep the promise.
What to check, and where this falls short
Read outcome first: reached, voicemail, no_answer or not_connected. reached means the call connected. It does not mean the goal was met, so read the summary and then the transcript. The caller is told to repeat back any number, date or name it hears, which makes those easy to verify. Check charged_cents against your cap. If a charge looks wrong, raise a dispute from Transactions in your account and a person at Vaaya reviews it.
The limits:
- Destinations. US and Canada numbers and Indian mobile numbers only, in E.164 format such as
+14155550123. Premium-rate and one-ring-scam prefixes are blocked. Anything else is refused before dialing, at no charge. - Length and volume. 10 minutes per call, 2 calls in flight and 30 reserved minutes per account in a rolling 24 hours. Reserved minutes count, so six calls at the default cap use the allowance.
- Language. English, or Hindi with
language: "hi". - Out of scope. Inbound numbers and IVR, SMS and conference calls. The caller's only tool is ending the call, so it cannot press keys in a phone menu. A booking that needs a card to hold it comes back unfinished.
- Callbacks. Vaaya dials from its own number, so put yours in
contextif the business may need to ring back.
Why this suits a pay-per-call wallet
Calls like these come one at a time: a booking tonight, a stock check next month. You pay 20¢ for each connected minute and nothing in between, and you need no telephony account or phone number of your own. The spend is bounded by max_minutes on the call, max_cost_cents on the request and a daily limit on the agent's key, which you can restrict to the Outbound category in spending controls. Pack sizes are on the pricing page.
Questions
How much does an AI phone call cost through Vaaya?
20¢ per connected minute, as listed on 16 November 2026. The call holds max_minutes times 20¢ up front, charges only the whole minutes that were connected, and charges nothing if the call never connects.
Which numbers can the agent call?
US and Canada numbers and Indian mobile numbers, written in E.164 format such as +14155550123. Premium-rate and one-ring-scam prefixes are blocked. Any other destination is refused before dialing and is not charged.
Does the caller say it is an AI?
Yes. Every call opens with a sentence saying it is an AI assistant, and it names who it is calling for when on_behalf_of is set. A custom first_message is added after that sentence and cannot replace it.
How does the agent find out what happened on the call?
voice/call returns a job_id straight away. The agent polls the free result tool with that id until it gets the outcome, transcript and summary. It should never run voice/call again to check, because that places a second phone call.