Добавление кнопок в АРМ агента

Обновлено: 18 сентября 2025

В АРМ агента можно добавить дополнительные кнопки двух типов:

• Кнопка для перехода по ссылке в профиле клиента. Например, можно использовать, чтобы из АРМ агента перейти в карточку клиента из CRM-системы заказчика.
• Кнопка для формирования ссылки в области поля ввода сообщения. Например, можно использовать, чтобы сформировать уникальную ссылку с формой для обратной связи по определенному треду и добавить её в поле ввода сообщения.

к сведению

Настройка кнопок выполняется в таблице workplace-settings, находящейся в базе данных.

Вы можете настроить и добавить две кнопки одновременно.

Кнопка для перехода по ссылке

Кнопка позволяет агенту перейти по ссылке, которая может содержать следующие данные:

• идентификатор треда;
• внешний идентификатор клиента;
• идентификатор клиента из CRM-системы заказчика.

Переменные

Для формирования URL кнопки используется шаблон clientCardUrlTemplate, который может содержать переменные для замены на актуальные данные:

Переменная	Данные
${threadId}	Идентификатор текущего треда.
${externalClientId}	Идентификатор клиента, передаваемый SDK.
${'path', 'regex', 'replacement', 'flags'}	Переменная позволяет в шаблоне использовать любой идентификатор клиента из объекта ClinetInfo (например, телефон). Также эту переменную в шаблоне ссылки можно указать несколько раз.

Параметры переменной ${'path', 'regex', 'replacement', 'flags'}

Параметр	Характер	Описание
path	Обязательный	Путь в объекте ClientInfo. Пример: - common.externalClientId
regex	Необязательный	Паттерн регулярного выражения для поиска в строке. Если параметр не задан — трансформация не выполняется. Примеры: - ^\+7 — найти префикс +7 в начале строки; - \d+ — найти все цифры; - [^a-zA-Z0-9] — найти все не алфавитно-цифровые символы.
replacement	Необязательный	По умолчанию — пустая строка, на которую будет заменено найденное совпадение. Можно использовать $1, $2 и т. д. для ссылок на группы захвата. $& — вставить полное совпадение. Если не задан параметр, но задан паттерн регулярного выражения — найденный текст удаляется. Примеры: - '' — удалить найденный текст; - $1-$2-$3 — форматировать захваченные группы через дефис; - prefix_$& — добавить префикс ко всему совпадению.
flags	Необязательный	флаги регулярного выражения, управляющие поведением поиска. По умолчанию — g, глобальный поиск. Доступные флаги, которые можно комбинировать: - g — global: найти все совпадения (по умолчанию); - i — ignore case: регистронезависимый поиск; - m — multiline: ^ и $ работают с каждой строкой; - s — dotAll: точка совпадает с переводом строки. Примеры: - g — заменить все вхождения; - gi — заменить все вхождения, без учета регистра; - i — заменить только первое вхождение, без учета регистра.

Дополнительные параметры

Параметр	Описание
clientCardUrlText	Текст кнопки, отображаемой в АРМ агента.
clientCardUrlSameTab	Открытие ссылки в существующем или в новом окне. Значение по умолчанию — false. Чтобы открывать ссылку в новом окне, оставьте значение по умолчанию. Чтобы открывать ссылку в существующем окне, укажите значение true.

к сведению

Параметр clientCardUrlSameTab доступен в edna Chat Center версии 6.26 и выше.

Пример настройки кнопки для перехода по ссылке

workplace-settings

"clientCardUrlTemplate": "threadId=${threadld}&externalClientId=${externalClientId}&value=${'common.crm_id', '.*_(\d+)$', '$1'}",
"clientCardurlText" : "Открыть карточку клиента в CRM",
"clientCardUrlSameTab" : "true"

подсказка

Чтобы удалить кнопку для перевода по ссылке из АРМ агента, удалите ключ clientCardUrlTemplate из таблицы workplace-settings.

Кнопка для формирования ссылки

Кнопка позволяет агенту сформировать ссылку и добавить ее в поле ввода сообщения, чтобы отправить клиенту. При нажатии на кнопку формируется ссылка по шаблону, указанному в workplace-settings. Ссылка может включать в себя идентификатор треда.

Для формирования URL кнопки используется шаблон clientCardTemplateButton.template, который может содержать переменную ${threadId} для замены на актуальный идентификатор треда.

Доступные дополнительные параметры:

Параметр	Описание
clientCardTemplateButton.text	Текст кнопки, отображаемой в АРМ агента.
clientCardTemplateButton.enabled	Отображение кнопки в карточке клиента. false — значение по умолчанию, чтобы временно скрыть кнопку без удаления настроек. Чтобы отображать кнопку, укажите значение true.

Пример настройки кнопки для формирования ссылки

workplace-settings

"clientCardTemplateButton.template" : "https://domain/${threadId}",
"clientCardTemplateButton.text" : "Получить ссылку",
"clientCardTemplateButton.enabled" : "true"