# Genesys Integration

This document describes how to integrate a Genesys Web Messaging system with the Aisera Gen AI platform, using the Aisera Administration application (Admin UI).

## Prerequisites <a href="#pdf-page-24videbz9tke9pyvz4wz-pdf-page-msnh2a5kvyyw7mdrka5q-id-2.-prerequisites" id="pdf-page-24videbz9tke9pyvz4wz-pdf-page-msnh2a5kvyyw7mdrka5q-id-2.-prerequisites"></a>

To pull records from Genesys, you need to create a Genesys service user account or use an Admin account that needs a minimum of Read-only or Read-Write access to the Genesys User, Ticket, and Knowledge Article tables. The Aisera Service User needs to log into your Genesys system to pull data from the pre-mapped User, Ticket, and Knowledge Article fields.\
\
Your Aisera team can use test tickets or knowledge articles to ingest and then determine the specific fields that are mapped, if your Genesys administrators want to restrict the access of the Aisera Service User to only those fields.

## Gathering Credentials from your Genesys Platform

You have a working Genesys Web Messaging application on Genesys System. Customer needs to provide

1. Web Socket Address, this address is based on the region of the Genesys Web Messaging application. [Genesys Cloud Developer Center](https://developer.dev-genesys.cloud/commdigital/digital/webmessaging/websocketapi)
2. Deployment Id of the Web Messaging application
3. Genesys API access credentials

   a. **Genesys API Server** based on the region of the account. [Genesys Region Overview](https://developer.dev-genesys.cloud/platform/api/)\
   b. **Genesys Auth Server API** based on the region of the account [Genesys Region Overview](https://developer.dev-genesys.cloud/platform/api/)

   c. **Client ID** of the Genesys Account

   d. **Client Secret** of the Genesys Account (Genesys Admin Page > Oauth > your app with Client Credentials)

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2F52hGAWrfFPCYdegw4s6P%2Fgenesys1.png?alt=media&#x26;token=18c843f2-3fef-4b4c-b093-250b0e8ba90b" alt=""><figcaption><p>Genesys Authorizaation for Integration</p></figcaption></figure>

4. The Agent End Chat message
   1. Genesys Web Messaging doesn’t provide the event when the agent ends the chat. However, when there is no agent available, Genesys will send text message to show the chat is ended. This message will be used as the indicator that Genesys/agent ends the chat. For example, `End of Chat - goodbye` in the following screenshot.

<div align="center"><figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FeeLMIyc5skFfcFlVnoPy%2Fgenesys2.png?alt=media&#x26;token=fda036be-0279-475e-9354-ecd53f531de9" alt="" width="375"><figcaption><p>Chatbot End Message</p></figcaption></figure></div>

## Connecting Your Genesys System to the Aisera Platform

The first part of the Genesys integration involves connecting your Genesys system to your Aisera platform. This is done using the **Settings > Integration** command.

Before you begin, make sure you have a working Genesys Web Messaging application on a Genesys System.

**To connect your Genesys system to your Aisera platform:**

1. Choose **Settings > Integration > + New Integration** in the Aisera Administration application (Admin UI).<br>
2. Type **Genesys** in the **Search** field.

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2FPP7wEDKJYxCAEGVkm2e4%2Fnew_integration_genesys.png?alt=media&#x26;token=abb63e05-c5d9-4d8f-ac92-e8dff452572e" alt="" width="563"><figcaption></figcaption></figure>

3. Choose **Next**.
4. Add your Genesys Web Messaging credentials into the **New Integration** dialogs.\
   \
   (Acquire the settings for this section from your Genesys Web Messaging application.\
   You will need the **Web Socket Address**, **Deployment ID**, and **Genesys API access credentials**. For more information on these see the [**Genesys Cloud Developer Center**](https://developer.dev-genesys.cloud/platform/api/).)

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2F2Czk7qdsT8S2vd3NxeSs%2Fnew_integration_gen2.png?alt=media&#x26;token=0798ce59-913f-4474-abe9-d5bf7b7e889f" alt="" width="563"><figcaption></figcaption></figure>

See descriptions for these fields in the table below.<br>

<table><thead><tr><th width="183">Field</th><th>Description</th></tr></thead><tbody><tr><td>Endpoint</td><td>The <code>API Server</code> for the Genesys Web Messaging application. This is based on the region of the account.</td></tr><tr><td>Client Id</td><td>The <code>Client Id</code> of the Genesys Web Messaging application. This is based on the region of the account.</td></tr><tr><td>Client Secret</td><td>The <code>Client Secret</code> of the Genesys Web Messaging application. (<strong>Genesys Admin Page > Oauth ></strong> your app with <strong>Client Credentials</strong>).</td></tr><tr><td>Access Token URI</td><td><p>The <code>Auth Server</code> of the Genesys Web Messaging application, such as:</p><p><code>https://login.usw2.pure.cloud</code></p></td></tr></tbody></table>

5. Enter the **Client ID**, **Client Secret**, and **Access Token URL**.

<figure><img src="https://3281977978-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FvBFXjH9S1CAy9f5hzg5Q%2Fuploads%2F1rlo68W7NHZglBURcI1D%2Fnew_integ_gen3.png?alt=media&#x26;token=2d37b8e5-6a25-4693-b9c6-114eedb01a6b" alt="" width="563"><figcaption></figcaption></figure>

Depending on your use case, choose one of the following options to proceed:\
\
[**Live Agent Setup**](https://docs.aisera.com/aisera-platform/channels/interactive-voice-response-ivr/genesys-integration/live-agent-setup)

[**Voice Bot Setup**](https://docs.aisera.com/aisera-platform/channels/interactive-voice-response-ivr/genesys-integration/voice-bot-setup)