RingCentral Engage - Cognigy Documentation

Documentation Index

Fetch the complete documentation index at: /llms.txt

Use this file to discover all available pages before exploring further.

As of Cognigy.AI 4.97.0, the Handover Providers section in the Endpoint settings is deprecated. From Cognigy.AI 2026.4 on, the Handover Settings section in the Endpoint settings is in read-only mode. You can’t use this section to configure new handover providers. You can still view configured handover provider settings, but you can’t change them. To configure handover providers, use the Handover Providers interface, which offers greater flexibility for managing your integration with contact centers. For a smooth migration, refer to the migration guide.

The RingCentral Engage Endpoint enables you to connect your AI Agent to the RingCentral Engage platform.

Prerequisites

• Access to RingCentral Engage.
• Admin role in RingCentral Engage.

Generic Endpoint Settings

• Endpoints Overview
• NLU Connectors
• Data Protection & Analytics
• Real-Time Translation Settings
• Transformer Functions
• Inject and Notify

Specific Endpoint Settings

RingCentral Engage Setup

How to Set Up

1. Create a RingCentral Engage Endpoint

2. In the left-side menu of your Project, click Deploy > Endpoints.

   2. On the Endpoints page, click + New Endpoint.
   3. In the New Endpoint section, do the following:
      1. Select the RingCentral Engage Endpoint type.
      2. Specify a unique name.
      3. Select a Flow from the list. Save changes.
      4. Go to the Configuration Information section and copy the URL from the Endpoint URL field.
      5. In the RingCentral Engage Setup section, copy the Secret value for later use.
      6. Create a verification token and paste it into the Verification Token field. The token can be any string, but must be kept secret and secure. Copy the value for later use. This token will be used to verify the authenticity of API requests to your RingCentral API domain.

3. Create API Access Token

4. Log in to your RingCentral Engage account.

   2. Go to ADMIN > API Access Tokens. Click + to create a new token.
   3. Assign an Agent with permissions to read and reply to your source.
   4. Copy the value from the Access Token field for later use.

5. Create Categories

6. Go to ADMIN > Categories.

   2. Create a new parent category. For example, Cognigy. Then, create two subcategories: Bot and Agent.
   3. Copy the category IDs from the URL for later use.

7. Configure Sources

8. Go to ADMIN > Sources.

   2. Select your source and under MESSAGE SETTINGS, set the Default Category to the Bot category.
   3. Save the configuration.

9. Create a Webhook

10. Go to ADMIN > Webhooks.

    2. Click + to create a new webhook. Configure the following settings:
       • API Access Token – use the token created earlier.
       • Active – enable the webhook.
       • URL – paste the Cognigy.AI Endpoint URL.
       • Secret – paste the secret from Cognigy.AI Endpoint.
       • Sources Filtering Strategy – select No sources except.
       • Sources – select your source.
       • Registered Events – enter content.imported.
       • Verification Token – paste the verification token from Cognigy.AI Endpoint.
    3. Save the webhook.

11. Complete the Endpoint Configuration

12. In the RingCentral Engage Setup section of your Endpoint, fill in the following fields:

    • API URL – enter the URL in the following format: https://api.ringcentral.com/restapi/v1.0/accounts/{accountId}.
    • Access Token – paste the Access Token copied earlier from RingCentral Engage.
    • Bot Category ID – paste the Bot Category ID copied earlier from RingCentral Engage.
    • Agent Category ID – paste the Agent Category ID copied earlier.
    2. Save changes. Test the connection by sending a message via RingCentral Engage chat.

More Information

• Cognigy Help Center: RingCentral Engage Deployment
• Cognigy Help Center: RingCentral Engage Send Structured Content
• Cognigy Help Center: RingCentral Engage Handover Integration

Last modified on June 15, 2026