Skip to main content
A Vobiz XML Application ties a phone number to your server. When a call arrives, Vobiz POSTs (or GETs) to your Answer URL; your server responds with XML that tells Vobiz what to say, gather, dial, stream, or record. When the call ends, Vobiz POSTs the result to your Hangup URL.
URL

​
The Applications list

Voice Applications page split into three columns - the navigation sidebar on the left, a searchable list of XML applications in the middle showing apps like Vobiz WebRTC Playground and qwerty, and an Application Details panel on the right showing Application ID, Answer URL, Hangup URL, attached phone numbers, and endpoints

Voice Applications - Applications

Three columns top‑to‑bottom:
  1. Search + Create - filter the list by name, or click + Create New Application to open the creation form.
  2. App list - every app on your account. Each card shows the Answer URL, Hangup URL, and a View details link.
  3. Application Details panel - the right side updates when you click a card.

​
What the details panel shows

Below the details, two tabs:
  • Phone Numbers - every DID attached to this application. Click + Attach Number to add more, or Detach to release one.
  • Endpoints - SIP endpoints (softphone logins) routed to this application.

​
Create an XML Application

Click + Create New Application to open the side panel.
Create XML Application side panel with fields for Application Name, Default Number App toggle, Answer URL with HTTP method dropdown and Test URL button, Hangup URL, Fallback Answer URL, Public URI toggle, and Default Endpoint App toggle

Create XML Application form

Use the Test URL button before saving. A green “200 OK” confirms reachability; a red error usually means your firewall is blocking Vobiz IPs - see IP whitelisting.
Generate the XML body your webhook returns with the interactive XML Builder, or hand‑roll it using the XML overview.

​
Attach phone numbers

The final step of the create flow (and a separate + Attach Number action on existing apps) opens the Attach Phone Numbers to Application view.
Attach Phone Numbers to Application screen showing two tabs Current Phone Numbers and Buy New Phone Number, a search field, and a table of 24 numbers with columns Number and Area, Alias, Type, Capabilities, Linked To, and Action with Select or Linked to Application / Trunk badges

Attach Phone Numbers modal

Two tabs:
  • Current Phone Numbers - every DID on your account. The Linked To column shows where each number is currently routed (another App, a Trunk, or unassigned). Only numbers with no link or those linked to this app can be selected.
  • Buy New Phone Number - opens the DID purchase flow without leaving this dialog.
Click + Select on each row you want, then Attach N Selected Numbers at the bottom. You can also click Skip for now and attach numbers later from the details panel.

​
Edit, delete, and disable

The two icons in the top‑right of the details panel:
  • ✏ Edit - opens the same form you used to create the app. URLs, name, and toggles can all change.
  • 🗑 Delete - permanently removes the app. Any attached numbers fall back to the default number app (or stop receiving calls if no default is set).
To disable temporarily without losing the config, edit the app and toggle Public URI off.

​
Tips

  • Keep one Default Number App that points to a small “this number is unconfigured” handler - newly purchased numbers will route there until you wire them up.
  • Use a Fallback Answer URL in production. A 502 from your primary handler is rare, but when it happens you want graceful XML, not a SIP error.
  • The Application ID is the canonical handle for API access - store it in your .env rather than the name.

​
What’s next

SIP Endpoints

Sign softphones into your app for click‑to‑call testing.

XML Reference

Every supported XML verb with examples.