Announcement audit log

Available in version 9.3 and later

The announcement audit log provides a log for tracking and searching announcements played by the system (or not). The system stores the audit log entries in the database and provides search and listing for the records. The audit log is turned off by default.

Supported unified communication platforms: Cisco, Skype for Business

Supported voice announcements:

Cisco: Inbound, Outbound (depending on the ECC profile triggers)
Skype for Business: PSTN Inbound, PSTN Outbound, Federated Inbound, Federated Outbound, Conference

The audit log entries are created by the related services:

Cisco Announcement Service
Lync/SfB Announcement Service

Limitations:

There is no direct link between a recorded conversation and an announcement. Users should use time and participant information to identify the corresponding announcement audit log entry.
Not all types of announcement failures are logged because there could be cases when the related announcement service cannot be reached, etc.

The content of this page:

Configuring audit log for Skype for Business announcements

In order to enable the audit log for Skype for Business announcements, follow the steps below:

Step 1 - Open the Web Interface and go to the System \ Servers. Alternatively, it can be configured at the profile level, under the System \ Configuration Profiles.

Step 2 - Select the server or the configuration profile of the servers where the SfB/Lync Announcement Service is deployed.

Step 3 - Go to the Change Configuration Settings tab.

Step 4 - Expand the Sfb/Lync Recording Announcement \ General node.

Step 5 - Set the Audit Log Enabled setting to Yes.

Step 6 - Click on the icon to save the changes.

Step 7 - A notification banner will appear on the top. Click on the click here link, and you will be redirected to the Configuration Tasks tab. Click on the Execute button in order to execute the changes.

Configuring audit log for Cisco announcements

In order to enable the audit log for Cisco announcements, follow the steps below:

Step 1 - Open the Web Interface and go to the System \ Servers. Alternatively, it can be configured at the profile level, under System \ Configuration Profiles.

Step 2 - Select the server or the configuration profile of the servers where the Cisco Announcement Service is deployed.

Step 3 - Go to the Change Configuration Settings tab.

Step 4 - Expand the Cisco Recording Announcement node.

Step 5 - Set the Audit Log Enabled setting to Yes.

Step 6 - Click on the icon to save the changes.

Step 7 - A notification banner will appear on the top. Click on the click here link, and you will be redirected to the Configuration Tasks tab. Click on the Execute button in order to execute the changes.

Granting access to the announcement audit log

The audit log is available to users with a role where the Announcement Audit Log permission is enabled. In order to grant this permission to a user, change one or more of the roles:

Step 1 - Open the Web Interface and go to Users \ Roles.

Step 2 - Select the roles you want to change.

Step 3 - Under Administrative Permissions / Announcement, check the Announcement Audit Log permission.

Step 4 - Click on Save. Changes will be in effect after the next login of the user(s).

Searching and viewing the announcement audit log

The announcement audit log is available under System \ Announcement \ Audit Log. The page is only available for users with Announcement Audit Log permission (see above).

The audit log contains the following information:

Field	Description
Time	Date and time of the announcement (start)
Recorded Party	The party which is configured for recording and announcement
External Party	The external party to whom the announcement is played
Direction	The direction of the announcement: Incoming: the announcement is played for the caller party in an inbound call Outgoing: the announcement is played for the called party in an outbound call Conference: the announcement is played for a conference participant
Prompt File Name	The name of the prompt file used for the announcement
Prompt Length	The length of the announcement call leg. It does not necessarily match the length of the prompt file, it could be longer than that.
Conference ID	The unique identifier of the conference call. Applies to Skype for Business conference announcements only.
SIP Call ID	The unique SIP call ID of the announcement call leg
Success	Indicates if the announcement was successfully played or not. The system is not able to create an entry for all announcement failers. There could be cases when there is no entry at all.
Error Message	The error message received when the announcement is failed

The audit log page allows searching for audit log entries based on the following criteria:

Time
Recorded Party
External Party
Direction
Success

There are multiple ways to find the audit log entries for a specific recorded conversation. The system is

Users can find the audit log entry using the search screen by entering filters for time and recorder and/or external party.
On the conversation details screen, there is a link on the top right corner, called View Announcement Audit Log link, whihc redirects the user to the audit log search screen pre-populated with the right search criteria.

Exporting the announcement audit log

The announcement audit log can be exported on the audit log search page which is available under System \ Announcement \ Audit Log. The page is only available for users with Announcement Audit Log permission (see above). On the page, once the audit log entries are displayed, the log can be exported to XLS or PDF by clicking on the corresponding link at the bottom of the page. The page by default only retrieves up to 1000 records, whihc can be changed as a system wide configuration.