Before you begin
To connect an Intercom workspace you need:
Octopods admin role. Only admins can connect workspaces. If you aren’t an admin, ask an admin teammate to connect the workspace or to upgrade your role.
Intercom admin access. Intercom requires admin permissions to approve a third-party app’s authorization. You should be able to sign in to Intercom and approve apps for the workspace you’re connecting.
The right Intercom workspace open. If your Intercom account has multiple workspaces, sign in to Intercom first and confirm the right one is selected before you start.
Each Intercom workspace can be connected to one Octopods account at a time. If the workspace is already connected to a different Octopods account, you’ll see an error. See “Intercom workspace already connected to another account” below.
Step 1: Open the Connected Workspaces page
Sign in to Octopods. You land on the Connected Workspaces page automatically.
If you haven’t connected anything yet, the page is in its welcome state with “Thanks for signing up!” and a “Step 1 of 2” badge.
If you already have other workspaces, find the option to add another from the same page.
Step 2: Start the Intercom connection
Locate the Connect Intercom card with the message “Link your Intercom workspace” and click Connect. Octopods redirects you to Intercom.
Step 3: Approve access in Intercom
On Intercom’s side:
Sign in to Intercom if you aren’t already signed in.
Pick the Intercom workspace you want to link.
Review the access Octopods is requesting and click the approval button. Octopods asks for the access it needs to read and write conversations and contacts, and to identify your team’s admins so the right people can use the connection.
Intercom redirects you back to Octopods.
Step 4: Confirm the workspace appears
After Intercom redirects you back to Octopods, the new workspace appears on the Connected Workspaces page. Each row shows:
The Intercom workspace name (the app name shown in Intercom).
The provider — Intercom.
The admin who connected it under Added by.
A green Active badge confirming the connection.
The workspace is now ready. Click into it to add your first messaging channel.
What Octopods needs from Intercom
Intercom’s authorization screen shows you the exact access Octopods is requesting before you approve. At a high level, Octopods needs to:
Read and write conversations. So inbound messages from connected channels can become Intercom conversations and your replies in Intercom can be sent back out to the customer.
Read and write contacts. So Octopods can match incoming messages to existing Intercom contacts (or create new contacts when no match exists), and keep contact details aligned.
Read your admin list. So Octopods can identify the team members who should be able to use the connection and so replies are attributed to the right Intercom admin.
You’re approving Octopods at the Intercom-workspace level, not your personal Intercom user. Once approved, anyone on your team who uses Octopods works through the same connection.
Common things that go wrong
“This Intercom Workspace has been activated under a different account.” The Intercom workspace is already connected to another Octopods account. See “Intercom workspace already connected to another account” below to find that account or move the workspace.
You can’t approve the Intercom authorization. Your Intercom user doesn’t have admin permissions on that workspace. Ask a teammate with Intercom admin access to complete the connection.
You connected the wrong Intercom workspace. Sign in to Intercom, switch to the correct workspace, then start the connection again from Octopods.
An unknown error appeared. Octopods shows “It looks like an unknown error occurred. Please contact us to help you fix this problem.” Reach out to Octopods support so we can investigate.
Intercom workspace already connected to another account
Each Intercom workspace can be connected to one Octopods account at a time. Sometimes a workspace is already connected to a different Octopods account. Often it’s a former teammate’s account, or a trial someone started and forgot.
What happens when you connect depends on the other account:
The other account has no active channels on the workspace. Octopods asks you to confirm a takeover. Confirm it, and the workspace connects to your account.
The other account has active channels on the workspace. The connection is blocked. The screen shows the contact details of the account that holds the workspace.
The workspace was disconnected, or Octopods was uninstalled in Intercom. Any Octopods account can connect it.
If you see “This Intercom Workspace has been activated under a different account.”, use the steps below to find that account or free the workspace.
Find the other Octopods account
Use the contact details on the error screen to reach the account that holds the workspace.
Ask teammates who are Intercom admins whether they signed up for Octopods. Have them check their email for Octopods messages.
If you think you signed up before, sign in with your work email, or reset your password. See Resetting Your Password.
If a teammate has the account, they can invite you instead of you moving the workspace. See Inviting Team Members. On that account’s Connected Workspaces page, the Added by column shows who connected the workspace.
Disconnect the workspace from the other account
An admin who can sign in to the other Octopods account can free the workspace:
Go to Settings.
In the Danger Zone section, open Disconnect a workspace.
Click Disconnect.
Tick the I understand… checkbox.
Click Disconnect workspace.
This stops the workspace’s channels and uninstalls the Octopods app from Intercom. Conversations stay in Intercom. Any Octopods account can then connect the workspace.
Uninstalling the Octopods app in Intercom also frees the workspace. Its channels in Octopods are deactivated.
Ask Octopods support to move the workspace
If nobody can reach the other account, contact Octopods support and ask us to move the workspace to your account. Include:
The email address of your Octopods account.
The name of the Intercom workspace, as shown in Intercom.
Your Intercom workspace ID. It’s the code after
/apps/in your Intercom URL.
What happens to the old account
When the workspace moves to your account, the old account’s channels on that workspace are deactivated. Conversations stay in Intercom.
Connect the workspace again
Once the workspace is free, start again from “Step 2: Start the Intercom connection”.
After connecting
With the workspace in place you can:
Add your first channel (WhatsApp, SMS, Telegram, Messenger, and others) from inside the workspace.
Test the round trip — send a message on a connected channel and confirm it appears in your Intercom Inbox.
Install the Octopods extension inside Intercom so your team can send proactive messages from the Intercom sidebar.
Intercom workspace connection FAQs
Why does it say my Intercom workspace is already connected to another account?
Another Octopods account connected this workspace first. A workspace can only be in one Octopods account at a time.
Nobody remembers setting it up. What do I do?
Check the contact details on the error screen, ask your Intercom admins, and look for an Octopods account under your work email. If you can’t reach the account, contact Octopods support and we’ll help you move the workspace.
Do we lose our Intercom conversations when the workspace moves?
No. Conversations stay in Intercom. Only the old account’s channels on that workspace are deactivated.
What’s next
See the Channels section for how to add WhatsApp, SMS, Telegram, and other channels to your Intercom workspace
See the Quick Start guide under Getting Started for an end-to-end walkthrough
