Phone Numbers

A phone number is what people dial to reach your AI. Once you buy one and connect it to an agent, calls to that number ring your AI receptionist instead of a human.

You can also use the number for outbound calls — your AI calls people from it.

The 30-second version

1. Buy a number (₹250/month for India)
2. Connect it to an agent ("when someone calls this number, Priya answers")
3. Done. Calls to that number now go to your AI.

Two kinds of calls

You can do both with the same number.

Discover your phone numbers via the SDK

If you're scripting outbound calls and don't want to copy IDs from the dashboard URL bar, use the SDK (v0.4.0+):

import { Osmtalk } from "@osmapi/osmtalk-sdk";

const client = new Osmtalk({ apiKey: process.env.OSMTALK_API_KEY! });

for (const n of await client.phoneNumbers.list()) {
  console.log(`${n.id}  ${n.phoneNumber}  outbound→${n.outboundAgentId ?? "—"}`);
}

// Re-assign which agent handles inbound calls on a number
await client.phoneNumbers.update("pn_xxx", { inboundAgentId: "agent_yyy" });

The client.phoneNumbers resource exists for users who want to manage numbers programmatically alongside the dashboard. See the SDK examples repo for full snippets.

Buy a number

1. Go to Phone Numbers in the sidebar
2. Click + Buy Number
3. Pick a country (India, US, etc.)
4. Filter by area code or type (toll-free, local, mobile)
5. Pick from the list — each shows its monthly price
6. Click Buy

You're charged the first month's rental immediately (₹250 for India). You can release the number at any time and stop paying further months.

Full guide: Buying numbers.

Already have a number with Plivo / Twilio? Skip the buying step — see Import numbers.

Connect a number to an agent

1. On the Phone Numbers page, find your number in the table
2. Click Edit
3. Pick an agent under Inbound agent (handles incoming calls)
4. Optionally pick an Outbound agent (used when your code makes outbound calls)
5. Click Save

Test by calling the number from your own phone. Your AI should answer in 1-2 rings.

What your dashboard shows

The Phone Numbers table:

Footer shows your total monthly recurring spend.

How much does it actually cost?

For a typical India number:

So a 2-minute inbound call costs:

Phone line (inbound): 2 × ₹0.67 = ₹1.34
AI agent cost (LLM+STT+TTS):   ~₹4.00
Total:                         ~₹5.34

See Pricing for every provider's rate.

What happens if you run out of credits

If your balance drops too low to cover the next monthly rental:

1. Day 0: Renewal fails (couldn't deduct ₹250). We email you, the number stays active.
2. Day 1-7: Grace period. You can top up; we'll retry automatically.
3. Day 8: If still unpaid, the number is released back to the carrier. You lose it forever.

To avoid this: keep at least ₹500 in your balance, or set up auto-recharge in Settings → Billing.

Common questions

"Why ₹250/month? Other providers are cheaper." Plivo charges us ₹235/mo. We add a 6% margin (₹15) for support, SIP trunk management, and renewal handling. That's it — no hidden fees.

"Can I get a vanity / specific number?" For India, no — numbers are randomly allocated. For US toll-free, yes (premium pricing).

"Can the same number do inbound + outbound?" Yes — set both Inbound agent and Outbound agent in the Edit dialog.

"What countries are supported?" India is the primary market. Limited support for US, UK, Singapore via Plivo. Contact support for others.

"Can I keep my existing business number?" Sometimes (called "porting"). Email support with your current number and provider — we'll see if it can be ported.

What's next

• Buying numbers — full purchase walkthrough
• Importing existing numbers — bring your own Plivo number
• Outbound calls — make calls from your number
• Campaigns — bulk outbound dialing