Announcements - Pre-Call - Destination Number

 

 

Pre-Call Announcements enable the IMG 2020 to play a treatment back to an originating number before outbound routing takes place. Informing a caller of any additional charges before proceeding with the call would be one form of Pre-Call announcement. After the pre-call announcement, the call proceeds as normal to the outbound side. If this feature is used, translation table re-run is not performed.

Diagrams

The Pre Call Announcement feature uses the Service Route Table in addition to standard routing tables to configure the feature to function. A typical pre-call announcement call flow is displayed below.

Based on Destination Number

Functionality

Test

Description

SS7 Continuity Test (COT)

If SS7 continuity testing is required on the inbound call leg, the continuity procedure should be completed before the announcement will be played, even if the outbound leg is using the SS7 protocol as well.

If an incoming SS7 IAM requests continuity test, indicated in nature of connection indicator parameter the behavior is as follows. If the Continuity Check Indicator is not 0, I2020 IMG waits for 10 seconds for the continuity test success event. Once COT with test success is received within this time, treatment will be played.

Call Tracing

The following information will be present in the call tracing

DPE output: Invoke Service [Branding Service]

Router table used to get treatment information

Apply treatment:  table ID and treatment ID

Treatment completed

Errors

In the event that an internal error occurs during Service Route processing, the call will be allowed to complete without interruption. An Internal error may be:

Router response time out

Router response NACK

No treatment information found on service route table

Any NACK from L4

SS7 continuity test time out.

Miscellaneous

If “bearer capability” information is present in the incoming signaling setup message, the announcement is made only if the value of “Information Transfer capability" is one of the following:

Speech (0x0)

Audio(0x10)

Unrestricted digital information(0x8)

Unrestricted Digital Information w/ Tone & Announcement (0x11)

 

Rerun option in a translation entry will not work if service table is selected in that entry.

Configuration

Before the Treatment Table can be associated with a channel group for routing, the announcements need to be retrieved from either an NFS Server, SD Card, or through an HTTP download and downloaded to the IMG 2020. Also, the Treatment Table with associated Treatment Entries and phrases need to be configured. Verify the functionality of the topics below have been configured and are running before starting the Pre Call announcement procedures.

In addition to the topics above. the procedure also assumes that the IMG 1010 - Basic Configuration topic has already been configured.

Example 1 - Pre-Call Announcement

In the example below an announcement will be played before the call is routed. Routing will be based on the Dialed Number scenario.

Configure Service Route Table and Element

A Service Route Table will be configured so when the incoming Dialed Number has the first three digits set to 555 the call will be routed to a Treatment Table. Refer to procedure below.  

  • Right click on Routing Configuration object and select New Service Route Tables. The Service Route Tables object created is a parent or container object and no configuration is needed in this object. Refer to the Service Route Tables topic for more information on this object.

  • Right click on Service Route Tables object just created and select New Service Route Table. A Service Route Table object gets created. Either enter a name in the Name field or accept the default. In this example, SrvRte_PreCa was the name entered. For more information on configuring the Service Route Table object, refer to the Service Route Table topic.

  • Right click on Service Route Table created and select New Service Route Element. A Service Route Element object gets created. Refer to screen capture below.

 

 

  • Entry ID - The Entry ID is automatically populated with next available ID.

  • Enable - Select True which will enable this Service Route Table Element.

  • Routing Criteria - This example is using the Dialed Number as a routing criteria which allows routing on a specific set of digits.

  • Router String - Enter the string of digits that are matched on incoming call. In this example any numbers with 555 as its first three digits will be flagged.

  • Route Action Type - Select either Treatment Table or Service TOD Table. In this example, Treatment Table was be selected since there was no Service Time Of Day objects created.

  • Treatment Element - Select which Treatment Element object which is under the Treatment Table object to play before routing the call. The announcement in the Treatment Element will play through its entirety before the call is routed.

 

  • The Route Table object under the Service Route Tables object, will display a yellow exclamation point. This icon indicates the configuration needs to be downloaded to the IMG 2020. Click on the Route Table object and then click the Download Routing Table button and the configuration will then be downloaded.

Configure Translation Table and Translation Table Element

