Getting Started with Telnyx

linkSIP Signaling Addresses

Outbound Calls

Telnyx SIP Proxies are located in different regions. You can choose which region to use by configuring your SIP device to use any of the SIP proxies below:

RegionFQDNPrimary IP AddressSecondary IP Address
USsip.telnyx.com192.76.120.1064.16.250.10
Europesip.telnyx.eu185.246.41.140185.246.41.141
Australiasip.telnyx.com.au103.115.244.145103.115.244.146
Canadasip.telnyx.ca192.76.120.3164.16.250.13

SIP Regions affect only the SIP signaling path. For selecting where the media path is anchored please refer to the Anchorsite section of this document.

Please note that outbound calls from the same IP address or SIP username are limited to 50 calls every 3 seconds. Telnyx retains the right to modify this limit at their discretion.


Inbound Calls

You can register your SIP device on any of the SIP regions listed above and you will receive Inbound calls from the regional SIP proxy.

If your device uses IP-address or FQDN authentication, then you can choose from which SIP region you will receive calls on the Inbound section of the Connections page in the Telnyx Mission Control portal. Unless you configure the region, the US region will be used.

If you use an ACL or Firewall on your network, please make sure you whitelist both primary and secondary IP addresses listed above for the region you have selected, as inbound calls may come from either IP address.


DNS Records

The FQDNs for each region support DNS records types A, SRV and NAPTR.

The DNS A records resolve to the primary IP address, while the DNS SRV and NAPTR records will allow you to use both IPs, primary and secondary, while also discovering the available transport protocols and their ports.


Transport Protocols

Telnyx supports the following transport protocols for SIP signaling:

Transport ProtocolPort
UDP5060
TCP5060
TLS5061

linkMedia

The RTP port range used by Telnyx is 16384 to 32768 (UDP).

Telnyx uses the following media IP addresses to handle RTP streams. If you use an ACL or Firewall on your network, make sure you whitelist these IP addresses:

Subnets (containing all media IPs)

64.16.226.0/24
64.16.227.0/24
64.16.228.0/24
64.16.230.0/24
64.16.248.0/24
64.16.249.0/24
185.246.41.128/25
103.115.244.128/25
50.114.144.0/21

List of individual IPs

If you need a list of individual IP addresses please email support@telnyx.com.

linkMedia Forking IP Subnets

When using the media forking feature Telnyx will send the forked media from an IP address in one of these subnets:

  • stream_type = raw (default)
    • 103.115.244.0/26 (addresses .0 to .63)
    • 185.246.41.0/26 (addresses .0 to .63)
    • 192.76.120.128/26 (addresses .128 to .191)
    • 192.76.120.192/27 (addresses .192 to .223)
  • stream_type = decrypted
    • subnets specified in Media section.

You may need to explicitly open your firewall to allow UDP traffic from these subnets.

linkCodecs

