Bring your own number
Connect a phone account you already have — Twilio or Vobiz — and run Intrlume agents on the numbers you already own, in any country you operate in.
If you already have a phone account and numbers, you don't have to get new ones from us. Bring your own connects that account to Intrlume so your agents call from — and answer on — numbers you already own.
Two providers are supported today: Twilio and Vobiz.
Bringing a number works on every plan, including the free trial. It doesn't count against your plan's number allowance — that covers only numbers on your workspace from us. It's the one way a trial workspace can take inbound calls.
What you'll need
-
Admin access to your Intrlume workspace.
-
An account with one of the supported providers, and its credentials from your own console:
Provider Credentials Twilio Account SID and Auth Token Vobiz Auth ID and Auth Token -
A voice-capable number on that account.
Your credentials are stored encrypted and are never shown back to you.
On a different provider? Email hello@intrlume.tech and tell us which — it helps us prioritise.
Connect your account
Outcome: the provider shows Connected, and you can start registering numbers.
Open Telephony
Go to Settings → Telephony and pick your provider from the tab strip.
Enter your credentials
Fill in the fields for that provider — Account SID and Auth Token for Twilio, Auth ID and Auth Token for Vobiz.
Test & Connect
Click Test & Connect. Intrlume checks the credentials against your provider before storing them, so a wrong value fails immediately with a clear message rather than saving quietly and breaking your first call.
Once connected, the card shows Connected and your masked account identifier.
Register a number you own
A connected account isn't enough on its own — tell Intrlume which of your numbers to use, and what for. Register each number for one direction.
Open Add a number on your provider's tab. Every registration asks for three things: the Phone number in full international format, its Type (Inbound or Outbound), and the Country it's registered in.
Country is about the number, not your workspace. They're often the same and they don't have to be — a business in one country can bring a number from another. Tell us where the number is and everything that depends on it stays right. It's never inferred, so it's always asked.
Outbound
Fill in the number
Enter the Phone number, set Type to Outbound, and pick the Country. It must be voice-capable on your provider account.
Register Number
Click Register Number. The number joins your outbound numbers and your agents can call from it.
Inbound
Inbound is two jobs. First, in your provider's console, send the number's calls to Intrlume. Then register the number here. Intrlume checks your setup before it saves anything.
The one thing you paste into your provider's console is your Answer URL. Intrlume shows it when you set Type to Inbound.
Copy the Answer URL from the app — don't type it, and don't reuse an old one. It's different for each provider, so copy it from your provider's tab. On Vobiz it also carries a code that belongs to your workspace.
On Twilio, the Answer URL goes on the number itself.
Copy your Answer URL
In Intrlume, go to Settings → Telephony and open the Twilio tab. Open Add a number, set Type to Inbound, and click the copy icon in the Answer URL box.
Open the number in Twilio
Click Open Twilio Console, or sign in to Twilio and go to Phone Numbers → Manage → Active numbers. Click the number you want to answer calls on.
Send its calls to Intrlume
Scroll to the Voice Configuration section.
- Set A call comes in to Webhook.
- Paste your Answer URL into the URL box.
- Set the method to HTTP POST.
Leave everything else as it is.
Save in Twilio
Click Save configuration at the bottom of the page.
Register the number
Back in Intrlume, enter the Phone number in full international format, check the Country, and click Register Number.
Your Twilio console looks different? In Twilio's newer layout, go to Numbers & Senders → Phone Numbers and pick the number. On the Configuration details tab, click Edit details in the Voice and emergency calling section. Choose Webhook, paste your Answer URL, and set the HTTP method to POST. Leave the secondary webhook empty, then click Save.
On Vobiz, the Answer URL goes on an application. You then attach your number to that application.
Copy your Answer URL
In Intrlume, go to Settings → Telephony and open the Vobiz tab. Open Add a number, set Type to Inbound, and click the copy icon in the Answer URL box.
The URL ends in ?token= and a long code. That code is part of the URL, so copy all of it.
Create an application
Click Open Vobiz Console, or sign in to Vobiz and go to Voice → Applications. Click + Create New Application.
Fill it in
- Application name — anything you'll recognise, like Intrlume inbound.
- Primary answer URL — set the method to POST and paste your Answer URL.
- Hangup URL — leave it empty.
- Fallback answer URL — leave it empty.
- Toggles — leave them all off, including Default endpoint app and Public URI. Turning on Public URI lets anyone call the application directly, without authentication.
Then create the application.
Attach your number
The last step of creating the application asks which numbers to attach. On the Current Phone Numbers tab, click + Select next to your number, then confirm with the attach button at the bottom.
Skipped this? Click the application to open its details, go to its Phone Numbers tab, and click + Attach Number.
Register the number
Back in Intrlume, enter the Phone number in full international format, check the Country, and click Register Number.
Can't select your number? Vobiz only lets you pick a number that isn't linked to something else. The Linked To column shows where it's linked now. If it's another application, open that application and click Detach on its Phone Numbers tab, then try again.
What registering checks. Intrlume reads your provider account and confirms the number sends its calls to your Answer URL — the number's own setting on Twilio, or the application it's attached to on Vobiz. If it matches, the number joins Your numbers. If not, nothing is saved, and the message tells you what to fix.
The check looks at the URL, not the method, so make sure the method is POST even when registration succeeds.
Registering checks your routing but doesn't change it. It does set one thing on Twilio inbound numbers: where their call-status updates go, so Intrlume knows when each call ends. Intrlume's daily check of your account puts that back if it's changed.
Point an agent at it
Open the agent, and on its Profile tab set Call type → Channel to Inbound. Pick this number as Number to answer on, then click Save Changes. See Configure your agent.
A number answers for one agent only. If your number isn't in the list, either it isn't registered for inbound yet, or another agent already answers on it.
To test, call the number from any phone. Your agent should pick up.
If inbound isn't working
Registration says "This number isn't pointed at us yet." The number doesn't send its calls to your Answer URL yet. Check that:
- You saved your changes in your provider's console.
- You pasted the whole Answer URL from this workspace. On Vobiz, that includes the
?token=part. - On Twilio, A call comes in is set to Webhook on the number itself.
- On Vobiz, the number is attached to the application that has your Answer URL.
Registration says "That number isn't on your account." Intrlume can't find it on the account you connected. Check that the number is on that same account, and that you typed it in full international format.
Registration says "That number is already registered." The number is already in Intrlume. If it's under Your numbers as outbound, release it, then register it for inbound. If it isn't listed, it's registered on another workspace — release it there first.
Registration says the number looks like it's from another country. The Country doesn't match the number. Pick the country the number is registered in.
Callers hear "Sorry, this number is not available right now." The call reached Intrlume, but no agent could take it. Check that:
- An agent answers on this number, and you saved it — see Point an agent at it above.
- Your workspace can take calls: its plan is active and includes inbound calls, it has credits, and it isn't at its call limits. See Settings → Billing.
It worked, but calls stopped reaching your agent. Intrlume checks your provider account every day. If a number no longer sends its calls to your Answer URL — say, someone edited it in the console — the number appears under Needs attention on your provider's tab, with your Answer URL ready to copy. Paste it back, and on Vobiz re-attach the number if it was detached. The number stays registered meanwhile. Once it's fixed, an admin can remove the notice.
What it costs
Nothing on your Intrlume bill. A brought number sits on your provider account, so your provider charges you for the number and its carrier minutes directly.
Intrlume still charges credits for the conversation — the agent's time on the call — exactly as it does on a number on your workspace from us. Your live rates are in Settings → Billing.
Which number gets used
On a paid plan your agents always dial from your own numbers.
On the free trial it depends on what you hold: the moment your workspace has an outbound number of its own, calls dial from it instead of the shared numbers. Two things follow — your own caller ID shows on the call, and the daytime window that applies to the shared numbers no longer applies to you.
Disconnect or remove
-
Release a number — click Release next to it in Your numbers. This unregisters it from Intrlume and clears the routing you pointed at us. You keep the number on your provider account, so it's reversible: register it again to bring it back.
Intrlume blocks the release while the number is still working — if an agent is answering on it, or a running or paused campaign could dial from it. Point the agent at another number, or stop the campaign, then release.
-
Disconnect the account — removes your stored credentials and the link to that provider. Register the numbers again after reconnecting. It changes nothing on your provider account.
Telephony showing "Not available yet"? Bringing your own phone account isn't switched on for your workspace. Email hello@intrlume.tech and we'll enable it.