Settings - Manipulation
-
OSS/BSS Answers
Access Control Admin Audit B3Network Master Account Channel App Contract App Customer App Discount App Edge Server File Management Finance App Invoice App Number Management Payment Portal Settings Price List Product App Release V2 SMS Gateway Supplier App Support Center Support Hub Business Hub Sales Hub
- App Model - Organization Management
- App Model - Communication Apps Answers
- License Model - Organization Management
-
License Model - CPaaS Solution Answers
Phone System - Admin Guide Phone System - End-user Guide Mobile App Desktop App Web Phone Auto Attendant - Admin Guide Developer Hub - Admin Guide Microsoft Teams Operator Connect - Admin Guide Microsoft Teams Direct Routing - Admin Guide Contact Center - Supervisor Guide Contact Center - Agent Guide Omni-Channel SIP Trunk CPaaS - SIP Trunk Power SIP Trunk CPaaS Fax Contact Dashboard Campaign File Explorer
- Telcoflow
- Integrations Answers
- Updated Regulations
- Ideas Portal
Table of Contents
Introduction
The variances among SIP networks, such as incompatible interconnection, can disrupt SIP operations. In order to resolve these problems, Edge Server provides SIP Header Manipulation, giving Edge operators the ability to control SIP traffic by manipulating SIP messages.
Shortly, Manipulation is to modify SIP Header.
Functions
- Add custom SIP Header, Parameters
- Capture information from a message and insert it into another message
- Remove all custom SIP headers
- Execute the change if the condition is satisfied
- Drop call or Log message if the condition is not satisfied
Contract
- Manipulation rule is only applicable to Outbound Trunk.
- Manipulation rule has a restriction to protect Edge Function, which does not allow to modify native SIP Header or native Session Variable.
- X-EDGE and V-EDGE are reserved for Edge and not available to modify.
- X- indicates custom SIP Header
- V- indicates custom Session Variable
Parameters
Parameter | Role | Description |
---|---|---|
Conditions | Optional | Conditions are the set of conditions (max 5 rules) that will be used to decide which action to be performed in Statements or Else Statement. If no conditions is set, it means always matches > always trigger actions in Statements. |
Statements | Required | Sequence of actions (max 5 rules) to perform if conditions match. |
Else Statement | Optional | Sequence of actions (max 3 rules) to perform if conditions do not match. |
1. Conditions
Parameter | Role | Description |
---|---|---|
variable | Required | Session Variable or SIP Header, SIP Params |
pattern | Required | The regex is used to define a search pattern |
2. Statements
Parameter | Role | Description |
---|---|---|
reference | Optional | Session Variable or SIP Header, SIP Params |
pattern | Optional | The regex is used to define a search pattern |
target | Required | New Variable (V-) or new Header (X-) |
values |
Required |
The list of values which can be fix chars, or back-reference from reference with pattern
|
3. Else Statement
Parameter |
Role |
Description |
---|---|---|
action |
Required |
2 available actions:
|
param |
Required |
String base, depending on the value of action:
|
The pattern must follow Perl Compatible Regular Expressions (PCRE) syntax.
Syntax Description
The below table shows most formalisms provide the following operations to construct regular expressions.
![](https://d2x3xhvgiqkx42.cloudfront.net/c94ab348-5fb1-4c1d-89b1-fa79e3e916d0/81ec6e6f-2b1b-45dc-9193-b23c4a10d966/2021/05/21/639d54e7-73ae-4827-8dba-a8a456bc796f/01fd58ac-eb74-4936-b172-d27679273efc.png)
How to create a new manipulation rule
1. Go to Settings > Manipulation > New profile
![](https://d2x3xhvgiqkx42.cloudfront.net/c94ab348-5fb1-4c1d-89b1-fa79e3e916d0/81ec6e6f-2b1b-45dc-9193-b23c4a10d966/2021/05/21/17c1ef86-a9ef-4ef3-8b7e-4c1fc6ba9c0d/c3209ba9-d6ec-41dd-9691-4a9abb0cb6f8.png)
Fill in Conditions (optional) > Statements (required) > Else Statement (optional) > Create
![](https://d2x3xhvgiqkx42.cloudfront.net/c94ab348-5fb1-4c1d-89b1-fa79e3e916d0/81ec6e6f-2b1b-45dc-9193-b23c4a10d966/2021/05/21/6167cbd6-8040-45e9-b61a-705f4c6c5a5f/7696dca4-c2a9-4ea2-8d9e-95a55d13afa4.png)
3. Finish
![](https://d2x3xhvgiqkx42.cloudfront.net/c94ab348-5fb1-4c1d-89b1-fa79e3e916d0/81ec6e6f-2b1b-45dc-9193-b23c4a10d966/2021/05/21/b6a37b3f-b40e-4f25-ad37-0916ead1f224/1ea86f7c-2c98-4db4-a7bf-2368cabf0351.png)