Omnichannel Admin's Guide

OmniChannel adds the ability to receive conversations from a pop-up livechat support on your website or your business Facebook chat or any other channel directly in

Rocket.Chat had minimal Livechat as a feature for a long time.

Recently the demand for production-grade Livechat has increased, so we did a complete rewrite of the package.


Enable Livechat feature

To enable the Livechat feature on your Rocket.Chat instance:

  1. Go to Administration.

  1. Search 'Omnichannel' in Settings and enable it.

Now the admin will have access to Omnichannel Panel Settings ** through a new menu called Omnichannel at the top left corner dropdown menu, as shown below:


OmniChannel Basic Settings

  1. Enable Omnichannel on your Rocket.Chat instance.

  2. Enable/Disable request comment from the agent when closing a conversation.

  3. Enable/Disable acceptance of new omnichannel requests when the agent is idle

  4. Enable/Disable continuous sound notification for new omnichannel room/conversation.

  5. Enable/Disable file uploads in livechat widget.

  6. Enable/Disable asking the visitor if they would like a trascript of the conversation.

  7. Enter the message to show when asking for a transcript.

Business Hour

The feature turns on the omnichannel toggle for the set business hours automatically. And you will be able to receive omnichannel conversations after. The toggle will be turned off during off-hours. The enterprise workspaces have an option to set up multiple business hours according to different time zones and their business needs. Community workspaces can only set up one set of business hours.

  1. Enable business hours.

  2. Choose multiple business hours according to your enterprise needs.

CRM Integration

Please follow the steps given here.

External Frame

If you have an app that you want to integrate with Rocket.Chat and use that app to embed an iFrame in Rocket.Chat to interact with your CRM, you can do so using External Frame.

  1. Enable external frame.

  2. Add the URL of your external frame.

  3. Enter the encryption key, as shown beow:


If your organization wishes to communicate with users of Facebook, you can enable integration within Rocket.Chat to do so.

First, you will need to request an API key from Rocket.Chat Support then set it up within your Administration area.

Send an email to [email protected] to request an API key. These are processed as time allows, and may take a few days, but you should have your key and secret soon enough.

  1. Enable Facebook integration.

  2. Enter your OmniChannel API Key

  3. Enter OmniChannel API Secret. Save the changes.


If you are a GDPR compliant company and want to allow your visitors to request to remove their data, allows you to do that for all your incoming chats, as shown below:


  1. Set the title of your widget.

  2. Set the color of the title bar of your widget.

  3. Enable message character limit.

  4. Set the allowed message character length.

  5. Display offline form.

  6. Validate email address.

as shown below:

Now customize the appears of your livechat widget here, for the hours when none of your agents are online/working.

  1. Set Offline Form Unavailable Message, if any.

  2. Set Offline Tittle.

  3. Set Title **bar Color** for offline widget.

  4. Give instructions, if any.

  5. Set the email address where you want to receive your offline messages.

  6. Set success message to display to the visitor when they have sent their message offline

as shown below:

Some more settings that you can customise according to your needs are shown below:

RD Station

This is a CRM integration with RD Station.

We setup your token, and when a new livechat conversation starts, your visitor information is sent to the RD station.


Routing allows you to define the behavior of your livechat queues.

Detail of every setting is listed below:

  1. Select your preferred routing method. (Please refer to this article for information on types of routing methods used in rocket chat.)

  2. Enable acceptance of incoming omnichannel requests even if there are no online agents if you want.

  3. Enable if you want the routing system to attempt to find a bot agent before addressing new conversations to a human agent.

  4. Set the limit of Max number of items displayed in the queue if you want.

  5. Enable if you want to show the livechat queue to all the agents.

  6. Mention your External Queue Service URL if your Omnichannel Routing Method is External Service.

  7. Enter Secret Token.

  8. Enable the Waiting queue if you want.

  9. Enter the max. number of simultaneous chats that you want your agents to attend.

  10. The Number of recent chats to calculate estimated wait time defines the number of last served rooms that will be used to calculate queue wait times.

  11. Enable The Last-Chatted Agent Prrefered setting allocates chats to the agent who previously interacted with the same visitor if the agent is available when the chat starts.


Sessions allow you to decide how you want to handle your chat sessions when an agent goes offline.

  1. You can either forward the chat to another agent, close it or do nothing.

  2. Mention the amount of time in seconds that you want to wait before you want to consider that the agent has abandoned the chat.

  3. Enter the message to display to the visitor on closing the session.

  4. Mention the time you want to wait to consider visitor abandonment?

  5. Enable automatic closing of rooms abandoned by the visitor if you want.

  6. Enter the message to display to the visitor when room is automatically closed by visitor inactivity.

As shown below: