9 Configuring the Announcement Player Application

This chapter describes how you configure the Announcement Player application.

About the Announcement Player

The Announcement Player is a Service Broker application that plays an announcement at the beginning of a call to a calling party. For example, you can use the Announcement Player to play a welcome announcement to a new subscriber when this subscriber is making the first call.

The Announcement Player communicates with the Orchestration Engine (OE) through IM-ASF SAL interworking module. To play announcements, the Announcement Player uses the Media Resource Function (MRF) that you defined when configuring the SIP SSU.

Figure 9-1 shows the place of the Announcement Player in the overall architecture of Service Broker.

Figure 9-1 Announcement Player Application

Like any other application, the Announcement Player is a part of the orchestration flow. You need to configure the orchestration flow in a way that triggers the Announcement Player when the OE receives an INVITE message. After the Announcement Player has finished playing an announcement, the OE routes the session to the next application in the orchestration flow.

To allow the OE to trigger the Announcement Player, you need to perform the following steps:

1. Set up the instance of IM-ASF SAL and MRF. See "Setting Up the Announcement Player" for more information.

2. Specify the MRF alias and the code of the announcement to be played. See "Configuring the Announcement Player" for more information.

Setting Up the Announcement Player

To set up the Announcement Player:

1. Create an instance of IM-ASF SAL. See the "Managing Interworking Modules" chapter in Oracle Communications Service Broker Processing Domain Configuration Guide for more information.

2. In the Application Server tab, set the parameters as follows:

   • In the SAL Application Address field, type sip:[e-mail].

   • From the SAL Mode list, select INLINE.

3. Specify configuration parameters on the Session Keep Alive and SAL tabs as required. See the "Configuring IM-ASF SAL" chapter in Oracle Communications Service Broker Processing Domain Configuration Guide for more information.

4. Using the Orchestration Studio, add the newly created instance of IM-ASF SAL to the orchestration flow. See the "Specifying IMs" section of the "Building an Orchestration Logic Flow" chapter in the Oracle Communications Service Broker Orchestration Studio User's Guide for more information.

5. To trigger the Announcement Player when it receives an INVITE message, in the Orchestration Studio, add the condition for routing the session to the IM-ASF SAL and check whether the SIP Method is INVITE. See the "Adding Conditions" section of the "Building an Orchestration Logic Flow" chapter in the Oracle Communications Service Broker Orchestration Studio User's Guide for more information.

6. Using the SIP Network Entities tab in the SSU SIP configuration screen, specify the alias and the physical address of the MRF that the Announcement Player uses. See the "Configuring SIP Network Entities" section of the "Configuring SIP Signaling Server Units " chapter in the Oracle Communications Service Broker Signaling Domain Configuration Guide for more information.

Configuring the Announcement Player

To configure the Announcement Player:

1. In the navigation tree, expand the OCSB node.

2. Expand the Processing Tier node.

3. Expand the Applications node.

4. Select the Announcement Player node.

5. In the mrf-alias field, enter the alias of the MRF that the Announcement Player should trigger to play the announcement.

   This alias must correspond to the alias that you defined when configuring SIP network entities in the SIP SSU. See the "Configuring SIP Network Entities" section of the "Configuring SIP Signaling Server Units " chapter in the Oracle Communications Service Broker Signaling Domain Configuration Guide for more information.

6. In the announcement-code field, enter the code of the announcement that the MRF should play.

7. Click Apply.