Skip to main content

Setting Up Facebook Messenger for HubSpot

Connect a Facebook Page's Messenger inbox to a HubSpot workspace so conversations arrive in HubSpot and replies go back.

Written by Tarek Khalil

Before you start

You need:

  • A HubSpot workspace already connected to Octopods.

  • A Facebook Page for your business.

  • Admin access to that Page.

  • A Facebook Business Manager account (recommended).

  • Admin access to the HubSpot portal with permission to grant additional HubSpot permissions.

Step 1: Open the Messenger setup

  1. Sign in to Octopods and open the HubSpot workspace.

  2. Click the option to add a new channel.

  3. In the Add a Channel modal, select Facebook (or Messenger) under Popular Channels.

Step 2: Re-authorize HubSpot (if prompted)

Messenger uses HubSpot’s native social messaging integration, which needs Messenger-specific messaging permissions.

  1. If Octopods shows a Re-authorize HubSpot prompt, click it.

  2. Sign in to HubSpot and approve the requested permissions.

  3. HubSpot redirects back to Octopods.

You only need to re-authorize once for Messenger permissions. If you already re-authorized for Instagram, this step may be skipped.

Step 3: Sign in with Facebook

  1. Click the Facebook sign-in button.

  2. Sign in with a Facebook user that has admin or editor access on the Page you want to connect.

  3. Facebook shows a consent screen listing permissions (manage messages on Pages, show list of Pages you manage, read Page profile). Keep everything checked and approve.

Step 4: Pick the Page

  1. Octopods shows a list of Pages your Facebook account administers.

  2. Pick the Page you want to connect.

  3. Confirm.

Step 5: Activate the channel in HubSpot

Messenger on HubSpot uses HubSpot’s native social messaging integration:

  1. Octopods links the selected Page to your HubSpot workspace.

  2. HubSpot’s native Messenger channel becomes available in your HubSpot inbox settings.

  3. In HubSpot, go to Inbox settings → Channels, locate the newly added Messenger channel, and assign it to the inbox you want to use.

Once the channel is active in HubSpot, Messenger conversations arrive in that inbox directly.

Step 6: Send a test message

  1. From a personal Facebook account, open Messenger and search for your Page.

  2. Send a message.

  3. Open the HubSpot inbox assigned to the Messenger channel. A new conversation appears with the message.

  4. Reply from HubSpot.

  5. The reply arrives in your Messenger conversation.

What Facebook allows

  • Inbound messages from anyone who messages your Page arrive in HubSpot.

  • Reactions, attachments, GIFs, and stickers are supported.

  • Outbound messages can be sent within the 24-hour messaging window after the customer’s last message. Outside that window, Facebook blocks outbound messages except the approved Messenger message tags.

  • Quick replies and button templates can be sent through the Octopods API.

Tips for Page admins

  • Assign the Page to Octopods-connected admins through Facebook Business Manager → Assigned Assets. This keeps the connection stable if individuals change roles.

  • If the person who connected the channel leaves your organization and loses Page access, reconnect with another admin before the token expires.

Common issues

  • “HubSpot re-authorization required” — follow the prompt to grant Messenger messaging permissions.

  • “No Pages available” — the Facebook user you signed in with does not have admin or editor access on any Page. Ask a Page admin to sign in, or get them to grant you access first.

  • Messages don’t arrive in HubSpot — in HubSpot’s Inbox settings → Channels, confirm the Messenger channel is still assigned to the inbox and both HubSpot and Octopods show the channel as Connected.

What’s next

Did this answer your question?