BXML Callbacks

Understanding BXML Callback Events

BXML callbacks are HTTP requests made by the Bandwidth platform to endpoints specified by you in your HTTP requests and BXML. Their purpose is to 1) inform you of events that have happened in the call flow and 2) receive instructions from your application on what to do next.

BXML callbacks are HTTP POST requests by default. The request will have a JSON body that describes the event. It expects an XML response consisting of BXML verbs.

HTTP GET requests may be used for callbacks by setting the appropriate *Method attribute when specifying each callback's URL. If the GET method is used, the properties are passed as query parameters. This can cause very long URLs, so POST is the preferred method.

We use a 15s request timeout when trying to deliver all callbacks, retrying once if we receive a connect error.

Callback Description
Answer Bandwidth API sends this to the application when the call is answered.
Bridge Complete Bandwidth API sends this to the application when a <Bridge> is complete and the original call needs to continue.
Bridge Target Complete Bandwidth API sends this to the application when a <Bridge> is complete and the target call needs to continue.
Gather Bandwidth API sends this when a <Gather> is completed.
Initiate Bandwidth API sends this to the application when an inbound call arrives.
Record Complete Bandwidth API sends this to the application when a <Record> is completed. The recording is not available to download until the Recording Available event is received.
Redirect Bandwidth API sends this to the application when a <Redirect> is requested or when a POST request is made to the /calls/{callId} endpoint requesting a redirect.
Transfer Answer Bandwidth API sends this to the application when a <Transfer> is answered.
Transfer Complete Bandwidth API sends this to the application when a <Transfer> is complete and the original call needs to continue.

Asynchronous Callbacks

Understanding Asynchronous Callback Events

Asynchronous callbacks are HTTP requests made by the Bandwidth platform to endpoints specified by you in your HTTP requests and BXML. The HTTP POST method is used by default. The request will have a JSON body that describes the event. An HTTP 201 response with no content is expected. HTTP 200 is also acceptable. If there is a response body (including BXML), it will be ignored.

HTTP GET requests may be used for callbacks by setting the appropriate *Method attribute when specifying each callback's URL. If the GET method is used, the properties are passed as query parameters. This can cause very long URLs, so POST is the preferred method.

Callback Description
Disconnect Bandwidth API sends this to the application when a call ends.
Recording Available Bandwidth API sends this to the application when a recording started by either a <StartRecording> or a <Record> verb is available for download.
Transfer Disconnect Bandwidth API sends this when any leg of a <Transfer> ends.
Conference Created Bandwidth API sends this when a new conference is created.
Conference Member Join Bandwidth API sends this when a new member joins a conference.
Conference Member Exit Bandwidth API sends this when a member leaves a conference.
Conference Completed Bandwidth API sends this after the last member leaves the conference.

results matching ""

    No results matching ""