Integrations
Intercom integration
Connect Intercom, assign integration roles, and use articles and support conversations to maintain documentation.
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.
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
- Open Integrations from the sidebar, or Settings → Workspace → Integrations.
- Search for Intercom and select Connect.
- Sign in to Intercom and authorize Pageloop for the intended workspace. A Connecting Integration page appears, followed by the Integration connected confirmation.
- 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.
- Select Save Configuration and check for Configuration saved.
- Confirm that the Intercom card shows Connected. Use the gear (Configure) button to revisit the region and workspace ID.
- At the bottom of the page, check Integration roles. Intercom takes the Knowledge base role only if no service already holds it.
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.
- Under Integration roles, select Change on Knowledge base. If the role is Not set, select Choose instead.
- In Change Knowledge Base, select Intercom. The dialog asks you to “Pick a connected service to read from and write to.”
- Select Save and confirm that Knowledge base names Intercom.
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
- Point at Connected on the Intercom card. The button changes to Disconnect.
- Select Disconnect to open Disconnect Intercom?. The dialog explains: “Pageloop stops reading from and writing to it.”
- 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.”
- Select Disconnect to confirm, or Keep connected to cancel.
- 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.
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. |
| 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. |

