Deployment-Configuration Steps

  • Updated on Mar 11, 2026
  • Published on Jun 17, 2025
  • 3 minute(s) read
  • Berkay Vuran
  • Mert Çıkan
  • Eda Koçarslan
 Prev Next

This document provides a step-by-step guide for configuring Knovvu Virtual Translator in a demo environment integrated with Genesys. It outlines the required installations, tenant setups, and platform-specific configurations. The guide is intended for application support and presales teams for deploying and configuring the Virtual Translator solution.

Before starting

Before continuing to next steps be sure that you have the information below:

  1. How many agents will use VT, 1 or many? In PoCs or for test purposes, customer might prefer to start using VT with 1 agent only. The configuration steps will change according single or multiple users.
  2. Which languages are required for the project? Language information is required for configuration. If multiple language support is required; will Language Identifier or DTMF (press 1 for English, 2 for German etc.) be used?
  3. Which TTS provider will be used? Sestek TTS or ElevenLabs? -> If ElevebLabs will be used, VoiceID should be delivered by Presales.

1. Hummingbird Installation

Create a ticket to Devops Support team for the deployment Hummingbird to the environment to be used.

You can check the guide on how to create a ticket requesting Hummingbird deployment.

2. Genesys-VT User Implementation Service Installation

Genesys-VT user implementation service is responsible for creating users from Genesys in the CA with same IDs. Every 12 hours, the service automatically gets users from Genesys and creates them in CA, by also assigning their Genesys ID as external ID in CA for user mapping.

Skipping this Step

This step can be skipped if VT will be used for 1 agent only, for PoCs or demo purposes as an example. The users can manually be created in CA and Genesys ID can be manually added as CA external ID.

Create a ticket for the DevOps Support team to install the Genesys-VT User Implementation Service in the target environment.

Example ticket:

xx müşteri/partneri tarafından kullanılacak Genesys-VT entegrasyonunda user implementasyon işlemi yapan genesys-vt-user-integration servisinin VT demolarında kullanılabilmesi için CA'nın xx ortamına aşağıdaki variant adı ile kurulması gerekmektedir. Bu servisin CA'nın güncel imajı ile xx ortamına kurulması konusunda destek olabilir misiniz?

  • varyant adı: tenantname

3. Creating CA Tenant

Create the CA Tenant in the system. Fill in the cloud request form to request a new tenant from Sales Operations. Select the following features as below, other features can be selected as "No".

image.png

4. CA Tenant Configurations

  1. Open the CA tenant, go to Administration > Settings and choose the Virtual Translator service as "Knovvu Core".

image.png

  1. Fill the required settings obtained in here
    Image

  2. Under Administration > Identity Management > Users check the user settings after the deployment of Genesys-VT integration service.

image.png

For agent mapping:

If single user is using VT, then Pbx agent ID should be same as the Genesys extension number of the agent. If multiple users are using VT, the external IDs should be same as Genesys agent ID of the users.

If you skipped Genesys-VT User Implementation Service step:

The external ID of the user should be same as the user's Genesys agentID. This will automatically be done if Genesys-VT user implementation service is being used. If not, you must enter the user's Genesys ID as external ID by following the steps below:

  1. In Genesys, go to Admin > People.

  2. Click on the user that will use VT.

  3. Genesys agent ID of the user can be seen in the URL as below:
    image.png

  4. Go to CA, Administration > Identity Management > Users, enter the ID as external ID of the related user.

5. Creating & Configurating the Core Tenant

Create the Core Tenant in the system. This tenant will host the project that use the VT capabilities. Fill in the cloud request form to request a new tenant from Sales Operations.

Product must be selected as SR (Cloud API).
ADD TTS or SR should be Yes.
AI should be No.

6. Genesys Configurations

Please refer to Genesys Integration document for the detailed steps.

7. Hummingbird Configurations

The following information should be provided to Bayram Boyraz to complete the necessary configurations. When submitting the request, be sure to specify whether a queue will be used (if there are multiple users using VT) or if the transfer should be made to a specific agent in Genesys. If a specific agent transfer is required, also include the agent’s extension number. If DTMF will be used for language asignment, the information of which number will be used for which language should also be sent.

  • Core base url
  • Core Tenant id
  • Core Client id
  • Core Client secret
  • Grant type
  • Scope
  • Data Flow wss address
  • Project name
  • Agent extension number (optional)
  • DTMF information (optional)