Voice

With Calls API, you can use our granular APIs to create any inbound or outbound voice and video scenario you require.

Every inbound connection to, or outbound connection from the Infobip platform is designated as a call leg, or simply put, a call. All API methods under the Call Legs section allow your application to create, answer and perform actions on individual calls.

Applications can connect multiple calls together, no matter if these calls are inbound or outbound, and no matter the type of the endpoint for each of these calls. When your application needs to connect only two calls together, it is not necessary to explicitly manage conference objects and use conferencing APIs – the connect API method on calls will manage these conferencing objects on your behalf. When your application needs to put together 3 or more calls together, you need to use the conference methods and their related actions under the Conference Calls section.

A Calls Configuration is a logical entity that represents a voice or video application you are implementing and hosting in your own environment, whether on premise or at your cloud hosting services. This logical entity includes only ID and Name, and is a placeholder for linking other configurations with your application.

One mandatory link to set up is linking you Calls Configuration with Subscriptions. Calls API is event-driven platform, and you need to define webhook to receive those events, as a pre-requisite for executing your business logic. Event subscriptions are defined on Subscriptions API. One of available parameters, when defining subscription criteria, is callsConfigurationId, which allows you to define webhooks for Calls Configurations you create.

Another mandatory link to Calls Configurations is actual traffic. The reference of the Calls Configuration (callsConfigurationId) must be specified in API calls your application will make towards Infobip to create or manipulate calls, conferences and dialogs, ensuring that corresponding events are routed to the right webhooks. All methods to create and manage Calls Configurations are under the Configurations section.

The Voice Message API initiate outbound calls to one or more destination numbers (landline or mobile). When the call has been answered, pre-recorded or text-to-speech converted audio file will be played to the recipient. Three flavors of voice messaging are available:

• Single voice message: call one target number at a time, and play an audio file or text to speech
• Multiple voice message: same as simple, but allows to define an array of messages, each with their own multiple target numbers
• Advanced voice message: same as multiple, but
  • Can use Automated Machine Detection
  • Can define schedule for sending calls
  • Can define acceptable time windows for sending
  • Can capture 1 DTMF input from the callee(s), and report it via webhook, or or use DTMF input to forward the call to defined destination

The IVR API enables the creation of inbound and outbound interactive call scenarios. For inbound calls, once your scenario is created you will need to link this scenario to the phone number you are renting on the Infobip platform using the voice setup on number method.

IVR scenarios can use the Record action to record a portion of the call. These recordings can be retrieved using the Search Voice IVR Recorded Files and Download Voice IVR Recorded File. Alternatively, IVR recorded audio can also be found using the Search Recording method.

Click To Call

Voice Reports And Logs

The Number Masking service enables two parties to engage in a conversation over the phone without exposing their phone numbers to each other. This service is ideal for businesses that share customer information with third parties. Have in mind that the Number masking mapping has to be implemented on your side in order to define to which phone number the incoming call should be forwarded to. Number masking mapping depends on your business logic.

All Number Masking calls can be recorded. To enable recording feature on Number masking calls, please check Voice recording feature documentation section. Recording on Number masking calls could be enabled using Apps section of the portal.

To fetch recorded audio files please check Voice recording audio page. You may also fetch recorded audio files using Recording page section of the portal.

Read more

This API offers advanced calls routing features. You can use it to set up destinations of different types and routing logic between them.