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 DirectionDescription
InternalBoth participants are a match for the defined pattern
ExternalNeither of the participants is a match for the defined pattern
IncomingOnly 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 DescriptionExample 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 end1213[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 end1213[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 numbers1213|1214|1215