Skip to content

Intercom

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

Intercom Settings
Parameter Description
Access Token The token generated by your Intercom app that has the necessary permissions to communicate with Intercom.
Bot User ID The unique identifier of the Intercom teammate that will be used as your Intercom bot.
Hub Secret The client secret provided by Intercom. The secret allows Cognigy.AI to authenticate and communicate with your Intercom bot.
Message Delay A 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. Create an Intercom Endpoint
  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.
2. Create an App
  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.
3. Create a Teammate
  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>.
4. Complete the Endpoint Configuration
  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