Taalk Help Center

Twilio BYOC (Bring Your Own Carrier)

Twilio BYOC lets your workspace place calls and send texts through your own Twilio account instead of Taalk's. Use it if you already have Twilio numbers or carrier pricing you want to keep.

Go to Platform › Developer › Integrations › Twilio.

Twilio is an add-on in Your own phone carrier ($10.00 one-time). If the row shows Unlock, buy it first. See Integrations Overview.

Before you start

You need Details
A paid Taalk plan The page shows "Please subscribe to unlock API Key" otherwise.
A Twilio account We recommend a sub-account used only for Taalk.
Your Account SID Starts with AC followed by 32 characters.
An API token The 32-character auth token for that account.

Step 1: Save your Twilio credentials

  1. Go to Platform › Developer › Integrations and click Connect on Twilio.
  2. Under Use your own Twilio account, fill in:
    • Twilio Account SID
    • Twilio API Token
  3. Click Save.

After saving, both fields show masked values and the Integrations list shows Twilio as Connected.

Taalk checks the format (AC + 32 characters, 32-character token) but doesn't test the credentials against Twilio when you save. Place a test call to confirm they work.

To stop using your account, click Delete. Taalk goes back to its own carrier.

Step 2: Point your Twilio numbers at Taalk

The same page shows two URLs to copy (click the copy icon):

Field Paste it in Twilio as
Inbound Webhook URL for Twilio The number's voice webhook ("A call comes in")
SMS Webhook URL for Twilio The number's messaging webhook ("A message comes in")

Set both for every Twilio number you want Taalk to answer. Use HTTP POST.

Step 3: Add your numbers to Taalk

With your own Twilio account connected, you can't buy numbers through Taalk ("Please buy number under your own Twilio console"). Buy them in Twilio, then register them in Outreach › Channels › Phone numbers. The add button opens the form to register an existing number.

[Confirm] Workspace admins can register their own Twilio numbers on the Phone numbers page without Taalk support.

Once registered, assign agents and campaigns to the numbers as usual. See Phone Numbers.

What changes with BYOC

Topic With BYOC
Phone numbers Live in your Twilio account
Twilio usage charges Billed by Twilio to your account
AI and platform usage Still billed by Taalk from your balance. See How Billing Works.
Recordings Stored in your Twilio account

Recording clean-up applies to your Twilio account. Taalk's recording retention schedule deletes recordings older than the retention period in the connected Twilio account, including recordings your other Twilio apps made. Use a sub-account that only Taalk uses.

Troubleshooting

Problem What to check
"Please set your Twilio account SID" The SID must start with AC and have 32 more characters.
"Invalid Twilio SID and token pair." Re-check both values for typos or spaces.
Inbound calls don't reach your agent The number's voice webhook in Twilio must be the Inbound Webhook URL for Twilio. The number must also be registered in Phone numbers with an inbound agent.
Texts don't arrive in Taalk Set the SMS Webhook URL for Twilio on the number.
Outbound calls fail Check Twilio geo permissions and that the number is voice-enabled.

What Twilio BYOC can't do (yet)

  • Test credentials on save.
  • Import your Twilio numbers automatically.
  • Use other carriers. Telnyx numbers are provided by Taalk only.

Related