> ## Documentation Index
> Fetch the complete documentation index at: https://boundbot.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Messenger

> Connect Facebook Messenger and send page conversations into BoundBot.

export const BrowserWrapper = ({src, alt, title, description, height = '280px', caption, imgStyle = {}, children, imagePadding = '0px'}) => {
  const legacyDocsImagePrefix = '/images/';
  const productionDocsImagePrefix = '/docs/images';
  const rawSrc = typeof src === 'string' ? src : src && (src.src || src.default) || '';
  const imageSrc = rawSrc.startsWith(legacyDocsImagePrefix) ? `${productionDocsImagePrefix}/${rawSrc.slice(legacyDocsImagePrefix.length)}` : rawSrc;
  return <Frame caption={caption || alt || title} width="100%">
      <div style={{
    border: '1px solid #e2e8f0',
    borderRadius: '12px',
    overflow: 'hidden',
    boxShadow: '0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -2px rgba(0, 0, 0, 0.05)',
    width: '100%'
  }}>
        <div style={{
    backgroundColor: '#f8fafc',
    padding: '10px 15px',
    borderBottom: '1px solid #e2e8f0',
    display: 'flex',
    gap: '6px'
  }}>
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ff5f56'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#ffbd2e'
  }} />
          <div style={{
    width: '10px',
    height: '10px',
    borderRadius: '50%',
    backgroundColor: '#27c93f'
  }} />
        </div>
        <div style={{
    overflow: 'hidden',
    background: '#ffffff',
    width: '100%',
    padding: imagePadding
  }}>
          {src ? <img src={imageSrc} alt={alt || ''} data-docs-screenshot style={{
    ...imgStyle,
    width: '100%',
    minWidth: '100%',
    height: 'auto',
    display: 'block',
    borderRadius: '0px'
  }} /> : children ? children : null}
        </div>
      </div>
    </Frame>;
};

Messenger is currently labeled **Beta** in the <a href="https://www.boundbot.com/dashboard/channels/messenger" target="_blank" rel="noopener noreferrer">dashboard</a> and is available on Starter and above.

## Connect Messenger

1. Open <a href="https://www.boundbot.com/dashboard/channels/messenger" target="_blank" rel="noopener noreferrer"><b>Channels</b> -> <b>Messenger</b></a>.

2. Click **Connect channel**.

   <BrowserWrapper src="../images/messege-insta/connect1.png" alt="BoundBot Messenger channel page with the Connect channel button highlighted." caption="Start the Messenger connection flow from the BoundBot Channels dashboard." />

3. Select the bot you want to use.

4. Click **Continue with Meta**.

   <BrowserWrapper src="../images/messege-insta/switch-acc2.png" alt="Meta authorization screen prompting you to continue with Meta and select the correct account." caption="Continue with Meta and confirm you are authorizing the correct Meta account." />

5. If you previously connected Messenger, click **Edit previous settings** to review page and permission selections.

   <BrowserWrapper src="../images/messege-insta/edit-previes-settigs5.PNG" alt="Meta authorization flow showing the Edit previous settings option." caption="Use Edit previous settings to adjust page selection and permissions before you approve." />

6. Approve the required Meta permissions.

   <BrowserWrapper src="../images/messege-insta/all-access4.png" alt="Meta permissions approval screen listing the required access for Messenger and connected assets." caption="Approve the required Meta permissions so BoundBot can receive and respond to messages." />

7. Choose the Facebook page you want to connect.

   <BrowserWrapper src="../images/messege-insta/choes-page3.png" alt="Meta page selection screen for choosing the Facebook page to connect to BoundBot." caption="Choose the Facebook Page that will route Messenger conversations into BoundBot." />

8. Once the Meta authorization is complete, you will see a success confirmation. Click **Got it** to proceed.

   <BrowserWrapper src="../images/messege-insta/gotit6.png" alt="Success confirmation screen after completing the Meta authorization flow." caption="Confirm the success prompt to complete the Messenger connection." />

9. In the final selection step, pick the Facebook/Instagram account pairing used by your Page.

   <BrowserWrapper src="../images/messege-insta/select-fac-ins-account7.png" alt="Final account selection screen showing connected Facebook and Instagram accounts for the selected Page." caption="Select the correct Facebook Page and Instagram account combination for message routing." />

10. Confirm the success prompt and finish the connection.

<BrowserWrapper src="../images/messege-insta/done8.png" alt="BoundBot Messenger channel shown as active and connected in the Channels dashboard." caption="The Messenger channel is active and ready to receive conversations." />

## Mandatory setup guides (Meta requirements)

These settings are required to ensure Messenger and Instagram messaging routes correctly from Meta into BoundBot.

### Facebook setup

1. Navigate to your specific Facebook Page.
2. Open **Settings & Privacy** -> **Linked Accounts**.
3. Connect your Instagram and WhatsApp accounts.
4. Open **Page Setup** -> **People with Facebook access**.
5. Send an invitation by entering the required details and confirming access.

### Instagram setup

1. Switch to a business account: **Settings and Activity** -> **Account type and tools** -> **Switch to Business Account**.
2. Enable message access: **Settings** -> **Messages and story replies** -> **Message requests**.
3. Toggle permissions: turn on **Allow access to messages**.

<Tip>
  After the channel is connected, test the bot by sending **Hi** from a different account to confirm the conversation appears in Inbox and the agent replies.
</Tip>

## What happens next

After OAuth completes, BoundBot creates the channel and associates it with your selected bot. New Messenger threads then appear in <a href="https://www.boundbot.com/dashboard/inbox" target="_blank" rel="noopener noreferrer"><b>Inbox</b></a> with the page context attached.

## Recommended checks

* Send a test message to the connected page.
* Confirm the thread appears in <a href="https://www.boundbot.com/dashboard/inbox" target="_blank" rel="noopener noreferrer"><b>Inbox</b></a>.
* Review the page display label on the conversation.
* Verify the correct bot is answering.

<Note>
  The <a href="https://www.boundbot.com/dashboard/channels/messenger" target="_blank" rel="noopener noreferrer">dashboard setup page</a> is focused on Messenger. If you plan broader Meta channel support, make sure your app review and permissions are already in place.
</Note>

## Related pages

<CardGroup cols={2}>
  <Card title="Channels overview" icon="messages-square" href="/channels/overview">
    Compare Messenger with WebChat, WhatsApp, Telegram, Slack, and Discord.
  </Card>

  <Card title="Inbox" icon="inbox" href="/guides/inbox">
    Confirm new Messenger threads appear in the shared conversation workspace.
  </Card>

  <Card title="Bots" icon="bot" href="/guides/bots">
    Review the bot that answers on the connected Facebook page.
  </Card>

  <Card title="Plans and limits" icon="badge-dollar-sign" href="/reference/plans-and-limits">
    Check Messenger availability by plan before you roll it out.
  </Card>
</CardGroup>