How to install an API extension in Ozeki Phone System
For using your own VoIP applications developed by OPS SDK, you need to install a new API Extension. It can be used to accept a client connecting through the Ozeki Phone System API. The following step-by-step guide demonstrates what you need to do in order to setup and configure your API Extension in less than 5 minutes.
|Video tutorial:||How to install a new API extension in Ozeki Phone System|
What is API Extension
API Extension is a standard extension that provides a phone number for your client application connecting through Ozeki Phone System. The phone number of the API Extension is used in the dial plan to forward calls coming to or initiated by the client. Thereby it can be used to build and use diverse VoIP and SMS applications, such as auto dialer applications, call assistants or IVR systems, etc.
How to install a new API extension
Installation consists of three main simple steps. The whole process only takes a few minutes.
Step 1: Install a new API Extension
Step 2: Define a phone number for this extension
Step 3: Add a new dial plan rule
Step 4: Configure your app and make a test call
For using your application with Ozeki Phone System, one or more installed outside lines (VoIP phone line, analog phone line, E-mail service or SMS service) are essentially needed. The type of the required outside line depends on your application. If the needed outside line does not exist, check out the following step-by-step guides in order to install it quickly and easily:
- How to install VoIP telephone lines
- How to install analog phone lines
- How to install ISDN phone lines
- How to setup e-mail messaging in Ozeki Phone System
- How to setup SMS messaging in Ozeki Phone System
Step 1 - How to add a new API Extension
After logging in, you need to add a new API Extension in Ozeki Phone System. Go to the third panel (called 'Extensions') then click on the 'Add' button on the top right-hand corner of this section (Figure 1).
Figure 1 - How to add a new extension
The 'Extensions' panel will appear. Here you need to look for the 'API extension' in the 'Standard Extensions' column then click on the 'Install' button next to it (Figure 2).
Figure 2 - How to add an API extension
Step 2 - How to specify a phone number for your API Extension
Now the configuration panel of the API extension can be seen. You need to enter a telephone number that will be assigned to the API extension. (This phone number will be used in the dial plan forward calls coming to or made by your client application.) After entering a number, click on the 'OK' button (Figure 3). The extension will be registered automatically.
Figure 3 - How to specify a phone number for your API Extension
Step 3 - How to define a new dial plan rule
Return to the home screen and click on the 'Add' button in the middle, called 'Dial plan' section (Figure 4).
Figure 4 - How to add dial plan rule
First select the 'Outbound/internal call' menu item from the 'Rule scope' drop-down menu. In the Source column select the 'Specific extension' option then choose the appropriate API Extension from the drop-down menu. In the 'Destination' column select the 'Send to outside line' option then choose a VoIP, SMS or E-mail service provider. Finally, click on the 'Save' button (Figure 5).
Figure 5 - Dial plan rule configuration
Step 4 - How to make a test call
As an example, we are going to demonstrate a test call by using an autodialer application, which can be used to call numerous external phone numbers automatically. (It is called Ozeki Broadcast By Phone that can be downloaded and modified free of charge if you download its installer and/or source code.)
Figure 6 shows that the application is ready to call the No.1100 and No.1200 phone numbers. However for dialing, you need to specify the API extension details within your application.
Figure 6 - How does Ozeki Broadcast By Phone work
In case of Ozeki Broadcast By Phone you need to click on the 'Settings' menu item then enter the telephone number of the API extension into the 'Extension id' edit box. You have defined this phone number previously in Ozeki Phone System (Figure 3). Finally, click on the 'Save' button (Figure 7).
Figure 7 - VoIP application configuration
Your application has been connected to Ozeki Phone System successfully, so it is ready to use. For making a call by using Ozeki Broadcast By Phone, you only need to click on the 'Start' button. The application will dial the listed phone number automatically. You can track the call status in the autodialer software and in the Ozeki Phone System as well. You can see that the calls have been made using the newly created No.9999 API Extension (Figure 8).
Figure 8 - Make a test call using your client application
Keep in mind
OPS SDK allows you to develop different kinds of telecommunication applications (such as autodialers, appointment reminders, SMS sender applications, etc.) that make your communication systems more effective. For using them with your Ozeki Phone System, an API Extension is required. If you follow the instructions above, you can connect your VoIP, SMS or E-mail application easily to your telecommunication system.
If you have any questions or need assistance, please contact us at email@example.com
Get more information about our solutions:
- Discover all of the free example projects
- C#.Net VoIP developers 101
- How to install a VoIP Service Provider
- How to install an ISDN Service Provider
- How to install an SMS Service Provider