> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Intercom

> Connect Intercom to Iru Compliance with an access token and the regional API host that matches your workspace to collect admin, team, and conversation evidence.

### About Intercom

Iru reads **contacts**, **conversation metadata**, **teams**, **tags**, and **workspace** settings through the Intercom REST API. You must pick the **regional base URL** (**US**, **EU**, or **Australia**) that matches **data residency**, then supply a **Bearer** token from the **Developer Hub** (app access token or equivalent).

### How It Works

```http theme={null}
Authorization: Bearer YOUR_ACCESS_TOKEN
```

| Detail             | Value                  |
| ------------------ | ---------------------- |
| **Category**       | Customer support / CRM |
| **Authentication** | Bearer token           |

| Region           | Base URL                     |
| ---------------- | ---------------------------- |
| **US (default)** | `https://api.intercom.io`    |
| **EU**           | `https://api.eu.intercom.io` |
| **Australia**    | `https://api.au.intercom.io` |

Official references: [Authentication](https://developers.intercom.com/docs/build-an-integration/learn-more/authentication), [Developer Hub](https://app.intercom.com/a/developer-signup), [REST API](https://developers.intercom.com/docs/).

### Prerequisites

* **Admin** or sufficient rights to create or view app tokens in the **Developer Hub**.

### Connect Intercom to Iru

<Tabs>
  <Tab title="Intercom">
    <Note>
      Complete this tab before you connect the source in Compliance.
    </Note>

    <Steps>
      <Step title="Open Intercom Developer Hub">
        Sign in to Intercom and open **[Developer Hub](https://app.intercom.com/a/developer-signup)** with a user who can manage developer apps.
      </Step>

      <Step title="Select the app for Iru">
        Open the **app** (workspace connector) you want Iru to use. If none exists yet, create an app and give it a clear name such as **Iru Compliance**.
      </Step>

      <Step title="Open Authentication settings">
        In the app, go to **Authentication** (or **Configure** → **Authentication**, depending on Intercom’s UI).
      </Step>

      <Step title="Create or locate the access token">
        Create an **Access Token** if you do not already have one for this integration, or open the existing token if your security policy allows reuse.
      </Step>

      <Step title="Copy and store the token">
        **Copy** the token immediately. You may not be able to see the full value again after you leave the page. Store it in a vault until you paste it into Iru.
      </Step>
    </Steps>

    <Note>
      Continue on the [**Iru Compliance**](#iru-compliance) tab.
    </Note>
  </Tab>

  <Tab title="Iru Compliance">
    <Note>
      Finish the [**Intercom**](#intercom) tab first.
    </Note>

    <Steps>
      <Step title="Open Sources">
        In Iru Compliance, on the left navigation bar, expand **Compliance** and select **Sources**.

        <Frame>
          <img src="https://mintcdn.com/iru/7HsGH7lnQ8GpVmI0/assets/media/images/iru-navigation-compliance-sources.png?fit=max&auto=format&n=7HsGH7lnQ8GpVmI0&q=85&s=595982441fd777b333b3ecfea24adc24" alt="Left navigation: Compliance expanded, Sources selected" width="424" height="1056" data-path="assets/media/images/iru-navigation-compliance-sources.png" />
        </Frame>
      </Step>

      <Step title="Turn on Intercom">
        Find **Intercom** (use **Category** or **Search by name or description**). On that card, turn on the **toggle**. A browser tab or window may open for the connector wizard.
      </Step>

      <Step title="Select the API host">
        Select the **server** endpoint for your region (**US**, **EU**, or **Australia**). Confirm before entering credentials.
      </Step>

      <Step title="Paste the access token">
        Paste the **Bearer** access token when prompted.
      </Step>

      <Step title="Finish the connection">
        Click **Submit Bearer Token**. When the connection succeeds, the wizard shows **Connection Configured**.
      </Step>

      <Step title="Confirm the source is Active">
        Close the **Iru is requesting access to external services** browser tab, then return to **Compliance** → **Sources** and confirm the **Intercom** card is **Active**.
      </Step>
    </Steps>
  </Tab>
</Tabs>

### Troubleshooting

<AccordionGroup>
  <Accordion title="Nothing opens when you turn the source on">
    Check **pop-up blocker** settings for the Iru site and try again.
  </Accordion>

  <Accordion title="401 Unauthorized">
    Token copied fully; belongs to this workspace.
  </Accordion>

  <Accordion title="Wrong region">
    EU/AU workspaces **must** use the matching host - not the generic US route.
  </Accordion>

  <Accordion title="Missing datasets">
    Extended scopes may require Intercom approval. Check app permissions in Developer Hub.
  </Accordion>
</AccordionGroup>

### Considerations

<CardGroup cols={2}>
  <Card title="Deep conversation scopes sometimes need Intercom…" icon="circle-info">
    Deep conversation scopes sometimes need Intercom review (can take several business days).
  </Card>
</CardGroup>

### Related Articles

<CardGroup cols={2}>
  <Card title="Sources Management" icon="plug" href="/en/compliance/sources-management">
    Browse and manage every Compliance source.
  </Card>

  <Card title="Getting Started With Compliance" icon="rocket" href="/en/compliance/getting-started-with-compliance">
    Frameworks, actions, and **Artifacts**.
  </Card>

  <Card title="Iru Overview" icon="layer-group" href="/en/iru/platform-overview/iru-overview">
    How Endpoint, Compliance, and Identity fit together.
  </Card>

  <Card title="Artifacts Management" icon="folder-open" href="/en/compliance/artifacts-management">
    Upload, review, and organize evidence from sources and actions.
  </Card>
</CardGroup>