# The best way to have an AI agent make a phone call

_By Apoorv Khanna, November 16, 2026_

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](/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_minutes` toward 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](/blog/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.

```json
{
  "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_cents` both 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 `result` is free.

The most this plan can cost is 62¢.

## How to run it

Connect your agent with the [install guide](/install), 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_of` is set. A custom `first_message` is 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 `context` if 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](/spending-controls). Pack sizes are on the [pricing page](/pricing).

## 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.
