[New] Create Emergency Livechat Shutdown Switch

app/livechat/server/api/lib/livechat.js

@@ -164,6 +164,8 @@ export function settings(url) {
 			limitTextLength: initSettings.Livechat_enable_message_character_limit
 
 			&& (initSettings.Livechat_message_character_limit || initSettings.Message_MaxAllowedSize),
+			livechat_kill_switch: initSettings.Livechat_kill_switch,
+			livechat_kill_switch_message: initSettings.Livechat_kill_switch_message,
 		},
 		theme: {
 			title: initSettings.Livechat_title,

app/livechat/server/config.js

@@ -19,6 +19,21 @@ Meteor.startup(function() {
 		public: true,
 	});
 
+	settings.add('Livechat_kill_switch', false, {
+		type: 'boolean',
+		group: 'Omnichannel',
+		section: 'Livechat',
+		public: true,
+		i18nDescription: 'Livechat_kill_switch_description',
+	});
+
+	settings.add('Livechat_kill_switch_message', 'Livechat is Currently Offline', {
+		type: 'string',
+		group: 'Omnichannel',
+		section: 'Livechat',
+		public: true,
+	});
+
 	settings.add('Livechat_title_color', '#C1272D', {
 		type: 'color',
 		editor: 'color',

app/livechat/server/hooks/leadCapture.js

@@ -1,3 +1,5 @@
+import { Meteor } from 'meteor/meteor';
+
 import { callbacks } from '../../../callbacks';
 import { settings } from '../../../settings';
 import { LivechatVisitors } from '../../../models';
@@ -45,3 +47,9 @@ callbacks.add('afterSaveMessage', function(message, room) {
 
 	return message;
 }, callbacks.priority.LOW, 'leadCapture');
+
+callbacks.add('beforeSaveMessage', function() {
+	if (settings.get('Livechat_kill_switch')) {
+		throw new Meteor.Error(settings.get('Livechat_kill_switch_message'));
+	}
+}, callbacks.priority.LOW, 'leadCapture');

app/livechat/server/lib/Livechat.js

@@ -471,6 +471,8 @@ export const Livechat = {
 		Settings.findNotHiddenPublic([
 			'Livechat_title',
 			'Livechat_title_color',
+			'Livechat_kill_switch',
+			'Livechat_kill_switch_message',
 			'Livechat_enable_message_character_limit',
 			'Livechat_message_character_limit',
 			'Message_MaxAllowedSize',

app/livechat/server/lib/routing/AutoSelection.js

@@ -1,5 +1,6 @@
 import { RoutingManager } from '../RoutingManager';
 import { LivechatDepartmentAgents, Users } from '../../../../models/server';
+import { settings } from '../../../../settings/server';
 
 /* Auto Selection Queuing method:
 	*
@@ -20,6 +21,9 @@ class AutoSelection {
 	}
 
 	getNextAgent(department, ignoreAgentId) {
+		if (settings.get('Livechat_kill_switch')) {
+			return null;
+		}
 		if (department) {
 			return LivechatDepartmentAgents.getNextAgentForDepartment(department, ignoreAgentId);
 		}

app/livechat/server/lib/routing/External.js

@@ -19,6 +19,9 @@ class ExternalQueue {
 	}
 
 	getNextAgent(department, ignoreAgentId) {
+		if (settings.get('Livechat_kill_switch')) {
+			return null;
+		}
 		for (let i = 0; i < 10; i++) {
 			try {
 				let queryString = department ? `?departmentId=${ department }` : '';

app/livechat/server/methods/getInitialData.js

@@ -92,6 +92,8 @@ Meteor.methods({
 		info.registrationFormMessage = initSettings.Livechat_registration_form_message;
 		info.showConnecting = initSettings.Livechat_Show_Connecting;
 		info.hideSysMessages = initSettings.Livechat_hide_sys_messages;
+		info.livechat_kill_switch = initSettings.Livechat_kill_switch;
+		info.livechat_kill_switch_message = initSettings.Livechat_kill_switch_message;
 
 		info.agentData = room && room[0] && room[0].servedBy && Users.getAgentInfo(room[0].servedBy._id);
 

packages/rocketchat-i18n/i18n/en.i18n.json

@@ -2439,6 +2439,9 @@
   "Livechat_guest_default_avatar": "Default Guest Avatar",
   "Livechat_Inquiry_Already_Taken": "Omnichannel inquiry already taken",
   "Livechat_Installation": "Livechat Installation",
+  "Livechat_kill_switch": "Emergency Livechat Shutdown",
+  "Livechat_kill_switch_description": "Temporarily Disable Livechat Communication with Agents",
+  "Livechat_kill_switch_message": "Emergency Livechat Shutdown Message",
   "Livechat_last_chatted_agent_routing": "Last-Chatted Agent Preferred",
   "Livechat_last_chatted_agent_routing_Description": "The Last-Chatted Agent setting allocates chats to the agent who previously interacted with the same visitor if the agent is available when the chat starts.",
   "Livechat_managers": "Omnichannel managers",