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

   <img src="https://mintcdn.com/koreai-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral2.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=76bf2e82f0a12f3926d26ba7eac96566" 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-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral3.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=fe7fca4e76bb43ebf38e04ae66454205" 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-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral4.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=032a9a907012184e8c3d278ba6e0553c" 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-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral5.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=0a15d5964564e7659dcad6468dae0b9e" alt="webhook configuration" width="628" height="202" data-path="ai-for-service/channels/images/ringcentral5.png" />

   <img src="https://mintcdn.com/koreai-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral6.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=c3aa1a65c562f00abc29287f43c23ed0" 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-ai-for-work-dev/qRCtzEihoRl9H3e2/ai-for-service/channels/images/ringcentral7.png?fit=max&auto=format&n=qRCtzEihoRl9H3e2&q=85&s=352fd359ed072322f705fb126235bf66" 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>
