Skip to main content

Set up Intercom Messenger

Back to the main guide

Intercom Messenger is the live-chat widget Intercom hosts for your workspace. Ordering.co stores the enablement toggle and Enter Intercom API Key on Settings → Pro → Integrations. When Activate Intercom Integration is Yes and Intercom accepts the install, the chat bubble can appear on the storefront—often in the profile section of the website.

Saving the Dashboard fields does not by itself load Messenger. Keep the Intercom app_id and any access token private.

The Dashboard field is labeled Enter Intercom API Key (older layouts may show Intercom Api Key). The Messenger install copies the Intercom app_id into that field. A separate Integrations overview points an Intercom Developer Hub Access token at the same field. Use the value your Intercom workspace provides for the chat you are enabling, then confirm the widget on the storefront.

Copy the Messenger app ID​

  1. Open your Intercom account and go to Settings.

Intercom getting started screen with Settings in the lower left

  1. In the left sidebar, open Channels, then select Messenger.

Intercom Settings sidebar with Channels and Messenger

  1. Open the Install tab and select Install for web.

Intercom Messenger Install tab with Install for web

  1. Enable Messenger API. Intercom keeps this off until you turn it on so the Messenger is not added before the workspace is ready.

Enable the Messenger API to continue installation

  1. Scroll down and copy your app_id from the install snippet.

Intercom web install snippet with app_id highlighted

  1. In the Ordering.co Dashboard, open Settings → Pro → Integrations. Set Activate Intercom Integration to Yes. Paste the app_id into Enter Intercom API Key, then select Save.

Integrations Intercom Live Chat with Activate Intercom Integration set to Yes and Enter Intercom API Key

  1. After Intercom and the storefront load Messenger, the chat control appears on the website profile.

Website profile with the Intercom chat launcher

Website profile with the Intercom Messenger conversation panel open

When the launcher opens and you can send a message in your Intercom workspace, Messenger is working. The screenshots show an example workspace; use your own app_id.

Copy an Intercom access token from Developer Hub​

The Integrations overview also documents an Intercom Access token from Developer Hub. Follow these steps when you need that token for Enter Intercom API Key.

  1. Log in to Intercom.
  2. Open Developer Hub.
  3. Select New app, or open an existing app.

Intercom Developer Hub Your apps with New app

  1. Open Authentication in the left menu. This is where Intercom shows API keys and access tokens for the app.

Intercom Developer Hub Basic information with Authentication selected

  1. If the app does not have a token yet, generate it in Authentication. If it already exists, copy the Access token. Paste it into Enter Intercom API Key and save.

Intercom Developer Hub Access token pointing at Enter Intercom API Key

Intercom treats the access token as a secret. Do not share it. Copying a token or an app_id into the Dashboard does not prove that Messenger is loaded for customers.

For the product overview, see Intercom on Ordering.co.

Back to the main guide