Skip to main content
Telnyx is Ringee’s default and recommended telephony provider. It provides WebRTC-based calling, phone number management, and call recording through a powerful API.

​
Setup

1

Create a Telnyx account

Go to telnyx.com and sign up for an account.
2

Get your API key

  1. In the Telnyx portal, go to API Keys
  2. Copy your API Key (starts with KEY...)
3

Create a Credential Connection (WebRTC)

Ringee uses Telnyx’s Credential Connections for WebRTC calling:
  1. Go to Voice → Connections → Credential Connections
  2. Click Add Credential Connection
  3. Configure the connection:
    • Connection Name: ringee-webrtc
    • Username: Choose a SIP username
    • Password: Choose a SIP password
  4. Copy the Connection ID, Username, and Password
4

Buy a phone number

  1. Go to Numbers → Search & Buy
  2. Search for a number in your desired country
  3. Purchase the number
  4. Assign the number to your credential connection
5

Configure webhooks

Set up webhooks to receive call events:
  1. Go to your credential connection settings
  2. Set the Webhook URL to: https://your-backend-url/api/telnyx/webhook
  3. Events will be sent for: call initiated, answered, ended, recording completed, etc.
6

Configure environment variables

Add the following to your .env file:

​
Environment Variables

The NEXT_PUBLIC_ variables are needed by the frontend to establish WebRTC connections directly from the browser to Telnyx. These are the same values as the SIP credentials.

​
How it works

​
Features

​
Troubleshooting

Verify that your SIP credentials match between TELNYX_SIP_USER / TELNYX_SIP_PASSWORD and NEXT_PUBLIC_TELNYX_LOGIN / NEXT_PUBLIC_TELNYX_PASSWORD. Also ensure your credential connection is active in the Telnyx portal.
Make sure your webhook URL is publicly accessible. For local development, use a tunneling service like ngrok to expose your backend: ngrok http 3000
Phone number availability varies by country. Try searching for different area codes or number types (local vs. toll-free).