Conversation direction detection using internal domain and number patterns

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

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

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