Configure a Translation Table that will take the incoming call, match on the first three digits. If the first three digits are 555 then route the call to the Service Route Table created above

  • Right click on Routing Configuration and select New Incoming Translation Tables. The Incoming Translation Tables object is a container object and no configuration is needed here. Refer to the Incoming Translation Tables topic for more information on this object.

  • Right click on Incoming Translation Tables and select New Translation Table. In the object that appears enter a name to identify this Translation Table. In this example the name given is Inc_TransTable_1. Refer to the Translation Table topic for more information on this object.

  • Right click on the Incoming Translation Table and select New Translation Element. A Translation Element as displayed below will get created.

 

  • Entry ID - The Entry ID is automatically populated with next available ID.

  • Enable - Select True which will enable this Translation Element.

  • String To Match - This example is using the Dialed Number as the routing criteria which allows routing on a specific set of digits.

  • Router String - Enter the string of digits that are matched on incoming call. In this example any numbers with 555 as its first three digits will be flagged.

  • Service Routing  - Select from drop down menu the Service Route Table created above.


For more information on configuring the individual fields, refer to the topic.

  • The Translation Table object under the Incoming Translation Tables object, will display a yellow exclamation point. This icon indicates the configuration needs to be sent to the IMG 2020. Click on the Translation Table object and then click the Download Translation Table button and the configuration will then get downloaded to the IMG 2020.

Configure the Incoming Channel Group

Configure the Incoming channel group that will accept the call then configure the outgoing channel group that the call will be routed to after the pre-call announcement has been played.

The Channel groups will be incoming/outgoing. This procedure is configuring one way routing. It is up to the user to configure routing in the opposite directions

  • Right click on Routing Configuration and select New Channel Groups. The Channel Groups object is a container object and no configuration is needed here. Refer to the Channel Groups topic for more information on this object.

  • Right click on Channel Groups object and select New Channel Group. Refer to the screen capture below. The Channel Group will be an SS7_ISUP channel group and the name entered in the Name field is ChGrp_PreCall. Refer to the Channel Group topic for more information on configuring a Channel Group.

  • In the Incoming Translation Table field, select from the drop down menu the Translation Table created earlier. The Translation Table selected routs to a Service Route Table.

Configure Outgoing Channel Group

Right click on Channel Groups object again and select New Channel Group. See screen capture below. The Channel Group will be a SIP channel group and the name entered will be ChGrp_out_SIP. Refer to the topic for more information on configuring a Channel Group.

The Channel Groups object will display a yellow exclamation point. This icon indicates the configuration needs to be sent to the IMG 2020. Click on the Channel Groups object and then click the Download Resource Tables button and the configuration will then get downloaded to the IMG 2020.

Configure Route Table and Route Table Entries

Configure a Route Table and Route Entries that will route the call after the Pre-Call Announcement has been played to the outgoing channel group created.

  • Right click on Routing Configuration object and select New Routing Tables. The Routing Tables object is a parent or container object and no configuration is needed here. Refer to the Routing Tables topic for more information on this object.

  • Right click on the Routing Tables object and select New Route Table. Enter a name in the Name field that describes the Route Table being configured. In this example the Name given is RouteTable1_PreCall. Refer to the Route Table topic for more information on configuring the individual fields in this object.

  • Right click on the Route Table just created and select New Route Table Element. Since Routing will be determined on the first three digits in the incoming string, the Router String will be 555&.

  • In the Route Action Type field select Channel Group from drop down menu.

  • In the Outgoing Channel Group field just below, select the outgoing channel group configured earlier. This is the channel group that the call will route to after the announcement has been played. Refer to screen capture below.

Refer to the Route Table Element topic for more information on configuring this object.

  • The Route Table object will display a yellow exclamation point. This icon indicates the configuration needs to be sent to the IMG 2020. Click on the Route Table object with the yellow exclamation point and then click the Download Routing Table button. The configuration will then get downloaded to the IMG 2020.

Link the Route Table on Outgoing Side to the Incoming Channel Group

  • Click on the Channel Group on the incoming side labeled ChGrp_PreCall and in the Route Table field select the Route Table that routes the call to the outgoing Channel Group after the Pre-Call announcement has been played. Refer to screen capture below.

  • The Channel Groups object will now display a yellow exclamation point as an icon. This icon indicates the configuration needs to be sent to the IMG 2020. Click the Channel Groups object and then click the Download Resource Tables button in each object and the configuration will then get downloaded.

Return to Documentation Home I Return to Sangoma Support