> For the complete documentation index, see [llms.txt](https://docs.statuspal.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.statuspal.io/platform/integrations/intercom.md).

# Intercom Messenger

With the Statuspal Intercom app, your customers can see current incidents and maintenance directly inside your Intercom live-chat widget — before they write in asking about it.

## 1. Install the Statuspal app from the Intercom App Store

Open the [Statuspal app in the Intercom App Store](https://www.intercom.com/app-store/?app_package_code=statuspal-urkv) and click **Install now**.

{% hint style="info" %}
Nothing will appear in your messenger until you complete all steps below.
{% endhint %}

## 2. Authorize Statuspal to your Intercom workspace

You'll be prompted to sign in to both Intercom and Statuspal to authorize the connection. Once authorized, you'll be taken back to the App Store.

![Statuspal Intercom OAuth authorization](/files/KUtJ76ZeIHuze0nLxk5U)

## 3. Add Statuspal to your Intercom Messenger

1. In your Intercom dashboard, click the **Messenger** icon in the sidebar (bottom left).
2. Expand the **Add apps to your Messenger** section.
3. Click **Add an app** and select **Statuspal**.
4. Choose the status page you want to display from the dropdown.\
   \
   ![Adding Statuspal app to Intercom Messenger](/files/kTO9dGyIRHkQljGf5Fgf)

## 4. Save and go live

Click **Save and set live**. Your status page will now appear inside your Intercom messenger, keeping customers informed about any active incidents or maintenance.

## Permissions and data handling

When you authorize the app, Intercom shows a list of permissions that includes **Read conversations**. That looks broader than it is, and it's worth explaining why it appears.

The Statuspal app is built with [Canvas Kit](https://developers.intercom.com/docs/canvas-kit), the framework Intercom provides for apps that render inside the Messenger. Intercom requires a fixed set of permissions from every Canvas Kit app — read and list users and companies, read conversations, read admins, and gather app data. Those permissions are locked in the Intercom Developer Hub and cannot be deselected by the app developer. You can verify the requirement in [Intercom's own documentation](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication/oauth-scopes).

The permission list is therefore defined by Intercom, not chosen by Statuspal.

What Statuspal actually does with your workspace:

* **We do not read your conversations**, contacts, or companies.
* The integration makes a single call to Intercom, when you install it, to identify which teammate is authorizing the app.
* After that, all traffic runs the other way: Intercom asks Statuspal for your current status, and Statuspal returns the card to display.
* We store your Intercom teammate ID, so the authorization can be linked to your Statuspal account. **We do not store your Intercom access token.**