Number Rewriting

Number rewriting is a feature that consists of sets of rules defined by users. Acrobits Softphone uses these rules to take specific actions(s) when certain condition(s) meet before placing a call.

The primary purpose of this feature is to modify numbers from your address book before they are dialed using the app.

To read examples using number rewriting, go to the links in the Related topics at the bottom of this page.

Number Rewriting Rules

Number rewriting rules comprise condition(s) and actions(s). The user specifies the rules, Acrobits Softphone then applies the desired action(s) when the condition(s) meets.

Conditions rules:

Starts with - State a specific prefix that phone numbers start with. Doesn’t start with - State a specific prefix that phone numbers do not start with. Equals - State a specific phone number. Length equals - State the number of digits of phone numbers. Shorter than - State the number that the length of phone numbers is lesser than. Longer than - State the number that the length of phone numbers is longer than. Network type - State the network as Wi-Fi, Cellular, Any, or None. SSID - State the Service Set Identifiers (SSIDs) which is also the Wi-Fi network name. Contains - State the specific number that phone numbers have. Is numeric - State when phone numbers are numeric.

Action rules:

Replace with - Changes to the stated value. Note: This rule works with conditions rules Starts with, Doesn't start with, Equals, and Contains only.

Prepend - Adds a prefix to the beginning of phone numbers. Append - Adds a suffix to the end of phone numbers. Try others - Checks and apply the next rules listed on the Number rewriting screen.

Override dial-out account - Enable or disable to use the selected SIP account to place specific calls, regardless of the active account in use. Note: This rule is visible in the SIP account-specific number rewriting rules only.

Record call - Records calls.

Override dial action - Uses Auto call, Voice call, Video call, GSM call, Callback, Call-through, Message or Send a Message, Show Options, or No action or Do Nothing. Note: See the description of these options at doc.acrobits.net/cloudsoftphone/dialactions.html#dialactions.

Reject call - Dismisses the call. Note: This rule is visible in the global incoming call processing settings only.

Forward call - Redirects the call to the specified number stated in the Forward to field. Note: This rule is visible in the global incoming call processing settings only.

Answer immediately - This application answers the call when the state condition(s) meet. Note: This rule is visible in the global incoming call processing settings only.

Set header - When setting a SIP header for outgoing SIP calls, include the header name and its value in the parameter. For example, to achieve &ltaction type="setHeader" param="X-Condition-Matched: true"/&gt, set X-Condition-Matched

. Override location policy - Sets the location data sharing as None, Optional, Optional with wait, or Required. Show alert - Displays an alert message on the screen when placing the calls.

Number Rewriting Types

Users can set global number rewriting rules and SIP account-specific number rewriting rules.

Global settings apply to the entire application:

Number rewriting - Use this to alter the numbers dialed from Acrobits Softphone, before placing the call. Incoming call processing - Use this to alter the incoming call numbers or to apply specific rules for incoming calls.

SIP account-specific settings allow multiple account users to manage Number rewriting rules for a specific account. Use this to alter the dialed numbers, before placing the call from that specific SIP account.

Setting Global Number Rewriting

Global settings apply to the entire application and are suitable for the following scenarios:

Single SIP account users Multiple account users who want to configure a single set of global rules that apply to all SIP accounts.

To set global number rewriting rules:

To open the Preferences screen:

Android devices - On the Main screen, select > Settings > Preferences. iOS devices - Open the Keypad tab, select > Preferences.

Select one of the following options as required:

Number rewriting Incoming call processing.

Select the + Add Rule button. The Rewriting Rules screen displays.

On the Rewriting Rules screen, select the + button beside Conditions, and then select a Condition type. In the new entry displays below Conditions, specify a required value. Select the + button beside Actions, and then select a Action type. In the new entry displays below Actions, specify a required value. (Optional) To set more Conditions or Actions, repeat step 5 to 9. Select Back or DONE. After making changes to any existing rules, select or Save to save the setting.

The following video demonstrates how to set up the global Incoming call processing to automatically add a prefix to a phone number and to start recording the call once it is answered.

Setting SIP Account-Specific Number Rewriting

The account-specific rules setting is for multiple SIP account users who want to configure rules for a specific account only.

To set number rewriting rules for a specific SIP account:

To open the Accounts screen:

Android devices - On the Main screen, select > Settings > Accounts. iOS devices - Open the Keypad tab, select > SIP Accounts.

Select the desired SIP account. Select Advanced Settings > Number rewriting.

On the Number rewriting screen, select the + Add Rule button. The Rewriting Rules screen displays.

To set Conditions or Actions, follow step 3 to 10 in the Setting Global Number Rewriting section.

The following video demonstrates how to set up a number rewriting rule for a specific SIP account. This rule says that Acrobits Softphone starts recording the call for a specific number once it is answered.

Arranging Number Rewriting Rules

If you have multiple rules, you can prioritize them by arranging their order. Acrobits Softphone applies the rules according to the sequence from top to bottom.

Android iOS

Open the desired number rewriting function. Touch and hold the icon beside the rules, and then move it up or down as required.

Open the desired number rewriting function. Select EDIT. Touch and hold the icon beside the rules, and then move it up or down as required. Select DONE.

Deleting Number Rewriting Rules

To delete a number rewriting rules:

• Android devices - Touch and hold and then select Delete, or touch and slide the rule to the left or to the right.

• iOS devices - Touch and slide the rule to the left.

To delete any Conditions or Actions:

• Android devices - Touch and hold the entry and then select Delete.

• iOS devices - Touch and slide the rule to the left.

Related topics:

Go to the following pages for more information:

• About number rewriting and examples - faq.acrobits.net/number-rewriting

• Address book matching for incoming call number rewriting and examples - faq.acrobits.net/address-book-matching.