ContactivityDocs
Voice appsMarkdown

Voice apps

A voice app answers calls with your own logic, hosted on your server. Voice apps are under Voice > Voice Apps.

To handle calls without code, see Flows and PBX apps.

Kinds

Kind How it works
CoXML (markup over HTTP) For each call we fetch instructions from your Voice URL. CoXML is compatible with TwiML.
Call Control (webhooks + REST) We send call events to your Webhook URL. Your server controls the call with the API.

The kind cannot be changed after creation.

Create an app

  1. Select Create app.
  2. Enter a Name and pick the Kind.
  3. Pick the Callback format: Contactivity (recommended), or Twilio-compatible for code you are moving from another provider.
  4. For CoXML: enter the Voice URL and Method. Optionally set a Fallback URL, Status callback and Hangup URL.
  5. For Call Control: enter the Webhook URL and optionally a Failover URL.
  6. Select Save.

Connect a number

Route a number to the app with CoXML app or Call Control app. See Route a number.

Enable and archive

Select Disable in the app's ⋮ menu to stop it. A disabled app rejects the calls routed to it. Enable turns it back on.

Archiving cannot be undone. An app that a number routes to cannot be archived. Change the routing first.

For developers

CoXML, Call Control and the API are documented on the developer site.