If you want to create an application that works directly from the cloud, such as a calling or messaging application, an IVR or an automatic survey with voice synthesis and recognition, VoxEngine will help you with that.
This guide will help you to build your first application on VoxEngine. In general, you need to:
- Create an application
- Create a scenario inside it
- Create a rule and attach it to the scenario
- Buy a phone number and attach it to the application
- Test the app
Now let us go through each step in details.
Let us begin with an application. Go to the Voximplant control panel and log in to your account or create a new one. Then choose the application section from the menu in the upper left corner and click New application in the upper right corner or Create at the bottom of page:
This opens the New application editor window where you set it up and confirm by clicking Create. The new app appears in the application list. To change its name, icon or description, click the three dots menu and select Edit.
With this done, we move to scenario creation.
Open your newly created app, select Scenarios on the left menu, and click on the plus icon and give your scenario a name:
This opens a new tab in the online IDE on the right. This is where you write your code. If needed, you can rename the scenario or change the source code later. Also, you can upload changes automatically via the Management API.
Now, give your scenario a name and add some code. Here is an example of what you can write there:
In this scenario, we play synthesized speech to a callee via the say method. But we test it after we create a rule and buy a phone number.
Let us move to the Rules section. Rules tell the platform which scenarios to execute when a call arrives at the platform or the StartScenarios API method is called. To create a rule, switch to the Routing tab of the application and either click Create in the center of the screen or New rule in the upper right corner:
The last thing we need to test our app is a phone number. You can rent a number from us and set your own CallerID, if you want to (not for test numbers). In this quickstart, we rent a test phone number accessible as an extension. On the Voximplant control panel, select My phone numbers on the left menu and then click Buy new phone number in the upper right corner:
The phone number interface is displayed. Select Test numbers, then select one or more test numbers and click Buy selected:
Next you can make a call. Dial one of the access numbers displayed on the page and enter the number you bought as an extension when you hear the prompt.
Each application session contains a log file with all calls in this session, both inbound and outbound. You can access the log via control panel or via Management API. The session log TTL is 1 month. After 1 month you cannot access and download the session log.
I want to continue
Now you know how to create a basic working app. To add more functionality to it, follow our guides.