Number Rewriting

Number rewriting in Acrobits Softphone and Groundwire can format your contacts before making a call. This is useful when SIP numbers need to be dialed differently from the regular phone number (GSM).

The main purpose of number rewriting is to enable you to dial from your native contacts without having to create new contacts. It can also be used to ensure certain numbers are dialed from a specific SIP account on the client, regardless of whether the account is currently active for outbound calls.

Our softphone application has two levels of number rewriting function:

• Global - affects all accounts on the softphone.
• SIP account-specific - applies only to that a specific account.

Setting Number Rewriting

To set the global number rewriting rules:

1. To open the Preferences screen:

   • Android devices - On the Main screen, select > Settings > Preferences.

   • iOS devices - Open the Keypad tab, select  > Preferences.

2. Select one of the following options as required:

   • Number rewriting

   • Incoming call processing

   • (Groundwire only) Custom dial actions.

3. Set the rules and actions.

The SIP account-specific number rewriting affects a specific account only. To set the SIP account-specific number rewriting rules:

1. To open the SIP account screen:

   • Android devices - On the Main screen, select > Settings > Accounts.

   • iOS devices - Open the Keypad tab, select > Accounts or SIP Accounts.

2. Select the desired SIP account.

3. Select Advanced Settings > Number rewriting.

4. Set the rules and actions.
5. Select  or Done to save the setting.

Conditions and Actions Rules

Rules consist of conditions and actions. When certain conditions are met, the app takes specific actions before placing a call.

Conditions:

• 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. For example, if you specify 7, all numbers with 7 digits apply the action.

• Shorter than - State the number that is shorter than a specified length.

• Longer than - State the number that is longer than a specified length.

• 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.

Actions:

• Replace with - Substitute the entire number with 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 the numbers.

• Append - Adds a suffix to the end of the numbers.

• Try others - Rules are gone through in descending order from the first on the list to the last. Normally, once a number meets a condition, only the actions of that condition are completed. Using Try others assures that actions for any other rules that the number meets the conditions for are applied too.

• Override dial-out account - Force a specific SIP account to place the call, 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 <action type="setHeader" param="X-Condition-Matched: true"/>, set X-Condition-Matched:true.

• 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.

Examples of Use

(1) Prepending Codes

Your contacts are stored with the area code and number, such as 904 555 1212. However, you need them to be dialed with a leading 1 for your SIP account, such as 1 904 555 1212.

Steps:

1. 1. Select the + Add Rule button.

   2. On the Rewriting Rules screen, select the + button beside Conditions, select Starts With, and then enter 904 in the field.

   3. (iOS only) Select Done.

   4. Select the + button beside Actions, select Prepend, and then enter 1 in the field.

All numbers beginning with a 904 area code are automatically prepended with a 1.

Besides this basic example, you can program rules such as adding country codes and replacing + with 00.

(2) Dialing from a Specific SIP Account

You have several SIP accounts, one with great rates for France. You regularly call several contacts in France. You want to ensure all calls to France go through this account. Fortunately, all your French numbers are in the correct format for your SIP provider, such as beginning with 0033, but you want an easy way to make sure that all French numbers are called using this account.

Steps:

1. 1. Select the + Add Rule button.

   2. Select the + button beside Conditions, select Starts With, and then enter 0033 in the field.

   3. (iOS only) Select Done.
   4. Select the + button beside Actions, and then select Override Dial-Out Account.

All numbers beginning with 0033 are always dialed using this SIP account.

This is a basic example; you can make the rule more specific if needed.

(3) Videos

The following videos demonstrate how to use number rewriting on the apps:

• Groundwire
  

   
• Acrobits Softphone