Skip to main content
Telnyx is a carrier-grade communications platform built on an elastic private global IP backbone. It provides deep PSTN interconnects, wholesale per-minute pricing, and direct programmatic control over call routing. Telnyx is ideal for brokerages running high-concurrency voice broadcasts where minimizing audio packet round-trip latency is vital for conversational realism. The BrokerOS integration (integrations/voice/telephony/telnyx/) uses the Telnyx v2 API, automated Outbound Voice Profiles, and bidirectional TeXML Media Streams.

​
Telnyx Calling Pipeline

​
Required Credentials

To connect Telnyx to BrokerOS, retrieve the following credentials from the Telnyx Mission Control Portal:

​
Automated Outbound Voice Profile Provisioning

Before an outbound telephone call can be placed through Telnyx, an active Outbound Voice Profile must be linked to your account. BrokerOS automates this setup in TelnyxTelephonyClient:
  1. Queries https://api.telnyx.com/v2/outbound_voice_profiles to verify existing profiles.
  2. If no profile exists, automatically provisions a BrokerOS Outbound Voice Profile with traffic_type: 'conversational' and usage_payment_method: 'rate-deck'.
  3. Attaches the outbound voice profile to your Call Control Application via PATCH /v2/call_control_applications/{appId}.

​
CRM Telephony PSTN Bridging Setup

To use Telnyx as the organization-wide carrier for human telecalling:
  1. Navigate to Dashboard -> Admin -> Settings -> CRM Telephony & WebRTC (/dashboard/admin/settings).
  2. Select the Telnyx carrier card.
  3. Enter the following parameters:
    • Telnyx API Key: Your Telnyx V2 API Key (starts with KEY...).
    • Call Control Application ID: Your Call Control application ID or TeXML connection ID.
    • Caller ID / Outbound DID: Your purchased Telnyx number in E.164 format (e.g., +12025550188).
  4. Click Save & Activate Carrier.
  5. During calls, BrokerOS dispatches TeXML bridge calls to /api/crm/telephony/webhooks/telnyx-voice with automated dual-channel call recording and Groq Whisper transcription.

​
Marketing AI Voice Configuration Steps

1

Generate an API Key in Telnyx Portal

Log in to Telnyx Mission Control. Navigate to API Keys and generate a new V2 API Key.
2

Ensure API_PUBLIC_URL is Configured

Telnyx requires a public URL for the TeXML answer_url parameter. Ensure API_PUBLIC_URL is configured in your root .env (e.g., API_PUBLIC_URL="https://api.yourdomain.com").
3

Add Carrier in BrokerOS Settings

In the BrokerOS dashboard:
  1. Navigate to Dashboard -> Marketing -> Voice -> Settings.
  2. Select the Gateways & Voice Platforms tab (/dashboard/marketing/voice/settings?tab=providers).
  3. Under the Telephony Gateways sub-tab, click Add Carrier and select TELNYX.
  4. Enter an Engine Label / Name (e.g. Telnyx Ultra-Low Latency Trunk).
  5. Paste your V2 API Key into the API Key field.
  6. Enter your purchased Telnyx number in From Numbers.
  7. Click Save & Verify Carrier. Credentials are encrypted with AES-256-GCM and stored in VoiceTelephonyIntegration.
4

Verify Carrier Credentials

Click Verify Carrier. BrokerOS tests credentials against https://api.telnyx.com/v2/phone_numbers and measures network latency.
5

Place a Test Call

Use the Dual-Mode Test Call Modal from the Agent Composer to verify that the TeXML media stream connects cleanly to your phone.

​
TeXML Media Stream Handshake

When an outbound call is answered, Telnyx executes the TeXML response provided by /api/marketing/voice/webhooks/telnyx-answer:
This establishes an ultra-low latency WebSocket stream, piping 160-byte audio packets directly to VoiceMediaStreamGateway.ts.