AudioHook Monitor overview

AudioHook Monitor is a mechanism and generic protocol to provide a near real-time stream of voice interactions from the Genesys Cloud platform to any third-party service endpoint. AudioHook Monitor enables partners and customers to extend the open Genesys Cloud platform with services that require monitoring voice interactions in near real-time. For information on how to implement an AudioHook Monitor connection, see the AudioHook Protocol Specification in the Genesys Cloud Developer Center. For information about how to showcase a simple service that implements the Genesys AudioHook protocol, see Genesys AudioHook Sample Service in the Genesys Cloud Developer Center.

Companies use AudioHook Monitor to stream near real-time conversational audio and metadata to customers and partners so that they can support multiple monitoring use cases in parallel.

To troubleshoot your AudioHook protocol-based integration, subscribe to AudioHook-related operational events. For more information about operational events, see Operational Event Catalog in the Genesys Cloud Developer Center. For more information about how to set up the Operational Console, see Troubleshoot using the Genesys Cloud Operational Console.

Notes:
  • Genesys Cloud supports up to five AudioHook Monitor integrations. This limitation is not configurable by your organization.
  • Genesys Cloud charges during the connection but not for secure or client-initiated pause.
  • Create AudioHook Monitor servers in the same or near region to keep latency to a minimum.
  • AudioHook Monitor is not supported under BYOC Premises.
  • AudioHook Monitor is not supported for premises-based Edge (LDM).
  • Audiohook does not store data; it only streams audio to the third-party. Genesys does not support using AudioHook for data storage.

PCI DSS compliance

This feature adheres to PCI DSS compliance when secure pause runs during secure flows. However, you cannot use it for PCI use cases to stream audio during secure flows. Best practice recommends that you do not use AudioHook Monitor to process audio during PCI-relevant interactions such as Architect secure flows. For more information, see PCI DSS compliance.

For PCI-relevant data collection, the Genesys Cloud secure pause feature temporarily stops the recording and transcription. By association, this feature also pauses AudioHook Monitor streaming of PCI-relevant phases of an interaction.

Click the image to enlarge.

AudioHook streaming protocol diagram

When you use AudioHook Monitor, the voice call audio streams to Genesys Cloud over a web socket. The Architect Audio Monitoring action enables AudioHook Monitor to start or stop streaming to a third party. You can also add the transcription to a queue and have AudioHook Monitor work on that particular queue.

After your platform analyzes the audio and enables you to perform an action or implement a process through third-party applications according to your organization’s goals and needs. 

Supported features

When you stream Genesys Cloud interactions through an AudioHook Monitor, you can monitor interactions for passive biometrics, transcription, recording, agent coaching, speech analytics, sentiment analysis, and agent assist. We enable multiple streams and use cases to run in parallel. An arbitrary number of streams to third parties means that any partner can build a solution that can listen in on calls to add value. Use cases include:

  • Stream audio to a third-party service that implements the AudioHook Protocol using WebSockets
  • Stream audio to two third-party services at the same time
  • The third-party service can pause, resume, and end the audio streaming
  • Pause the streaming in secure flows (for more information about pauses and other limitations, see Limits > AudioHook in the Genesys Cloud Developer Center)
  • Return data in-band for real-time call analytics
  • Monitor customer participants during the AudioHook sessions as they converse with other participants (for example, with a bot or agent)
  • Channel-separated audio streams
  • Voice biometrics; for example, verbal recognition of passwords
  • Language work for non-native Genesys Cloud features 

For more information, see About AudioHook Monitor.