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 (about $1.22/month for a US local number)
2. Connect it to an agent ("when someone calls this number, Sarah 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 { LetusTalk } from "@letustalkai/sdk";

const client = new LetusTalk({ apiKey: process.env.LETUSTALK_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 (US, etc.)
4. Filter by area code or type (toll-free, local)
5. Pick from the list — each shows its monthly price
6. Click Buy

You're charged a one-time $0.50 setup fee plus the first month's rental immediately (about $1.22 for a US local number). You can release the number at any time and stop paying further months.

Full guide: Buying numbers.

Already have a number with 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 US local number:

So a 2-minute inbound call costs:

Phone line (inbound): 2 × $0.005 = ~$0.01
AI agent cost (LLM+STT+TTS):   ~$0.04
Total:                         ~$0.05

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 the ~$1.22 rental). 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 $5 in your balance, or set up auto-recharge in Settings → Billing.

Common questions

"Why ~$1.22/month? Other providers are cheaper." Twilio charges us $1.15/mo for a US local number. We add a 6% margin ($0.07) for support, SIP trunk management, and renewal handling. That's it — no hidden fees.

"Can I get a vanity / specific number?" For US local numbers you can filter by area code. For US toll-free vanity numbers, 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?" The US is the primary market (US local and toll-free numbers via Twilio). 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 Twilio number
• Outbound calls — make calls from your number
• Campaigns — bulk outbound dialing