Telnyx Voice

Telnyx is an optional bring-your-own-account voice provider for Leenops. A workspace can connect its Telnyx account, buy a number without leaving Leenops, assign that number to a team member, and make outbound browser calls from CRM.

Telnyx remains the owner and billing provider for every number and call. Leenops stores an encrypted connection, synchronized number inventory, user assignments, orders, and call history.

What You Need

You must be a workspace owner or administrator, or have the relevant telephony provider and phone-number permissions.

Prepare these values from the Telnyx Mission Control Portal:

Do not paste any secret into chat, source code, a ticket, or a screenshot. Enter the API key only in the password field in Leenops.

Trial Account Limits

Telnyx trial limits can change. At the time this guide was verified:

• outbound calls can dial only the phone number verified in your Telnyx account;
• a trial account can order one local number in its country of origin;
• the number can be reclaimed if the account is not upgraded within 30 days;
• trial voice calls have concurrency, duration, hourly, and daily limits;
• a trial account can have only one API key at a time.

Verify your destination number in Telnyx before the first test call. See Telnyx trial privileges and limitations for the current rules.

1. Create the Telnyx API Key

1. In Telnyx, open your account menu and choose API Keys.
2. Select Create API Key.
3. Give it a clear name, such as Leenops test.
4. Choose an appropriate expiration policy.
5. Create the key and save it securely.

Telnyx displays the complete key only once. If it is lost, create a replacement instead of trying to recover it. See Create and manage API keys.

2. Create a Credential Connection

Leenops browser calls use a Telnyx Credential Connection.

1. In Telnyx, open Voice and create a credential-based connection.
2. Make the connection active.
3. Attach an outbound voice profile that permits the destinations you intend to call.
4. Copy the connection ID.

The account API key and Credential Connection must belong to the same Telnyx account. The connection must support WebRTC calling. Telnyx's current configuration details are in the Credential Connection guide.

3. Find the Webhook Public Key

In Telnyx, open the account's keys and credentials area and copy the public key used for Ed25519 webhook verification. This is a public verification key, not your API key.

Leenops rejects an invalid signature and events with an old timestamp. Adding the correct public key is therefore required for trustworthy call-state updates.

4. Connect Telnyx in Leenops

1. Go to Settings > Telephony & Messaging.
2. Open the Providers tab.
3. Select Add Provider.
4. Choose Telnyx.
5. Enter a display name and your API key.
6. Enter the Credential connection ID.
7. Enter the Webhook public key.
8. Optionally enter a two-letter Default number country such as BE.
9. If Telnyx gave you one for the intended number, enter the Requirement group ID.
10. Enable Default voice provider if CRM calls should use Telnyx first.
11. Select Connect provider.

Leenops verifies the API key against the specified Credential Connection before marking the provider connected. The API key is encrypted before it is stored and is never sent to a caller's browser.

5. Configure the Telnyx Webhook

After connecting, the Telnyx provider card shows a path like:

/api/webhooks/telnyx/<connection-id>

Prefix it with your public Leenops domain:

https://your-leenops-domain.example/api/webhooks/telnyx/<connection-id>

Set this as the primary webhook event URL on the same Telnyx Credential Connection and use webhook API version 2. The URL must be publicly reachable over HTTPS; localhost cannot receive Telnyx events.

6. Buy a Number

1. In Settings > Telephony & Messaging, open Phone Numbers.
2. Choose a two-letter country, number type, and optional city or locality.
3. Select Search.
4. Review the recurring monthly price and any one-time charge.
5. Select Review purchase for the desired number.
6. Optionally choose a member under Assign after activation.
7. Select Confirm purchase only when you approve the displayed charge.

Search results are short-lived quotes. If a quote expires, search again instead of relying on its former price or availability.

Regulatory requirements

Some countries and number types require identity, business, address, or other documents. If an order shows requirements pending:

1. Open the linked Telnyx number page.
2. Complete the required documentation in Telnyx.
3. Return to Leenops and select Refresh on the order.

A Requirement Group ID can be added to the provider connection when the order must use a group already prepared in Telnyx. See Telnyx Requirement Groups.

7. Assign the Number

Once a number appears under Owned Telnyx numbers:

1. Open its member selector.
2. Choose the person who should call from that number.
3. Leave it as Not assigned if it should remain in workspace inventory.

The assignment becomes that user's outbound Telnyx caller number. A caller without an assigned number receives a prompt to buy or assign one before a browser call can start.

8. Call a CRM Contact

1. Open a CRM contact or another record with click-to-call.
2. Select a valid phone number.
3. Allow microphone access if the browser asks.
4. Use the voice dock to mute or end the call.

Leenops requests a short-lived Telnyx login token for the signed-in user. The browser never receives the workspace API key. Call progress is written to the provider-neutral Leenops call journal.

Release a Number

Releasing a number is destructive:

1. In Phone Numbers, find the owned number.
2. Select its trash icon.
3. Read the warning and select Release number only if you intend to return it to Telnyx.

The number may become permanently unavailable. It is removed from user assignment and can no longer be used for CRM calls.

Troubleshooting

Security and Billing

• Leenops encrypts the Telnyx API key in the workspace provider connection.
• Browser clients receive only short-lived, per-user WebRTC credentials.
• Signed webhooks are checked against the configured Ed25519 public key and a five-minute replay window.
• Telnyx bills the connected customer account directly. Leenops is not the merchant of record.
• Access to provider setup, number purchase, assignment, release, and calling is controlled by workspace telephony permissions.

Next Steps

• CRM Activities — Start calls and review customer activity
• Telnyx developer overview — Browse official Telnyx documentation
• Telnyx trial limits — Confirm current test-account restrictions