> For the complete documentation index, see [llms.txt](https://ask.birdie.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/genesys.md).

# Genesys

### Overview

The Genesys connector allows Birdie to import conversations directly from your Genesys transcripts.

### Requirements

Our integration leverages the speech-to-text analytics feature from Genesys to retrieve call transcripts. Before proceeding, ensure that you have the necessary access to this feature on your Genesys Cloud account.

{% hint style="info" %}
Genesys adheres to the OAuth 2 standard for secure authentication, and our solution uses client\_credentials as grant type.

This grant type is designed for non-user applications, such as the Genesys connector. Additionally, this grant type enhances security by restricting access to user-specific APIs (for example, GET /v2/users/me).

The only necessary credentials that you need to provide to Birdie's team are:

* Client ID
* Client Secret
  {% endhint %}

Details on how to obtain these credentials are provided in the next section.

### Setup in Genesys

To enable the Genesys connector, you need to create an OAuth authentication client with sufficient permissions to access Genesys transcripts.

Follow the Genesys [tutorial](https://help.mypurecloud.com/articles/create-an-oauth-client/) and make sure the following steps are correctly configured:

{% stepper %}
{% step %}

### Select grant type

* Choose the Client Credentials grant type.
  {% endstep %}

{% step %}

### Assign client roles / scopes

Assign the appropriate client roles related to call transcripts.

* Required Permissions:
  * analytics:conversationDetail:view
  * analytics:agentConversationDetail:view
  * speechAndTextAnalytics:data:view
  * recording:recording:view
  * recording:recordingSegment:view
* Required Scopes:
  * analytics
  * conversations
  * speech-and-text-analytics
  * recordings
  * analytics:readonl
  * conversations:readonly
  * speech-and-text-analytics:readonly
  * recordings:readonly
    {% endstep %}
    {% endstepper %}

### Connect to Birdie

After creating the client, make sure to store the provided Client ID and Client Secret securely.

Share the following securely with the Birdie team so they can finalize the connector configuration:

* Client ID
* Client Secret

### Data in scope

Once configured, the Genesys connector imports call and conversation transcripts from Genesys speech-to-text analytics into Birdie, along with the associated metadata that is exposed through the configured permissions and scopes.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ask.birdie.ai/integrations-and-data-ingestion/how-to-integrate-with/genesys.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.