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

# Facebook User Interaction

> Configure the persistent menu, Get Started button, commands, and conversation sync for Messenger.

## What is this?

Facebook Interaction is where you configure how your connected Facebook Page's Messenger experience behaves — the persistent menu, the Get Started welcome screen, Messenger slash commands, and importing existing conversations into the platform.

\[SCREENSHOT: facebook-user-interaction-overview — the Facebook User Interaction page with its four tabs: Persistent Menu, Welcome Screen, Commands, Conversation Sync]

## What can I do here?

**Persistent Menu tab**

* Add up to 5 menu items (Facebook's recommended limit) as **Postback** or **Web URL** actions via **Add Item**
* Edit or delete existing menu items (pencil / trash icons)
* View configured items in a table: Item, Title, Type, Action / URL, Actions

**Welcome Screen tab**

* Open the **Get Started Payload** row to configure the postback payload sent to your webhook when a user taps Messenger's Get Started button
* Save the payload to enable Get Started, or **Disable** to turn it off
* See its current status (Enabled / Disabled) at a glance

**Commands tab**

* Add, edit, or delete Messenger slash commands (a name of 1–32 characters and a description of 1–64 characters, up to 100 commands) via **Add Command**
* View all commands in a table: Command, Description, Actions

**Conversation Sync tab**

* **Queue Sync** to import Facebook Messenger conversations into the platform in small background batches, continuing from the last sync cursor
* **Reset & Sync** to start a fresh sync from scratch
* **Refresh** to check the current sync status
* Review sync stats: Conversations processed, Contacts upserted, Messages created, Messages skipped, Errors
* See the sync status (idle / queued / running / completed / failed) and its Requested, Started, and Completed timestamps

## How to use it

Go to **Facebook → Interaction** and choose a tab.

<Tabs>
  <Tab title="Persistent Menu">
    1. Open the **Persistent Menu** tab (the default view).

       \[SCREENSHOT: facebook-user-interaction-persistent-menu — the Persistent Menu tab with its items table]

    2. Click **Add Item**.

    3. Choose a **Type** — Postback or Web URL — enter a **Title**, and for Web URL, enter a **URL**.

       \[SCREENSHOT: facebook-user-interaction-menu-modal — the Add Menu Item dialog with Title, Type, and URL/Payload fields]

    4. Click **Save**. The menu updates on your connected Facebook Page; existing open chats need a refresh to see the update.

    5. Use the pencil icon to edit an item, or the trash icon to remove it.
  </Tab>

  <Tab title="Welcome Screen">
    1. Click the **Get Started Payload** row.

       \[SCREENSHOT: facebook-user-interaction-get-started-modal — the Get Started Payload dialog with the payload input, Save, and Disable buttons]

    2. Enter a **Postback Payload** and click **Save** to enable it, or click **Disable** to turn off the Get Started button.
  </Tab>

  <Tab title="Commands">
    1. Open the **Commands** tab.

       \[SCREENSHOT: facebook-user-interaction-commands — the Commands tab listing configured slash commands]

    2. Click **Add Command**, then enter a **Command Name** (1–32 characters) and **Description** (1–64 characters). You can add up to 100 commands.

    3. Click **Save**. Use the pencil and trash icons on a row to edit or remove a command.
  </Tab>

  <Tab title="Conversation Sync">
    1. Open the **Conversation Sync** tab.

       \[SCREENSHOT: facebook-user-interaction-conversation-sync — the Conversation Sync tab showing the status pill and the stats grid]

    2. Click **Queue Sync** to import conversations, continuing from where the last sync left off.

    3. Click **Reset & Sync** to start over from scratch — use this if a previous sync failed with permission or thread errors, or after reconnecting the Page.

    4. Click **Refresh** to check the latest status and stats.
  </Tab>
</Tabs>

Editing and deleting on this page require the `facebook:edit` and `facebook:delete` permissions respectively; without them, the corresponding controls are disabled. Without any Facebook permission, or without a connected Page, the page shows an access-denied or setup-required message instead.

## Related docs

* [Facebook overview](/workspace/facebook/overview)
* [Facebook Insights](/workspace/facebook/facebook-insights)
* [Instagram User Interaction](/workspace/instagram/instagram-user-interaction)