> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-apis.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Add RingCentral Engage as a Channel

<Badge icon="arrow-left" color="gray">[Back to Available Channels](/ai-for-service/channels/adding-channels-to-your-bot#available-channels)</Badge>

To set up **RingCentral Engage** as a channel, you must complete the following steps:

## Add the Host URL

1. Copy-paste the **HOST URL** from **RingCentral Engage** to the Platform.
2. Provide it in the **Channels & Flows** > **Channels** > **Digital** > **All** > **RingCentral Engage** > **Configurations**.

## Generate API Access Token

1. Login to your **RingCentral Engage** developer account. The URL specific to your company will be available after creating a paid account with RingCentral Engage.

2. Navigate to the **Admin** section and click the code snippet icon on the left navigation menu.

3. Select **API Access Tokens**.
   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=6cac57466ba39cac6f9411f77a33d7d7" alt="RingCentral Engage integration" width="628" height="254" data-path="ai-for-service/channels/images/ringcentral.png" />

4. If there are any tokens present already, you can use them or click **ADD** to generate a new API Token.

   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral1.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=16a6af231f16aab99903baf30afcb095" alt="RingCentral access token" width="628" height="281" data-path="ai-for-service/channels/images/ringcentral1.png" />

   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral2.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=723a7e5070c06b9c4b16bad9f1711318" alt="RingCentral api token" width="628" height="244" data-path="ai-for-service/channels/images/ringcentral2.png" />

5. Provide a **Name** for your API Token.

6. Select **Agent** from the drop-down list.

7. Click **Save**.

8. Navigate to the **API Tokens** screen and select the **Edit** icon to land on the screen shown below where the generated API Access Token appears.
   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral3.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=ef133fbdfab911b7aa347ac5ad2e1ca9" alt="access token" width="628" height="277" data-path="ai-for-service/channels/images/ringcentral3.png" />

9. Copy and provide the generated **API Access Token** under **Channels & Flows** > **Channels** > **Digital** > **All** > **RingCentral Engage** > **Configurations** on the Platform.

## Setup Webhook Configuration

1. Once the API Token has been generated, navigate to **Admin > Webhooks**. Click the **code snippet** icon on the left navigation menu, and select **Webhooks**.
   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral4.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=ccfef009fde171a1c0db2d0bf0abecc1" alt="webhook " width="628" height="206" data-path="ai-for-service/channels/images/ringcentral4.png" />

2. If any webhook configurations are present already, you can use them or click **ADD** to generate a new webhook configuration.

   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral5.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=9c69a8232b4d7669144306df87227f11" alt="webhook configuration" width="628" height="202" data-path="ai-for-service/channels/images/ringcentral5.png" />

   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral6.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=3ed143cf2095b81a08bad29858a2617c" alt="new webhook configuration" width="628" height="279" data-path="ai-for-service/channels/images/ringcentral6.png" />

3. Select the **API Access Token** generated.

4. Copy the **URL** from the Platform under the **RingCentral Engage** channel and paste it to the above webhook configuration screen.

5. Provide a **Name** for the configuration.

6. The Verification Token will be generated automatically.

7. Copy the **verification token** and paste it in the **RinCentral Engage > Configurations** section of the Platform.

8. Provide any unique **“Secret Key”** of your choice.
   <img src="https://mintcdn.com/koreai-apis/vBXxLdTkRvJTIakI/ai-for-service/channels/images/ringcentral7.png?fit=max&auto=format&n=vBXxLdTkRvJTIakI&q=85&s=1dc726c93758bf5be08418cddc917a1d" alt="secret key" width="628" height="281" data-path="ai-for-service/channels/images/ringcentral7.png" />

9. Select the Channel you prefer or select all the channels if the message is to be delivered on all the channels.

Please refer to this [link](https://support.ringcentral.com/engagedigital/admin/configure-entry-points.html) for more information on how to configure channels.

## Subscribe to events for message delivery

1. Select the **content. imported** event under the **Subscriptions** section.
2. Click **Save**.

<Note>Make sure to check the Active option before you save. This will establish a handshake between RingCentral Engage and Platform by sending a 200 code to RingCentral on successful connection establishment.</Note>
