Hosted SIM API

TwiML

Your answer to a call is a TwiML document: XML with <Response> at its root. v1 supports the verbs below. Anything else, an unknown verb or an unsupported attribute value makes the whole document invalid: 720001 (naming it) or 720002.

Supported verbs

Verb Supported Notes
Play loop, digits wav, mp3 or µ-law audio from your URL
Pause length (1-60)
Gather input="dtmf" only, action, method, timeout, finishOnKey, numDigits, actionOnEmptyResult; nested Play and Pause The first key press stops the nested audio at once
Hangup Before the answer, the caller hears voicemail
Reject reason (accepted, ignored) The caller hears the SIM's voicemail, not a busy tone
Redirect method Doesn't answer the call
Connect><Stream url, name; nested Parameter Two-way live audio (Media Streams). One per call
Start><Stream / Stop><Stream url, name, track One-way live audio
Message to, action, method Sends a text from your line, during a call too
Dial><Sip timeout, action; your line's own SIP login only Incoming calls only, and only as the first verb

When the dongle answers

It answers only when your TwiML reaches a verb that needs audio: Play, Pause, Gather, Connect or Start. Message and Redirect keep the call ringing. Reject, Hangup, or a document that ends with the call unanswered, all send the caller to the SIM's voicemail.

Limits per call

Up to 20 TwiML fetches, 200 verbs and 60 seconds of total fetch time. Past that, the call ends with 720003.

Not in v1

Say, Record, Dial to a number, client, conference or queue, Enqueue, Leave, Pay, Prompt, Refer, Connect><Room>, Connect><ConversationRelay>, Connect><VirtualAgent>, Siprec and Transcription. Each is refused with 720001.