# Блокировки

Раздел **Блокировки** — список правил, из-за которых посетитель не может начать диалог. Сюда попадают блокировки, созданные [из диалога в РМО](https://webim.ru/kb/for-agents/online-work-with-visitors/block-visitor.html), и блокировки, добавленные в этом разделе вручную.

Пункт **Блокировки**, ведущий в соответствующий раздел, расположен в навигационном меню отдельным пунктом верхнего уровня. Кнопка блокировки в диалоге — на панели ответа в РМО. Раздел и кнопка доступны, если в тарифе включена блокировка посетителей. Доступ к странице задаётся функциональностью `ui.bans` ([атрибуты политик](https://webim.ru/kb/for-admins/access-control-system/available-attributes.html)). В политиках по умолчанию раздел открыт администратору, супервизору и оператору. Состав ролей меняется в [редакторе политик](https://webim.ru/kb/for-admins/service-pages/policies-editor.html). Кратко права собраны в статье [Роли](https://webim.ru/kb/for-admins/roles.html).

Создание, изменение и снятие блокировки пишутся в [историю действий](https://webim.ru/kb/for-admins/action-log.html) с объектом **Блокировка**.

Пока правило активно, посетитель с совпавшим идентификатором не начинает новый диалог. Если его диалог находится в состоянии `queue`, `chatting`, `hold` или `closed_by_operator`, диалог переходит в состояние `closed`, а в ленте появляется сообщение [Посетитель был заблокирован оператором](https://webim.ru/kb/for-admins/system-messages.html). В состояниях `chatting_with_robot`, `invitation` и `routing` состояние диалога не меняется. Список состояний — в [схеме жизненного цикла чата](https://webim.ru/kb/dev/basic-objects/life-of-chat.html). После снятия или истечения срока диалог в состоянии `closed` сам не открывается: посетитель может начать новый.

![Страница «Блокировки»](https://webim.ru/kb/img/online-work-with-visitors/block-visitor/block-menu.webp "блокировки"){ style="width: 4320px; max-width: 100%" }

## Вкладки

На странице две вкладки:

  * **Активные блокировки** — правила, которые ещё действуют: их не сняли, и срок **До** ещё не наступил.

  * **Отключенные блокировки** — правила, которые сотрудник снял, и правила, у которых срок уже истёк.

При переключении вкладки период поиска возвращается к значению по умолчанию: с даты месяц назад по сегодняшний день.

## Поиск

Над таблицей задаются период и строка поиска. Период фильтрует блокировки по времени создания. Самая поздняя дата периода — сегодня. По умолчанию выбран интервал с даты месяц назад по сегодня.

Текст, введённый в строке **Введите данные блокировки посетителя**, ищется в таких полях: имя посетителя, IP-адрес, адрес электронной почты, телефон, идентификатор канала, идентификатор посетителя в канале, имя оператора, создавшего блокировку, и комментарий.

После ввода нажмите **Искать** или клавишу Enter.

В таблице по 15 записей, сначала более новые. Если записей больше, под таблицей есть постраничная навигация.

Кнопка **Добавить блокировку** в шапке страницы доступна всегда, в том числе когда в таблице уже есть записи. Если поиск ничего не нашёл, таблица пустая и показывается сообщение, что условиям не соответствует ни одна блокировка.

## Колонки таблицы

  * **Данные посетителя** — идентификаторы правила. У каждого значения подписан тип: **Имя**, **Адрес**, **Адрес электронной почты**, **Номер телефона**, **Идентификатор канала**, **Идентификатор в канале**, **Токен устройства**. Пустые поля не показываются.

  * **Имя оператора** — сотрудник, который создал блокировку.

  * **Время блокировки** — когда запись создана.

  * **До** — до какой даты блокировка действует.

  * **Количество блокировок** — сколько записей с теми же идентификаторами уже было, включая текущую.

  * **Исключена сотрудником** — кто снял блокировку. Если правило только истекло по сроку, в колонке прочерк.

  * **Время исключения** — когда блокировку сняли. Если её не снимали вручную, в колонке прочерк.

  * **Диалоги** — идентификаторы диалогов, которые совпали с данными правила:

      * по адресу электронной почты;

      * по телефону;

      * по паре «канал и идентификатор в канале»;

      * по IPv4-адресу сессии;

      * по push-токену устройства.

    Имя посетителя в этот отбор не входит.

  * **Комментарий** — текст, указанный при создании или изменении.

  * **Действие** — только на вкладке **Активные блокировки**:

      * **Изменить блокировку** — открывает ту же форму, что и добавление;

      * **Исключить блокировку** — снимает правило. Перед снятием нужно ответить согласием на вопрос **Вы действительно хотите снять блокировку?**. После этого появляется сообщение **Блокировка снята**, запись переходит на вкладку **Отключенные блокировки**.

Идентификатор в колонке **Диалоги** открывает [протокол этого диалога](https://webim.ru/kb/for-admins/threadprocessor.html) в отдельном окне.

![Протокол диалога](https://webim.ru/kb/img/online-work-with-visitors/block-visitor/chat-thread.webp "протокол диалога"){ style="width: 4026px; max-width: 100%" }

## Снятие и изменение {: #снятие-и-изменение}

Снятая или истёкшая запись в форме больше не редактируется. Снятие оставляет строку в списке: на вкладке **Отключенные блокировки** видны сотрудник и время исключения.

Как блокировка из диалога выбирает идентификаторы и на какой срок создаётся, описано в статье [Блокировка посетителя](https://webim.ru/kb/for-agents/online-work-with-visitors/block-visitor.html).

## Добавление блокировки

Нажмите **Добавить блокировку**. Обязательна дата **Блокировка действительна до**. Самая ранняя дата в календаре — завтра. Остальные поля заполняются по необходимости.

Нужен хотя бы один блокирующий идентификатор. Если его нет, форма сообщает: **Вы должны заполнить хотя бы одно поле - адрес, адрес электронной почты, идентификатор в канале, номер телефона или push-токен**.

Если активная блокировка уже содержит тот же адрес, почту, телефон, push-токен или ту же пару «канал и идентификатор в канале», сохранение прерывается сообщением **Этот посетитель уже заблокирован**.

Длина текстовых полей — не больше 255 символов.

  * **Имя**. Подсказка поля: «Поле будет отображено в истории, но не будет блокировать посетителя. Например: Иванов Иван Иванович».

  * **Адрес** — IPv4-адрес, например `192.0.2.10`. IPv6 не поддерживается.

  * **Адрес электронной почты** — адрес в обычном виде, например `user@mail.local`.

  * **Номер телефона**. Пример из подсказки: `79513400200`. При сохранении остаются только цифры, поэтому номер с пробелами и «+» совпадает с тем же набором цифр.

  * **Каналы** — канал, в котором действует идентификатор посетителя. Пока канал не выбран, значение **Не выбрано**. Подсказка: «Выберите канал, в котором будет заблокирован посетитель».

  * **Идентификатор в канале** — появляется после выбора канала. Пример из подсказки: `id7687687`. Пара «канал и идентификатор» сохраняется только вместе: идентификатор без канала не записывается, а смена канала на **Не выбрано** очищает оба поля. Для ВКонтакте префикс `id` при сохранении отбрасывается, поэтому `id7687687` и `7687687` — одна и та же блокировка.

  * **push-токен** — токен push-уведомлений мобильного приложения посетителя. Подсказка поля: «Формат: строка в шестнадцатеричном формате».

  * **Комментарий** — причина запрета, не длиннее 255 символов.

Кнопка сохранения создаёт запись и возвращает к списку. Сообщение об успехе: **Посетитель заблокирован**. При изменении уже существующей записи сообщение другое: **Изменения сохранены**.

Параметр `ban_conditions` в [настройках аккаунта](https://webim.ru/kb/for-admins/service-pages/account-config-editor.html) ограничивает идентификаторы только при блокировке из диалога в РМО. Форма этого раздела позволяет указать любой из перечисленных идентификаторов независимо от `ban_conditions`.

---

Источник: https://webim.ru/kb/for-admins/bans.html
