Skip to main content

HubSpot Channel Setup: What's Different

Understand how adding channels to a HubSpot workspace differs from Intercom — scope re-authorization, inbox selection, and activation.

Written by Tarek Khalil

The short version

HubSpot workspaces work the same way as Intercom workspaces — you add channels, messages flow in, your team replies from the HubSpot inbox — but the setup process has three notable differences:

  1. A smaller channel catalog. HubSpot supports a curated set of channels, not the full Octopods catalog.

  2. HubSpot permissions may need extending. When you add a channel that needs scopes your HubSpot connection doesn’t already grant, Octopods prompts you to re-authorize the HubSpot connection first.

  3. HubSpot’s inbox needs to know about the channel. After the channel is authenticated, you pick which HubSpot inbox should receive its messages, then click Activate.

This article covers each difference in detail.

Channels available on HubSpot

HubSpot workspaces can connect:

  • WhatsApp Cloud API (Meta’s native WhatsApp integration)

  • Twilio SMS

  • Instagram Direct Messages

  • Facebook Messenger

  • Telegram

  • Slack

If a channel doesn’t appear in the Add a Channel modal on a HubSpot workspace, it’s not supported on HubSpot. Connect an Intercom workspace instead if you need the full channel catalog.

Re-authorizing HubSpot for new scopes

HubSpot controls what external tools can do inside your portal through a set of permissions. The permissions Octopods originally requested when you connected the workspace cover the basics, but some channels need additional ones:

  • WhatsApp Cloud API, Twilio SMS, Telegram, and Slack use HubSpot’s Custom Channels feature, which needs permission for Octopods to create and manage custom channels in your HubSpot inbox.

  • Instagram and Facebook Messenger use HubSpot’s native social messaging integration, which needs Instagram and Messenger messaging permissions.

When you add a channel that needs a permission HubSpot hasn’t granted yet, Octopods shows a Re-authorize HubSpot prompt. Follow the prompt, sign back in to HubSpot, and approve the additional permissions. You only need to do this once per workspace per permission — future channels that need the same permission won’t ask again.

Picking a HubSpot inbox

HubSpot routes all conversations into inboxes — collections of teammates, views, and workflows defined inside HubSpot. For Octopods channels to surface their messages, each channel must be assigned to a specific HubSpot inbox.

After you finish the channel’s authentication steps, Octopods shows a Select HubSpot Inbox dropdown on the channel’s detail page. It lists every inbox available on your HubSpot portal.

  1. Pick the inbox where messages from this channel should appear. The Activate button stays disabled until an inbox is selected.

  2. Click Activate.

  3. Octopods registers the channel as a custom channel inside HubSpot and subscribes to message events. The channel then moves to Connected.

Note: You can change the inbox later from the same dropdown, but existing conversations stay in the original inbox. New incoming messages go to whichever inbox is currently selected.

Custom channels in HubSpot

HubSpot’s Custom Channels feature is the mechanism Octopods uses to surface WhatsApp, SMS, Telegram, and Slack messages inside the HubSpot inbox. When you activate one of these channels on a HubSpot workspace, Octopods:

  1. Registers a custom channel entry with HubSpot on your behalf (using the permissions you re-authorized).

  2. Tells HubSpot which inbox to route messages to.

  3. Tells HubSpot where to send replies that teammates type into the inbox.

From the HubSpot side, the channel appears in Inbox settings → Channels as a connected channel, with the Octopods-managed name. You don’t need to configure anything there — Octopods manages the custom channel entry for you.

Facebook-backed channels

Instagram and Facebook Messenger use HubSpot’s native social messaging support rather than the custom channel mechanism. Setup still starts in Octopods, but the flow looks slightly different:

  1. Octopods prompts you to re-authorize HubSpot for Messenger or Instagram permissions.

  2. You run through the standard Facebook sign-in and pick the Page or Instagram Business Account.

  3. Octopods links the chosen account to your HubSpot workspace, and HubSpot’s native Instagram or Messenger channel becomes available.

Incoming messages appear in HubSpot exactly as if you had connected the channel directly through HubSpot — Octopods stays out of the way for the inbox experience, and provides the cross-channel features (broadcasts, API, analytics) on top.

Troubleshooting HubSpot channel setup

  • “HubSpot re-authorization required” — the channel needs a permission HubSpot hasn’t granted yet. Follow the prompt to re-sign-in and approve it.

  • Inbox dropdown is empty — your HubSpot portal has no inboxes configured. Create an inbox inside HubSpot first, then return to Octopods and refresh the page.

  • “Activate” button is disabled — you haven’t selected an inbox yet, or the re-authorization step is still pending.

  • Messages arrive in the wrong inbox — the channel was set to a different inbox. Change the inbox from the channel detail page; new messages will route to the new inbox.

What’s next

Did this answer your question?