Skip to main content
The Intercom Endpoint enables you to connect your AI Agent to the Intercom platform.

Prerequisites

Generic Endpoint Settings

Learn about the generic Endpoint settings on the following pages:

Specific Endpoint Settings

ParameterDescription
Access TokenThe token generated by your Intercom app that has the necessary permissions to communicate with Intercom.
Bot User IDThe unique identifier of the Intercom teammate that will be used as your Intercom bot.
Hub SecretThe client secret provided by Intercom. The secret allows Cognigy.AI to authenticate and communicate with your Intercom bot.
Message DelayA delay in milliseconds for each letter in a message. This parameter allows you to control the typing speed of the Intercom bot.

How to Set Up

  1. 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 Intercom 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.
  1. Log in to your Intercom account.
  2. Go to Settings > Home > Integrations, then click Developer Hub.
  3. Click the app you want to use with Cognigy.AI or create a new one.
  4. In the app, go to Configure > Webhooks. Paste the copied Endpoint URL into the Endpoint URL field. Click Send a test request.
  5. Go to Configure > Basic information. Copy the client secret from the Client secret field.
  6. Go to Configure > Authentication. Make sure Read Conversations and Write Conversations are enabled. Copy the access token from the Access token field.
  1. In the Intercom interface, go to Settings > Home > Workspace, click + Add teammate, then + Add new teammates.
  2. Enter an email address for your bot, for example, bot@yourcompany.com. Click Continue and set permissions.
  3. Set the role and permissions. Grant limited permissions to your bot if you want to restrict access to inboxes or admin settings. Click Send Invite.
  4. Accept the invitation via email. Open the teammateโ€™s profile and copy the Admin ID from the URL. The Admin ID is the 7-digit number in the URL: https://app.intercom.io/a/apps/<app-id>/admins/<admin-id>.
  1. In the Cognigy.AI interface, go to the Intercom Endpoint you created.
  2. In the Access Token field, paste the access token you copied from Intercom.
  3. In the Bot User ID field, paste the Admin ID of the Intercom teammate you created.
  4. In the Hub Secret field, paste the client secret you copied from Intercom.
  5. (Optional) Set a Message Delay to control the typing speed of your bot. Save changes.

More Information

โŒ˜I