Conversation direction detection using internal domain and number patterns
Overview
This feature allows proper call direction detection for recordings. It is essential when call direction is used in recording rules. By using a simple pattern (regular expression), the system is able to distinguish internal and external participants and set the call direction properly.
The following call directions are available:
| Call Direction | Description |
|---|---|
| Internal | Both participants are a match for the defined pattern |
| External | Neither of the participants is a match for the defined pattern |
| Incoming | Only the called party is a match for the defined pattern |
| Outgoing | Only the caller party is a match for the defined pattern |
Internal Domain, Numbers Pattern Configuration
The configuration is available for multiple services. Refer to the corresponding configuration guide for more information.
In multi-tenant environments, if an internal pattern regular expression is defined in both the environment and in a service configuration, the pattern specified in the environment configuration is used to determine the internal values, not the pattern defined in the service configuration.
All settings should contain the same pattern. Otherwise, it can lead to missing recorded conversations when "Recorded Directions" condition is set as something different than "all".
Example Patterns
For regular expression language please refer to https://msdn.microsoft.com/en-us/library/az24scfc(v=vs.110).aspx.
To check and validate your regular expressions, you can use: http://www.regexr.com/.
Example domains, numbers:
- 1{DID}@128.144.122.12
- 12143221234@128.144.122.12
- some_extension_name@128.144.122.12:5080
- other_extension_name@voip.example.com
- extension_name@123456_subaccount
- {DID}@123456_subaccount
| Example Description | Example Pattern |
|---|---|
| Match your domain | .*@yourdomain\.com |
| Match SIP URI that starts with "verba" plus one or more charaters and ends with "@yourdomain.com" | verba(\w+)@yourdomain\.com |
| Match extension name that starts with "ext" plus one or more charaters and ends with "@128.144.122.12:5080" | ext(\w+)@128\.144\.122\.12:5080 |
| Match one digit numbers | [0-9] |
| Match four digit numbers | [0-9]{4} |
| Match numbers that start with 1213 and has one or more numbers at the end | 1213[0-9]+ |
| Match numbers that start with +1213 and has one or more numbers at the end | \+1213[0-9]+ |
| Match numbers that start with 1213 and has 3 additional numbers at the end | 1213[0-9]{3} |
| Match optional + sign at the beginning of a number | \+*1213 |
| Multiple conditions, match numbers that start with +12 or +13 plus one or more numbers at the end | \+(12|13)[0-9]+ |
| Multiple conditions, SIP URI / numbers | .*@yourdomain\.com|1213[0-9]+ |
| Multiple conditions, multiple numbers | 1213|1214|1215 |