Dial Actions

Overview

Dial Actions are “commands” which tell Acrobits client what to do with the particular number. In Cloud Softphone, it’s possible to configure which dialAction will be performed when dialing the number by single-tap, long-press and 3D-touch on iOS devices which support it.

For example, you can configure the “call” button in keypad screen to do a SIP call for single-tap and cellular call on long-press, or show all available dial actions as a menu on single tap.

There are two kinds of Dial Actions. The Basic Dial Actions are hard-coded into the app and provide the elementary operations on the dialed number. Programmable Dial Actions can be defined by the user or provisioned by provider and may be used to control advanced PBX features or provide any other advanced functionality.

Basic Dial Actions

The table below lists the supported dial actions.

dialAction Description
autoCall
start a VoIP call. The video will be enabled based on the value in
autoSendVideo preference key.
voiceCall
start a voice-only VoIP call
videoCall
start a VoIP call with video
gsmCall
dial the number via cellular network
webCallback
triggers webCallback. Web service will be called with the given number and
an incoming call will be expected.
callThrough
triggers call-through. In case a web service is defined, it will be asked for
access number and dial string, otherwise the preconfigured access number will
be used.
text
compose a new text message to the given number.
openUrl
Opens an external browser with an URL defined in Account XML and passes the
number as a parameter.
options
shows a menu with all applicable dial actions for the given number.
customOptions
shows a menu with just the dial actions configured for the app. See
Programmable Dial Actions.
forceOffnetCall
For “smart” contacts, Acrobits apps always prefer to make on-net call. This dial
action will force an off-net call to the PSTN number.

Programmable Dial Actions

Programmable Dial Actions use Number Rewriting rules and conditions to define how is the given number or SIP uri going to be dialed. When the action is triggered, the rules may modify the number by adding special codes before or after, replace parts of the number, set flags like whether the call should be recorded by the app or not and which of the Basic Dial Actions should be used to actually do something with the number.

Programmable Dial Action should always resolve to some Basic Dial Action on a number which may be a modified version of the original number. The most simple Programmable Dial Action would only have one overrideDialAction rule (without any condition) which sets the action to one of the Basic Dial Actions defined above.

For details about the format and provisioning or Programmable Dial Actions, please refer to the web service documentation at Dial Action Provisioning.