Number
Get a number
The Voice Agent is on plans that include it. Open your AI Agent's Settings, then Channels and Voice. Choose Use my existing number to keep the number customers already call, or Get a new number. Search by country and area code and get one: numbers are on sale in the United States, Canada, Puerto Rico and the US Virgin Islands. Other countries are by request: choose the country and send the request, and our team arranges the business documents it asks for, which usually takes some days. Each number is a monthly charge to your card, apart from your plan and your AI credits: you pay for the rest of this month when you get it, then monthly, and the page shows the price before you confirm. An AI Agent can hold several numbers up to your plan's limit, so different campaigns can call from different numbers. Each number answers for one AI Agent, and calls are answered once the AI Agent is published.
If a number's charge fails, the number is paused: it takes and places no calls, and starts again within the hour once the card on Billing is updated and the charge goes through. Giving a number up credits the rest of its month on your next charge. A number left unpaid for 30 days is given back to the phone company for good, with a warning a week and a day before.
Numbers can't be added during the free trial. A test call works then, so you can hear your AI Agent before you get a number.
Forwarding
Keep your own number
- 1Enter your numberUnder the number you got, add the number your customers already call and its carrier. It can be in any country.
- 2Turn on forwardingDial the forwarding code shown for your carrier, so calls to your number reach your OrhanAI number.
- 3Check forwardingPress Check forwarding and call your own number within ten minutes. A short message confirms the call came through, and it uses no AI credits.
SIP
Connect your phone system (SIP)
If your number runs on a phone system such as 3CX, FreePBX or another VoIP provider, it can send calls to your AI Agent over SIP instead, and you don't need a number from us. A SIP connection works during the free trial and doesn't count toward your plan's numbers.
- 1ConnectOn the Voice page, choose Connect your phone system. You get a server, a username and a password. Copy the password then: it is shown again only on request.
- 2Add a SIP trunkIn your phone system, add a SIP trunk that signs in to sip.telnyx.com with that username and password, over UDP or TCP on port 5060 or TLS on port 5061. The Voice page has short guides for 3CX, FreePBX, RingCentral, Zoom Phone and Grasshopper.
- 3Route callsRoute the calls you want answered to the trunk, dialling your business number in full. The status changes from Waiting for first call to Connected when the first call arrives.
To transfer these calls to your team, verify your business number under Transfers with a code sent by text or call. Until then the AI Agent takes a message instead. Only US and Canadian numbers can be verified.
Settings
Call settings
Greeting
The first thing callers hear, in your own words.
Voice
Choose one of 8 voices. Play a short sample of each before you choose.
Questions
Up to 5 questions the AI Agent asks to qualify a caller, such as what they need or how soon.
Departments and transfers
Name the teams callers can be sent to, their numbers and when to transfer. Transfers dial US and Canadian numbers. When nobody answers, the AI Agent takes a message.
Business hours
Set when you are open. After hours the AI Agent handles calls differently, for example by taking a message instead of transferring.
Longest call
The longest a call may last before it ends.
The AI Agent answers calls from the same knowledge as your chat, so training a source improves both.
Test
Test call
Place a test call from the Voice page with your browser's microphone. It answers even while the AI Agent is a draft, works during the free trial, and uses AI credits like a real call.
Inbox
Calls in the Inbox
- Every call is a conversation in the Calls tab of your AI Agent's Inbox, with its transcript, summary and outcome.
- The caller is saved as a contact.
- Calls can't be replied to from the Inbox. Call the person back from your own phone.
Outbound
Outbound call campaigns
On plans that include outbound campaigns, your AI Agent can call a list of US and Canadian contacts for you. Open the AI Agent, then Campaigns. Campaigns can't be started during the free trial, and your plan sets how many calls can be placed each day.
To call just one person, open the AI Agent's Voice page and press Call someone, or press Call with AI on a contact's page. Write what the call is for and it rings them now, under the same rules. A number on the Do Not Call list, or a person outside the calling hours where they are, is refused with the reason rather than called later.
To ring someone yourself, press Call from browser on the Voice page, a contact's page or the Inbox details panel, and allow the microphone. No AI is on the call, their phone shows the AI Agent's number, and nothing is recorded. Minutes use AI credits only once the person answers. A number on the Do Not Call list cannot be called, and outside the calling hours where they are you are asked to confirm first.
- 1Add contactsUpload a CSV with a phone number column and any other columns you want to use, or pick people from your contacts.
- 2Write the scriptSay what the call is for and what the AI Agent should say, using {{variables}} from your columns such as {{name}}, and set the goal the summary is judged against. Add a voicemail message if you want one left on answering machines.
- 3Choose when and from wherePick the days and hours to call, the caller ID (a number you got from us, or your own number verified for a SIP connection), how many calls run at once (up to 5) and how many attempts each contact gets (up to 3).
- 4Confirm consent and startTick the box confirming every contact agreed to be called, then start. You can pause, resume or stop the campaign at any time.
- Calling hours: each contact is called only in their own local time, and never before 8 AM or after 9 PM there, whatever window you choose.
- Disclosure: every call opens by saying it is an AI assistant calling on behalf of your business.
- Voicemail: when an answering machine picks up, the call says it is an AI assistant calling on behalf of your business, then leaves your voicemail message, which is saved in the call's transcript. With no message set, none is left.
- Do Not Call list: a person who asks not to be called again is added to your workspace's Do Not Call list, and no campaign calls a number on it. You can add or remove numbers by hand.
- Retries: a contact who doesn't answer or is busy is called again later, up to the attempts you chose.
- Live results: the campaign page counts answered calls, voicemails, no answers, busy lines and people who asked not to be called, as they happen. Once it finishes, its report can be downloaded as a PDF to share or a CSV for a spreadsheet, or emailed to up to three people with both attached.
- Every call is a conversation in the Calls tab of the Inbox, with its transcript and summary.
You are responsible for having consent to call each contact and for following the laws on calling where they live, such as the TCPA in the United States and Canada's telemarketing rules. The calling hours, the disclosure and the Do Not Call list help, but they don't make a campaign compliant on their own.
SMS
Text messages (SMS)
On plans that include texting, your AI Agent answers text messages sent to a US or Canadian number you got from us, and your team can text a person from their contact page. Open the AI Agent, then Settings > Channels > SMS. Texting can't be used during the free trial.
- 1Register your businessUS carriers only deliver business texts from a registered business, so fill in the registration form once: your business details, your EIN, what the texts are for, sample messages, how people agree to get texts, and links to your privacy policy and terms. We send it to the carriers for you.
- 2Wait for approvalCarriers check your business, then review what the texts are for. It usually takes a few days, and the SMS page and your notifications say when it is approved or what to fix.
- 3Turn texting on for a numberChoose a number your AI Agent already has from the Voice tab. Once approved, texts to it are answered and land in the Text tab of the Inbox.
- Your privacy policy must say that mobile numbers and text consent are never shared with third parties. The form shows the sentence to add.
- People can reply STOP to stop texts, START to get them again and HELP for your contact details. Someone who replied STOP gets nothing more until they reply START.
- Registering costs AI credits once, and keeping the registration active costs AI credits each month. The form shows both before you send it, and credits for a step the carriers never charged for come back.
- Each text uses AI credits by its length, whoever wrote it, on top of the AI credit for the reply. A long answer is cut at a sentence so one text never costs more than a few segments.
- A sole proprietor, a business without an EIN, can text from one number only.
Billing
AI credits
Call minutes, incoming and outbound, use AI credits per minute from the same allowance as chat. The Voice page shows how many credits a minute uses. The Voice Agent is not part of the lifetime deal.
Conversations and leads
Review visitor conversations, source references, context, image attachments, contacts, and captured leads.