Bring your own Telnyx

If you already have US numbers in Telnyx, you can connect your Telnyx account and import them into Rydhm. Your experts answer them and can call out from them. You keep paying Telnyx directly for the numbers and their call minutes.

Only admins and the owner can connect Telnyx and import numbers. See Members and roles.

Before you start

A Telnyx account at the Paid level. Trial accounts can only call their verified numbers. Check it in the Telnyx portal under Account → Levels.
An API key made by the account owner. Telnyx keys have no scopes: a key can manage the whole account. Create one just for Rydhm, ideally with an expiry, so you can revoke it on its own. A team member’s key may not be allowed to read the account’s numbers.
US numbers that can take voice calls. Local and toll-free numbers can be imported. Non-US numbers, and numbers that aren’t active in Telnyx (a port still pending, for example), can’t.
SIP REFER, for transfers. Handing a caller to a person on your team uses SIP REFER, which Telnyx turns on per account. If you want transfers, ask Telnyx support to enable it. Calls work without it; only the transfer fails.

To create the key, sign in to the Telnyx portal (Mission Control), open API Keys and select Create API Key. Copy it right away: Telnyx shows it only once. It starts with KEY.

Connect your account

Open the connect dialog

Go to Settings → Integrations and find Phone. On the Telnyx row, select Connect. You can also start from Settings → Phone numbers → Add a number → Import from Telnyx.

Paste your API key

Paste it into API key. Spaces and line breaks from copying are removed for you. The key is stored encrypted and never shown again.

Connect

Select Connect Telnyx. Checking your key and setting up takes a few seconds, so keep the dialog open. You’ll see Telnyx connected.

What Rydhm does in your Telnyx account

Connecting makes only these changes:

It creates an outbound voice profile named “Rydhm outbound” that can call US numbers only.
It creates a SIP connection named “Rydhm” that sends calls to Rydhm, with its own login so your experts can call out through your account.
It leaves your numbers alone. A number moves to Rydhm only when you import it.

Rydhm signs in with your API key from then on. It never orders, releases or deletes numbers in your account.

Import a number

Open the list

Go to Settings → Phone numbers, select Add a number, then Import from Telnyx.

Pick a number

Each number shows where its calls go today:

Not in use: it isn’t on any connection.
Used by an app’s name: a Call Control or TeXML app answers it today.
On SIP connection and a name: another SIP connection answers it today.
In Rydhm: it’s already imported.

A number that can’t be imported says why, for example Only US numbers can be imported for now.

Choose who answers

Under Who answers, pick an expert, or Decide later. Calls aren’t answered until you pick one.

Import

Select Import (the button shows the number). It shows as Active within a few seconds.

Importing a number that another app or SIP connection uses moves its calls to Rydhm straight away. Rydhm remembers which connection it was on and puts it back there if you remove the number from Rydhm later.

A workspace can import up to 50 numbers, from Twilio and Telnyx together. A number can be in only one Rydhm workspace at a time.

Remove a number

On Settings → Phone numbers, select Remove from Rydhm on the number. Rydhm puts it back on the connection it had in your Telnyx account. You see Removed from Rydhm. Rydhm never releases an imported number. It stays yours in Telnyx.

If that connection no longer exists, the number is left with no connection, and the message tells you to choose where its calls go in the Telnyx portal (Numbers → My Numbers).

Check or disconnect

The Phone section on Settings → Integrations shows the start of your API key, how many numbers are in Rydhm, and the SIP connection and outbound profile Rydhm keeps in your account.

Verify checks that Rydhm can still sign in, and repairs its SIP connection and outbound profile if someone changed them.
If Telnyx starts refusing Rydhm, for example because the key was deleted, disabled or expired, the section shows an error. Select Connect again and paste a new key.
Disconnect removes every imported number from Rydhm (each one goes back to its old connection), then deletes the SIP connection and the outbound voice profile Rydhm made, and forgets its key. Your numbers stay yours in Telnyx.

A Telnyx key can’t be revoked through Telnyx’s API, so revoke it yourself after disconnecting: in the Telnyx portal, open API Keys and delete or disable the key Rydhm showed you (it starts with the same characters). Rydhm lists this, and anything else it couldn’t clean up, when you disconnect.

Costs

Telnyx bills you directly for imported numbers and their call minutes, including the second leg of a transfer.
Rydhm charges phone call minutes at the usual rate. See Billing.
An imported number has no monthly fee from Rydhm and doesn’t use your plan’s phone numbers.

Troubleshooting

When Telnyx refuses a call, the refusal ends in a short code. Rydhm turns the common ones into a sentence on the call and, for a campaign, in its pause reason.

Code	What Rydhm shows	What to do
D35	”Telnyx refused the caller ID…”	Check that the number is still in the connected Telnyx account. If it isn’t, remove it from Rydhm.
D36	”…the number belongs to another Telnyx account.”	The number moved to another Telnyx account. Remove it from Rydhm and import it from the account that has it now.
D7, D38	”The Telnyx connection has no outbound voice profile…”	Select Verify on Settings → Integrations.
D60, D61	”The Telnyx account is on a trial level…”	Upgrade the account in the Telnyx portal (Account → Levels).
D1, D2, D3, D22	”Too many calls at once on your Telnyx account.”	Wait and try again. A Paid account allows 5 outbound calls at once.
D42	”Transfers aren’t enabled on your Telnyx account.”	Ask Telnyx support to enable SIP REFER (call transfer).
D19	”Telnyx blocked the account (billing)…”	Check the balance and payment method in the Telnyx portal.

Connecting can also fail before anything is set up:

“Telnyx didn’t accept that API key.” The key is wrong, deleted or expired. Create a new one.
“That key can’t read phone numbers.” Use a key made by the account owner.

Gotchas

Outbound calls are US-only, whichever account the number comes from. See Phone.
Campaigns place at most 5 calls at once on your Telnyx numbers, the limit of a Paid Telnyx account.
Don’t edit or delete the “Rydhm” SIP connection or the “Rydhm outbound” profile in Telnyx. If calls stop, use Verify, then Connect again.
One Telnyx account per workspace. To switch accounts, disconnect first.