Skip to main content

Voice Application

For the impatient

You may explore this data model via the API Playground, by clicking here

Endpoints

  • /domains/{domain}/applications[/{application-name}] (alias to /customers/self/domains/{domain}/applications)
  • /customers/{customer}/domains/{domain}/applications[/{application-name}]

The Cloudonix application model represents deployment of voice applications into a domain. Each application object refers to either:

  • An application installed on customer's servers.
  • A Container Application installed in the customer's account.
  • A Cloudonix built-in application.

An application object contains the configuration required by the Cloudonix voice application runtime engine (APP.Core) to execute the application.

Properties

PropertyTypeEditableDescription
domainObjectNoThe Cloudonix Domain object that this application belnogs to
nameStringCreateThe application configuration name
profileObjectCreate, UpdateA set of metadata properties that can be assigned to the application. The customer may also update the profile with whatever metadata they wish to store in Cloudonix.
typeStringCreate, UpdateThe application protocol. Currently supported values are twiml for TwiML compatible applications or cxml for Cloudonix XML applications (backwards compatible to TwiML and supports some Cloudonix specific capabilities).
urlStringCreate, UpdateThe application start URL. This can be either a standard HTTP or HTTPS URL for customer Container Applications, or a cx: URL for Cloudonix hosted and built-in applications.
methodStringCreate, UpdateThe HTTP method used to call the application, can be either GET or POST. Default: GET
activeBooleanUpdateWhether the application is enabled and will be executed. Default: true

Application Profile Properties

The following properties are recognized by Cloudonix when set in the application's profile field:

PropertyTypeEditableDescription
status-start-ringingBooleanCreate, UpdateRequires that CXML application requests sent to the application before the call is answered will always have the CallStatus field set to ringing regardless of the actual status.
send-progressBooleanCreate, UpdateControl whether the voice application engine sends ring tone to the caller before starting to run the application. Default: true
auto-answerBooleanCreate, UpdateControl whether the voice application engine will automatically answer the incoming call before starting to run the application. Default false