Announcement audit log
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, Microsoft Skype for Business, Microsoft Teams
Supported voice announcements:Â
- Cisco: Inbound, Outbound (depending on the ECC profile triggers)
- Microsoft Skype for Business: PSTN Inbound, PSTN Outbound, Federated Inbound, Federated Outbound, Conference
- Microsoft Teams:Â PSTN Inbound, PSTN Outbound, Federated Inbound, Federated Outbound, Internal
The audit log entries are created by the related services:
- Cisco Announcement Service
- Lync/SfB Announcement Service
- Microsoft Teams Bot 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 Microsoft Teams announcements
In order to enable the audit log for Microsoft Teams 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 Microsoft Teams Bot Service is deployed.
Step 3 - Go to the Change Configuration Settings tab.
Step 4 - Expand the  Microsoft Teams Bot / General node.
Step 5 - Set the Audit Log for Customisable Announcement 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 Microsoft Skype for Business announcements
In order to enable the audit log for Microsoft 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:
|
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. For Microsoft Teams, the length is always 00:00, because the Microsoft SDK cannot provide the information. |
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. For Microsoft Teams, this is the Technical Call ID of the recorded call. |
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 in the top right corner, called View Announcement Audit Log link, which 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, which can be changed as a system-wide configuration.