Source: https://docs.pageloop.ai/guides/intercom-integration

# Intercom integration

# Intercom integration

Connect Intercom to sync help center articles into Pageloop and prepare updates for review. A connection that includes conversation access can also supply support conversations and tickets as evidence for documentation gaps.

Intercom can hold the **Knowledge base** role, the **Ticketing** role, or both. For an overview of help-center connections and integration roles, see [Connect your knowledge base](/guides/connect-knowledge-base).

## Before you begin

- Sign in to Pageloop as an **Admin**.
- Use an Intercom account allowed to install apps in the workspace you want to connect.
- Know your Intercom workspace's region: US, EU, or AU.

Intercom uses its own sign-in and authorization flow. You do not need an API key.

## Connect and configure Intercom

1. Open **Integrations** from the sidebar, or **Settings → Workspace → Integrations**.
2. Search for **Intercom** and select **Connect**.

![Intercom card with Connect and unassigned integration roles](/images/uploads/uploaded-image-0-ba57f4c8.png)

3. Sign in to Intercom and authorize Pageloop for the intended workspace. A **Connecting Integration** page appears, followed by the **Integration connected** confirmation.
4. In **Configure Intercom Integration**, confirm your region and workspace ID:
   - **Intercom Region:** select **US (app.intercom.com)**, **EU (app.eu.intercom.com)**, or **AU (app.au.intercom.com)** to match your workspace.
   - **Workspace ID:** check the detected value. Pageloop shows **Workspace ID detected from your Intercom connection** when it finds the ID. The workspace ID is the code after `/apps/` in your Intercom address; use `<your workspace ID>`, not the sample value shown below.
5. Select **Save Configuration** and check for **Configuration saved**.

![Configure Intercom dialog with Save Configuration outlined](/images/uploads/uploaded-image-1-29851f9b.png)

6. Confirm that the Intercom card shows **Connected**. Use the gear (**Configure**) button to revisit the region and workspace ID.
7. At the bottom of the page, check **Integration roles**. Intercom takes the **Knowledge base** role only if no service already holds it.

![Connected Intercom card with Configure and Intercom assigned to Knowledge base](/images/uploads/uploaded-image-2-83be6e36.png)

### Choose Intercom's roles

**Knowledge base** is “Where Pageloop reads your articles from and publishes updates to.” If another service, such as Pageloop Docs, already holds this role, Intercom connects but its articles are not synced until you change the assignment.

1. Under **Integration roles**, select **Change** on **Knowledge base**. If the role is **Not set**, select **Choose** instead.
2. In **Change Knowledge Base**, select **Intercom**. The dialog asks you to “Pick a connected service to read from and write to.”
3. Select **Save** and confirm that **Knowledge base** names **Intercom**.

![Change Knowledge Base dialog with Intercom as the current service](/images/uploads/uploaded-image-3-fb715e87.png)

**Ticketing** is “Where support conversations come from when looking for doc gaps.” Pageloop never assigns this role automatically. To use Intercom conversations, select **Choose** or **Change** on **Ticketing**, pick **Intercom**, and select **Save**. This requires a connection that includes conversation access; an articles-only connection can hold the Knowledge base role but not Ticketing.

## What Pageloop reads and writes

### Articles and support conversations

When Intercom holds the Knowledge base role, Pageloop syncs your Intercom help center articles into Pageloop. Article changes arrive within minutes, with a full check daily.

With conversation access and Intercom assigned to Ticketing, Pageloop can read support conversations and tickets as evidence for documentation gaps. Names and emails from conversations are never written into drafts.

Intercom can be the source of a scheduled workflow. A run is skipped when no conversations were updated in its time window.

### Publishing to Intercom

Pageloop's proposals arrive in the **Inbox** for review. Nothing reaches Intercom until a person publishes.

When you publish an article, choose where it goes and select **Publish** or **Save as draft in Intercom**. If your Knowledge base settings show **Default publish mode for Intercom**, the **Draft** or **Live** setting determines whether published changes are saved as drafts in Intercom or go live. **Draft** is the safer default.

## Disconnect Intercom

1. Point at **Connected** on the Intercom card. The button changes to **Disconnect**.
2. Select **Disconnect** to open **Disconnect Intercom?**. The dialog explains: “Pageloop stops reading from and writing to it.”
3. If Intercom holds the Knowledge base role, the dialog warns: “Intercom is your knowledge base integration. That role is left unassigned until you pick another.”
4. Select **Disconnect** to confirm, or **Keep connected** to cancel.
5. Check for **Intercom disconnected**. Pageloop uninstalls its app from your Intercom workspace. If Intercom held the Knowledge base role, choose another service for that role when you are ready.

![Disconnect Intercom? dialog with Disconnect outlined](/images/uploads/uploaded-image-4-e49f79c2.png)

### Reconnect after losing access

If Pageloop loses access or syncing fails several times in a row, the card can show **Needs reconnecting**. The page explains: “Intercom needs to be reconnected. Pageloop lost access, so it is paused until you reconnect it.”

Open the **...** menu on the card and select **Disconnect**. Then select **Connect** and repeat the setup above. Check the integration roles after reconnecting.

## Troubleshooting

| Message or symptom                                                                                                                                                                | What to do                                                                                                                                                                                |
| --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Error connecting integration** with **Something went wrong**                                                                                                                    | Authorization was cancelled or refused in Intercom. Select **Connect** again and authorize Pageloop.                                                                                      |
| **Error connecting integration** with **No authorization code received** or **Failed to exchange code for tokens**                                                                | Start again from **Connect**.                                                                                                                                                             |
| **Please enter your Intercom workspace ID**                                                                                                                                       | Enter the code after `/apps/` in your Intercom address.                                                                                                                                   |
| **Invalid workspace ID format. It should contain only letters and numbers.**                                                                                                      | Enter only the workspace ID from your Intercom address, not the full address.                                                                                                             |
| **Update failed** with **intercom does not support ticketing**                                                                                                                    | This connection only has article access. It can be your knowledge base but not your ticketing source. Use a connection that includes conversation access to assign Intercom to Ticketing. |
| Intercom is **Connected**, but its articles are not synced.                                                                                                                       | Check **Integration roles**. If another service holds **Knowledge base**, change the assignment to Intercom.                                                                              |
| **Needs reconnecting**                                                                                                                                                            | Follow [Reconnect after losing access](#reconnect-after-losing-access).                                                                                                                   |
| **Pageloop can’t sign in to your Intercom help center, so it isn’t syncing.**                                                                                                     | Disconnect Intercom, then connect and configure it again.                                                                                                                                 |
| **Pageloop stopped syncing your Intercom help center after it failed several times in a row.**                                                                                    | Disconnect Intercom, then connect and configure it again.                                                                                                                                 |
| **The last sync of your Intercom help center didn’t finish. Pageloop keeps trying on its own.**                                                                                   | Pageloop retries automatically.                                                                                                                                                           |
| **Pageloop paused syncing: most of your Intercom articles were missing from the last read, so it kept them rather than delete them. If you didn’t remove them, contact support.** | Check whether you removed the articles in Intercom. If you did not, contact support.                                                                                                      |

## Related guides

- [Connect your knowledge base](/guides/connect-knowledge-base)
- [Review an Inbox item](/guides/review-inbox-item)
- [Finish an Inbox item](/guides/finish-an-inbox-item)
- [Troubleshooting](/guides/troubleshooting)
