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.

api extension

Prerequisites

First you need to download and install Ozeki Phone System (take a look at the quick start guide for getting started quickly). After the installation, login by using your username and password.

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:

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).

add new extension
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).

add api extension
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.

specify phone number
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).

add dial plan rule
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).

dial plan configuration
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.

ozekibroadcast
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).

voip application configuration
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).

test call
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 info@ozekiphone.com

Download Ozeki Phone System