Connect Telnyx (Programmable Voice): API credentials and connection
Connect your Telnyx account to Omnifox to make and receive calls. All you need is your API Key and the Connection ID of your voice connection.
Telnyx Programmable Voice lets you make and receive calls inside Omnifox using your own Telnyx account. To connect it you only need two values: your API Key and the Connection ID of your voice connection. This guide is for beginners.
Requirements
- An active Telnyx account (Mission Control Portal).
- At least one phone number purchased in Telnyx.
- A Voice Connection of type Call Control set up in Telnyx.
- Permission to manage channels in Omnifox.
Step 1: Get the API Key in Telnyx
- Sign in to your Telnyx Mission Control Portal.
- Go to API Keys (account menu).
- Create a new API Key (or copy an existing one). It starts with
KEY.... - Store it safely: the full key is shown only once.
Step 2: Get the Connection ID
- In Telnyx open Voice -> Call Control / Connections.
- Open your voice connection (or create a Call Control one).
- Copy the Connection ID (a long number). This is what routes the calls.
Step 3: Connect the channel in Omnifox
- In Omnifox go to Channels and click Connect channel.
- Pick the Telnyx Programmable Voice type.
- Fill in the form:
- API Key: the key from Step 1 (from Mission Control -> API Keys).
- Connection ID: the ID from Step 2.
- Default From Number (E.164): optional here; covered in its own article.
- Save to create the channel.
Step 4: Point the Telnyx webhook to Omnifox
So Telnyx can notify Omnifox about incoming calls, copy the webhook URL Omnifox shows when creating the channel and paste it into your Telnyx connection under Connection -> Webhooks. Save the changes in Telnyx.
How to verify
- Under Channels, the new Telnyx channel should show as active.
- Place a real inbound call to your Telnyx number: it should land in Omnifox. A live test catches problems that a successful save won't.
- If you run a test outbound call, confirm it goes out with your number.
If it doesn't work
- No calls reach the channel: check the webhook URL in Connection -> Webhooks and that the connection is Call Control type.
- Authentication error: the API Key is mistyped or was revoked in Telnyx. Generate a new one and paste it again.
- Invalid Connection ID: make sure you copied the connection's ID, not the number's or the messaging profile's.
Tips
- Use a dedicated API Key for Omnifox; that way you can revoke it without breaking other integrations.
- The recommended next step is setting the default number and, for extra security, verifying webhook signatures.
Related articles
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.