Technical Overview

Prev Next
Warning

This is an internal document and is for Sestek employees only and will not be accessible if shared with other parties.

With the Microsoft CC-Knovvu Analytics integration, call centers using Microsoft CC as their call center application, can have all the conversations between agents and customers analyzed in Knovvu Analytics.

All Microsoft CC admin needs to do is gather the agents whose calls will be analyzed into a group. When an agent in this group makes a call, Knovvu Analytics captures it; and as soon as the call ends, it automatically imports the call into Knovvu Analytics to be analyzed.

It is further explained how Knovvu Analytics works integrated with Microsoft CC, which APIs are used for the integration and technical details.

Microsoft CC Services

Microsoft CC Producer

One of the services written for Knovvu Analytics-Microsoft CC integration is Microsoft CC Producer. Microsoft CC Producer has 3 main jobs:
1. Getting the user group and the users in it whose calls will be analyzed and create these users in Knovvu Analytics as agents.
2. Starting an event listening for these added users. With this request, Microsoft CC understands that if these users receive an event, it will notify Microsoft CC Producer. If Microsoft CC Producer catches an event about a call being ended belonging to these users, it sends the conversation ID of the relevant call to RabbitMQ.
3. Checking if there is an event missed that day with a job that runs every night. This job works by comparing the calls in Microsoft CC with those in Knovvu Analytics for the last 24 hours.

Conversation Consumer

The other service written for Microsoft CC integration is Conversation Consumer. Its job is to get the conversationID from RabbitMQ, and get the metadata and download the recordings of the call with this conversationID using Microsoft CC API. Conversation Consumer then saves the metadata into Knovvu Analytics' database and sends the call recording to MinIO.

Integration Flow

  1. Deployment
    Deployment of the integration services to the desired environment should be done by Sestek DevOps Support team.

  2. Configuration
    Required settings for the integration to work should be made by the Knovvu Analytics' host.
    More details on the required settings.

  3. With the tenantID entered into Microsoft CC Producer's settings during the configuration, the service becomes aware of which tenant it works for. Using this tenantID, Microsoft CC Producer reads the Microsoft CC settings of the relevant tenant kept in Knovvu Analytics' database, such as:

    • which organization this tenant corresponds to in Microsoft CC,
    • which users in this organization will be added to Knovvu Analytics,
    • which users' calls will be analyzed, etc.

  4. When Microsoft CC Producer receives an event coming from Microsoft CC API, it sends the conversation ID of the relevant call to RabbitMQ.

  5. Conversation Consumer gets the conversationID from RabbitMQ, and again uses Microsoft CC APIs to get the metadata and download the recording of the call.
    Note: For calls with transfer scenario, Microsoft CC does not send the recordings as multiple audios separated with each transfer session. We receive a single recording for the entire call.

  6. Conversation Consumer saves the metadata received into Knovvu Analytics' database and sends the call recording to MinIO.

  7. As the final step, the call enters the analysis queue and is analyzed when its turn comes.