Callbacks

Callbacks

When you configure a Verboice Application to use a callback URL Verboice will issue an HTTP POST request to that URL with some parameters:

• CallSid: a unique identifier for the call
• Digits: the digits the user has just input
• From: the caller id of the incoming call

Your response must be an XML that will tell Verboice what to do next.

If you have previously worked with Twilio you will notice that the parameters sent by Verboice have the same name. And in fact, the XML response should be TwiML. This is so you can reuse that knowledge if you happen to be using it and also to allow you to port your application to Verboice with minimal changes.

Currently Verboice supports the following TwiML verbs:

• Play
• Say
• Gather
• Redirect
• Hangup

Also there is a Verboice specific verb Bridge. This verb allows to connect the current session with another session.

This will bridge the current session with the session 42342. After both sessions are bridged the sessions for Verboice are both ended.

#!xml
<Response>
  <Bridge session_id="42342" />
</Response>