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

   <img src="https://mintcdn.com/koreai-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral2.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=8360612940498f9e7e64cbb1f4a2b850" 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-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral3.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=33215aed0b56d79cf18a62585d9cfbaa" 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-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral4.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=62a33a30e0e6528cd8166f61024965f6" 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-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral5.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=0572bf962267c1d05bca172546d8137f" alt="webhook configuration" width="628" height="202" data-path="ai-for-service/channels/images/ringcentral5.png" />

   <img src="https://mintcdn.com/koreai-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral6.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=61fbabeb0effd7da59b2800b5bb6ee27" 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-content-gov/BT5lWQ5TAcTBx3FU/ai-for-service/channels/images/ringcentral7.png?fit=max&auto=format&n=BT5lWQ5TAcTBx3FU&q=85&s=b8335fce51b6a71b537e854f90baaf3c" 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>
