--- title: "Rocket Chat Instagram Direct App" slug: "instagram-direct" description: "Connect Instagram Direct with Rocket Chat to unify secure customer communication, streamline omnichannel support, and boost engagement." tags: ["Premium"] status: "update" updated: 2026-04-28T16:37:29Z published: 2026-04-28T21:47:57Z canonical: "docs.rocket.chat/instagram-direct" excludeFromExternalSearch: true --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.rocket.chat/llms.txt > Use this file to discover all available pages before exploring further. # Instagram Direct ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Enterprise.svg) With the Instagram Direct app, you can directly handle messages from your Instagram Business inbox in Rocket.Chat. Instagram users contact you via Instagram Direct messages, and you answer chats from your Rocket.Chat workspace. Some key features of this integration include sending messages with quick reply buttons, welcome messages(starting/closing chat), file sharing, and the correlation between your Instagram Direct pages and your Rocket.Chat departments. The Instagram Direct integration is available to the following Instagram Direct Professional Accounts: - All business accounts - Creator accounts via a phased roll-out, beginning with accounts with less than 500k followers > For more official info, see [Instagram messaging with the Messenger platform](https://developers.facebook.com/docs/messenger-platform/instagram). ## Install Instagram Direct app To install the Instagram Direct app, - Click **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) **> Explore**. - Search for the **Instagram Direct** app. - Click **Install** and accept the needed permissions. You receive a message from `instagram.bot` in the `#omnichannel-instagram-setup` channel with setup instructions. > [!WARNING] > You must have the [Omnichannel feature](/v1/docs/omnichannel) enabled and have [agents](/v1/docs/agents) and [managers](/v1/docs/managers) assigned to receive and send Omnichannel messages. ## Configure Instagram Direct app ### Handover protocol If you have multiple Facebook apps connected to a single Facebook account, then Facebook allows those apps to participate in a conversation by passing control of the conversation between them. This feature is known as the Handover protocol. If you use the Handover protocol on your account, this Instagram app allows you to perform some handover operations. > To learn more, see the official documentation for [handover protocol](https://developers.facebook.com/docs/messenger-platform/instagram/features/handover-protocol). To configure the Instagram Direct app, - On the Instagram Direct App I**nfo** screen, navigate to **Settings**. - Update the required fields: > **Take Thread Control** action will only work if you've configured Rocket.Chat Omni-gateway app as a **Primary Receiver** from Facebook Apps page settings. - **Agents Display Name:** Choose to display the agent's name or username. - **File Upload Enabled:** Enable/disable file sharing and set a limit for maximum upload size. - **Accepted Media Types:** Select the type of files that can be exchanged during a conversation. - **Delete messages once it has been "Unsend" from Instagram:** Select what to do with Unsent messages. - **Instagram Handover Protocol Action:** It defines the action which should be performed while sending an agent's message to a thread to get access to the thread. - **Instagram Handover Protocol Metadata:** It defines the metadata to be passed along with thread control action requests. You can use this to pass some custom payload to other apps. - Click **Save Changes**. ## Instagram Direct authentication Before sending any messages, you must authorize the **Omni-Gateway** to send and receive Instagram Direct messages on behalf of your account. Ensure that each of the following requirements is met before starting the authentication process: - An Instagram [Business Account](https://help.instagram.com/502981923235522). - A [Facebook account](https://www.facebook.com/). - A [Facebook page](https://www.facebook.com/pages/creation/) connected to your Instagram account. > See the Meta guide on [connecting your Facebook page to your Instagram account](https://help.instagram.com/589697191199472/?helpref=hc_fnav). - Enable [Message Control Connected Tools Settings](https://developers.facebook.com/docs/messenger-platform/instagram/get-started#connected-tools-toggle) from your Instagram account on mobile. - Make sure your Rocket.Chat instance is on a public address and is accessible to anyone on the internet. Go to **Manage > Workspace > General > Site Url** to confirm this. - Lastly, ensure your Rocket.Chat instance is connected to Rocket.Chat Cloud. Go to **Manage > Workspace > Subscription** to sync to Cloud. ### Authentication To start the authentication with Instagram Direct, - From the `instagram.bot message`, click on the Start Authentication button. - You are redirected to a page to log in and authorize Instagram Direct. - Select the Instagram business account you want to use with Rocket.Chat Omni Gateway. - If you have multiple pages associated with your Instagram account, it will prompt you to choose the preferred page to connect. - Determine what Rocket.Chat Omni Gateway can do with the pages you have selected. - After selecting your page, you will receive a success message with credentials for your Instagram Business Account that has been authenticated and subscribed. ### Subscribe/Unsubscribe You are automatically subscribed to the Instagram page following successful authentication. However, you can choose to unsubscribe. - From the list of connected Instagram Business Accounts, click the **UNSUBSCRIBE** button against the account you want to unsubscribe. ### Edit page configurations To update the page configurations, - Click the **Edit Page Config** button under the account and update the following settings: - **Department**: You can route all the conversations from this page to a specific [**department**](/v1/docs/departments). Only the agents of this department can serve conversations coming from this page. - **Welcome Message:** First message your customer will receive when they message you. - **Conversation Finished Message:** A message sent to your customer when a conversation is closed. - **Default message for offline service:** Message sent to your customer when no agents are available online. > [!CAUTION] > When an Instagram user sends a message, and no agent is available on the server to chat, the conversation won't be created. This means that when agents return to work, they will not know someone was reaching out. Therefore, please ensure you always have at least one agent online. ## Instagram Direct app shortcuts The Instagram Direct app has a list of shortcuts to ease usage. - `/instagram authorize`**::** Starts the Instagram authorization process to connect your Instagram accounts. - `/instagram unauthorize`**:** Revoke Instagram authorization to remove all connected Instagram accounts. - `/instagram edit pageId`**:** Edit Page configuration for the given pageId. - `/instagram edit username`**:** Edit configuration for the given Instagram username. - `/instagram help`**:** Shows help message. ## Uninstall Instagram Direct app To delete the Instagram Direct app from your workspace, - Go to **Marketplace** ![](https://cdn.us.document360.io/6ae79a05-7252-45d0-96e8-8f375e07b1b2/Images/Documentation/Screenshot 2025-12-23 130453.png) **> Installed**. - Click th**e kebab menu** against the **Instagram Direct** **app**. - Select **Uninstall**. - Click **Yes** to confirm the uninstallation. > [!CAUTION] > You cannot receive messages on Rocket.Chat if you have a country restriction set on Instagram.