Telnyx Voice and SMS

Telnyx is an optional bring-your-own-account voice and SMS provider for LeenOps. A workspace can connect its Telnyx account, synchronize or buy a number, assign that number to a team member, make outbound browser calls, and send and receive SMS 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.

For the cross-provider workflow, roles, call history, and operations, read the Telephony guide first.

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 the complete URL for that connection:

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. The same signed URL can also be used by the Telnyx Messaging Profile if you enable SMS.

Synchronize Existing Numbers

If the Telnyx account already owns phone numbers:

1. Open Settings > Telephony & Messaging > Phone Numbers.
2. Select Sync account.
3. Review the numbers assigned to the configured Credential Connection.

LeenOps reads the complete paginated Telnyx inventory and preserves existing team-member assignments. A locally known number that is no longer present at Telnyx is marked for attention instead of silently disappearing.

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, transfer, 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.

Signed Telnyx events keep the LeenOps call state current even when provider events arrive more than once or out of order. When Telnyx emits recording and transcript events, LeenOps links them to the call and mirrors completed audio to private storage for durable playback.

Enable Telnyx SMS

Before this step, connect Telnyx Voice and select Sync account so LeenOps can verify the sender number.

1. In Telnyx, create or choose a Messaging Profile.
2. Add the intended sender number to that Messaging Profile.
3. Configure the connection-specific signed LeenOps webhook URL on the Messaging Profile.
4. In LeenOps, open Settings > Telephony & Messaging > SMS & WhatsApp.
5. Choose Telnyx SMS.
6. Enter the Messaging Profile ID and sender number in international E.164 format.
7. Enable Use as default SMS provider if outgoing SMS should use Telnyx.
8. Select Connect Telnyx SMS.

Telnyx SMS reuses the encrypted API key from the voice connection; LeenOps does not ask for or store a second copy. Outbound messages, inbound messages, delivery state, CRM activity, recipient opt-out, and idempotency use the same LeenOps message records as other providers.

LeenOps requires the synchronized number to show the same Messaging Profile ID you entered. If it has no profile or a different profile, assign it in Telnyx and select Sync account again before connecting SMS.

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.
• Disconnecting Telnyx removes encrypted credentials and revokes WebRTC credentials created by LeenOps while retaining call, message, number, and audit history.

Next Steps

• Telephony — Provider choice, roles, calling, call history, and operations
• CRM Activities — Start calls and review customer activity
• Telnyx developer overview — Browse official Telnyx documentation
• Telnyx trial limits — Confirm current test-account restrictions