Phone numbers
Get a number your customers ring, or point one you already own at your agent.
Your agent answers on a phone number. You can get one from us — searched, bought and ready on the same screen — or use a number you already own.
Numbers belong to the workspace, not to one agent. They live on the Phone Numbers page in the main sidebar, which lists every number you hold, where it came from, and two things for each: the Inbound agent, which answers it, and the Outbound agent, which calls out on it. They can be the same agent or different ones, or either can be empty — see Inbound and outbound. A Dial-out ready column says whether the number can place calls as well as answer them. You can search the list and move any number to another agent.
Note
You do not need a number to try voice. The website call button works without one, on any plan, and it is the same agent with the same voice. A number is what lets somebody ring you from a phone — and if you already own one, you can point it at your agent on any plan, free included.
Note
Which numbers you can buy from us depends on where your workspace is billed. A workspace billed in India buys Indian numbers; a workspace billed anywhere else buys United States local numbers (see United States numbers). Either can bring a number it already owns from any country. See Where you are billed.
Country codes
Every phone number carries its country code — the +44, +1, +971 or +91
at the front.
- In the console, wherever you type or upload numbers (importing a number,
adding or importing contacts, the do-not-contact list, a calling campaign's
list, sending a WhatsApp message, a test call), a country list with flags sits
beside the box. It starts on your workspace's country and you can change it.
A number you type without a code takes the country picked there; a number
that already starts with
+or00keeps its own. - Through the API, send every number with its country code, like
+44 7700 900123or+91 98765 43210. Spaces and dashes are fine, and full international digits without the+(447700900123) work too. A number without its country code is refused with a message saying how to write it; nothing is assumed to be Indian or anywhere else.
Getting a number from us
1. Open Phone Numbers
In the main sidebar choose Phone Numbers, then Buy / Import number.
2. Search
Pick a city (India) or a state (United States) if you want a local code, or type an area code. You will see the numbers available now, each with what it costs a month.
3. Take one
Choose a number. Before anything is charged you get a summary — the number, what it costs a month, what leaves your wallet today and what is left in it — and the number is yours the moment you confirm. There is nothing to configure with a phone company and no settings to copy anywhere.
4. Say which agent answers it
A new number is not pointed anywhere yet. On the Phone Numbers page, choose the agent under Inbound. That agent starts answering immediately.
5. Ring it
Call the number. You should hear your greeting, then the agent.
What it costs
Each number has a monthly price, shown before you take it, and it repeats every month until you give the number up. The price is the same on every plan.
Buying a number needs a paid plan, because we rent it for you every month.
Pay as you go has no monthly fee of its own and can hold numbers. Through the API,
send an Idempotency-Key on Rent Phone
Number: a retry returns the first
answer instead of renting a second number.
Pointing a number you already own at your agent works on every plan, including the free one. It costs us nothing to answer it — you are already paying your own provider for the number — and a phone call is usually the thing you want to hear before you decide to pay for anything. Free-plan calls come out of the same trial minutes as calls from your website.
That covers calls in both directions. On the free plan your agent can answer a number you brought and, once you have added that account's credentials, ring people from it — your own provider bills you for the line either way. Buying a number from us is the part that needs a paid plan.
United States numbers
A workspace billed outside India buys United States local numbers: ordinary numbers with a US area code, which your customers ring like any other. Toll-free numbers are not offered yet; if you need one, tell us.
- Search by state or area code. Pick a state from the list, or type a
three-digit area code such as
415. A leading1is ignored, so1415finds the same numbers. - Nothing to verify. No business documents are needed. The number is yours the moment you confirm.
- They call the United States and Canada only. A call from one of these
numbers can go to any US or Canadian number (
+1), including US toll-free numbers. It cannot go anywhere else, and that includes the parts of the+1code outside the US and Canada: Puerto Rico, the US Virgin Islands, Guam and the other US territories, and the Caribbean countries that dial+1(Jamaica, the Dominican Republic, the Bahamas and the rest).
What happens when a call would go further:
| What | What happens |
|---|---|
| A campaign, a test call or the call API rings a number outside the US and Canada | That call is not placed. In a campaign only that person fails, with "We cannot call that country from your calling number", and the rest go ahead |
| Your agent tries to put a caller through to a person outside the US and Canada | The transfer is not made and the caller stays with your agent |
| You set a forward to a number outside the US and Canada | The forward is not saved: "US numbers can call US and Canada numbers only." |
The Buy list says this too, under the numbers. A number you bring from your own carrier account is not limited this way: your carrier decides where it can call.
India needs your business verified first
An Indian number is only issued to a registered business, and the check is in your name rather than ours. It has its own tab — KYC, beside Imported on the Phone Numbers page — because it takes a little time to clear and it is worth being able to come back and see where it got to.
This is not our rule and we cannot shortcut it. Numbers in most other countries need nothing beyond choosing one.
Note
This is not the same as business verification for WhatsApp, which Meta runs and which unlocks a different set of things. Passing one does nothing for the other, and you may well need both.
What it asks for
Your registered business name, and one document. Which one depends on a single question:
| Registered for GST? | The document to send |
|---|---|
| Yes | Your GST certificate |
| No | Your Certificate of Incorporation, or your Udyam certificate — whichever you hold |
That is the whole form. PDF, JPG or PNG, up to 5 MB.
Note
Send it as registered. The name you type is checked against the certificate you attach, so an abbreviation or a trading name is the usual reason an application comes back.
Following it up
The KYC tab shows where the application stands, asked afresh each time you open the page rather than remembered from last time:
- Being checked — sent, usually decided within minutes.
- Approved — you can take an Indian number.
- Not accepted — the reason is shown with it. Correct and resend puts the form back up.
- Suspended or Expired — send your documents again.
Each application has a reference. If you ask us to chase one, that is the thing to quote.
Note
We keep a copy of the document you sent, so correcting an application does not mean going and finding the file again. You can download it from the same tab; that needs an owner or admin.
Warning
You cannot buy an Indian number until this is approved — pressing Buy takes you to the form instead. Numbers in every other country need none of it.
Doing it from the API
If you run a platform with one workspace per customer, each customer's business
is verified in its own workspace — the application belongs to the workspace,
not to you. Send the customer's details with the X-Workspace header
(see Build a platform) and the same form the console
shows is filled in for them.
For each business you need three things: its legal name, whether it is registered for GST (yes or no), and one document — the GST certificate if it is, otherwise the Certificate of Incorporation or the Udyam certificate. PDF, JPG or PNG, up to 5 MB, with a file name of 99 characters or fewer.
curl -X PUT https://app.katexs.com/api/v1/phone-numbers/business-details \
-H "Authorization: Bearer $API_KEY" \
-H "X-Workspace: org_3f6a9c21-7d4e-4b58-9a1f-0c2e8b7d5a34" \
-F businessName="Acme Traders Private Limited" \
-F gstRegistered=true \
-F [email protected]
Without GST, send -F gstRegistered=false and the certificate you hold, adding
-F documentKind=udyam if it is a Udyam certificate (incorporation is
assumed). The answer is the application, and the status in it is the same set the
KYC tab shows:
{
"status": "submitted",
"businessName": "Acme Traders Private Limited",
"gstRegistered": true,
"documentKind": "gst",
"submittedAt": "2026-10-08T09:41:12.380Z",
"canRent": false
}
Get Business Details reads it
back at any time, and checks it afresh each time. The check usually finishes in a
few minutes; when canRent turns true, Rent
Phone Number will issue an Indian
number. If the application comes back rejected, reviewNote says what to
correct, and sending again corrects that same application. Sending while one is
being checked, or after it was approved, is refused with 409.
This needs a full key and a paid plan: the document goes to India's numbering authority in your customer's name, so a build or read-only key cannot send it (any key can read it). We never return the document itself.
Marketing calls need a different number
Indian rules give every number a purpose, and it is worth knowing before you buy one rather than after you build a campaign.
| What you are calling about | The number for it |
|---|---|
| Reminders, order updates, renewals, anything the customer is expecting | The numbers on this page — landlines, bought in a few clicks |
| Marketing — an offer, a promotion, anything selling | A 140 number, which is applied for in your business's name |
A 140 number is not sold from a list. It is issued to your business after you register on the DLT portal, so choosing Promotional (140) when adding a number shows you the steps rather than a search.
1. Register your business on the DLT portal
As both the principal entity and the telemarketer — the calls are yours, so the registration is yours. Two to three working days.
2. Send us your certificates
Your GST certificate and both DLT registrations. We apply for the number and hand you back the approval letter it needs.
3. Register your header and your script
On the same portal. Scripts are approved one at a time — a marketing call says an approved thing, not whatever you type on the day.
Five to ten working days end to end. Get in touch and we will start it.
Warning
Check this before anything else: the telemarketer registration has to be in Maharashtra or Karnataka. Registered anywhere else and we cannot get you a 140 number today.
Note
Until you hold one, a campaign marked promotional is refused rather than quietly sent from a landline. That refusal is the rule working — it is the number that carries the penalty, not us — and it names the number it is about so you know which one to change.
Using a number you already own
If your number is with Plivo, Vobiz, Twilio or Telnyx, you can point it at your agent and keep it where it is. You go on paying them for the number and we charge you nothing for it — we only answer it. Twilio and Telnyx work a little differently — we set the number up for you; see Numbers from Twilio and Numbers from Telnyx below. The steps here are for Plivo and Vobiz.
Note
A Plivo, Twilio or Telnyx number needs your account's credentials before it can answer. Plivo and Twilio sign every call with your Auth Token, and we use it to confirm each call really came from your account — without it, calls to the number are refused. On Telnyx your API key is how we set the number up at all. A Vobiz number answers without them; there, the credentials are only needed for outgoing calls.
1. Open Buy / Import number on the Phone Numbers page
Choose Import, then say which carrier the number is with.
2. Plivo only: add your account's keys first
Paste the Auth ID and Auth Token from your Plivo console. Plivo signs every call with your Auth Token, and that signature is how we tell a real call to your number from somebody pretending to be one — so until we have it, calls to the number are refused. The same keys are what your outgoing calls go out on. (Vobiz needs nothing here to answer calls.)
3. Type the number
Exactly as it is dialled, including the country code.
4. Point it at us
Set the address shown as the number's Answer URL in your carrier's console, with the method set to POST. Copy the whole thing — everything after the question mark matters, and a shortened address will not be recognised.
For one of the two carriers the address is the same for every number and is shown straight away, so you can set your console up first if you prefer. For the other it carries a key unique to the number, so it appears once the number is added. Either way that address belongs to the number, so it keeps working if you later move the number to a different agent.
5. Say which agent answers it
Back on the Phone Numbers page, choose the agent under Inbound.
Warning
A Plivo number does not answer until its keys are saved. If you added one before the keys were asked for, its row on the Phone Numbers page says so — open the row's menu, choose Edit credentials, and save them.
Warning
Until the Answer URL is set, the number rings and nothing picks up. Nothing on this page can tell you that has happened, because the call never reaches us — so if a test call goes unanswered, check the Answer URL first.
A number on any other carrier cannot be pointed at us. We check that each call genuinely came from the carrier it claims to, and a call from anywhere else is refused before it is answered.
Numbers from Twilio
A Twilio number is set up the other way round from the two above. Instead of you pasting an address into your carrier's console, you give us your Twilio account and we set the number up for you.
1. Choose Twilio under Import
The credentials box comes first, because Twilio is the one carrier where it is needed before the number.
2. Add your Account SID and Auth Token
Both are on your Twilio console's home page. The Account SID starts with AC. We check them with Twilio before saving, and the token is stored encrypted and never shown again.
3. Type the number, with its country code
For example +1 415 555 0100. A number typed without a country code is read as an Indian one, and we will then not find it on your account.
4. That is it
We confirm the number is on your Twilio account and point it at us there. The dialog still shows the two addresses we set, in case you ever want to check them or set them yourself.
5. Say which agent answers it
On the Phone Numbers page, choose the agent under Inbound.
Warning
Pointing a Twilio number at us replaces whatever it was set to. If the number already runs something of yours — an IVR, a forwarding rule — that stops receiving its calls. If it had an address set, the dialog tells you what it was so you can put it back, and removing the number here clears the address we set and does not restore the old one. Import a number that is free to use.
Note
We need your Auth Token because Twilio signs every call with it, and that signature is how we tell a real call to your number from somebody pretending to be one. If you change your Auth Token in Twilio, save the new one from the number's menu (Edit credentials) — until you do, calls to the number are refused and we tell you so.
Note
A workspace works with one Twilio account. If you save a different Account SID while Twilio numbers from the first account are still added here, we refuse it — those numbers would stop receiving calls. Remove the Twilio numbers first, then connect the other account. Saving a new Auth Token for the same account is always fine.
Note
If we could not set the number up for you — your Twilio account may have restricted it — the dialog says so and shows what to set: in Twilio, open the number and set A call comes in to the Voice URL and Call status changes to the status callback, both HTTP POST.
What a Twilio number does not do yet: answering-machine detection (so no voicemail message) and transferring a call to a person. Call recording works on it — see Recording calls on a number you brought.
Numbers from Telnyx
A Telnyx number is set up for you too, and it takes one API key rather than an ID and a token.
1. Choose Telnyx under Import
The key comes first, for the same reason as on Twilio: we need it before we can find the number and set it up.
2. Paste an API key from your Telnyx portal
Create one under API Keys in the Telnyx portal. We check it with Telnyx before saving, and it is stored encrypted and never shown again. Saving it creates an application on your Telnyx account called Katexs voice agent — that is what answers your number and places your outgoing calls, so leave it in place.
3. Type the number, with its country code
For example +1 415 555 0100. A number typed without a country code is read as an Indian one, and we will then not find it on your account.
4. That is it
We confirm the number is on your Telnyx account and assign it to that application. Nothing to paste.
5. Say which agent answers it
On the Phone Numbers page, choose the agent under Inbound.
Warning
Telnyx only calls the countries your account allows. A new Telnyx account allows the United States and Canada. To call India — or anywhere else — add the country to your outbound voice profile in the Telnyx portal (Voice → Outbound Voice Profiles) before you place calls; until then Telnyx refuses them, and the call shows as failed here. Telnyx may ask you to verify your account before it allows some countries.
Warning
Assigning a Telnyx number to our application replaces whatever it was connected to. If it was connected to something else of yours, the dialog tells you its name so you can move it back; removing the number here takes it off our application and does not restore the old one.
Note
A workspace works with one Telnyx account. A key from a different account is refused while numbers from the first are still added here — remove those numbers first. A new key for the same account is always fine, and if you had deleted our application in Telnyx, saving a key makes a new one and moves your numbers onto it.
Note
If we could not assign the number for you, the dialog says so. In the Telnyx portal, open the number and set its connection to the application called Katexs voice agent.
When we turn a call to a Telnyx number away — no agent set to answer it, or the workspace out of balance — the caller hears a busy tone rather than a sentence.
A Telnyx number does what a number from us does: it records, it detects answering machines (so a campaign can leave a voicemail), and it transfers a call to a person. Telnyx charges your Telnyx account a small fee for each call it checks for an answering machine, and the call to the person you transfer to goes on your Telnyx bill like any other call.
Recording calls on a number you brought
With Record calls on, phone calls on a number you brought are recorded too, whichever company it is with. Your carrier is not asked to record anything — your agent hears both sides of the call and keeps the recording here, so it plays with its call in Usage, downloads, and is deleted on your plan's schedule exactly like any other recording.
A transferred call on a number you brought
When your agent puts a caller through to a person on a number you brought, we stop charging at the moment of the transfer. From then on the two people talk on your carrier's line, on your carrier's bill, with no agent involved. (On a number you took from us the call is billed to its end, because we pay the carrier for those minutes.)
Calling out from a number you brought
Outgoing calls go out through the account the number belongs to — and for your own number, that account is yours, even if your carrier happens to be the same one we buy numbers from. So there is one more step, and only if you want outgoing calls: in the same Import panel, add the Auth ID and Auth token from your carrier's console. (For Plivo, Twilio and Telnyx you have already done this — it came first.)
We check them against your carrier before saving, so a wrong pair is refused while you are still looking at the page you copied it from rather than on a call weeks later. The token is stored encrypted and never shown again.
You can change them later without re-adding the number: the row's menu on the Phone Numbers page has Edit credentials. They belong to the carrier account rather than to one number, so saving applies to every number you brought from it.
The Dial-out ready column on that page says which of your numbers can already place calls and which are still waiting for their credentials — a number can answer perfectly while being unable to ring anybody, and that column is where you would see it.
Once they are saved, calling campaigns and the call API work from that number exactly as they do from one taken from us.
Note
Answering needs none of this. If the number only ever receives calls, the Answer URL above is the whole setup.
Note
A number can answer for one agent. Typing a number another agent already answers is refused rather than quietly moved — that is almost always a mistake. Moving one deliberately is a different act: choose the new agent under Inbound on the Phone Numbers page.
Whenever an agent is about to lose a number — moved to another agent, or set back to no agent at all — we ask first and name the agent losing it. Giving a number that nobody answers to an agent for the first time takes nothing from anybody, so that one just happens.
Note
Getting, moving, renaming, releasing and removing numbers need an owner or admin. Everyone else on the workspace sees the list and what each number is doing, which is usually what they came to check.
Note
An agent's Voice page shows which number that agent answers, and links here to change it. Getting a number and choosing who answers it both happen on this page, because a number belongs to the workspace rather than to one agent.
What you can do to a number
On the Phone Numbers page every row has a menu:
- Edit credentials — for a number you brought, the API credentials of the carrier account its outgoing calls go through. Saving applies to every number you brought from that account.
- Rename — a name for your own eyes, so a list of numbers reads as "Bengaluru showroom" rather than six strings ending in different digits. Callers never see it.
- Forward calls — send every call to this number to another phone, with the agent not answering at all. See Forwarding a whole line.
- Move to another workspace… — only for developers building on the customers API: hand the number to one of your customers, or back to your own workspace, keeping its digits. See Moving a number to another workspace.
- Release — only on a number you rent from us. See below; it is permanent.
- Remove — only on a number you brought. We forget it; you keep it. For a Twilio number we also clear the address we set on it, and a Telnyx number is taken off our application, so it stops ringing at us — but only if it still points at us, so anything you have since pointed it at yourself is left alone.
You can also search the list, filter it by where the numbers came from, and
Forwarding a whole line
A number can send every call straight to another phone — your front desk, your mobile — without the agent answering. It is meant as a fallback: if an agent is not working, or the number has no agent at all, point it at a person so the number never goes quiet, then clear the forward and the agent answers again.
- It rings for 30 seconds. If nobody picks up, the caller of a number from us, Plivo or Twilio hears that nobody could take the call, and the line ends. On a number brought from Telnyx the caller gets no spoken message: the line rings out or returns busy, then ends.
- A forwarded call has a time limit. On a number you took from us it ends when your balance can no longer pay for it, and never later than 20 minutes, the longest any call can run. On a number you brought it ends after 30 minutes.
- Who the phone shows as calling. On a number from Twilio or Telnyx, the original caller's number. On a number from us or from Plivo, your own number — those lines may only present a number on the account.
- It works whether or not an agent answers the number. If an agent does, the forward replaces it. If none does — no agent attached, the agent deleted, or its Answer calls switched off — the forward answers the call itself. Your plan, your call lines and your balance are checked first, as for any call, so a workspace that cannot pay for a call, or has every call line busy, does not forward it: the caller hears that the number is not answering.
- What it costs is what a call put through to a person costs: on a number you took from us, every minute the caller is connected, at the voice plan of the agent attached to the number — or the Premium voice rate when no agent is. If your own keys apply to that agent (or to the workspace, when no agent is attached), it is the flat price of that set of keys instead, even though a forward uses none of them. On a number you brought, nothing from us — the minutes are on your carrier's bill. It is not the carrier-only charge of a call that ends before the agent speaks.
- It is not recorded. The agent never takes a forwarded call, so there is no
recording and no transcript: Get Call shows
recordingasnulland Get Recording answers404. - Not to one of these numbers. A forward cannot point at the number itself or at another number on the platform, which would send calls round in a loop.
- Not to premium or special numbers. Premium-rate, shared-cost and toll-free
numbers, satellite and international-network numbers, and a short list of
high-cost international destinations are refused
(
forward_destination_not_allowed): a forward runs with nobody watching, and those numbers charge by the minute to whoever dials them. An ordinary landline or mobile is always fine. If you have a real need for one of them, tell us. - Nothing is said or sent after a forwarded call. The agent never took it,
so there is no summary, no extracted details and no follow-up message — you
still get the
call.completedwebhook, withforwardedToset, when an agent answers the number. When no agent does there is no agent to send it for, so the call shows in Usage, Get Call and the call list (with no agent) and not as a webhook or an inbox conversation. Get Call and the call list carryforwardedTotoo, andsecondsis how long the caller was connected, even on a number you brought where nothing is billed. A forward nobody picked up is reported asmissed, with ahangupofno_answer,busy,rejectedorunreachable, andseconds0. On a Telnyx number a caller who hangs up while the phone is still ringing may be reported as a completed call instead. - Not on Vobiz. A Vobiz number cannot forward calls, so the setting is
refused (
number_cannot_forward).
From the console it is Forward calls in the number's menu. From the API it
is forwardTo on Update Phone Number:
{ "forwardTo": "+919812345678" }
Send "forwardTo": null to stop. A refusal says which rule stopped it in its
code: forward_loop or number_cannot_forward. A United States number you
rent from us forwards only to US and Canadian numbers (see United States
numbers).
Moving a number to another workspace
If you build on the developer API, a number can move between your own workspace and your customers' — keeping its digits, so nobody who has it saved needs a new one.
In the console, open the Phone Numbers page, open the number's menu, choose Move to another workspace… and pick where it goes: your own workspace or one of your customers. The option is there only for developers, and only on a number that can be moved. A refusal says why (the number is on a call, an Indian number whose new workspace has no approved business details, and so on).
Through the API (or the move_phone_number MCP tool):
curl -X POST https://app.katexs.com/api/v1/phone-numbers/918041234567/move \
-H "Authorization: Bearer $KEY" \
-H "X-Workspace: org_…the customer that has it now…" \
-H "Content-Type: application/json" \
-d '{ "toWorkspace": "org_…the workspace it goes to…" }'
Leave the X-Workspace header out when the number is in your own
workspace. What happens:
- The number stops being any agent's line, and leaves every agent's spare numbers, in the workspace it leaves.
- It arrives in the other workspace answered by nobody. Point it at an agent there, as with a number you have just rented.
- Rent carries on from the next month in the new workspace. The month already paid is not charged again — and since your customers are billed to you, no money moves either way.
- An Indian number is held in the name of the business using it, so the workspace it moves to must have its own business details approved first (see India needs your business verified first). The move registers the number to that business.
- A number you rent from us moves only to a workspace billed in the same
region: a United States number stays with workspaces billed outside India, an
Indian number with workspaces billed in India (
number_move_other_region). - A number you brought moves only when both workspaces have the same carrier account's keys saved. A Telnyx number set up for one workspace cannot move this way: remove it and add it again in the other workspace.
- It is refused while the number is on a call, or while the same number is already being moved.
- Any call forwarding set on the number is cleared: it was the old workspace's choice.
- If the phone network cannot take the move, the number stays where it was,
answered by nobody, and you can try again shortly (
number_move_unavailable). - Repeating a move that already succeeded, to the same workspace, gives the same result, so a lost response is safe to retry.
- A few long-held numbers were set up before workspace-level phone accounts existed and cannot be moved this way; write to us for those.
Only workspaces of one developer can trade numbers. A key you gave one customer cannot move its numbers anywhere.
Inbound and outbound are separate
Every number has two pickers on the Phone Numbers page, and they are independent:
| What it decides | |
|---|---|
| Inbound | Which agent answers when somebody rings the number. One agent, or nobody. |
| Outbound | Which agent calls out from the number — in campaigns, test calls and the call API. |
They can be the same agent, which is the ordinary case, or different ones. Some things that is useful for:
- A receptionist and a caller on one number. One agent answers; a different one makes the outbound calls, and the people it rings see your usual number.
- A number that only calls out. Leave Inbound empty and choose an agent under Outbound. Nobody answers when it is rung, but the agent can place calls from it.
- An agent that only calls out. It does not need a number of its own at all. Give it a number under Outbound and it can run campaigns and test calls straight away — we switch its phone on for you when you do.
Inbound empty means nobody answers. Whoever rings the number hears that it is not taking calls — including somebody ringing back after a campaign call. A number that is only lent out for calling is never answered by the agent calling from it. If you want a number to answer, choose an agent under Inbound.
When you let a different agent call out on a number that another agent answers, we ask first, because of exactly that: a customer ringing it back will reach the agent that answers it, not the one that rang them.
A number is lent to one agent at a time on this page. Lending it to a second agent takes it out of the first one's list, and ends no call: one that is ringing or being answered carries on from that number to its end.
Several agents can call from one number at once through the API. A call placed
with Place Call can name, as its from, any number the
workspace holds and can call from — lent to that agent or not. So one agent can
answer the number while two others call out from it, with no lending at all. A call
waiting to be placed that named a number rings from it as long as the workspace
still holds it; one that named no number rings from the agent's own number, or its
first lent one.
A ring-back can reach the agent that called. When several agents call out from
one number, a person ringing it back normally reaches the agent that answers
it. Set the number's ringBack to last_caller with
Update a Phone Number and they reach the agent that called them
from that number in the last 30 days instead. If no agent called them, or that
agent is not answering phone calls, the number answers as usual. It is off unless
you turn it on.
Numbers from different phone companies on one agent
An agent can call out from numbers on different phone companies — a Katexs number and one you imported from Twilio, say — like a phone with two SIM cards. Each call goes out through its own number's company, on its own account, and hangs up there too.
- In the Playground, Call from lists every number the agent can call from, each with its company's logo. A number that cannot call yet (one you imported without saving its credentials) is shown but greyed out.
- Campaigns spread their calls across all of them.
- Some features depend on the company. Transferring a call to a person and leaving a voicemail work on Katexs numbers and numbers from Plivo or Telnyx, but not on Vobiz or Twilio numbers. Recording works on every number. A call from a number that can't do one of these still goes out — that feature is simply off for it, and the Playground and the campaign builder tell you before you call.
One limit to know about: a number you brought needs its credentials saved before an agent can call from it, the same as any number of yours that places calls.
Spare numbers for calling out
A calling campaign goes out from your agent's number. That is fine for a few hundred calls and starts to hurt at a few thousand: phone companies and phones themselves watch for a line that makes a burst of calls, and once a number is marked as one, everything it does afterwards suffers — including a customer ringing you back and seeing a warning on their screen.
Spare numbers spread that out. Give an agent several numbers under Outbound, and campaigns share their calls across the agent's own number, if it has one, and the others.
1. Have a spare
Any number on the page — one you bought and have not pointed anywhere, one you brought and have not used yet, or one another agent answers.
2. Lend it
Under Outbound, choose the agent. That is the whole setup.
What it does not do. A spare does not become the agent's number. Nothing about who answers changes, the number you gave your customers stays the number they ring, and you can take a spare back at any time by choosing the agent that answers it, or Nobody if none does.
One person always sees the same number. Whichever of your numbers rings a customer is the one that rings them again — including a second attempt days later. Three attempts from three different numbers is what a nuisance call looks like, and avoiding that is half the point, so it does not happen.
Note
A spare can be on a different phone company from the agent's other numbers. A spare you brought needs its carrier credentials saved, the same as any number of yours that places calls. The page says which of these is missing rather than letting you find out on a campaign.
Note
Changing who answers a number does not change who calls out on it. Moving or clearing Inbound leaves Outbound exactly as it was.
Warning
A spare must be licensed for the same kind of calling as the campaign. In India promotional calls need a 140-series number, so a campaign marked promotional is refused if any of the numbers it would use is not one — and it names which. It is the number that carries the penalty.
Disconnecting, giving up, and removing
Three different things and only one of them is permanent.
Disconnect takes the number off the agent so it stops answering. The number stays yours either way — your own number stays with your carrier, and one you rent from us stays rented and still charged. It shows on the Phone Numbers page with nothing under Inbound, ready to point at another agent. An agent you had chosen under Outbound keeps calling out on it.
Give up hands a number you rent from us back to the phone company. The monthly charge stops and the number goes back to the pool.
Remove applies only to a number you brought. It takes our record of it away, so we stop answering it and stop listing it — the line stays yours and your carrier keeps billing you for it exactly as before. Remember to unset its Answer URL in your own console afterwards, or calls to it will still reach us and be declined. Bringing it back later is the same three fields.
Warning
Releasing is permanent. The number goes back to the phone company and somebody else can take it — we cannot get it back for you, even a minute later. If it is printed anywhere, or anybody has it saved, keep it.
What callers hear when nothing is set up
- Answer calls off — the agent does not answer. A caller on a Plivo, Vobiz or Twilio number hears a short spoken message and the call ends; a Telnyx caller hears a busy tone. You can write the message yourself (When Answer calls is off).
- Answer calls on, Phone number switched off — the same: the agent does not answer. You have switched voice on without telling it to pick up the phone.
- Everything on, no greeting — the agent waits for the caller to speak first. That is a real choice, and some lines are better that way, but it surprises people who expected a greeting.
Things worth knowing
One number, one answering agent
Two agents cannot both answer one number. If you want different behaviour for different callers — sales and support, say — that is one agent with instructions covering both, or two agents on two numbers.
Who calls out on a number is a separate choice, and an agent can call out on several numbers — see Inbound and outbound are separate above. Answering is still one to one.
Trying it on a real phone
The Playground has a Try it on a real phone box under the browser call. Type your own number and press Place call: the agent rings you from its number, so you hear exactly what a customer hears — a phone line, not a browser. If the agent can call out on more than one number, a Call from list lets you choose which, so you can hear a spare as well.
It is a real call and costs the same per minute as any other. The browser call beside it is free and instant, which is the one to use while you are editing what the agent says; this one is for hearing how it sounds.
Which number do calls out use?
When your agent rings somebody, it calls from its own number, or from one you have given it under Outbound. That is what they see, and what they will ring back — and it is answered by whichever agent is under Inbound on that number, which may not be the one that rang them. See Inbound and outbound are separate above.
How long those calls ring before they count as not answered is a setting of
the agent, not of the number: Playground → Ending calls → Ring time in the console, or
voice.ringSeconds in the API (and ringSeconds on a single call). See
How long it rings.
Promotional calling in India needs a different kind of number
A normal business number is licensed for service and transactional calls. Promotional calling in India needs a 140-series number, and using an ordinary one for it can get the number blocked. See Calling campaigns.
Test before you print it
Ring your own number and ask the hardest question you get — not "what are your hours". The awkward one, with a condition attached, where the honest answer is "it depends". That is the answer worth hearing out loud before a customer does.
