> ## Documentation Index
> Fetch the complete documentation index at: https://koreai-agentplatform-dev.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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=aff703d2662f34b8d6f19840508620ac" 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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral1.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=6eabae9aa221b553ae99e562be071ce0" alt="RingCentral access token" width="628" height="281" data-path="ai-for-service/channels/images/ringcentral1.png" />

   <img src="https://mintcdn.com/koreai-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral2.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=cb581d8aab487b445eb7995edf573276" 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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral3.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=d4b723fa29604dd6465d066a96de4377" 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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral4.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=d819a18a1b7425dae6a8ff8bff00768e" 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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral5.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=8da3dde6b223aede26ecd2a6e3e01c05" alt="webhook configuration" width="628" height="202" data-path="ai-for-service/channels/images/ringcentral5.png" />

   <img src="https://mintcdn.com/koreai-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral6.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=79a49eb0897be622ae79b12dfe88a9ae" 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-agentplatform-dev/4dCvmBnzs3i0xf95/ai-for-service/channels/images/ringcentral7.png?fit=max&auto=format&n=4dCvmBnzs3i0xf95&q=85&s=03c90f767c9de1543f312793520e1a91" 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>
