Linphone is an open source VoIP softphone SIP client that supports audio and video calls through VoIP softswitches or IP-PBX. It also allows for instant messaging. Since it was launched in 2001, it has become very popular, especially within the open source community.
For Linphone documentation, see:
Linphone vendor-side technical documentation
Linphone support
Instructions for Configuring Linphone with Telnyx
Pre-Requisites:
Have already created a credentials-based connection on your Telnyx Mission Control Panel account, have assigned this connection to a DID and outbound profile in order to make or receive calls
Video Walkthrough
Coming soon! Check back frequently as we are updating our documentation.
1. Configuring your Linphone
Run your Linphone Softphone and follow the instructions on the wizard.
Once Linphone is up and running, click on the ACCOUNT ASSISTANT option.
From the Assistant screen, click on USE A SIP ACCOUNT.
Fill in the form with the following information where:
Username: Your auth username for the SIP connection in your portal.
Display Name: Most Linphone versions use the Display name as the FROM field, so this needs to be your caller id. We have very strict policies about caller id format, which you can read here. If you are not using a Telnyx number you need to verify your number before using it as a caller id you can read more about that here.
SIP Domain: sip.telnyx.com
Password: The auth password for the SIP connection in your portal
Transport: UDP or TCP
Click on the USE button.
Your Linphone should now be ready to make calls.
Note: To make outbound calls, Telnyx requires either a valid caller ID from your device or a caller ID override enabled on your SIP connection. Please view our caller ID number policy for information on enabling a caller ID override from within the Telnyx portal. |
2. Configuring your Linphone with Encryption
Follow steps 1-4 of section 2.1 with the following exceptions:
In the SIP Domain field, append port 5061 to the end of the server address (i.e.: sip.telnyx.com:5061)
In the Transport field, select TLS.
Click on the top right menu and select Preferences.
Click on the Call and Chat tab and enable SRTP.
3. Setting up Caller ID
At Telnyx we have a very strict caller ID policy. You need to make sure your softphone or system is sending a valid caller id per our policies found here and the number you're using is either a number you have in your account with Telnyx or it's a number that has been previously verified with Telnyx. Instructions on how to verify a number can be found here.
If you are still getting a 403 error about an invalid caller id, the most usual issue is your softphone or system is not correctly passing the caller ID in one of the headers required. As a workaround you will need to setup a caller ID override in the outbound section of your sip connection settings. You can find the instructions in the caller id policy article here.
Additional Resources
Review our getting started guide to make sure your Telnyx Mission Control Portal account is set up correctly.
Additionally check out:
Linphone's developer documentation
Linphone support