Skip to content
Contactivity

Programmable voice

Programmable voice lets your own code answer, place and control calls. Pick the model that fits: markup over HTTP, or events and REST actions.

How it works

  1. 1

    Create a voice app

    Pick CoXML or Call Control. The kind is fixed once the app is created.

  2. 2

    Answer with your code

    CoXML: for each call we fetch your voice URL and run the document it returns. Call Control: events go to your webhook and your server answers with API actions.

  3. 3

    Connect a number

    Route a number to the app for inbound calls, or place outbound calls with the Calls API.

Features

CoXML
Say, play, gather, dial, record, enqueue, stream and more. CoXML is compatible with TwiML. A fallback URL runs when your voice URL fails.
Call Control
Events such as call.answered and call.gather.ended go to your webhook. Answer with actions: speak, gather, bridge, transfer, record, hang up.
Building blocks
Conferences, queues, recordings and transcriptions, and answering machine detection.
Streams and live transcription
Stream call audio to your WebSocket, and receive live transcripts as events.
Signed webhooks
Every webhook and CoXML fetch is signed, and each delivery is logged.
No-code options
Flows built on a canvas, and ready-made phone menus, ring groups and voicemail.
In-app calling
Browser and mobile SDKs make and receive calls with short-lived access tokens.
Move existing code
CoXML is compatible with TwiML and TeXML, and Plivo XML runs too. Compatible callback formats and APIs keep the changes small.

Answer a call

<!-- Returned by your voice URL for each call --><Response>  <Gather input="dtmf speech" numDigits="1" action="/menu" timeout="5">    <Say>Press 1 for sales, or 2 for support.</Say>  </Gather>  <Say>We did not get that. Goodbye.</Say></Response>

Request in, events out

Questions

CoXML or Call Control?

CoXML when your server returns instructions for each step of the call. Call Control when you want events and to drive the call with API actions.

Can I move code from another provider?

Yes. CoXML is compatible with TwiML, and a compatible callback format and compatibility APIs keep the changes small.

Can I build a call flow without code?

Yes. Use a flow on the canvas, a phone menu, a ring group or voicemail.

Start in the sandbox

Try trunks, voice apps and flows with calls to your own verified numbers, before you add a card.

Create an account