Testing the example Dialplan
Now that you have a phone configured, you can perform several kinds of test calls. If you can get two different phones configured, you can make a few additional types of test calls. Before you begin dialing, be sure that you have installed the default sounds and music files. (Windows users will have them installed by default. Linux/Unix users should refer to the Step 5 – install sound and music files section in Chapter 2, Building and Installation, for more information.)
Test calls for a single phone
The following tests are simple ways to confirm that FreeSWITCH is operating properly, as well as learning more about what it can do. In each case, you simply need to dial the four-digit number and click on your phone's Send button.
The Tetris extension
Dial 9198. You will hear what hopefully sounds like the Tetris theme song. The sound is generated solely using tone generation. (See http://wiki.freeswitch.org/wiki/TGML for more information on TGML, the tone generation markup language used in FreeSWITCH.)
Echo test
Dial 9196. Speak into the phone and the audio will be echoed back to you. This test confirms that audio is flowing in both directions. (Keep in mind that if your phone and the FreeSWITCH server are on the same LAN then the echoed audio will return very quickly. Try dialing 9195, which will do an echo test with a 5-second delay.)
Music on hold
Dial 9664. The system will play the default music on hold. If you hear the music, your music on hold
files are properly installed, and FreeSWITCH is correctly playing those sound files.
Demonstration IVR
Dial 5000. The demonstration IVR menu will play. You will be given the options that are described as follows:
- Call FreeSWITCH public conference
- Echo test
- Music on hold
- Register for ClueCon
- Screaming Monkeys (yes, really)
- Sample IVR sub-menu
The FreeSWITCH public conference is quite literally a public conference room, which anyone may call into. Note that your FreeSWITCH system will need to have the Internet access, and that your firewall and NAT must be configured to allow SIP and RTP traffic.
The echo test and music on hold options are identical to dialing 9196 and 9664, respectively.
ClueCon is an annual telephony developer conference. Dialing 4 will transfer you to an operator who will be glad to get you registered for the conference.
The sample sub-menu is very simple— press * to return to the main menu.
The demonstration IVR menu is found at conf/ivr_menus/demo_ivr.xml
.
The information application
Dial 9192. This extension is very simple. Before dialing, be sure to open up the fs_cli
utility. The info
application will dump a lot of debug data about the current phone call. Change the debug level to 6 (INFO) before you dial. You can find the sample output of this in the Chapter 3
folder of the code bundle.
Don't worry about what all of that means right now. Just remember that FreeSWITCH stores a lot of information for each call leg that is active. The info
Dialplan application is useful for debugging your custom Dialplan entries.
Test calls for two or more phones
The true power of FreeSWITCH is seen in how it can handle calls from multiple endpoints. The following tests will give you an idea of some of the features that FreeSWITCH supplies. The tests in this section require at least two different telephones to be configured.
Calling another telephone
Dial 1000, 1001, and so on. Simply dial the other phone's extension number and it should ring. Most SIP phones are like regular telephones, so just pick up the handset to answer. If a telephone isn't configured for a particular extension, you will be connected to the voicemail application and prompted to leave a message in the mailbox for the extension you called.
Parking a call
Call another telephone and wait for an answer. Click on the Transfer button and dial 6001. Hang up. The other party is now parked and will hear music on hold. Retrieve the call in one of the following ways:
- Dial 6001. The parked call is automatically unparked.
- Dial 6000 and wait for the system to answer. The system will prompt you for the extension number.
Dial 6001. The parked call is automatically unparked.
Calling a conference
Dial 3000 from several different phones. All parties will be able to hear each other.
Example Dialplan quick reference
Consult the following table for a list of extension numbers and their functions:
The bulk of the example Dialplan is defined in conf/dialplan/default.xml
.