Telnyx supports the following codecs:

  • G.722
  • G.711U (PCMU)
  • G.711A (PCMA)
  • G.729
  • Opus (supported for IB and OB calls, for IB calls though it's only allowed when using TLS or TCP transport)
  • H.264

We currently support only ptime:20 for RTP.

linkAdditional Network Information

Information on peering with Telnyx can be found on PeeringDB.

Points of presence

United StatesEquinix CH1, DC2, SV1
CanadaEquinix TR1, Cologix VAN2
UKEquinix LD6
EuropeEquinix FR5, AM6
AustraliaEquinix SY1
SingaporeEquinix SG1

Customers can request a direct connection to the Telnyx network via Megaport.

linkSetting Up Mission Control

Initial setup

  1. Log in to Telnyx Mission Control.
  2. Create a Connection for your SIP device. You can choose between the following types of authentication:
    • Credentials (username and password) (inbound and outbound)
    • IP address (inbound and outbound)
    • FQDN (inbound) + Credentials (outbound)
    • FQDN (inbound) + IP address (outbound)

Making outbound calls

  1. Create an Outbound Profile and assign your Connection to it.
  2. When using UDP or TCP, configure your SIP device to send calls to sip:sip.telnyx.com:5060.
  3. When using TLS, configure your SIP device to send calls to sip:sip.telnyx.com:5061.
  4. When using the FQDN + Credentials authentication, only Credentials will be used.
  5. When making calls, be sure to use a valid calling number. Numbers in +e.164 format should always be ok. Please check this article for further details.

Receiving inbound calls

  1. Purchase a number and assign it to your Connection.
  2. If you chose Credentials authentication, you need to register your SIP device with your username and password to sip:sip.telnyx.com:5060 before receiving calls.
  3. When using IP Authentication Telnyx will initiate a call from the IP address 192.76.120.10 to your Connection using UDP transport by default. If you prefer TCP or TLS transport you can edit the SIP Transport Protocol option for Inbound Calls in the Connections page.
  4. When using IP authentication, you can enter multiple IP addresses and set different priorities. Telnyx will attempt to connect calls to each IP address following the priorities order and the No Ringback Timeout setting. More advanced routing settings can be configured from the Numbers page under Routing options.
  5. When using FQDN + Credentials authentication, Telnyx will route calls to the resolved FQDN records .

linkEncryption

Telnyx supports TLS versions 1.2 and v1.3 for encrypted signaling, and SRTP for encrypted media.

For outbound calls, you can configure your device to use TLS and SRTP and make calls without further configuration on the Telnyx portal.

For inbound calls, you can enable TLS with SRTP in the Connections page.

linkAnchorSite™

Telnyx will regularly ping your Connection using ICMP ping messages to calculate round trip timings from all Telnyx available sites.

The site with the lowest latency will be selected as the AnchorSite™, and the media for Inbound/Outbound calls will be anchored in that site.

If you prefer not to receive pings from Telnyx and manually anchor your media in one of the available sites, you can do so from the Connections page.

linkMedia Handling

Telnyx will automatically detect your media IP address by monitoring the RTP packets received during the first seconds after media establishment on the media IP address:port pair and adjust it automatically if it differs from the pair announced by you during call establishment. This option can be disabled using the option Disable RTP Auto Adjust in the Numbers page under Expert Options.

The same behavior can be extended to the whole duration of the call by selecting the option Accept any RTP packets in the Numbers page under Expert Options.

linkFAX

Telnyx supports FAX calls using G.711 codec or T38.

For inbound FAX calls, Telnyx will expect the customer connection to send a T38 reinvite by default. If no reinvite is received, the call will continue with G.711 codec. This can be disabled using the T38 option in the Numbers page.

For outbound FAX calls you can chose different FAX modes using T.38 Re-invite Initiated By options in the Outbound tab on the Connections page:

  • Telnyx Telnyx will send a T38 reinvite after detecting FAX tone
  • Customer Telnyx will expect a T38 reinvite from the customer
  • Disabled Telnyx will not send a T38 reinvite and will reject an T38 reinvite sent from the customer

linkSTUN

Telnyx provides STUN service using the following addresses:

stun.telnyx.com:3478

linkTURN

Telnyx provides TURN service using the following address:

turn.telnyx.com:3478

Please request the TURN username and password by email to support@telnyx.com.

linkWebRTC (Beta)

Telnyx supports WebRTC calls through the following:

Unencrypted websocket:

ws://sip.telnyx.com:5066

Encrypted websocket with flexible TLS cipher suites for use with most browsers (i.e. Firefox):

wss://sip.telnyx.com:7443

Client configuration

Most WebRTC clients will ask for the following settings:

WebsocketUse one from the list above
UserSame as SIP username
PasswordSame as SIP password
Domain/Realmsip.telnyx.com
SIP URI/Proxysip:username@sip.telnyx.comsip:username
@sip.telnyx.com
Registrarsip:sip.telnyx.comsip:sip
.telnyx.com
STUN serverstun.telnyx.com:3478
TURN serverturn.telnyx.com:3478

linkContact Us

Don’t hesitate to reach out if you have any questions!