BlueVia Voice Call Control Commands Reference

You have access to a rich set of call control functionality via either XML and JSON call control commands. When you call one of your BlueVia Voice Numbers, make a BlueVia REST API request to create a new call or modify an existing call, you can specify how to manage the calls behaviour by specifying XML or JSON commands. Calls can be managed by commands via the following mechanisms:

  • When your BlueVia Voice Number is called, BlueVia will make a HTTP POST request to the callback URL associated with your number. You can provide Call Control Commands in the HTTP Response body to BlueVia

  • When you make a REST API request to either create a call or add a call leg then, when the phone that is being called is answered BlueVia will make an HTTP POST request to the callback URL associated with the callerId that was provided in the request. NOTE: In the API request you can override the callback URL for your BlueVia Voice Number that you use as the callerId. This will override the callback URL for the present call only. See the BlueVia REST API Reference for further details.

  • When you use the /setcommands shortcut you can provide either JSON or XML commands in the REST API request body. You can also provide a URL to the XML or JSON commands. BlueVia will then make a HTTP request to the URL to get those commands.
  • Various call events will also result in BlueVia making requests to the callback URL├¡s you have configured. BlueVia will make a HTTP POST request to your callback URL providing all event data in the POST request body. You can respond to these notifications with JSON or XML Call Control Commands. To Understand how BlueVia can provide you detail of call notifications to your BlueVia Voice Numbers refer to the BlueVia Voice Call Event Notification Reference

The following Call Control Commands can be specified by you: