
Prerequisites
- Access to the Intercom platform.
Generic endpoint settings
Override snapshot connections
If you activate the Override Snapshot Connections toggle, the endpoint overrides the connections in the snapshot with connections from the project. If only the snapshot has a connection, the connection isn’t overridden. If necessary, you need to update such connections manually. To override the connection of the agent in production, you can:- Make the necessary changes in a staging environment, create a snapshot of the same agent, and select the snapshot in the endpoint settings. Deactivate the Override Snapshot Connections toggle.
- Import connections from another agent using a package. Activate the Override Snapshot Connections toggle.
Mocking
In the Advanced Settings section, you can toggle on the Enable Mocking setting to activate mocking for the endpoint. Mocking lets you change node behaviors and test how they perform through the endpoint without changing the original node settings. Make sure that you also activate mocking at the node level.Additional endpoint settings
You can use the following additional settings to customize the endpoint:Endpoint-specific settings
How to set up
1. Create an Intercom endpoint
1. Create an Intercom endpoint
- In the left-side menu of your Project, click Deploy > Endpoints.
- On the Endpoints page, click + New Endpoint.
- In the New Endpoint section, do the following:
- Select the Intercom Endpoint type.
- Specify a unique name.
- Select a Flow from the list. Save changes.
- Go to the Configuration Information section and copy the URL from the Endpoint URL field.
2. Create an app
2. Create an app
- Log in to your Intercom account.
- Go to Settings > Home > Integrations, then click Developer Hub.
- Click the app you want to use with Cognigy or create a new one.
- In the app, go to Configure > Webhooks. Paste the copied Endpoint URL into the Endpoint URL field. Click Send a test request.
- Go to Configure > Basic information. Copy the client secret from the Client secret field.
- Go to Configure > Authentication. Make sure
Read ConversationsandWrite Conversationsare enabled. Copy the access token from the Access token field.
3. Create a teammate
3. Create a teammate
- In the Intercom interface, go to Settings > Home > Workspace, click + Add teammate, then + Add new teammates.
- Enter an email address for your bot, for example,
bot@yourcompany.com. Click Continue and set permissions. - 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.
- 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
4. Complete the endpoint configuration
- In the Cognigy interface, go to the Intercom Endpoint you created.
- In the Access Token field, paste the access token you copied from Intercom.
- In the Bot User ID field, paste the Admin ID of the Intercom teammate you created.
- In the Hub Secret field, paste the client secret you copied from Intercom.
- (Optional) Set a Message Delay to control the typing speed of your bot. Save changes.