Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Build a multi-level Interactive Voice Response menu on Vobiz with dynamic configuration, DTMF keypad routing, and call analytics tracking in Python.
<Gather inputType=dtmf>, <Speak>, <Redirect>, <Dial><Number>, <Hangup>
git clone https://github.com/vobiz-ai/Vobiz-IVR-XML-Python.git
cd Vobiz-IVR-XML-Python
cp .env.example .env
pip install -r requirements.txt
python server.py
/answer → Main Menu
1 → Sales
│ 1 → Products & pricing (spoken)
│ 2 → Request a demo → Hangup
│ 3 → Connect to sales rep → <Dial>
│ 9 → Back to main menu
2 → Technical Support
│ 1 → API issues → raise ticket option
│ 2 → Call quality → <Dial>
│ 3 → Account access (spoken)
│ 9 → Back
3 → Billing
│ 1 → Balance info (spoken)
│ 2 → Payment issues → <Dial>
│ 3 → Invoice / GST info (spoken)
│ 9 → Back
4 → Account Management
│ 1 → Upgrade plan → <Dial>
│ 2 → Update details (spoken)
│ 3 → Cancel → double confirm
│ 9 → Back
0 → Operator → <Dial>
9 → Repeat menu
/answer as the Answer URL in your Vobiz application.
| Method | Path | Description |
|---|---|---|
| POST | /answer | Main IVR menu |
| POST | /ivr-main-choice | Routes digit 1–4 / 0 / 9 to sub-menu |
| POST | /ivr-sales | Sales sub-menu |
| POST | /ivr-sales-choice | Routes sales choice |
| POST | /ivr-support | Support sub-menu |
| POST | /ivr-support-choice | Routes support choice |
| POST | /ivr-support-ticket | Raises high priority ticket |
| POST | /ivr-billing | Billing sub-menu |
| POST | /ivr-billing-choice | Routes billing choice |
| POST | /ivr-account | Account management sub-menu |
| POST | /ivr-account-choice | Routes account choice |
| POST | /ivr-account-cancel-confirm | Double confirms cancellation |
| POST | /ivr-operator | Direct transfer to operator |
| POST | /dial-complete | Callback after any <Dial> ends |
| POST | /hangup | Call ended webhook |
| Method | Path | Description |
|---|---|---|
| GET | /config | View current department config |
| PUT | /config/department/{dept} | Update transfer number / enable-disable |
| GET | /call-logs | Full call history |
| GET | /call-logs/analytics | Which menu options are pressed most |
| Variable | Required | Description |
|---|---|---|
VOBIZ_AUTH_ID | Yes | Vobiz account auth ID |
VOBIZ_AUTH_TOKEN | Yes | Vobiz account auth token |
FROM_NUMBER | Yes | Your Vobiz DID (caller ID for transfers) |
HTTP_PORT | No | Server port (default: 8000) |
PUBLIC_URL | No | Production URL - skips ngrok if set |
NGROK_AUTH_TOKEN | No | ngrok auth token for local dev |
Was this page helpful?