> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.rydhm.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.rydhm.ai/_mcp/server. # 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](/workspace/members). ## Before you start * **A Telnyx account at the Paid level.** Trial accounts can only call their verified numbers. Check it in the [Telnyx portal](https://portal.telnyx.com/#/account/account-levels) 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](https://portal.telnyx.com/#/api-keys) (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: 1. It creates an **outbound voice profile** named "Rydhm outbound" that can call **US numbers only**. 2. 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. 3. 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. > **Warning** > > 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](/workspace/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](/channels/phone#us-only-dialling). * **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. ## Related * [Phone](/channels/phone) * [Bring your own Twilio](/channels/byo-twilio) * [Campaigns](/channels/campaigns) * [Security](/workspace/security)