Collect a caller’s phone number via keypad (DTMF + # terminator) with validation and duplicate detection. XML elements used:Documentation Index
Fetch the complete documentation index at: https://docs.vobiz.ai/llms.txt
Use this file to discover all available pages before exploring further.
<Speak>, <Gather inputType=dtmf finishOnKey=#>, <Redirect>, <Hangup>
View on GitHub
Clone and run the full working example
Getting started
Overview
The caller is prompted to enter a phone number using their keypad, followed by#. The server validates the digits, reads them back one at a time for confirmation, and stores the number with deduplication. Captured numbers are accessible via API for CRM import or lead management.
Call flow
Vobiz webhooks
Set/answer as the Answer URL in your Vobiz application.
| Method | Path | Description |
|---|---|---|
| POST | /answer | Prompts for number + # |
| POST | /number-received | Validates + reads back digit by digit |
| POST | /number-confirm | 1=confirm / 2=re-enter / 3=cancel |
| POST | /number-received-repeat | Re-reads number on invalid key press |
| POST | /hangup | Cleanup |
App API
| Method | Path | Description |
|---|---|---|
| GET | /leads | List all captured numbers |
| GET | /leads/export.csv | Download as CSV |
| GET | /leads/analytics | Total, unique, duplicates, today count |
| GET | /leads/{id} | Single lead detail |
| DELETE | /leads/{id} | Remove a lead |
Environment variables
| Variable | Required | Description |
|---|---|---|
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 |