# Change log (новые версии) itgrix\_bx

Подписывайтесь на канал в Telegram [Itgrix\_news](https://t.me/itgrix_news), где публикуются изменения Itgrix.

## Версии

| Версия (новый функционал) | Тип            | Актуальный релиз (патч)             |
| ------------------------- | -------------- | ----------------------------------- |
| [3.13](#id-3.13.0).\*     | Актуальная     | [3.13.15](#id-3.13.15) - 29.04.2026 |
| [3.12](#id-3.12.0).\*     | Поддерживается | [3.12.11](#id-3.12.11) - 29.01.2026 |
| [3.11](#id-3.11.0).\*     | Поддерживается | [3.11.14](#id-3.11.14) - 15.07.2025 |

{% hint style="info" %}
Версии обозначаются тремя числами `X.Y.Z`:

* `X` - мажорная версия, крупные изменения с нарушением совместимости
* `Y` - минорная версия, новый функционал и доработка старого
* `Z` - патч, исправления ошибок

Последние 3 минорные версии обновляются патчами. Актуальная минорная версия содержит самый новый функционал и все применимые исправления. Поддерживаемые версии получают только совместимые с ними исправления.

Обновиться на версию `X.Y.Z`: `/opt/itgrix_bx/update.sh --version=X.Y.Z`
{% endhint %}

## Лог изменений

Версии упорядочены по дате релиза.

### 3.13.15

> 29.04.2026

**Исправлены ошибки**

* Исправлено редкое нарушение порядка обработки событий дозвона и ответа на C2C звонках (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена ошибка кастомизации номеров телефонов на звонках, которые инициализируются на локальных каналах (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена задержка проверки лицензии после сетевых проблем
* Исправлена опечатка в выводе флага `--help`
* При регистрации звонка используется поле `EXTERNAL_CALL_ID`
* Улучшена процедура проверки пользователя AMI
* При авторизации в портале, его адрес автоматически добавляется в список разрешённых доменов CORS
* При установке файл конфигурации logrotate создаётся с более строгими правами доступа `0600`
* Обновлена устоновочная версия файла конфигурации logrotate: хранить 7 ротаций вместо 5, использовать "вчерашнюю" дату в именах файлов, обновлены комментарии

**Кастомизатор**

* В файле конфигурации перечисляются все точки кастомизации, в том числе отключенные

### 3.12.11

> 29.01.2026

**Исправлены ошибки**

* Исправлена проверка прав БД со старыми настройками в момент изменения настроек подключения
* Исправлено формирование адресов записей с не-HTTP(S) схемой
* Оптимизирован запрос поиска связанных звонков
* Улучшено логирование бэкапов и добавлена поддержка симлинков при бэкапе

### 3.13.14

> 28.01.2026

**Админка**

* Улучшена вёрстка таблиц в админке
* Улучшено отображение ошибок переобработки звонков в админке
* Исправлены ошибки выполнения команд state в админке (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена редкая ошибка формирования CSV файлов
* Добавлена опция переобработки звонков с очисткой state

**Исправлены ошибки**

* Исправлена ошибка работы с данными звонка при показе карточки на ответе (наблюдалось с версии [3.13.0](#id-3.13.0))
* Оптимизирован запрос поиска связанных звонков (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена ошибка переподключения к БД при сетевых проблемах
* Исправлено формирование адресов записей с не-HTTP(S) схемой

**Кастомизатор**

* Данные кастомизаций `custom_data` восстанавливаются при повторной обработке звонка
* В данных кастомизации `customize_recording_query` поле "CallID" переименовано в "call\_id"

### 3.13.13

> 16.10.2025

**Админка**

* Добавлена возможность скачать вывод в формате CSV на странице БД Itgrix
* В списках пользователей в админке отображаются только активные
* Исправлена проверка прав БД со старыми настройками в момент изменения настроек подключения (наблюдалось с версии [3.13.10](#id-3.13.10))

**Исправлены ошибки**

* Исправлена циклическая переобработка звонка при ошибке регистрации (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлено срабатывание фильтра по внутренним номерам на транке

### 3.13.12

> 20.08.2025

**Исправлены ошибки**

* Исправлено редкое падение при коллизии ID разговоров между звонками (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлен устаревший запрос поиска звонков за время простоя (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлен вывод ошибки таймаута в лог при очень быстром выполнении SQL запросов (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена работа таймаута при проверке соединения с БД Asterisk (наблюдалось с версии [3.13.0](#id-3.13.0))
* Улучшено логирование бэкапов и добавлена поддержка симлинков при бэкапе

### 3.11.14

> 15.07.2025

**Админка**

* Обновлён порядок, названия и логотипы приложений на странице авторизаци в CRM
* Исправлен формат вывода минимальной версии Asterisk в статусах в админке
* Исправлена обработка "certified" версий Asterisk

**Исправлены ошибки**

* Исправлено зависание при одновременном сбое AMI и MySQL
* Добавлена поддержка параметра `path` в узле API `/get_config`

### 3.12.10

> 14.07.2025

{% hint style="warning" %}
Обратите внимание на изменения в лицензировании для лицензии по подписке Маркет Битрикс24:

* 5 пользователей вместо 6;
* только базовые кастомизации вместо всех кастомизаций.

Для работы с лицензией по подписке необходим доступ к серверу лицензирования lk.bx24asterisk.ru, иначе действует бесплатная лицензия с меньшим функционалом.
{% endhint %}

**Админка**

* В статусы на главной странице добавлена проверка прав на обновление таблицы CDR
* Исправлена проблема сохранения логина AMI
* Исправлена проблема отображения статуса лицензии
* Обновлён формат минимальной версии Астера в текстах в админке
* Исправлены ошибки сохранения настроек

**Исправлены ошибки**

* Исправлена загрузка ID пользователей в сохранённых звонках при возобновлении работы после остановки
* Исправлено редкое падение при переводах
* Изменены условия бесплатной лицензии по подписке Маркет Битрикс24: 5 пользователей, только базовые кастомизации
* Улучшено логирование API запроса `/status`

### 3.13.11

> 03.07.2025

**Исправлены ошибки**

* Исправлен цикл переподключения сокета в админке (наблюдалось с версии [3.13.10](#id-3.13.10))
* Исправлено падение при обработке ошибки дублирования регистрации звонка (наблюдалось с версии [3.13.10](#id-3.13.10))
* Улучшено логирование API запроса `/status`

### 3.13.10

> 01.07.2025

**Что нового**

* В статусы на главной странице добавлена проверка прав на обновление таблицы CDR
* В вывод API запроса `/status` добавлены поля `app.launched_at` и `app.system_up_since`

**Админка**

* Исправлена редкая ошибка переподключения к сокету и использование некорректного порта для сокета
* Улучшена вёрстка на странице БД Asterisk
* Обновлены плейсхолдеры полей запросов в админке

**Исправлены ошибки**

* Исправлено отсутствие события начала звонка при обработке звонков, включающих дозвон самому себе
* Улучшена работа со `state.db` при пропуске шагов обработки звонка и при работе с зависимыми шагами
* Исправлена задержка применения настроек ч/б фильтров (наблюдалось с версии [3.13.0](#id-3.13.0))
* Добавлена обработка ошибок отсутствия звонка в CRM на момент завершения звонка

**Кастомизатор**

* ID звонка используется при логировании в кастомизаторе
* В кастомизации при автораспределении добавлены данные звонка

### 3.13.9

> 29.04.2025

**Исправлены ошибки**

* Исправлено обновление пути до записи в таблице CDR когда исходное значение recordingfile не содержит полный путь (наблюдалось с версии [3.13.0](#id-3.13.0))
* В запрос API `/state` добавлена поддержка заголовка `Accept: application/json`
* Обновление пути до записи в таблице CDR не выполняется если алиас поля recordingfile совпадает с другим полем

**Кастомизатор**

* В кастомизацию `customize_record_conversion` добавлены параметры `initial_cdr_recordingfile` и `updated_cdr_recordingfile`
* Функции логирования в кастомизаторе принимают значения любого типа, а не только строки
* Добавлено определение ID звонка (`2_call_id`) в кастомизациях `process_record_file_path` и `customize_autodistribution`

### 3.13.8

> 10.04.2025

**Админка**

* В админке на странице БД Itgrix добавлена история запросов

**Исправлены ошибки**

* Исправлено обновление имени записи в таблице CDR при конвертации в mp3 (наблюдалось с версии [3.13.0](#id-3.13.0))

### 3.13.7

> 02.04.2025

**Админка**

* В админке добавлена обработка ошибки настройки доступа к службе Supervisor по HTTPS (наблюдалось с версии [3.13.0](#id-3.13.0))
* В админке исправлено отображение новых кастомизаций (наблюдалось с версии [3.13.0](#id-3.13.0))
* Обновлена всплывающая подсказка о включении конвертации записей в mp3

**Исправлены ошибки**

* Исправлено падение при отключении от БД Asterisk во время выполнения запроса (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлен порядок создания таблиц в БД Itgrix при использовании флага `--sql` (наблюдалось с версии [3.13.0](#id-3.13.0))
* Добавлен регулярный вывод в лог статистики звонков в БД Itgrix

### 3.13.6

> 17.03.2025

**Исправлены ошибки**

* Исправлена работа ч/б списка по транкам: применятся только ко входящим звонкам (наблюдалось с версии [3.13.0](#id-3.13.0))
* По умолчанию отключена конвертация записей через кастомизацию, вместо этого используются настройки конвертера в админке
* Путь к исполняемому файлу ffmpeg по умолчанию изменён с относительного на абсолютный

### 3.13.5

> 11.03.2025

**Админка**

* Исправлено отображение кастомизаций в админке в режиме по подписке (наблюдалось с версии [3.13.4](#id-3.13.4))

**Исправлены ошибки**

* Исправлено падение при чтении устаревших данных регистрации звонка из БД (наблюдалось с версии [3.13.4](#id-3.13.4))
* Добавлен порт HTTPS Supervisor по умолчанию

### 3.13.4

> 10.03.2025

{% hint style="warning" %}
Обратите внимание на изменения в лицензировании для лицензии по подписке Маркет Битрикс24:

* 5 пользователей вместо 6;
* только базовые кастомизации вместо всех кастомизаций.

Для работы с лицензией по подписке необходим доступ к серверу лицензирования lk.bx24asterisk.ru, иначе действует бесплатная лицензия с меньшим функционалом.
{% endhint %}

**Админка**

* Исправлена ошибка проверки статуса БД Asterisk до создания таблиц в БД Itgrix (наблюдалось с версии [3.13.0](#id-3.13.0))

**Исправлены ошибки**

* Улучшена процедура повторной регистрации звонка при переобработке
* Исправлена обработка обратных звонков с коротких номеров
* Изменены условия бесплатной лицензии по подписке Маркет Битрикс24: 5 пользователей, только базовые кастомизации

### 3.13.3

> 03.03.2025

**Исправлены ошибки**

* Исправлена загрузка ID пользователей в сохранённых звонках при возобновлении работы после остановки (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена работа флагов очистки данных приложения (наблюдалось с версии [3.13.0](#id-3.13.0))
* Добавлена статистика по времени выполнения операций с БД
* Улучшено логирование при таймауте операций с БД

### 3.13.2

> 27.02.2025

**Админка**

* Исправлено выполнение пользовательских SQLite запросов типа update из админки (наблюдалось с версии [3.13.0](#id-3.13.0))

**Исправлены ошибки**

* Исправлено падение при проверке наличия регистрации в данных звонка (наблюдалось с версии [3.13.0](#id-3.13.0))

### 3.13.1

> 26.02.2025

**Админка**

* Исправлено отображение устаревшей версии страницы ч/б списков в админке (наблюдалось с версии [3.13.0](#id-3.13.0))
* Исправлена проблема отображения обновлений в админке (наблюдалось с версии [3.12.0](#id-3.12.0))
* Исправлен формат вывода минимальной версии Asterisk в статусах в админке

**Исправлены ошибки**

* Из установочного файла конфигурации убраны примеры заполнения разрешённых пользователей

### 3.13.0

> 24.02.2025

{% hint style="danger" %}
**Внимание! Изменения в кастомизаторе нарушают обратную совместимость с кастомизациями, написанными для версий ниже v**[**3.10.0**](#id-3.10.0)**!**

В версии v[3.10.0](#id-3.10.0) был добавлен новый [формат данных звонка](/custom_common/dannye-o-zvonke-call_full-v-kastomizaciyakh.md) `call_full`, но старые поля в корне данных кастомизаций были временно оставлены для совместимости. Теперь эти старые поля убраны и данные, которые присутутвуют в `call_full`, более не дублируются в корне.

Если у вас есть кастомизации, написанные для версий ниже v[3.10.0](#id-3.10.0), вам может быть нужно обновить их код. Обратитесь за дополнительной информацией в техподдержку.
{% endhint %}

**Что нового**

* Вместо файла состояния `state.json` теперь используется SQLite база данных `state.db`. Благодаря этому:
  * Во время низкой активности приложение повторно обрабатывает звонки, при обработке которых возникли ошибки
  * Результат каждого действия при обработке звонка сохраняется и используется при повторной обработке для предотвращения дублирования
  * При восстановлении работы после перезапуска, звонки за время с момента остановки обрабатываются в отдельном потоке с меньшим приоритетом и не блокируют обработку текущих звонков, так же как при повторной обработке во время низкой активности
  * Уменьшен объём логирования, и теперь по умолчанию данные звонка выводятся в лог только в конце звонка
* Добавлена конвертация записей в основной логике (не через кастомизацию) при помощи сторонних конвертеров, в том числе `ffmpeg` в поставке модуля
* Добавлена возможность передавать произвольные данные между кастомизациями без использования специальной базы данных
* Добавлен чёрный/белый список транков в админке
* Добавлены новые кастомизации: параметров конвертации записи, запроса поиска записи, обработки ответа на Originate

**Админка**

* На страницу статусов добавлен статус наличия/активности в CRM всех пользователей, выбранных в настройках
* Добавлены настройки конвертации записи
* Добавлена страница "Itgrix DB" для доступа к `state.db`
* Улучшена работа списков
* Улучшена работа с веб-сокетами
* Исправлено отображение неактивных пользователей в списках

**Обработка данных звонков**

* Реализована обработка C2C звонков на несколько устройств по протоколу PJSIP
* Исправлено отсутствие завершения разговора в одном из звонков управляемого перевода
* Исправлена обработка неотвеченных FollowMe звонков

**Исправлены ошибки**

* Исправлена замена экранированных символов Юникод при выводе в лог
* Исправлено использование параллельных батч-запросов при их низком заполнении
* При ошибке CRM 401 делается попытка обновить токен
* Добавлен таймаут для процедуры остановки приложения
* Улучшена обработка ошибок в коннекторе CRM
* Улучшено логирование ошибок запросов к CRM

**Кастомизатор**

* Данные из сообщения AMI OriginateResponse включены в данные о регистрации звонка
* Обновлена документация в кастомизациях
* Убраны устаревшие поля во входных данных кастомизаций (в пользу нового поля `call_full`)

**Служба Supervisor**

* Добавлена поддержка HTTPS

### 3.12.9

> 19.02.2025

**Админка**

* Исправлены ошибки сохранения данных в мастере настройки
* Исправлена обработка "certified" версий Asterisk

**Исправлены ошибки**

* Добавлена поддержка параметра `path` в узле API `/get_config`
* Исправлена ошибка при сравнении таймштампов времени завершения разговоров на x32 системах
* Добавлена защита от потенциальных зависаний в процесе остановки приложения

### 3.12.8

> 13.01.2025

**Админка**

* Обновлён порядок, названия и логотипы приложений на странице авторизаци в CRM
* Исправлено отображение кнопки перезапуска служб
* В Мастере настройки исправлено сохранение настроек при переходах между шагами
* Исправлено отображение паролей

**Исправлены ошибки**

* Исправлены ответы на запросы `/pbx/read_call`, `/pbx/read_cel` и `/crm/request` при остановке модуля
* Исправлено редкое зависание при переобработке частично обработанных звонков (наблюдалось с версии [3.12.0](#id-3.12.0))

### 3.12.7

> 17.12.2024

**Админка**

* Исправлен вывод старых логов в ответ на запрос переобработки звонка (наблюдалось с версии [3.10.0](#id-3.10.0))

**Исправлены ошибки**

* Исправлено зависание при одновременном сбое AMI и MySQL
* Исправлено редкое падение при одновременном наполнении и выводе данных статистики (наблюдалось с версии [3.12.0](#id-3.12.0))
* Добавлена попытка автоматического обновления токена при ошибке авторизации в CRM
* Улучшено логирование ошибок запросов к CRM

### 3.12.6

> 20.11.2024

**Админка**

* Исправлена регулярная потеря соедиения с вебсокетом для обновления статуса приложения в админке (наблюдалось с версии [3.11.0](#id-3.11.0))

**Исправлены ошибки**

* Исправлено чтение целочисленных значений в диагностических запросах к БД Asterisk (наблюдалось с версии [3.12.3](#id-3.12.3))
* Исправлена обработка неактивных пользователей: при поиске по номеру телефона отдавать приоритет активным (наблюдалось с версии [3.12.3](#id-3.12.3))

### 3.11.13

> 19.11.2024

**Админка**

* Обновлена документация кастомизаций в Админке

**Исправлены ошибки**

* Добавлено кэширование неактивных пользователей
* Улучшена обработка ошибок соединения с C2C-сервером
* Включен вывод в лог результата управляемого перевода (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено чтение целочисленных значений в диагностических запросах к БД Asterisk

### 3.10.19

> 19.11.2024

**Админка**

* Обновлена документация кастомизаций в Админке

**Исправлены ошибки**

* Дополнен список прав AMI по умолчанию
* Более подробный вывод в лог данных регистрации звонка
* Исправлено редкое падение при чтении данных AMI
* Исправлена ошибка чтения ID при создании задачи
* Улучшена обработка ошибок соединения с C2C-сервером
* Исправлено чтение целочисленных значений в диагностических запросах к БД Asterisk

**Кастомизатор**

* Разрешено увеличивать таймаут для кастомизации пути записи

### 3.12.5

> 08.10.2024

**Исправлены ошибки**

* Исправлен вывод в лог содержимого файла записи при таймауте запроса прикрепления записи
* В ответ на запрос `/crm/request` добавлен ID запроса
* При обработке запроса `/pbx/read_call` логируется ID запроса, добавлен вывод в лог если найдено ноль записей CEL
* Включен вывод в лог сообщения об успешном переводе звонка

### 3.12.4

> 03.09.2024

**Админка**

* Обновлена документация кастомизаций в Админке

**Исправлены ошибки**

* Исправлены ошибки поиска неактивных пользователей в API модуля (наблюдалось с версии [3.12.3](#id-3.12.3))
* Исправлена обработка ошибок чтения запросов от сервера C2C
* Исправлено поведение по умолчанию для кастомизаций ссылки на запись и показа карточки: вместо отмены запроса ничего не менять (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен вывод в лог специальных символов HTML
* Исправлена ошибка логирования входящих запросов (наблюдалось с версии [3.10.10](#id-3.10.10))

### 3.12.3

> 18.07.2024

**Исправлены ошибки**

* Исправлено потенциальное зависание авторизации HTTP-сервера при одновременном таймауте и успехе
* Добавлено кэширование неактивных пользователей

### 3.11.12

> 04.07.2024

**Исправлены ошибки**

* Исправлено редкое падение при определении ответственного за звонки, неотвеченные на IVR
* Исправлена ошибка в альтернативном способе поиска ID разговора при управляемом переводе
* Исправлена ошибка чтения ID при создании задачи (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено редкое зависание при продолжительных сетевых проблемах связи с AMI (наблюдалось с версии [3.11.0](#id-3.11.0))

### 3.12.2

> 03.07.2024

**Админка**

* Исправлено отображение успеха при нажатии кнопки Обновить список пользователей (наблюдалось с версии [3.12.0](#id-3.12.0))

**Исправлены ошибки**

* Исправлено редкое падение на звонках с пустыми номерами в переводах (наблюдалось с версии [3.12.0](#id-3.12.0))
* Исправлено редкое падение при определении ответственного за звонки, неотвеченные на IVR (наблюдалось с версии [3.12.0](#id-3.12.0))
* Исправлено редкое зависание при продолжительных сетевых проблемах связи с AMI (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлена ошибка подсчёта данных статистики на час (наблюдалось с версии [3.12.0](#id-3.12.0))
* Расширена статистика запросов к CRM

### 3.12.1

> 26.06.2024

**Исправлены ошибки**

* Исправлена ошибка редактирования источников транков в админке (наблюдалось с версии [3.12.0](#id-3.12.0))
* Исправлена ошибка загрузки пользователей в админке (наблюдалось с версии [3.12.0](#id-3.12.0))

### 3.12.0

> 18.06.2024

**Что нового**

* События CEL с `channame` вида `Local/...` обрабатываются и используются для обработки управляемых переводов
* Добавлено обновление ответственных в повторных лидах
* Повышена производительность за счёт отправки нескольких запросов `batch` в CRM одновременно
* Создание сущности считается успешным если получен ID но не сама сущность
* Изменён формат внутренних ID в логах
* Добавлено сквозное логирование с использованием внутренних ID в обработке автораспределения, C2C и запросов от кастомизаций
* Улучшена обработка и вывод ошибок запросов в CRM
* Отчёт для техподдержки можно генерировать запуском приложения с флагом `--report`, даже если нормальный запуск проходит неуспешно
* В запросе `/pbx/read_call` можно указывать настройки интервалов между событиями звонка и добавлять связанные звонки
* В запрос `/pbx/read_cel` добавлена поддержка данных в формате `.json`
* В запросе `/crm/request` можно указывать ID звонка

**Админка**

* На главной странице добавлена поддержка вывода нескольких сообщений в одном статусе приложения
* Добавлена страница настройки FMC
* Улучшено обновление статусов приложения в реальном времени

**Исправлены ошибки**

* В настройках `logrotate` при установке явно указывается использование даты в именах файлов
* Улучшена обработка временных зон при чтении CEL
* Звонки неизвестного типа не удаляются из кэша на ответе
* Процедура обновления номеров телефонов в звонке сделана более безопасной
* Исправлена ошибка в альтернативном способе поиска ID разговора при управляемом переводе

**Кастомизатор**

* Добавлена кастомизация отклонённых событий звонка, с помощью которой можно обрабатывать звонки между сотрудниками, нераспознанные звонки, дубликаты звонков и звонки с некорректными данными
* Переводы звонков хранятся в данных звонка как отдельные объекты
* В запросе пользователей можно пользоваться кэшем для поиска по ID и телефону
* Параметр ActionID для Originate включён в кастомизацию

### 3.11.11

> 30.05.2024

**Исправлены ошибки**

* Исправлено отображение успеха авторизации в CRM
* Исправлены редкие ошибки валидации настроек
* Исправлен многократный перезапуск при обновлении токена CRM когда открыта админка (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлена ошибка скрытия карточки после длинных звонков (наблюдалось с версии [3.11.0](#id-3.11.0))
* Улучшена обработка ошибок авторизации в CRM
* Дополнен список прав AMI по умолчанию
* Исправлены ошибки расписания проверки лицензии (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено редкое падение при чтении данных AMI
* Более подробный вывод в лог данных регистрации звонка
* Добавлен вывод в лог момента отправки запроса Originate

### 3.10.18

> 08.04.2024

**Исправлены ошибки**

* Запрос пользователей может работать на основе кэша когда нет соединения с CRM
* Исправлен сброс кэша пользователей при выполнении запроса с фильтром (наблюдалось с версии [3.8.0](#id-3.8.0))
* Исправлено потенциальное зависание при ошибках проверки лицензии (наблюдалось с версии [3.8.0](#id-3.8.0))
* Исправлена ошибка закрытия карточки звонка при большой продолжительности разговора

### 3.11.10

> 04.04.2024

**Что нового**

* Добавлено новое опциональное разрешение приложения `user.userfield` для доступа к кастомным полям пользователей

**Админка**

* Подсказки в админке дополнены ссылками на актуальную документацию

**Исправлены ошибки**

* Исправлен сброс кэша пользователей при выполнении запроса с фильтром (наблюдалось с версии [3.8.0](#id-3.8.0))
* Исправлена ошибка регистрации звонка с внешней линией, не принадлежащей текущему инстансу (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлена задержка обработки управляемых переводов при наличии локальных каналов (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлена редкая ошибка определения статуса звонка при его завершении (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлена ошибка проверки лицензии при запуске кастомизаций (наблюдалось с версии [3.10.14](#id-3.10.14))
* Исправлено потенциальное зависание при ошибках проверки лицензии (наблюдалось с версии [3.8.0](#id-3.8.0))

### 3.11.9

> 12.02.2024

**Админка**

* Обновлены подсказки в админке

**Исправлены ошибки**

* Реализована синхронизация номеров `from` между начальными исходящими PJSIP разговорами
* В настройки по умолчанию (при начальной установке) добавлена автозамена номера клиента на C2C: удаление не-цифровых символов
* В настройках по умолчанию (при начальной установке) отключена автозамена FMC номеров
* Исправлены лишние запросы лицензии при обновлении токена CRM
* Исправлено определение пути к файлу `fmc_patterns` для нестандартных установок

**Логи**

* Исправлен некорректный вывод ошибки поиска сущности в `OriginatedConversationRequested`
* Исправлено некорректное логирование ID в ошибке создания канала

### 3.11.8

> 18.12.2023

**Исправлены ошибки**

* Исправлено падение при дозвоне на FMC номер не распознанный как FMC (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.11.7

> 11.12.2023

**Админка**

* Исправлены ошибки отображения списка внешних линий в админке (наблюдалось с версии [3.11.5](#id-3.11.5))

**Исправлены ошибки**

* При завершении звонка может находиться не только номер пользователя, но и номер клиента (наблюдалось с версии [3.11.0](#id-3.11.0))
* При запуске исходящего звонка PJSIP номер пользователя используется во всех разговорах начатых одновременно, а не только в одном
* Исправлена таймзона при парсинге времени создания канала (наблюдалось с версии [3.11.3](#id-3.11.3))
* Запрос пользователей может работать на основе кэша когда нет соединения с CRM
* В запрос `/status` добавлен раздел со статистикой ошибок и звонков

### 3.9.11

> 24.11.2023

**Админка**

* В выводе MySQL в админке исправлено отображение `NULL` значений

**Исправлены ошибки**

* Исправлено редкое зависание при отключении от AMI (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен редкий кейс циклического перезапуска C2C-клиента (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.10.17

> 24.11.2023

**Админка**

* Обновлён текст статуса при отсутствии недавних записей звонков в таблице CDR

**Исправлены ошибки**

* Исправлено редкое зависание при отключении от AMI (наблюдалось с версии [3.10.0](#id-3.10.0))
* Добавлена поддержка чтения из CEL колонки `extra` со значениями `NULL`
* Исправлен редкий кейс циклического перезапуска C2C-клиента (наблюдалось с версии [3.10.0](#id-3.10.0))
* Расширена обработка ошибок соединения с AMI

### 3.11.6

> 15.11.2023

**Админка**

* Исправлена ошибка при редактировании списка транков (наблюдалось с версии [3.11.5](#id-3.11.5))
* Улучшена валидация значений хостов CORS и адреса портала

### 3.11.5

> 14.11.2023

**Админка**

* Исправлена ошибка сохранения настроек при первом запуске (наблюдалось с версии [3.11.0](#id-3.11.0))
* Обновлено форматирование таблицы на странице MySQL
* Обновлён текст статуса при отсутствии недавних записей звонков в таблице CDR

**Исправлены ошибки**

* Улучшена синхронизация звонков при обработке перехвата
* Исправлены лишние перезапуски при обновлении токена по расписанию (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен редкий кейс циклического перезапуска C2C-клиента (наблюдалось с версии [3.10.0](#id-3.10.0))
* Расширена обработка ошибок соединения с AMI
* Исправлена редкая ошибка интерпретации причины завершения звонка (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.11.4

> 17.10.2023

**Админка**

* Исправлено сохранение списка префиксов и ч/б списка в админке

**Исправлены ошибки**

* Исправлена ошибка определения направления управляемого перевода на части входящих звонков (наблюдалось с версии [3.11.0](#id-3.11.0))
* Добавлена поддержка чтения из CEL колонки `extra` со значениями `NULL`
* Улучшен вывод ошибок в логе

### 3.11.3

> 11.10.2023

**Исправлены ошибки**

* Исправлена ошибка сохранения изменений в списке транков в админке (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено редкое зависание при отключении от AMI (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен сброс последнего прочитанного из CEL ID при рестарте
* Исправлена редкая ошибка определения таймзоны при чтении CEL
* Исправлена постановка в очередь события начала звонка при определении номера на ответе (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено зависание при повторном завершения разговора во время управляемого перевода (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено некорректное завершение разговора при управляемом переводе (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено падение при отсутствии разговора на управляемом переводе (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлена отмена создания задачи из кастомизации (наблюдалось с версии [3.11.0](#id-3.11.0))

### 3.10.16

> 13.09.2023

**Админка**

* В выводе MySQL в админке исправлено отображение `NULL` значений
* На странице MySQL добавлена возможность менять размер поля запроса
* Исправлены мелкие проблемы вёрстки страниц админки

**Исправлены ошибки**

* Исправлена редкая проблема приоритизации разговоров в звонке (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлено некорректное логирование ошибок создания сущностей при C2C звонках (наблюдалось с версии [3.10.11](#id-3.10.11))
* Исправлено повторное чтение событий звонка, находящихся в очереди обработки в момент перезапуска

**Кастомизатор**

* Исправлена обработка отмены создания задачи из кастомизации (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.11.2

> 13.09.2023

**Админка**

* Исправлена задержка отображения статусов на главной странице (наблюдалось с версии [3.11.0](#id-3.11.0))
* На странице MySQL добавлена возможность менять размер поля запроса
* Исправлены мелкие проблемы вёрстки страниц админки

**Исправлены ошибки**

* Исправлена утечка лимита открытых файлов при работе с файлом токена (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.11.1

> 06.09.2023

**Исправлены ошибки**

* Исправлено сохранение настроек автозамены в админке (наблюдалось с версии [3.11.0](#id-3.11.0))
* Исправлено падение при ошибках подключения к базе данных (наблюдалось с версии [3.11.0](#id-3.11.0))

### 3.11.0

> 31.08.2023

**Что нового**

* Добавлены отдельные автозамены для FMC номеров, транков и Originate запросов
* Добавлена настройки языка отправки данных в CRM
* Расширена поддержка управляемых переводов в различных конфигурациях
* При управляемом переводе время разговора между сотрудниками не считается ни в один из разговоров
* Реализована обработка звонков, где номер `to` в разговорах становится известен не при дозвоне, а при ответе или завершении
* При работе нескольких экземпляров приложения на одном портале между ними отслеживается владение/использование обработчиков событий и внешних линий
* Звонки, поставленные модулем на паузу, сохраняются при перезапуске службы модуля
* Добавлено прикрепление записей в звонки, неотвеченные на IVR
* Добавлена обработка события AMI `OriginateResponse`
* C2C запросы из CRM сопоставляются со звонками в Asterisk по ID вместо телефонов
* Для очень объёмных звонков реализовано сжатие данных при передаче звонка в кастомизации

**Админка**

* Реализовано обновление статуса модуля в реальном времени и отображение проблемных статусов на всех страницах
* Добавлено отображение оффлайн лицензии модуля
* Добавлена настройка внешних линий отдельно от транков
* При успешном завершении мастера настройки автоматически выполняется переход на страницу бизнес-логики
* Настройка префиксов перемещена на страницу настроек модуля вместо бизнес-логики
* Кнопка перезапуска служб на главной странице отображает состояние процесса перезапуска

**Кастомизатор**

* Таймаут выполнения кастомизаций теперь можно настраивать отдельно для каждой кастомизации
* Разрешено включать/отключать все кастомизации, даже те которые ранее были "обязательными"
* Логи кастомизатора оформлены аналогично логам запросов в CRM

**Логи**

* Поля в логе форматируются отступами для улучшения читаемости
* Запросы к CRM, сгруппированные в батчи, выводятся в лог отдельно по одному с ID связанных звонков
* Более подробное логирование обработки событий CEL
* При сохранении звонков в `state.json` выводится общее число звонков и число активных звонков
* Добавлен вывод в лог "Processing finished" в случаях когда обработка конца звонка не выполняется
* В запросе `/crm/request` добавлен вывод в лог uuid запроса

**Исправлены ошибки**

* Таймаут обработки событий CEL увеличен до 3 часов
* В выводе MySQL в админке исправлено отображение `NULL` значений
* При поиске ответственного на автораспределении игнорируются неактивные пользователи
* FMC номера обновляются вместе с кэшем пользователей
* Исправлены отступы плейсхолдеров в админке
* Ошибка 500 от CRM больше не считается проблемой соединения
* Исправлена обработка спецсимволов в номерах C2C звонков
* Исправлена задержка смены портала в левом нижнем углу страниц админки
* Исправлено отсутствие перезапуска при изменении файла токена извне
* Улучшена обработка ошибок при завершении работы приложения

### 3.10.15

> 15.08.2023

**Исправлены ошибки**

* Исправлена ошибка редактирования портов в админке
* Изменён уровень логирования некоторых событий

### 3.9.10

> 15.08.2023

**Исправлены ошибки**

* `last_id` не сбрасывается при рестарте когда отключен `state.json`
* В админке исправлено падение при редактировании адреса C2C (наблюдалось с версии [3.9.0](#id-3.9.0))
* Исправлена ошибка редактирования портов в админке

### 3.8.9

> 15.08.2023

**Исправлены ошибки**

* `last_id` не сбрасывается при рестарте когда отключен `state.json`

### 3.10.14

> 24.07.2023

**Исправлены ошибки**

* `last_id` не сбрасывается при рестарте когда отключен `state.json`
* В ответ на запрос `/status` добавлены сведения об авторизации в CRM
* Исправлено повторное завершение разговоров при слепом переводе
* В админке исправлено падение при редактировании адреса C2C (наблюдалось с версии [3.9.0](#id-3.9.0))

### 3.10.13

> 27.06.2023

**Исправлены ошибки**

* Исправлены потенциальные проблемы проверки лицензии
* При управляемом переводе запускается не только обработка ответа, но и дозвона
* Добавлена поддержка управляемых переводов без ответа между сотрудниками
* Исправлена проблема определения пути к `state.json` на не новых не основных инстансах приложения (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлено логирование запросов от C2C-сервара

### 3.10.12

> 02.05.2023

**Исправлены ошибки**

* Исправлена утечка MySQL-соединений
* Оптимизирована работа с сущностями при автораспределении
* Статус звонка без ответа определяется направлением: входящий - пропущенный, исходящий - временно недоступен
* Исправлено отсутствие этапа обработки звонка `CallStarted` на некоторых C2C звонках
* Исправлена проблема переподключения к AMI при смене авторизационных данных
* Исправлена проблема переподключения к Apix при смене портала
* Улучшено логирование обработки CEL

### 3.9.9

> 02.05.2023

**Исправлены ошибки**

* Оптимизирована работа с сущностями при автораспределении
* Статус звонка без ответа определяется направлением: входящий - пропущенный, исходящий - временно недоступен
* Исправлено отсутствие этапа обработки звонка `CallStarted` на некоторых C2C звонках
* Исправлена проблема переподключения к AMI при смене авторизационных данных

### 3.8.8

> 02.05.2023

**Исправлены ошибки**

* Оптимизирована работа с сущностями при автораспределении
* Статус звонка без ответа определяется направлением: входящий - пропущенный, исходящий - временно недоступен
* Исправлено отсутствие этапа обработки звонка `CallStarted` на некоторых C2C звонках

### 3.10.11

> 23.03.2023

**Исправлены ошибки**

* Исправлена некорректная проверка минимальной версии Астериск (**13.0.0**)
* Исправлено падение при отсутствии целевого разговора при управляемом переводе исходящего (наблюдалось с версии [3.10.10](#id-3.10.10))
* Оптимизирована процедура запуска (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен регистр при выводе статуса приложения через API `/status`

**Кастомизатор**

* Исправлено отсутствие сущности в структуре звонка при C2C (наблюдалось с версии [3.10.0](#id-3.10.0))

### 3.10.10

> 07.03.2023

**Исправлены ошибки**

* Исправлено редкое зависание при обработке C2C звонков (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлена загрузка записей звонков, неотвеченных на IVR (наблюдалось с версии [3.10.0](#id-3.10.0))
* Статус неотвеченного звонка зависит от направления: входящий - пропущенный, исходящий - временно недоступен (наблюдалось с версии [3.10.5](#id-3.10.5))
* Исправлена обработка управляемых переводов нестандартной конфигурации (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлена обработка входящих отвеченных звонков с распределением на FMC номера (наблюдалось с версии [3.10.9](#id-3.10.9))
* Восстановлен флаг запуска `--legal` (наблюдалось с версии [3.10.0](#id-3.10.0))
* Оптимизирован поиск сущностей при автораспределении (наблюдалось с версии [3.9.0](#id-3.9.0))
* Улучшено логирование

**Кастомизатор**

* В кастомизацию прикрепления ссылки на запись звонка добавлены поля `old_description` и `record_url`

### 3.10.9

> 14.02.2023

**Админка**

* Исправлено падение страницы настроек модуля

**Исправлены ошибки**

* Исправлена обработка управляемых переводов на исходящих (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлена проблема установки соединения на некоторых маршрутах отдельных провайдеров, вызывавшая ошибку `TLS Handshake timeout`
* Исправлена остановка обработки C2C-запросов при ошибках доступа к данным звонков
* Исправлена редкая проблема обработки неотвеченных исходящих звонков

**Кастомизатор**

* Добавлены недостающие данные в ряд кастомизаций

### 3.9.8

> 14.02.2023

**Исправлены ошибки**

* Исправлена проблема установки соединения на некоторых маршрутах отдельных провайдеров, вызывавшая ошибку `TLS Handshake timeout`

### 3.8.7

> 14.02.2023

**Исправлены ошибки**

* Улучшена обработка ошибок при проверке лицензионного ключа
* Исправлена проблема установки соединения на некоторых маршрутах отдельных провайдеров, вызывавшая ошибку `TLS Handshake timeout`

### 3.10.8

> 31.01.2023

**Исправлены ошибки**

* Улучшена обработка ошибок при проверке лицензионного ключа

### 3.9.7

> 31.01.2023

**Исправлены ошибки**

* Улучшена обработка ошибок при проверке лицензионного ключа

### 3.10.7

> 31.01.2023

**Админка**

* Исправлены мелкие ошибки вёрстки в админке

**Исправлены ошибки**

* Исправлена ошибка проверки лицензионного ключа сразу после запуска приложения (наблюдалось с версии [3.9.0](#id-3.9.0))
* Исправлены редкие зависания при многократной обработке одного события звонка (наблюдалось с версии [3.10.0](#id-3.10.0))
* Улучшено логирование

### 3.9.6

> 31.01.2023

**Исправлены ошибки**

* Исправлена ошибка проверки лицензионного ключа сразу после запуска приложения (наблюдалось с версии [3.9.0](#id-3.9.0))
* Улучшено логирование

### 3.10.6

> 23.01.2023

**Исправлены ошибки**

* Исправлено зависание при перезапуске
* Улучшено логирование

### 3.9.5

> 19.01.2023

**Исправлены ошибки**

* Опция проверки статуса рабочего дня доступна в бесплатном приложении
* Исправлена проверка статуса разговора в конце звонка, из-за которой иногда ставилось неправильное время завершения разговора
* Статус входящего неотвеченного звонка изменён с 480 (временно недоступен) на 304 (пропущенный), дело создаётся незакрытым
* При C2C номер `to` обновляется по результатам кастомизации
* Исправлена ошибка обработки номера телефона при получении записи звонка по ссылке, когда начало номера совпадает с одним из префиксов
* Исправлено некорректное отображение ошибки "пользователь не является администратором" в статусе CRM
* Исправлено автораспределение на неактивных пользователей
* FMC номера из CRM теперь обновляются одновременно с кэшем пользователей (раз в час)
* Исправлен эскейпинг в `csv` файлах
* Улучшен вывод ошибок запросов
* Улучшено логирование

**Кастомизатор**

* В кастомизацию пути записи разговора добавлены новые варианты устранения дублирования пути

### 3.8.6

> 19.01.2023

**Исправлены ошибки**

* Опция проверки статуса рабочего дня доступна в бесплатном приложении
* Исправлена проверка статуса разговора в конце звонка, из-за которой иногда ставилось неправильное время завершения разговора
* Статус входящего неотвеченного звонка изменён с 480 (временно недоступен) на 304 (пропущенный), дело создаётся незакрытым
* При C2C номер `to` обновляется по результатам кастомизации
* Исправлена ошибка обработки номера телефона при получении записи звонка по ссылке, когда начало номера совпадает с одним из префиксов
* Исправлено некорректное отображение ошибки "пользователь не является администратором" в статусе CRM
* Исправлено автораспределение на неактивных пользователей
* FMC номера из CRM теперь обновляются одновременно с кэшем пользователей (раз в час)
* Улучшен вывод ошибок запросов
* Улучшено логирование

**Кастомизатор**

* В кастомизацию пути записи разговора добавлены новые варианты устранения дублирования пути

### 3.10.5

> 18.01.2023

**Исправлены ошибки**

* Исправлена редкая утечка памяти при превышении лимита времени обработки событий (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлено автораспределение на неактивных пользователей
* FMC номера из CRM теперь обновляются одновременно с кэшем пользователей (раз в час)
* Увеличена частота автоматического логирования статуса приложения (раз в час)
* Исправлены некорректные записи в логе

**Кастомизатор**

* В кастомизацию пути записи разговора добавлены новые варианты устранения дублирования пути

### 3.10.4

> 28.12.2022

**Исправлены ошибки**

* Исправлено падение при обработке неотвеченного звонка на FMC номер когда включена загрузка записей файлами (наблюдалось с версии [3.10.2](#id-3.10.2))

### 3.10.3

> 28.12.2022

**Исправлены ошибки**

* Исправлены падения при переводах без ответа на FMC номера (наблюдалось в версии [3.10.2](#id-3.10.2))
* Добавлена регистрация неотвеченных звонков, распределённых на FMC номера

### 3.10.2

> 26.12.2022

**Админка**

* Исправлена ошибка редактирования списка разрешённых пользователей
* В статусы CEL на главной странице добавлена проверка на устаревание на 15 часов с приоритетом отображения выше, чем отсутствие поля `extra`
* Добавлена проверка устаревания CDR на час
* В примеры MySQL запросов добавлено поле `extra`

**Исправлены ошибки**

* Обработка номеров телефонов в звонке выполняется в начале каждой стадии звонка, если ещё не выполнена
* Исправлена ошибка обновления номера `to` звонка (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлено подвисание при проблемах сохранения `state.json` (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлена ошибка удаления старых звонков из `state.json` (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлен порядок номеров `from`/`to` в ссылках на записи (наблюдалось с версии [3.10.0](#id-3.10.0))
* Исправлены ошибки обновления внешних линий (наблюдалось с версии [3.10.0](#id-3.10.0))
* При регистрации звонка для определения внешней линии и настроек транка используется исходный номер транка вместо кастомизированного
* Добавлена регистрация пропущенных звонков на FMC номера аналогично пропущенным на IVR, когда нельзя получить номер телефона
* Исправлено редкое падение при проблемах чтения токена
* Исправлена ошибка работы с конфигом при формировании отчёта для техподдержки (наблюдалось с версии [3.10.0](#id-3.10.0))

**Кастомизатор**

* Убран лишний запуск кастомизации `post_registration` после завершения регистрации
* Исправлено формирование legacy данных о сущности в кастомизациях

### 3.10.1

> 12.12.2022

**Исправлены ошибки**

* Исправлена ошибка формирования списка номеров при поиске файла записи (наблюдалось в версии [3.10.0](#id-3.10.0))
* Исправлено зависание при поиске записей для звонков без разговоров (наблюдалось в версии [3.10.0](#id-3.10.0))
* В запрос API `/status` добавлен параметр `path`

### 3.10.0

> 08.12.2022

{% hint style="danger" %}
**Внимание! Эти изменения могут повлиять на работу приложения:**

1. Минимальная версия Астериск увеличена до `13.0.0`. Начиная с этой версии, в CEL присутствует поле `extra` в ожидаемом нами формате.

   На более старых версиях приложение будет работать, но с предупреждениями. Обработка переводов звонков будет выполняться в режиме совместимости, а перехваты звонка не будут обрабатываться.
2. Изменилась схема логики и запуска кастомизаций, что особенно важно для нестандартных кастомизаций номеров телефонов, кастомизации `need_registration` и проверки ч/б списком.

   `need_registration` и ч/б список теперь вызываются в начале каждого этапа обработки звонка, кроме CallStarted. Кастомизации номеров теперь вызываются только в момент их получения - на CallStarted и ConversationRequested.
3. Изменились данные кастомизаций, но оставлены legacy данные для обратной совместимости.

   Кастомизации "по умолчанию" обновятся автоматически, но если в них вносились изменения, то необходимо их переписать вручную. Главное изменение - во все кастомизации теперь приходит объект `call_full` с более полными данными. Все данные теперь нужно брать из него.

   **Если вы ранее заказывали у нас кастомизации - обратитесь в нашу техподдержку за помощью в их обновлении.**
4. Изменён формат логов: новые имена полей и новый формат времени.

   Если были настроены дополнительные приложения для обработки логов, например для мониторинга ошибок, то необходимо их перенастроить.
5. Изменения в файлах `/etc/itgrix_bx/config.json` и `/opt/itgrix_bx/token.json` теперь отслеживаются в реальном времени.

   Для внесения изменений в эти файлы больше не нужно останавливать и перезапускать приложение, но и незаконченные изменения будут применяться сразу же. Если во время работы сохранить некорректный конфиг, то приложение продолжит работу с предыдущими настройками, но при следующем запуске выдаст ошибку и не заработает.
6. При некорректном файле конфига приложение теперь не игнорирует ошибочные данные, а отказывается запускаться.
7. В запросах к CRM через функции кастомизатора более недоступны данные помимо результата и ошибок.

   Такие данные, как время выполнения запроса на стороне CRM, теперь отсутствуют. Если вы опирались на них в своих кастомизациях, то необходимо переписать их.
   {% endhint %}

**Что нового**

* Усилена стандартизация логики работы приложения
* Добавлена опция показа карточки звонка на дозвоне либо при ответе
* Опция проверки статуса рабочего дня доступна в бесплатном приложении
* Добавлена настройка белого списка CORS (для управления правами на выполнение запросов к приложению с внешних ресурсов, таких как ваш сайт)
* Добавлен запрос API `/crm/request` для отправки запросов к CRM через общую очередь коннектора, что снижает замедление работы при дополнительных запросах из кастомизаций
* Добавлены новые кастомизации: показа карточки, прикрепления URL записи звонка, кастомизация после регистрации разговора
* Реализовано слежение за файлами конфига и токена в реальном времени
* Оптимизарована работа с настройкой обработчиков событий CRM и начальными запросами при запуске приложения
* Оптимизированы запросы списков из CRM (сущности, дела, задачи)
* Изменён формат лога

**Админка**

* Добавлена автоматическая сортировка ч/б списка
* Добавлено отображение наличия несохранённых изменений
* Добавлено автоформатирование адреса портала
* Добавлено отображение ошибки загрузки цен на лицензию
* На главную страницу добавлен статус настройки внутренних номеров пользователей
* Обновлена разметка таблиц логов
* Добавлен вывод ошибок при нажатии на неактивные кнопки
* Исправлена ошибка некорректного позиционирования кнопки чата
* Обновлена справка по кастомизациям

**Исправлены ошибки**

* Реализована плавная процедура остановки приложения
* Реализовано централизованное синхронное хранение данных звонка
* Исправлена проблема перечитывания звонков/зависания `state.json`
* Исправлено редкое падение при работе с оффлайн лицензией
* При получении дела запрашивается специфичный для него набор полей
* При сбросе списка пользователей также сбрасываются FMC номера
* Исправлено некорректное прикрепление ссылок на записи и/или файлов записей в некоторых случаях (разделена логика обрезания номеров телефонов)
* Если записи хранятся ссылками, то кастомизация дела выполняется после прикрепления записи, а не одновременно
* Исправлено зависание на переподключении AMI после разрыва соединения
* Исправлена редкая ошибка, из-за которой иногда ставилось неправильное время завершения разговора
* Статус входящего неотвеченного звонка изменён с 480 (временно недоступен) на 304 (пропущенный), дело создаётся незакрытым
* При C2C номер `to` обновляется по результатам кастомизации
* Добавлена проверка версии удалённого Астериска через AMI
* Исправлено сохранение CEL со спецсимволами через админку

**Кастомизатор**

* В кастомизации передаются полные данные звонка `call_full` вместе с legacy-данными для обратной совместимости
* В кастомизатор добавлены и задействованы запросы к CRM через модуль
* В автораспределении обрабатывается транк и в кастомизацию отправляются все данные запроса
* В автораспределении в кастомизацию передаются все данные сущности, имя сущности передаётся даже когда пользователь недоступен
* В статусе (`/status`) кастомизатора отображается `false` у всех методов если кастомизатор отключен
* Кастомизация сущности запускается всегда, а не только на новых сущностях
* В кастомизацию `need_registration` и кастомизации номеров добавлены этап и данные звонка
* В кастомизацию дела добавлены поля дела
* Убраны дублирующиеся кастомизации номеров, теперь они выполняются при появлении номера на CallStarted или ConversationRequested
* Добавлена кастомизация прикрепления ссылки на запись
* Добавлена автозамена и кастомизация номеров на C2C
* Добавлена кастомизация показа карточки
* Добавлена кастомизация после регистрации разговора
* Добавлена возможность отмены запроса кастомизацией на регистрации звонка, завершении регистрации, прикреплении ссылки и показе карточки
* При выполнении кастомизаций используется комбинированный вывод
* Регистрация звонка теперь возможна в кастомизации завершения звонка
* Обновлён формат логов кастомизатора
* Кастомизатор приоритетно использует новые данные звонка
* Обновлены стандартные кастомизации

**Supervisor**

* При ошибке обновления выводится абсолютный путь до `update.log`
* Исправлен вывод версии supervisor в API

### 3.9.4

> 30.09.2022

**Админка**

* Добавлена автоматическая сортировка ч/б списка
* Добавлено автоматическое форматирование и проверка правильности адреса портала
* Добавлено отображение ошибки при проблеме получения актуальных цен на лицензию

**Исправлены ошибки**

* Исправлено падение при большой нагрузке при использовании офлайн-лицензии (наблюдалось с версии [3.9.0](#id-3.9.0))
* Исправлена ошибка обработки номера телефона при получении записи звонка по ссылке, когда начало номера совпадает с одним из префиксов
* Исправлены некорректные поля в запросе дела
* Исправлено зависание после восстановления связи с AMI (наблюдалось с версии [3.9.0](#id-3.9.0))

### 3.8.5

> 30.09.2022

**Исправлены ошибки**

* Исправлена ошибка обработки номера телефона при получении записи звонка по ссылке, когда начало номера совпадает с одним из префиксов
* Исправлены некорректные поля в запросе дела

### 3.7.4

> 30.09.2022

**Исправлены ошибки**

* Исправлена ошибка обработки номера телефона при получении записи звонка по ссылке, когда начало номера совпадает с одним из префиксов

### 3.9.3

> 11.08.2022

**Админка**

* Убрана возможность авторизации в архивном приложении
* Обновлена страница оплаты лицензии
* Исправлены ошибки обновления через админку

**Исправлены ошибки**

* Исправлена проблема авторизации в AMI в мастере настроек (наблюдалось с версии [3.9.0](#id-3.9.0))

### 3.8.4

> 11.08.2022

**Админка**

* Убрана возможность авторизации в архивном приложении

**Исправлены ошибки**

* Исправлена проблема изменения настроек автозамены (наблюдалось с версии [3.7.0](#id-3.7.0))
* Исправлено закрытие пользовательских дел (теперь закрываются только дела, созданные по факту звонка)

**Кастомизатор**

* В кастомизацию автораспределения добавлена обработка транка и остальных данных запроса

### 3.7.3

> 11.08.2022

**Админка**

* Убрана возможность авторизации в архивном приложении

**Исправлены ошибки**

* Исправлена проблема изменения настроек автозамены (наблюдалось с версии [3.7.0](#id-3.7.0))

### 3.9.2

> 08.08.2022

**Исправлены ошибки**

* Исправлена проблема изменения настроек автозамены (наблюдалось с версии [3.7.0](#id-3.7.0))
* Исправлено закрытие пользовательских дел (теперь закрываются только дела, созданные по факту звонка)

**Кастомизатор**

* В кастомизацию автораспределения добавлена обработка транка и остальных данных запроса
* Исправлены ошибки выбора временной зоны в кастомизаторе

### 3.9.1

> 01.07.2022

**Админка**

* Исправлены нередактируемые поля ввода в админке
* Исправлено отображение доступных обновлений

### 3.8.3

> 01.07.2022

**Админка**

* При успешном сбросе кэша пользователей отображается подтверждение
* Исправлено отображение доступных обновлений
* Обновлена справка по автозамене номеров

**Исправлены ошибки**

* Из поиска лидов при автораспределении исключены закрытые лиды
* Ошибка соединения с сервером авторизации Bitrix вызывает перезапуск вместо остановки
* Исправлено редкое падение при нескольких одновременных C2C звонках

**Кастомизатор**

* В автораспределение добавлена автозамена и кастомизация номера клиента

### 3.7.2

> 01.07.2022

**Админка**

* Обновлены тексты справки по автозамене
* Исправлено отображение доступных обновлений
* Обновлена справка по автозамене номеров

**Исправлены ошибки**

* Ошибка соединения с сервером авторизации Bitrix вызывает перезапуск вместо остановки
* Исправлено редкое падение при нескольких одновременных C2C звонках

**Кастомизатор**

* В автораспределение добавлена автозамена и кастомизация номера клиента

### 3.9.0

> 23.06.2022

**Админка**

* Добавлена кнопка перезапуска служб
* Отображаются обязательные кастомизации
* Обновлены тексты справки по кастомизациям и автозамене
* При успешном сбросе кэша пользователей отображается подтверждение
* Исправлена проблема сохранения адреса C2C
* Исправлен эскейпинг в `csv` файлах
* Убрано поле таймаута кэша
* Правки дизайна

**Исправлены ошибки**

* Исправлено зависание при неправильном пароле AMI
* Ошибка соединения с сервером авторизации Bitrix вызывает перезапуск вместо остановки
* Исправлены редкие ошибки запуска/остановки
* Улучшено логирование при подключении к БД
* Из поиска лидов при автораспределении исключены закрытые лиды
* Исправлено редкое падение при нескольких одновременных C2C звонках
* Исправлено замедление работы при использовании лицензионного ключа
* В отчёт для техподдержки добавлены данные: системный лог, данные о PHP и MySQL, наличие sudo, настройки временной зоны, данные о пользователе
* Улучшена обработка ошибок при формировании отчёта для техподдержки
* Исправлены конфликты обращения к общим ресурсам при формировании отчёта для техподдержки

**Кастомизатор**

* Настройки кастомизатора [вынесены в `json` файл](/custom_common/customizer-settings-update.md)
* Добавлена [настройка таймаута запросов](/custom_common/customizer-settings-update.md#novoe-pole-requesttimeoutsec)
* В кастомизацию сущности передаются: звонок, параметры сущности, регистрация
* Исправлен вывод данных в кастомизацию автораспределения при остановленном рабочем дне
* Опциональные кастомизации не запускаются в бесплатном режиме
* В автораспределение добавлена автозамена и кастомизация номера клиента
* Кастомизатор штатно возвращает исключения

{% hint style="info" %}
3.9.0 - "специальная" версия, поэтому [обновление](/faq/update.md) на неё необходимо выполнять скриптом с правами `root`, а не через админку.
{% endhint %}

{% hint style="warning" %}
Начиная с версии 3.9.0, опциональные кастомизации будут запускаться только с оплаченной лицензией:

```
process_final_params.php
customize_entity.php
customize_activity.php
process_registration_params.php
customize_autodistribution.php
process_task_creation_params.php
```

{% endhint %}

### 3.8.2

> 14.04.2022

**Исправлены ошибки**

* Исправлена проблема сохранения настроек (наблюдалось с версии [3.8.0](#id-3.8.0))

### 3.8.1

> 06.04.2022

**Исправлены ошибки**

* Исправлена редкая ошибка обработки событий CEL при чтении C2C звонков (наблюдалось с версии [3.5.0](#id-3.5.0))
* Исправлено некорректное определение типа C2C звонка при смене внутреннего номера на ответе (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлено логирование создания задач с именами по умолчанию

### 3.7.1

> 06.04.2022

**Админка**

* Исправлен визуальный баг кнопки авторизации

**Исправлены ошибки**

* Исправлена проблема обновления файла `state.json` при задержке обработки событий CEL (наблюдалось с версии [3.3.4](#id-3.3.4))
* Исправлена редкая ошибка обработки событий CEL при чтении C2C звонков (наблюдалось с версии [3.5.0](#id-3.5.0))
* Исправлено некорректное определение типа C2C звонка при смене внутреннего номера на ответе (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлено автозакрытие задач с транком в названии (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлена ошибка чтения настроек TCP порта Apix (наблюдалось с версии [3.7.0](#id-3.7.0))
* Исправлена редкая ошибка проверки подключения к серверу авторизации Bitrix24 (наблюдалось с версии [3.7.0](#id-3.7.0))
* Исправлено логирование создания задач с именами по умолчанию
* Улучшено логирование подключения к C2C-серверу

**Кастомизатор**

* В кастомизацию `need_registration` передаётся параметр `is_ivr`

### 3.6.3

> 06.04.2022

**Админка**

* Обновлена справка по настрйкам создания задач

**Исправлены ошибки**

* Исправлена проблема обновления файла `state.json` при задержке обработки событий CEL (наблюдалось с версии [3.3.4](#id-3.3.4))
* Исправлена редкая ошибка обработки событий CEL при чтении C2C звонков (наблюдалось с версии [3.5.0](#id-3.5.0))
* Исправлено некорректное определение типа C2C звонка при смене внутреннего номера на ответе (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлено автозакрытие задач с транком в названии (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлена проверка группы разрешений `user`

**Кастомизатор**

* Параметры запроса C2C передаются в [кастомизацию Originate](/custom_common/c2c.md)
* В кастомизацию `need_registration` передаётся параметр `is_ivr`

### 3.8.0

> 29.03.2022

**Что нового**

* Обновлена работа с пользователями: теперь все пользователи кэшируюся раз в час и никогда не запрашиваются по одному
* Добавлена кастомизация автораспределения `customize_autodistribution`

**Админка**

* Обновлена логика UI при переходе между страницами мастера настройки
* Поле кода авторизации появляется если код не был получен в первые 10 секунд
* В браузерах с языком, который не поддерживается админкой, будет использоваться Английский

**Исправлены ошибки**

* Исправлена проблема обновления файла `state.json` при задержке обработки событий CEL (наблюдалось с версии [3.3.4](#id-3.3.4))
* Исправлена обработка звонков с управляемым переводом когда каналы в CEL не отмечены как локальные
* Номера телефонов при поиске записей разговоров сделаны опциональными, возможен поиск только по ID звонка
* Исправлено автозакрытие задач с транком в названии (наблюдалось с версии [3.6.2](#id-3.6.2))
* Исправлено создание задач с именами по умолчанию (наблюдалось в версии [3.7.0](#id-3.7.0))
* Добавлены новые статусы звонков
* Улучшено логирование при определении ответственных за пропущенные звонки

**Кастомизатор**

* В кастомизацию `need_registration` передаётся параметр `is_ivr`
* В кастомизацию `process_final_params` передаются данные регистрации разговора

### 3.7.0

> 22.02.2022

**Что нового**

* Добавлена функция [автозамены номеров телефонов](/for-admins/autoreplacement.md)
* Выполнен переход на новый C2C-сервер "Apix v2"; старые C2C-сервера более не используются
* Добавлена опция создания задач по неуспешным исходящим звонкам

**Админка**

* В левом нижнем углу на всех страницах отображаются версия модуля и подключенный портал
* Язык по умолчанию соответствует настройкам языка браузера
* Проверки статусов для главной страницы выполняются по возможности независимо, статусы которые не удалось проверить из-за таймаута предыдущих статусов отображаются как `Skipped`
* В настройки БД добавлен алиас поля `extra`
* В мастер добавлено поле адреса получения записей
* Обновлена вёрстка
* Добавлены/исправлены тексты статусов
* Добавлено поле порта службы Supervisor
* Обновлены тексты подсказок

**Исправлены ошибки**

* Исправлена проверка доступности сервера авторизации (наблюдается на версии [3.6.2](#id-3.6.2) и более ранних с момента запрета запросов ping на `oauth.bitrix.info`)
* Исправлена проверка группы разрешений `user` (в будущем может наблюдаться на версии [3.6.2](#id-3.6.2) и более ранних при установке новой версии приложения на портале)
* Данные запроса API `/status` периодически выводится в лог для диагностики проблем
* Улучшено логирование ошибок запросов C2C-сервера

**Кастомизатор**

* Исправлена ошибка времменой зоны в кастомизаторе
* Параметры запроса C2C передаются в [кастомизацию Originate](/custom_common/c2c.md)

{% hint style="warning" %}
Старый C2C-сервер по адресу `c2c.bx24asterisk.ru`, начиная с версии 3.7.0, более не используется.\
Убедитесь что с сервера, где установлен модуль интеграции Itgrix, разрешён доступ к новому C2C-серверу `apix.itgrix.ru`.
{% endhint %}

{% hint style="info" %}
3.7.0 - "специальная" версия, поэтому [обновление](/faq/update.md) на неё необходимо выполнять скриптом с правами `root`, а не через админку.
{% endhint %}

### 3.6.2

> 11.02.2022

**Исправлены ошибки**

* Ошибки запроса API сервера лицензирования при автоматической проверке лицензии приводят к понижению лицензии не сразу, а только если проблема сохраняется 3 часа
* Исправлена регистрация неуспешных C2C звонков
* Исправлена ошибка авторизации при отключении всех опций C2C-сервера (наблюдалось с [3.6.0](#id-3.6.0))
* Исправлено падение при использовании узла API `/status` когда не задан портал (наблюдалось с [3.6.0](#id-3.6.0))
* В [шаблон имени задачи](/settings/additional/parametry-sozdaniya-zadach.md) добавлена поддержка переменной `#TRUNK#`
* Улучшено логирование при запуске
* Улучшено логирование при чтении файлов конфигурации Asterisk
* Улучшено логирование при использовании узла API `/pbx/read_call`

### 3.5.7

> 11.02.2022

**Исправлены ошибки**

* Исправлена регистрация неуспешных C2C звонков
* Если номер не найден (`hangupcause` 1 или 20) но был ответ, то звонок считается успешным
* В [шаблон имени задачи](/settings/additional/parametry-sozdaniya-zadach.md) добавлена поддержка переменной `#TRUNK#`
* Улучшено логирование при использовании узла API `/pbx/read_call`

### 3.4.9

> 11.02.2022

**Исправлены ошибки**

* Исправлена регистрация неуспешных C2C звонков

### 3.6.1

> 14.12.2021

**Админка**

* Ссылки на доки открываются в новых вкладках

**Исправлены ошибки**

* Исправлено переподключение к C2C-серверу при проблемах соединения
* Исправлено сохранение пустых массивов в файл конфигурации
* Исправлена повторная обработка недавних звонков при частых перезапусках

**Кастомизатор**

* В кастомизацию пути записи добавлено удаление дублирования элементов пути

### 3.4.8

> 06.12.2021

**Исправлены ошибки**

* Исправлено зависание сохранения `state.json` при задержке обработки событий CEL (наблюдалось с [3.5.1](#id-3.5.1))
* Исправлена работа со структурой данных CallBack при использовании Apix
* Исправлено название задач по умолчанию для исходящих звонков

### 3.5.6

> 06.12.2021

**Исправлены ошибки**

* Исправлено зависание сохранения `state.json` при задержке обработки событий CEL (наблюдалось с [3.5.1](#id-3.5.1))
* Исправлено подвисание админки при переключении на несуществующий портал

### 3.6.0

> 29.11.2021

**Что нового**

* Добавлена возможность лицензирования оффлайн по лицензионному ключу (только для версии `x64` с правами `root`)
* Авторизация в CRM теперь выполняется без ручного копирования кода
* Добавлено [распознавание FMC номеров](/settings/additional/fmc-numbers.md) по файлу с Wildcard масками и по номерам указанным в CRM
* Добавлен узел API `/status` для [автоматизации мониторинга состояния приложения](/for-admins/status-monitoring.md)
* Узел API для ручной загрузки CEL `/pbx/read_cel` поддерживает `.csv` данные
* В узел API `/pbx/read_call` добавлено получение логов
* Переподключение к AMI при разрыве соединения выполняется без перезапуска приложения
* Добавлен флаг `--cleanlist` для выборочной очистки: `h` обработчиков Bitrix24, `l` внешних линий и `s` - `state.json`

**Админка**

* Добавлена возможность скачивания MySQL таблиц в формате `.csv`
* При обновлении добавлена возможность выбора между только установкой патчей или обновлением с новым функционалом
* Админка предлагает обновиться через консоль, если следующая версия - "специальная", и на неё нельзя обновиться из админки
* Исправлено подвисание интерфейса обновления после неуспешного обращения к службе supervisor
* Исправлена блокировка кнопок "Купить" на странице оплаты лицензии
* Исправлен баг смены состояния админки при переключении портала
* Исправлено подвисание админки при переключении на несуществующий портал
* Добавлен статус службы supervisor вместо статуса ОС
* Добавлены тексты новых статусов
* Обновлены имена приложений
* Мелкие правки в админке

**Исправлены ошибки**

* Исправлена ошибка многократного подключения к C2C-серверу
* Исправлена ошибка прикрепления вчерашнего лога к отчёту для техподдержки
* Исправлено зависание сохранения `state.json` при задержке обработки событий CEL (наблюдалось с [3.5.1](#id-3.5.1))
* Исправлена проверка статсуса доступности серверов при запрете использования `raw socket`
* В логи обновления добавлено больше вывода
* Ускорено прикрепление записей разговоров
* Ускорена загрузка списка пользователей
* Исправлена проверка `logrotate` при установке
* Исправлена обработка запроса `/read_cel` при пустом теле запроса (проблема наблюдалась с [3.5.1](#id-3.5.1))
* Исправлено название задач по умолчанию для исходящих звонков
* Исправлены ошибки проверки чисел в файле конфигурации (присутствовали с [3.1.4](#id-3.1.4))
* Исправлена очистка ошибок проверки файла конфигурации (проблема наблюдалась с [3.1.4](#id-3.1.4))
* Убран устаревший флаг `hostory-date`, его функционал [заменён](/for-admins/obrabotka-zvonkov-za-period.md) узлом API `/pbx/read_call`

{% hint style="info" %}
3.6.0 - "специальная" версия, поэтому [обновление](/faq/update.md) на неё необходимо выполнять скриптом с правами `root`, а не через админку.
{% endhint %}

### 3.5.5

> 11.11.2021

**Исправлены ошибки**

* Исправлена работа со структурой данных CallBack при использовании Apix

### 3.5.4

> 10.11.2021

**Админка**

* Обновлены имена приложений на странице авторизации в CRM
* В ошибку разрешений приложения на странице статусов добавлена ссылка на статью о проблеме

**Исправлены ошибки**

* Исправлен запуск автосохранения токена
* Исправлено использование алиасов полей MySQL с флагом `-T`
* Исправлен баг чтения массивов в запросах API модуля
* C2C звонки отправляются на Asterisk даже если канал указанного номера занят (они отменялись с [3.3.3](#id-3.3.3))
* Исправлена возможность падения при сохранении `state.json` (могло наблюдаться с [3.5.1](#id-3.5.1))
* Увеличен таймаут обработки событий CEL
* Исправлен порядок обработки полей запроса CallBack при использовании Apix
* Исправлено отображение ошибки при запросе несуществующей записи разговора
* Исправлено неожиданное удаление существущей установки при её фактическом отсутствии
* В API `/pbx/read_call` добавлено получение логов по обработанным звонкам

**Кастомизатор**

* В кастомизации Originate теперь можно добавлять параметры, не предусмотренные конфигом модуля

### 3.4.7

> 09.11.2021

**Админка**

* Обновлены имена приложений на странице авторизации в CRM
* В ошибку разрешений приложения на странице статусов добавлена ссылка на статью о проблеме

**Исправлены ошибки**

* Исправлен запуск автосохранения токена
* Исправлено использование алиасов полей MySQL с флагом `-T`
* Исправлен баг чтения массивов в запросах API модуля
* C2C звонки отправляются на Asterisk даже если канал указанного номера занят (они отменялись с [3.3.3](#id-3.3.3))
* Исправлена возможность падения при сохранении `state.json` (могло наблюдаться с [3.5.1](#id-3.5.1))
* Увеличен таймаут обработки событий CEL
* Исправлен порядок обработки полей запроса CallBack при использовании Apix

**Кастомизатор**

* В кастомизации Originate теперь можно добавлять параметры, не предусмотренные конфигом модуля

### 3.4.6

> 19.10.2021

**Админка**

* Исправление многократного запроса пароля в админке
* Лого в админке - ссылка на главную страницу
* Исправления обработки данных при начальной настройке
* Мелкие правки вёрстки, текстов и ссылок на документацию

**Исправлены ошибки**

* Исправлена обработка пустых и некорректных ответов на MySQL-запросы
* Исправлена ошибка регистрации внешних линий при наличии пустого транка
* Исправлен баг проверки CDR при большом размере таблицы
* Проверка статуса рабочего дня не отображается на версиях, где не доступна
* Исправлена блокировка сохранения `state.json`
* Исправлен баг проверки настроек БД после предыдущей успешной проверки (присутствовал с [3.4.0](#id-3.4.0))
* При ответе обновляется номер принимающей стороны, если он не был известен ранее, при этом проверяется, внутренний ли он
* Исправлен баг смены адреса C2C-сервера с нестандартного обратно на стандартный
* Исправлена ошибка прикрепления вчерашнего лога к отчёту для техподдержки
* Исправлено отображение ошибки при запросе несуществующей записи разговора

**Кастомизатор**

* Кастомизация номера клиента применяется при создании и при закрытии задачи
* Добавлены функции обновления контакта, запуска бизнес-процесса, формирования ссылок на модуль и записи разговоров
* В логе кастомизатора используется местное время (с версии [3.4.0](#id-3.4.0) было UTC)
* Исправлена проблема превышения лимитов API CRM запросами из кастомизаций (возможность превышения появилась с версии [3.4.0](#id-3.4.0))

### 3.5.3

> 14.10.2021

**Админка**

* Мелкие исправления в админке

**Исправлены ошибки**

* Добавлен флаг `--cleanlist`, определяющий какие элементы очищаются флагом `--clean`
* Перезапуск при изменении настроек CRM приводит к удалению только обработчиков, но не внешних линий
* При обновлении поля принимающего номера при ответе проверяется, внутренний ли он (в версии [3.5.2](#id-3.5.2) номер все считался внешним)
* Исправлена блокировка сохранения `state.json`
* Если в файле конфигурации указан нестандартный адрес сервера C2C, то он используется не только для подключения, но и при регистрации обработчиков
* Неотвеченные но "успешные" звонки (IVR) считаются пропущенными (были успешными с версии [3.5.1](#id-3.5.1))
* Добавлена обработка [статуса звонка](/faq/detalnye-statusy-zvonka.md) с ошибкой "Bearer capability not presently available"
* Исправлена проблема превышения лимитов API CRM запросами из кастомизаций (возможность превышения появилась с версии [3.4.0](#id-3.4.0))
* В логе кастомизатора используется местное время (с версии [3.4.0](#id-3.4.0) было UTC)
* Исправлено зависание авторизации запросов к API модуля после большого числа авторизаций (порядка тысячи) (наблюдалось с версии [3.5.0](#id-3.5.0))

### 3.5.2

> 16.09.2021

**Исправлены ошибки**

* Если в начале звонка не было принимающего номера, то при ответе на звонок проверяется номер принимающей стороны даже если он внутренний
* Расширено содержание отчётов для техподдержки

### 3.5.1

> 13.09.2021

**Что нового**

* Расширена поддержка статусов звонка Битрикс24: помимо Успешного и Пропущенного, теперь поддерживаются Занято, Отклонено, Временно недоступен, Не найдено и Неизвестная ошибка
* Добавлена опция отправки оповещений о звонках в чат Битрикса - ранее оповещения отправлялись всегда, а теперь их можно отключить в админке

**Админка**

* Лицензия обновляется при проверке кнопкой из админки и получении статусов без перезагрузки страницы
* Тип приложения в админке корректно переключается при получении нового токена без перезагрузки страницы
* При переходе на страницу получения токена не перезагружается страница
* При обновлении версии на сервере, админка перезагружается
* На странице получения токена добавлены ссылки на приложения на портале
* Исправлена загрузка изменений статусов на странице результатов Мастера
* Исправлены заголовки статусов на страницах Мастера

**Исправлены ошибки**

* Исправлена неполная остановка когда пользователь не администратор портала
* Управление внешними линиями синхронизировано с управлением транками - создание/удаление транка вызывает такое же действие со внешней линией
* Исправлен баг сохранения порта БД при начальной настройке
* Исправлен баг проверки настроек БД после предыдущей успешной проверки (присутствовал с [3.4.0](#id-3.4.0))
* Исправлены редкие проблемы, препятствовавшие сохранению `state.json`
* Исправлена ошибка регистрации звонка на неправильный номер при перехвате звонка

**Кастомизатор**

* Добавлена функция запуска бизнес-процесса
* Добавлены функции для работы со ссылками на записи разговоров
* Кастомизация номера клиента применяется при создании и при закрытии задачи

{% hint style="warning" %}
**Изменение требований к системе: требуется поле CEL "extra"**

В таблице CEL в базе данных Asterisk теперь требуется наличие поля `extra`. При отсутствии или некорректном заполнении этого поля модуль будет запускаться и работать, но:

1. не будут использоваться детальные статусы звонка (будут только Успешный и Пропущенный);
2. не будут корректно обрабатываться перехваты звонка (набор **\*8**).
   {% endhint %}

{% hint style="info" %}
3.5.1 - специальная версия, поэтому [обновление](/faq/update.md) на неё необходимо выполнять скриптом с правами root, а не через админку.
{% endhint %}

### 3.5.0.2

> 16.08.2021

**Админка**

* В мастере настройки исправлен баг проверки подключения к Asterisk (AMI) от лица существующего пользователя (наблюдался с версии 3.4.0 в виде статуса Error)

### 3.5.0.1

> 11.08.2021

**Админка**

* Исправление сохранения настроек в некоторых случаях
* Мелкие исправления текстов и вёрстки

### 3.5.0

> 06.08.2021

**Что нового**

* Добавлена возможность обновляться по кнопке из админки. Для этого устанавливается отдельная служба `itgrix_bx_supervisor`. В отдельных случаях, например когда вносятся изменения в `itgrix_bx_supervisor`, потребуется использовать старый способ обновления

**Админка**

* Добавлена ссылка на список пользователей телефонии на портале
* Лого в левом верхнем углу - ссылка на страницу состояния
* Частично исправлена проблема повторного запроса авторизации
* По умолчанию логи отображаются с конца файла
* Проверка статуса рабочего дня не отображается на версиях, где не доступна
* Мелкие исправления текстов и вёрстки

**Исправлены ошибки**

* Обновлены скрипты установки, удаления, службы, резервного копирования
* Расширено содержание резервных копий
* Исправлена ошибка регистрации внешних линий при наличии пустого транка
* Исправлена работа с некорректными MySQL-таблицами
* Запросы с неуспешной авторизацией пишутся в лог
* Исправлен баг проверки CDR при большом размере таблицы
* Исправлен баг падения страницы MySQL при пустом выводе

### 3.4.5

> 15.07.2021

**Исправлены ошибки**

* Исправлен баг выгрузки файла записи разговора в CRM (наблюдался с версии v3.4.3 в виде пустых запросов)

### 3.4.4

> 12.07.2021

**Админка**

* Улучшено форматирование статусов на главной странице

**Исправлены ошибки**

* Исправлена ошибка из-за которой игнорировались таймауты некоторых запросов
* Исправлена ошибка остановки сервера при изменении настроек
* В запросе read\_call используется местное время вместо UTC и убрано ограничение в 100 записей CEL на звонок
* Исправлена ошибка сохранения, приводившая к повторной обработке звонков после перезапуска (наблюдается с v3.4.2)
* Исправлена ошибка при регистрации звонка с созданием компании
* При получении отчёта для техподдержки используется ограничение по времени
* Исправлена регистрация звонков followme с переадресацией на сотовый

### 3.4.3

> 07.07.2021

**Что нового**

* В кастомизатор добавлены функции обновления лидов и создания сделок

**Админка**

* Мелкие исправления текстов и вёрстки в админке

**Исправлены ошибки**

* Исправлен формат запросов в CRM
* Ускорена загрузка записи в CRM
* Исправлена регистрация пропущенных звонков на IVR (не регистрировались с версии 3.4.0)
* Оптимизирована проверка статуса рабочего дня
* Из файла конфигурации убрана неактуальная настройка адреса сервера C2C

### 3.4.2

> 16.06.2021

**Что нового**

* В кастомизатор добавлена функция создания лидов

**Админка**

* Переделано отображение статусов на главной странице, теперь они более понятны и содержательны
* Результат авторизации в CRM теперь отображается так же как статус, лучше описаны возможные ошибки и действия для их решения
* Исправления вёрстки страницы логов модуля
* Добавлена проверка отставания CEL от модуля

**Исправлены ошибки**

* Исправлена ошибка при авторизации в CRM `profile check failed: Not connected` (наблюдалась с версии 3.4.0)
* Убрано извлечение внутреннего номера из поля CEL `channame` при его отсутствии в `cid_num` из-за проблем при переключении транка (введено в версии 3.3.1)
* В кастомизацию регистрации звонка добавлены данные разговора

### 3.4.1

> 08.06.2021

**Админка**

* Исправлены баги отображения логов
* Добавлены недостающие тексты на английском

**Исправлены ошибки**

* Исправлен баг поиска записей без номера
* Исправлен баг чтения настроек кастомизаций (появился в 3.4.0, кастомизации не включались)

### 3.4.0

> 31.05.2021

**Что нового**

* [Улучшение производительности](/for-admins/work_acceleration.md) до 10x за счёт одновременной обработки множества звонков и группировки запросов к Битрикс24
* Добавлены [настройки ответственных за транки](/settings/additional/trunk-responsible.md)
* Добавлена возможность [проверки статуса рабочего дня](/settings/autodistribution/autodistribution-and-timeman.md) сотрудника при автораспределении
* Добавлены настройки [параметров создания задач](/settings/additional/parametry-sozdaniya-zadach.md)
* [Кастомизатор переписан](/custom_common/obnovlenie-kastomizatora-v-itgrix_bx-3.4.0-i-itgrix_amo-2.6.0.md) и теперь поддерживает запросы в CRM, улучшено логирование и обработка ошибок
* Максимальная длина внутренних номеров теперь настраивается
* В кастомизации `process_final_params.php` теперь доступны данные лида/контакта
* Запрос API /pbx/read\_call поддерживает загрузку звонков по датам

**Админка**

* Оптимизирована работа с полями выбора пользователей
* Статусы для главной странице проверяются быстрее и имеют ограничение по времени проверки
* Исправлен баг отображения цен для новых клиентов на странице оплаты лицензии
* Мелкие исправления текстов и вёрстки в админке

**Исправлены ошибки**

* Исправлено множество потенциальных багов
* Исправлено зависание при ошибке во время штатного перезапуска
* Исправлена ошибка при создании задачи без лида/контакта
* Исправления багов кастомизатора
* Исправлены устаревшие данные в кастомизациях
* Улучшено логирование

### 3.3.5

> 29.04.2021

**Админка**

* Исправлен выход всплывающих подсказок за границы страницы
* Исправлено отображение опций кастомизаций при отключённом кастомизаторе
* Исправлена вёрстка страниц логов и MySQL
* Мелкие исправления интерфейса

**Исправлены ошибки**

* Лицензия по подписке Маркетплейса теперь работает с отдельным приложением
* Лицензия по подписке работает без ограничений по времени

### 3.3.4

> 16.04.2021

**Админка**

* Мелкие исправления интерфейса

**Исправлены ошибки**

* Исправлена ошибка обращения к базе данных при сборе отчёта для техподдержки
* Исправлен баг поиска сущности при автораспределении на ответственного (наблюдался с 3.3.3)
* Исправлен баг загрузки файла записи разговора в CRM (наблюдался с 3.3.3)

### 3.3.3

> 09.04.2021

**Админка**

* Добавлена страница оплаты лицензии, видимая при приближении истечения лицензии
* Добавлена возможность ручного контроля списка обработчиков событий Bitrix24
* Исправлена загрузка `.svg` файлов
* Исправлен баг сохранения настроек при первичной конфигурации (присутствовал с 3.3.1)
* Мелкие исправления интерфейса

**Исправлены ошибки**

* Улучшена полнота логов на уровне вывода `info`
* Новая динамическая система обновлений (**если у вас версия ниже 3.3.2.1, то для перехода на новую систему придётся запустить обновление дважды**)
* Группировка запросов для последующего ускорения работы
* Исправлен баг авторизации на коробочных версиях с переадресацией запросов
* Обновлены ограничения бесплатной версии
  * хранение записей только в CRM
  * отключено использование внешних линий (сквозная аналитика)
  * источник лида всегда "Звонок"
  * отключён чёрный/белый список
  * первый ответственный всегда определяется по разговору
  * ответственный за пропущенный звонок всегда определяется по сущности
* Флаги запуска `-T` и `-sql` корректно завершают работу после выполнения
* Обработчики событий удаляются из CRM при запуске автоматически по известному списку адресов, а затем регистрируются заново
* При установке вызова на удержание не озвучивается номер места парковки
* Снятие вызова с удержния теперь поддерживает автоответ и остальные параметры Originate
* Originate возвращает ошибку "номер занят", если номер разговаривает или находится на дозвоне
* Originate по умолчанию выполняется в асинхронном режиме, что предотвращает задержки при частых звонках
* Исправлена обработка ошибок AMI при использовании Apix (проблема с 3.3.1)

### 3.3.2.1

> 24.03.2021

**Исправлены ошибки**

* Обработка звонков без номера `to` как входящих в версии 3.3.2 нарушила регистрацию исходящих звонков с переводами и Originate, изменение отменено

### 3.3.2

> 24.03.2021

**Админка**

* Исправления вёрстки

**Исправлены ошибки**

* Исправлено зависание при обрыве связи с Asterisk AMI
* Исправлена проверка версии Asterisk
* Звонки с номерами `from` и `trunk` но без номера `to` теперь обрабатываются как входящие
* Исправлена работа с файлами при использовании админки

### 3.3.1

> 19.03.2021

**Админка**

* Исправления в интерфейсе мастера настройки
* Исправлены ошибки при выборе пользователей
* В мастере настройки на шаге авторизации в CRM, портал сохраняется автоматически
* Исправлена проблема сохранения настроек после авторизации в CRM

**Исправлены ошибки**

* Если в событии\*\* \*\*CEL `CHAN_START` отсутствует поле `cid_num`, то внутренний номер сотрудника будет извлекаться из поля `channame`
* Завершение звонка теперь разрешено не только во время разговора, но и на этапе дозвона
* Содержание ошибок AMI теперь отображается и выводится в лог
* Повторные запросы при сетевых ошибках проверки лицензии
* Повторные запросы при сетевых ошибках запросов CRM
* Кастомизация пути до записей звонков теперь имеет отдельный фиксированный таймаут 10 секунд, его нельзя изменить
* Обновлены настройки подключения к Apix

### 3.3.0

> 20.02.2021

**Что нового**

* Добавлена опция автоматического завершения дел и задач после звонка с ответом

**Админка**

* Исправлена ошибка сохранения пользователя по умолчанию и разрешённых пользователей
* Исправлена ошибка сохранения настроек после авторизации в портале (наблюдалось в 3.2.3)
* Исправлена задержка смены лицензии после авторизации в портале

**Исправлены ошибки**

* Исправлено зависание при ошибке соединения AMI
* Исправлена работа ч/б списка при пропущенных звонках
* Мелкие исправления в админке

### 3.2.3

> 12.02.2021

**Админка**

* Закреплены кнопки на странице результатов мастера
* Новый способ проверки установки приложения

**Исправлены ошибки**

* Исправлено зависание при повторном получении токена после ошибки авторизации
* Обновлены настройки по умолчанию
* Обновлена кастомизация Originate
* Исправлено форматирование лога
* Добавлен таймаут соединения с Asterisk AMI
* Исправлена проверка версии Астера

### 3.2.2

> 04.02.2021

**Исправлены ошибки**

* Исправлено отображение карточки звонка когда первым ответственным выбран пользователь по умолчанию
* Исправлен поиск пользователя при C2C при отключённом кэшировании
* Исправление логирования при регистрации разговора
* Отчёт для техподдержки можно получить даже если модулю не удаётся его сохранить
* Мелкие исправления в админке

### 3.2.1

> 02.02.2021

**Админка**

* SQL-запросы ограничены только немодифицирующими

**Исправлены ошибки**

* Исправлен баг http-заголовков, нарушавший работу с карточкой звонка
* Исправлено редкое падение модуля, вызываемое действиями пользователя в админке
* При обработке C2C используется кэш пользователей
* Улучшено логирование ошибок кастомизаций

### 3.2.0

> 28.01.2021

**Что нового**

* Добавлен выбор начального ответственного для новых сущностей: пользователь, на которого поступил звонок, либо ответственный по умолчанию

**Логика обработки звонков**

* Изменён расчёт длительности звонков при переводах: вместо длительности последнего разговора, время от первого ответа до конца звонка
* Исправлена обработка переводов исходящих звонков
* Смена ответственного за новую сущность при переводах звонков осуществляется в начале нового разговора

**Админка**

* На странице статусов отображается состояние сервера авторизации CRM и сервера C2C
* На страницу с логами добавлено чтение последних `n` строк лога модуля
* Разрешено отключение кэширования пользователей CRM
* Обновлены тексты ошибок
* Мелкие исправления и улучшения

**Исправлены ошибки**

* Исправлена повторная обработка недавних завершённых звонков при перезапуске модуля
* Установлен минимальный таймаут кастомизаций: 100 мс
* Убраны некорректные запросы `crm..list`
* Обработчики удаляются из CRM при изменении настроек C2C и устанавливаются заново
* Перезапуск при ошибках чтения БД и соединения с Asterisk AMI
* Добавлен таймаут запросов в CRM
* Исправлен сбор отчётов для техподдержки на дополнительных копиях модуля
* Исправлено закрытие карточки при удержании вызова
* Исправлено удержание вызова при переводах
* Улучшено логирование

### 3.1.5.1

> 30.12.2020

**Исправлены ошибки**

* Исправлено подключение к Apix

### 3.1.5

> 18.12.2020

**Исправлены ошибки**

* Исправлено переподключение к Apix при ошибках
* Исправлено редактирование транков в админке

### 3.1.4

> 16.12.2020

**Исправлены ошибки**

* Исправлено падение при проблемах проверки соединения с базой данных
* Обновлено значение variable в Originate для автоответа при конвертации старой версии конфига

### 3.1.3

> 11.12.2020

**Что нового:**

* На странице статусов отображается какой подключен портал

**Исправлены ошибки**

* Исправлен поиск записей в CDR когда в номерах есть буквы
* Улучшена обработка ошибок запросов в CRM
* Исправлена ошибка авторизации `NO_AUTH_FOUND`, возникавшая на некоторых коробочных версиях Битрикса
* Исправлена проблема конвертации формата токена при обновлении с 3.0.6.1 (и ранних версий), вызывавшая ошибку `token_expired` в течение нескольких первых часов после обновления
* Исправлена регистрация звонков с followme при отключённых внутренних номерах
* Убран вывод неактуальных отладочных данных

### 3.1.2

> 20.11.2020

**Исправлены ошибки**

* Улучшен поиск логов для отчётов техподдержки
* Исправлена ошибка авторизации

### 3.1.1

> 19.11.2020

**Что нового:**

* Отчёты для поддержки формируются в сжатом формате

**Админка**

* Обновлены ссылки на инструкцию по обновлению и на changelog
* Корневой адрес перенаправляет на страницу конфига

**Исправлены ошибки**

* Исправлена проблема с обновлением токена
* Исправлено форматирование вывода с флагом -h
* Исправлена загрузка старых звонков
* Исправлена проблема с частой проверкой лицензии

### 3.1.0

> 18.11.2020

Что нового:

* Добавлены параметры для использования https порта и своего сертификата
* Добавлена функция формирования отчёта для техподдержки
* Ошибки кастомизатора выводятся в лог

**Админка**

* В английской версии мастера снова две версии приложения

### 3.0.7

> 13.11.2020

**Что нового:**

* Интерфейс для чёрного/белого списков через админку
* При поиске записей в CDR используются префиксы, это упрощает поиск, если номер в CEL и CDR был в разных форматах.
* Добавлена поддержка followme (перевод на сотовый сотрудника, указанный в профиле).\
  Нужно только добавить свои транки в настройки для корректной работы.
* Расширено логирование ошибок запросов
* Интервал проверки лицензии 3 часа (бесплатный режим) или 24 часа (платный)

**Админка**

* На странице статусов отображается состояние модуля (работает, перегружается, остановлен)
* Сохранение списка кастомизаций в новом формате

**Исправлены ошибки**

* Исправлен баг с зависанием callback
* Исправлены проблемы с блоком customizer при конвертации конфига из старого формата
* Исправлен запуск с ошибками запросов
* Исправления в админке

### 3\*\*.0.6.1\*\*

> 09.10.2020

**Что нового:**

* Параметр Variable в Originate (по умолчанию - автоответ)
* Новый способ создания задач в соответствии с новым API Битрикса
* Добавлено значение по умолчанию для времени кэширования

**Админка**

* Добавлена кнопка переключения портала на странице настроек Bitrix в админке
* В логах даты/время отображаются корректно в Firefox

**Исправлены ошибки**

* Исправлена кастомизация задачи
* Остановка при ошибке авторизации, вместо циклического перезапуска
* Исправления в интерфейсе

### **3.0.5**

> 17.09.2020

**Что нового:**

* Исправлены ошибки в админке
* Добавлен разговор в кастомизацию завершения разговора
* Исправлено обновление транков
* Добавлен Apix-клиент. Теперь модуль может использовать в качестве c2c-сервера Apix-сервер.

### **3.0.4**

> 07.09.2020

**Исправлены ошибки**

* Бэкап конфига в скрипте установки
* Селектор пользователя в админке показывает список доступных пользователей
* Добавлена работа с c2c-сервером
* Добавлен флаг --clean
* Улучшили вывод --help

### **3.0.3**

> 28.08.2020

**Что нового**\
1\. За исходящий без ответа ответственный тот, кто звонил (Исходящий не отвеченный - не пропущенный).\
2\. Удаление обработчиков и внешних линий по флагу --clean\
\
**Исправления:**\
1\. Ошибка с получением токена из мастера\
2\. Обработка ошибок из AMI\
3\. Исправили ошибки в вызове кастомизаций

### **3.0.2**

> 18.08.2020

**Админка:**\
1\. Улучшили страницу админки с логами\
2\. Поправили проверку версии модуля\
\
**Логи:**\
1\. Логируем параметры originate\
\
**Доработки:**\
1\. Добавляем номер клиента в задачи\
2\. Решили проблему затягивания записи с "+7"\
3\. Вернули работу чёрно-белых списков

### **3.0.1**

> 06.08.2020

**Что нового:**

* Поправили ошибку с получением записей
* Добавили сохранение типа приложения с токеном
* Немного изменили лог для лучшего чтения
* Добавили в админку выбор логики пропущенны

**Теперь пропущенные звонки могу быть зарегистрированы по 3м сценариям:**\
1\. На ответственного за сущность пользователя (так он увидит, что его клиент звонил) - включено по-умолчанию.\
2\. На того, кому звонили (подходит если клиенты не закреплены за сотрудниками).\
3\. На ответственного по-умолчанию.

### **3.0.0**

> 13.07.2020

**Перешли на новый стек технологий.**\
\*\*\*\*Переименовали сервис itgrix\_bx вместо bx24asterisk\
\- Решены проблемы с совместимостью старых ОС.\
\- Решены проблемы с библиотеками.\
\- Упростили логику регистрации звонков: убрали параметр "дело на каждый перевод".\
\
Для обновления с версии 2.15 нужно будет установить новую версию коннектора отдельно.\
И с помощью вспомогательного скриптов перенести конфиг и кастомизации.\
[Инструкция для самостоятельного обновления](https://docs.google.com/document/d/15hgCKH3L2Nad5y9eSPUhzh6xVzM6zqPuhrIXmGzdg7I/edit)\
\
Для обновления все же советуем обратиться в нашу техническую поддержку.

### **2.15.6**

> 20.07.2020

* **Реализован механизм oauth авторизации (без логина и пароля)**

### **2.15.5**

> 30.06.2020

* Исправлена ошибка чтения БД (загрузка записей с начала БД)

### **2.15.4**

> 24.04.2020

**Производительность:**\
Изменили формат запроса к базе. Теперь в запросе нет времени, только id последней записи. Ускоряет получение ответа.\
\
Исправление ошибок:\
1\. Исправлена ошибка в кастомизации параметров регистрации звонка\
2\. Исправлена обработка в C2C клиенте (логическая ошибка, обрабатывались не все ответы сервера)

### **2.15.3**

> 26.03.2020

**Админка:**\
1\. Правильное отображение элементов админки в бесплатном режиме\
2\. Добавили английский чатик в админке в английском интерфейсе.\
\
**Исправления, доработки:**\
1\. Регистрацией пропущенного на IVR\
2\. Поиск пользователей по сотовому\\

### **2.15.2**

> 28.02.2020

**Админка:**\
1\. Доработан интерфейс для работы с транками, внешними линиями и источниками лидов.\
2\. Починили сохранение настроек кастомизатора.\
3\. Отображается актуальный срок действия лицензии в админке.

**Мастер-настройки**\
1\. Починили автоматический поиск данных для подключения к Астеру и БД

### **2.15.1**

> 18.02.2020

**Админка:**\
1\. Новый интерфейc для работы с транками, внешними линиями и источниками лидов (бета-версия)\
2\. Добавлено отображение срока действия лицензии в админке\
3\. Добавлена возможность проверить лицензию прямо из админки,\
4\. Исправлены ошибки на странице с логами,\
5\. Исправлена ошибка с сохранением пользователей в бесплатном режиме,\
6\. Исправлена ошибка сохранения настроек кастомизатора,\
\
**Исправление ошибок:**\
1\. При отключенном кастомизаторе регистрируем все звонки (результат need\_registration всегда true)\
2\. Улучшена работа с Базой данных\
3\. Определение ответственного при переводе на группу

### **2.15.0**

> 30.12.2019

**Логика:**\
Регистрация звонков и создание сущностей теперь полностью происходит через API телефонии Битрикс24. Это позволяет работать со сквозной аналитикой в Битрикс24 ([**Статья про сквозную аналитику**](https://docs.google.com/document/d/1F1M1UWBmRYwNV_P4-Dnaw7cE5OWHI9URUpiT6pAnlVw/edit?ts=5e0071ad#heading=h.24piyygc3r9c))\
\
Из-за этого произошли существенные\*\* \*\*[**изменения в кастомизациях**:](https://docs.google.com/document/d/1WtuEhW-uV24VqFakHJDpGvzApqYtHH0M4KJ3bXDEvig/edit#heading=h.v3l93q5khlrx)\
1\) Добавили метод "need\_registration" для реализации чёрных и белых списков. Теперь решение о регистрации (или НЕ регистрации звонка) принимается в одном месте\
2\) Удалили методы: "process\_entity\_creation\_params", "process\_search\_params"\
3\) В метод кастомизации параметров создания задачи добавили данные о звонке\
4\) В методе "process\_final\_params" убрали блок с информацией о сущности\
\
**Важно:** Если у вас были настроены кастомизации черных/белых списков, то при переходе на эту версию необходимо перенести их в другой метод. [**Подробнее о переносе кастомизаций**](https://docs.google.com/document/d/1WtuEhW-uV24VqFakHJDpGvzApqYtHH0M4KJ3bXDEvig/edit#heading=h.69k2w7w0g6q4)\
Если пока сложно разбираться, то обновляйтесь только после окончания праздников.

### **2.14.11**

> 26.12.2019

Общее:\
1\. Выполняем повторный запрос лицензии при изменении данных подключения к Б24\
2\. Подробный лог ошибок при выполнении запроса в CRM\
\
Исправление ошибок в Админке:\
1\. На странице логов\
2\. На странице sql-запросов\
3\. С вводом имени для внешних линий\
4\. В мастере для 32х (приводило к падению модуля)

### **2.14.10**

> 18.12.2019

1\. Исправление критические ошибки при подключении к базе данных.\
2\. Убрали websocket.

### **2.14.9**

> 09.12.2019

Улучшения и багфиксы в Админке:\
1\. Исправлена ошибка удаления объектов при сохранении.\
2\. Добавлен лоадер при ожидании ответа модуля (переподключение к зависимым службам)\
3\. Вернули функционал на страницу с логами\
4\. Вернули чат в админку\
5\. Подсвечиваем красным пустые поля\
6\. Добавили выпадающий Список пользователей для бесплатного режима\
7\. Исправлена ошибка со страницей локализации.\
8\. Убрали поле "history\_start\_date"

### **2.14.8**

> 07.11.2019

Логика:\
Убрали ограничение по транкам для бесплатного режима (restricted mode). Осталось в ограничения 2 пользователя, загрузка файлов в CRM, невозможность отключить создание лидов/контактов.\
\
Админка:\
Добавлена возможность указать путь до кастомизатора в админке\
\
Исправление ошибок:\
Исправлена ошибка при поиске клиента: добавили номер без префикса в список номеров для поиска.

### **2.14.7**

> 14.10.2019

Решение проблемы с конфликтом библиотек при запуске подпроцессов (php, asterisk).

### **2.14.6**

> 10.10.2019

Исправление ошибок:\
1\) Исправлено использование галочек "создавать сделку для ..."\
2\) Исправлена ошибка в мастере: данные подключения не подтягивались автомиатически\
3\) Вернули connector.js

### **2.14.5**

> 03.10.2019

Исправление ошибок:\
1\) Критические ошибки, приводящие к зависанию модуля\
2\) Проверка версий в админке\
3\) Ошибки в админке

### **2.14.1**

> 11.09.2019

Админка:\
1\) Добавлена новая возможность - выбрать словарь для текстовых полей, создаваемые в Битриксе (название лида, комментарий, название задачи). Сейчас можно выбрать русский язык, английский язык либо создать свой словарь на основе этих двух.\
2\) Изменили порядок левого меню: перенесли Бизнес-логику выше.\
3\) Исправили ряд ошибок\
4\) Добавили новые шаги в мастер настройки (настройка пути до папки с записями, выбор режима работы CRM, настройка клика)

Логи:\
1\) Добавлено саммари-сообщение по звонку\
2\) В дефолтном кастомизаторе добавили сообщение на ошибку 127 (нет lame)\
3\) Изменили сообщение при отмене регистрации сущности по параметру в конфиге ("Создавать лид для входящих" и подобные)

### **2.13.6**

> 06.08.2019

Исправление ошибок:

1. Обработка ситуации, когда у сущности в CRM нет ответственного (такое почему-то бывает в коробках Битрикс24).
2. Добавлен id звонка при выводе ошибок в лог (помогает для отладки работы).
3. При ошибке кастомизатора используются некастомизированные параметры.

### **2.13.5**

> 11.07.2019

Админка:

1. Изменили поведение при нажатии кнопки "Повторить" на странице "Проверка подключений".
2. Теперь админка не дает нажать кнопку "Повторить" пока серверное приложение не закончит проверку состояния.

Баги:

1. Исправили ошибку в работе с БД.

### **2.13.4.0**

> 02.07.2019

Доработки:

1. Добавлена возможность перевода служебных сообщений и названий на другие языки (работает в тестовом режиме).
2. Исправлена ошибка в работе с повторными лидами.

Админка:

1. Появилась возможность выбора английского языка для интерфейса админки.
2. Изменили логику работы при сохранении настроек: после нажатия кнопки "Сохранить" админка сохраняет настройки в конфиг-файл, перезапускает модуль, и только после этого позволяет вносить изменения.

Исправлены баги админки:

* Вернули настройку "Внешних линий в Битрикс24".
* Исправили формат отправки даты.
* Исправили логику выбора в селекторах.
* Исправили сохранение настройки "Кастомизация полей лида".

### **2.12.0.1**

> 20.05.2019

**Важное** изменение логики поиска сущности в Б24:\
Теперь при начале звонка перебираем все сущности (лиды, контакты, компании) и добавляем звонок самую новую.\
Если модуль нашел только лиды, то учитываем их статус. Убираем из выборки сконвертированные и некачественные лиды, после чего регистрируем звонок в самый новый лид в рабочем статусе. (Ранее выбиралась самая старая сущность).\
\
Исправлены баги:

* Ошибка скрипта обновления: при отказе от бэкапа прерывает выполнение обновления.
* В админке Нулевая дата при загрузке страницы и 30 часов в сутках на странице логов.

Дополнительно в админке перенесли стили на html страницу, чтобы избавиться от ошибок загрузки.

### **2.11.9.18**

> 30.04.2019

Функционал:

1. Реализовали режим работы "без лидов", подходящий для режима в Битрикс24 - Простая CRM. По звонкам новых клиентов создаётся не лид, а контакт + сделка. После ответа на звонок ответственный меняется у контакта и сделки.
2. Добавили новые параметры настройки в админку: можно создавать либо игнорировать создание контакта для выходящих и исходящих звонков. И если создается контакт, то выбрать, создавать ли сделку.
3. Доработали метод кастомизации - создания сущности.

**Важно:** Если вы использовали кастомизацию создания лида, то сейчас название метода изменилось с "process\_lead\_creation\_params" на "process\_entity\_creation\_params".

### **2.11.8.4**

> 11.04.2019

Админка:\
1\) Исправлена ошибка с сохранением времени хранения кэша для Битрикса. 2) Добавили демонстрацию порта для https запросов (поменять можно только через файл конфига).\
\
Админка для бесплатного приложения:\
1\) Отображается "Ограниченный режим".\
2\) Добавили возможность выбора разрешенных пользователей.\
\
Логика:\
1\) Поменяли порядок обработки номера: в начала звонка обрезаем нули перед отправкой в Битрикс, затем выполняем кастомизацию.\
\
Возможности:\
1\) Стала возможным обрабатывать входящего звонка с технологией DAHDI\
2\) При обновлении модуля на сервере скрипт (update.sh) предлагает сделать бэкап

### **2.11.7.6**

> 15.03.2019

Возможности:\
1\) Пользователь по умолчанию автоматические попадет в список разрешенных пользователей для бесплатной версии.\
2\) Для отладки добавили флаг --testcall \<linkedid> для обработки одного звонка из CEL.

### **2.11.7.0**

> 11.03.2019

Возможности:\
1\) Новая возможность: использовать в кастомизаторе запросы в CRM через модуль (дополнительные запросы имени пользователя, клиента, сущностей).\
2\) В админку добавлена ссылка на страницу с описанием новых версий.\
3\) Упростились методы кастомизации номера телефона и последующего поиска сущности в CRM.\
4\) Для регистрации пропущенных без номеров доделываем разговор по завершению.

Оптимизации:\
1\) Улучшена работа с префиксами.

### **2.11.6.3**

> 27.02.2019

Особенности:\
Доработали сервер лицензирования, теперь модуль одинаково работает как с бесплатной, так и с платной версией приложения в Битрикс24.\
Добавили кэширование.

Багфикс:\
При ошибке приложения, лицензия на портале проверяется не чаще, чем раз в час.

### **2.11.5.10**

> 21.02.2019

Доработка логики:

* При поступлении звонка и поиске сущности по номеру не учитываем некачественные и сконвертированные лиды. Теперь если лид с этим номер уже переведен в некачественные, то будет создан новый лид.

Оптимизации:\
1\) Убрали параметр конфига "utc\_offset" (время), теперь передаем время звонка в utc формате, и для пользователя отображается часовой пояс заданный в битриксе.\
2\) Изменили порядок кастомизации - теперь номер телефона кастомизируется в самом начале.

Баги:\
1\) Исправили заголовки для css файлов, теперь интерфейс админки должен открываться более стабильно.

### **2.11.4.2**

> 18.02.2019

Возможности:

1\) Выдается информация об авторе приложения ООО Разумные решения по флагу --legal.\
2\) По пропущенному звонку появилась возможность создавать задачу:\
\- постановщик - пользователь, под которым работает модуль,\
\- ответственный за задачу - ответственный за сущность,\
\- дедлайн + 1 час от времени звонка.\
Включить можно в админке. Доступно для изменения в кастомизации (например можно сделать постановщиком руководителя отдела продаж или изменить время дедлайна).\
3\) Номер внешней линии попадает в кастомизатор при звонка кликом и обратных звонках. Это позволит кастомизировать исходящий маршрут. Нужно будет указать соответствующий контекст.

### **2.11.3.1**

> 06.02.2019

Админка, веб-интерфейс:\
исправлен баг сохранения транка, который содержит "+".

### **2.11.2.3**

> 30.01.2019

Возможности:\
Реализовали работу модуля с бесплатной версией приложения: ограничение по 1 транку и 2 пользователям.\
<https://www.bitrix24.ru/apps/?app=itgro.asteriskbx24free>

Баги:\
Обработка клик-ту-кола по http без редиректа на https.\
(оставили старую возможность передавать команду для клика через имеющийся протоколо http, порт по умолчанию 8077)

### **2.11.1.4**

> 30.01.2019

Возможности:\
1\) Вернули работу части запросов работает по http: клик-ту-колл, автораспределени, прослушивание записей.\
Добавили Флаг для отключения http в конфиге.\
Оставили админку только по https (порт по умолчанию 8078), при вводе 8077 будет редирект.\
Если требуется подключение из внешней сети - потребуется проброс второго порта.\
2\) При кастомизации завершения разговора в кастомизатор передаются id и тип сущности. Будет полезно\
3\) Добавили интерфейс админки в приложение на портале.

### **2.11.0.10**

> 22.01.2019

Возможности:\
1\) Перевели доступ к админке на https протокол с самоподписным сертификатом, для шифрования запросов к модулю.\
При первом входе требуется одобрить сертфикат в браузере.\
2\) Добавили возможность проверки новой версии модуля из админки.

Баги:\
1\) Кастомизация номера сотрудника.\
2\) Ошибка с "+" в ссылке.\
3\) Создание лидов при флаге "не создавать".

### **2.10.2.14**

> 24.12.2018

Баги:\
1\) Обработка ответа БД.\
2\) Опции соединения с БД.

Возможности:\
1\) **Создаём лид без использования телефонии.**\
\*\*\*\*2) Кастомизация полей лида при создании.\
3\) Разделение кастомизатора на несколько файлов.

Админка - баги:\
1\) Проверка лицензии.\
2\) Ошибка завершения мастера.

### **2.9.10.3**

> 11.12.2018

Баги:\
1\) Исправлена ошибка при чтении конфигов Астериска (пустые значения)\
2\) Критическая ошибки при обработке ответов от БД.

Возможности:\
Постраничный просмотр лога.

### **2.9.8.1**

> 03.12.2018

Баги:\
1\) Удаление лида при входящем.\
2\) Исправление ошибки с числами в запросах с Json.

Оптимизация:\
1\) Улучшенный поиск в логе.\
2\) Стандартизация сообщений.\
3\) Загрузка конфига при старте.\
\
Возможности:\
Добавляем транк в исходящий звонок при ответе.

### **2.9.5.4**

> 27.11.2018

Баги:\
Обновление токена при сохранении данных в админке

### **2.9.4.1**

> 27.11.2018

Оптимизация:\
Уменьшение запросов при звонке кликом.

Баги:\
Исправлена ошибка в подсчёте разговоров в звонке

Админка:\
1\) Проверка версии модуля.\
2\) Правки таблицы логов.

### **2.9.3.6**

> 23.11.2018

Баги:\
1\) Закрывание карточек всех разговоров при завершении звонка.\
2\) Сборка разговора на ответе для группы.

Возможности:\
1\) Поиск в логе по данным.

### **2.9.2.2**

> 19.11.2018

Баги:\
Доработана сборка разговора при ответе

### **2.9.1.3**

> 14.11.2018

Баги:\
Исходящий пропущенный без разговора должен удаляться.

### **2.9.0.3**

> 14.11.2018

Логика регистрации звонков:\
Если сотрудника, которому звонили, нет на портале, то звонок не будет зарегистрирован.

Использование:\
1\) Скрипт удаления.\
2\) Добавлены примеры кастомизаций в шаблонный файл.

### **2.8.120**

> 12.11.2018

Баги:\
Исходящий звонок, с номером в дочернем канале

Внешний вид:\
В логе появились события удаления лида и дела

### **2.8.117**

> 08.11.2018

Баги:\
Перезапуск логера после ротации

### **2.8.115**

> 06.11.2018

Админка - возможности:\
1\) Изменение внешних линий ч/з админку.\
2\) Просмотр лога ч/з админку.\
3\) Выполнение sql запросов ч/з веб-интерфейс.

Использование:\
Ссылка на мастер в скрипте установки.

Оптимизация:\
1\) Запрос кастомизации originate.\
2\) Http общение.\
3\) Улучшение sql запроса записи.

Баги:\
Завершение пикапнутого канала.

### **2.8.97**

> 19.10.2018

Оптимизация:\
1\) Оптимизация запроса на поиск пользователя портала.\
2\) Избавляемся от отладочного вывода.\
3\) Кастомизация параметров originate и отправка запроса

Возможности:\
1\) Функция логирования в кастомизаторе\
2\) Использование внешних линий на портале (транк в окне)

Баги:\
1\) Регистрируем неотвеченный разговор в конце цепочки переводов, если нужно создавать все дела.

### **2.8.77**

> 03.10.2018

Возможности:\
1\) Обработка перевода при исходящем C2C звонке\
2\) Обработка звонка при использовании FollowMe

Баги:\
1\) Ошибка запроса на получение сущности при кастомизации поиска\
2\) Определение последнего разговора в звонке\
3\) Регистрация начала звонка при исходящем, если не найден сотрудник

### **2.8.71**

> 01.10.2018

Возможности:\
Перевод исходящего звонка

Баги:\
Обновление логера

### **2.8.64**

> 27.09.2018

Баг:\
Перезагрузка логера вызывала утечку

### **2.8.63**

> 27.09.2018

Баги:\
1\) Ошибка при обработке http-запроса (ссылка на временный объект)\
2\) Скрытие карточек звонка при переводе в режиме "одно дело на перевод".

Оптимизация:\
Компиляция с флагом оптимизации -O3

### **2.8.59**

> 24.09.2018

Баг:\
Починили обновление токена авторизации.

Возможности:\
Originate на внешний номер.

Оптимизации:\
Оптимизация использования конфига.

### **2.8.52**

> 18.09.2018

Админка - баги:\
1\) Сохранение строк с пробелами (заменялся на '+')\
2\) Отображение картинок

Баги:\
Ошибки C2C-клиента (бешенный reject)

Возможности:\
Кастомизация поиска сущности в начале звонка.

### **2.8.45**

> 17.09.2018

Админка - баги:\
1\) Сохранение пароля на локальном Астериске.\
2\) Проверка доступа на локальном Астериске. Баги: Остановка цикла обработка ответов от C2C-сервера при перезапуске.

Возможности:\
Более подробное описание ошибки получения кода авторизации (форма, капча)

### **2.8.39**

> 07.09.2018

Баги:\
1\) Обновление статуса канала после перехвата (фикс перевода после перехвата)\
2\) В админке используем текущий конфиг для проверки подключений (НЕ найденный автоматически)\
3\) Очистка памяти, выдялемой под запрос при http-общении

Возможности:\
Обратный звонок через сервер c2c.

### **2.8.35**

> 06.09.2018

Баги:\
Обновление флагов кастомизатора в админке

### **2.8.34**

> 06.09.2018

Баги:\
Деструктор для ответов БД (очистка ресурсов)

Возможности:\
Запуск с флагом "-c" также удаляет обработчик события call\_back.

### **2.8.30**

> 04.09.2018

Баги:\
Утечка памяти при использовании админки

### **2.8.29**

> 04.09.2018

Баги:\
Получение cid\_num из имени канала.

Админка - баги:\
Чек-бокс для "регистрации входящих" считывался в переменную "регистрации исходящих" и наоборот.

Админка - внешний вид:\
Добавили виджет обратной связи.

### **2.8.23**

> 09.08.2018

Возможности:\
Устанавливаем имя контакта в CALLERID при автораспределении вызова.

### **2.8.22**

> 08.08.2018

Баги:\
Не закрывали соединение при запросе на установку данных roistat

### **2.8.21**

> 08.08.2018

Баги:\
При перезапуске SQL коннектора сбрасывались переменные сессии.

Возможности:\
Обратный звонок.

### **2.8.17**

> 01.08.2018

Баги:\
Проблемы с сохранением невалидных данных с админки.

### **2.8.15**

> 30.07.2018

Баги:\
1\) Утечка памяти при само-перезапуске модуля.\
2\) Использование неинициализированных данных в сущности "Звонок".

Производительность:\
Очередь тасков была вектором тасков.

### **2.8.9**

> 24.07.2018

Исправлена ошибка перемотки записи

### **2.8.6**

> 23.07.2018

1\) Исправлена ошибка с переводом на группу.\
2\) Добавлена установка таймаутов на соединение с БД.

### **2.8.0**

> 17.07.2018

Звонки теперь продолжают "собираться" до ответа на канале. Благодаря этому:\
1\) Указание транков больше не является требованием для фиксирования звонков\
2\) Будут фиксироваться originate-звонки, даже если они сделаны НЕ через модуль.

### **2.7.112**

> 09.07.2018

Мелкие исправления админки:\
1\) Доработана проверка версии Астериск\
2\) Доработана валидация ввода

### **2.7.103**

> 05.07.2018

Добавлена возможность кастомизации дела и лида

### **2.7.94**

> 03.07.2018

1\) Новый формат лога\
2\) Исправлена ошибка с управляемым переводом

### **2.7.69**

> 19.06.2018

1\) Выгружаем запись для пропущенного звонка, если она существует.\
2\) Возможность добавить Variable и Codecs к параметрам originate через кастомизатор.

### **2.7.51**

> 14.06.2018

1\) Новый интерфейс для изменения конфига приложения.\
2\) Доработана проверка Астериска в мастере настройки

### **2.7.0**

> 06.06.2018

Новый функционал:\
1\) Обработка перехватов.

Мелкие изменения:\
1\) Дефолтный конфиг завёнут в скрипт установки. При установке заполняем логин и пароль для доступа через веб.\
2\) Добавили получение версии ОС и версии приложения в мастере. 3) Исправлена ошибка с сохранением пользователя Астериска через мастер.\
4\) Добавлена проверка фиксируемых событий CEL на Астериск.

### **2.6.49**

> 28.05.2018

Мелкие исправления:\
1\) Не выгружаем записи для пропущенных 2) Доработано удаление нулей в начале номера

Новые особенности\
1\) Возможность использовать сервер "click to call"

### **2.6.41**

> 14.05.2018

1\) Использование имён таблиц и столбцов из конфига при проверке базы.\
2\) Путь до лог файла перенесён в конфиг.

### **2.6.32**

> 08.05.2018

1\) Мастер настройки перемещён на /config/master\
2\) Исправление обработки ошибок при настройке.

### **2.6.11**

> 06.05.2018

1\) Добавлена возможность кэширования пользователей портала.\
2\) Страница запуска мастера проверки закрыта паролем (basic authorization).

### **2.6.1**

> 04.05.2018

1\) Появился мастер настройки подключений. Запуск: /opt/bx24asterisk/bx24asterisk\_configure, после чего настраиваем через веб-интерфейс.\
Для использования консольного интерфейса нужно использовать флаг '-c'.\
2\) Исправлена ошибка регистрации при переводах.

### **2.5.3**

> 20.04.2018

1\) Уменьшено время ожидания при перезапуске (с 5 минут до 1)\
2\) В чек-мастере добавлена проверка Астериска на удалённой машине

### **2.5.1**

> 17.04.2018

1\) bx24asterisk\_configure теперь представляет собой мастер чек-тест:\
\- Выполняет проверку подключения к базе\
\- Выполняет проверку подключения к Битриксу (авторизация, админ, приложение)

### **2.4.51**

> 09.04.2018

Доработано удаление дел/лидов для случая с одним делом на звонок с переводом.

### **2.4.42**

> 04.04.2018

1\) Добавлена возможность изменять паузу между запросами в Битрикс в конфиге.\
2\) Убрал ответы Астериска на: Login, SIPPeers, IAXPeers\
3\) Перевёл часть сообщений на английский

### **2.4.27**

> 23.03.2018

Исправлен баг: неверное время в делах.

### **2.4.26**

> 20.03.2018

1\) Добавлена базовая авторизация на страницу настройки конфига.\
2\) Исправлен баг с поиском пользователей с номерами 0xxx

### **2.4.17**

> 12.03.2018

1\) Берём внутренний номер из chan\_name, если его нет в cid\_num при chan\_start.\
2\) При исходящем звонке сразу ставим ответственным в созданную сущность звонящего пользователя.\
3\) При поиске записи используем номер без префикса.

### **2.4.13**

> 06.03.2018

Изменения в порядке регистрации звонка:\
1\) Можем регистрировать при поступлении на ivr\
2\) Если не зарегистрировали на ivr (из-за ошибки или ответа кастомизатора), то регистрируем при запросе разговора.

Добавлена возможность кастомизации параметров поиска сущности и параметров регистрации завершения разговора (finish).\
Первый метод позволяет НЕ регистрировать звонок на ivr.\
Второй метод позволяет принять сообщить о необходимости удаления дела, после регистрации.

### **2.4.3**

> 26.02.2018

1\) Добавлена возможность изменения конфиг-файла через веб-интерфейс.\
2\) Рестарт программы при потере связи с зависимыми сервисами.

### **2.3.26**

> 14.02.2018

1\) Исправлена ошибка с нарушением логирования при ротации логов.\
2\) Отмена показа окна для старых разговоров.

### **2.3.22**

> 09.02.2018

1\) Исправлен баг составления запроса записи.\
2\) В скрипт-инсталятор добавлено включение ротации логов.\
3\) В скрипт-инсталятор добавлено использование update-rc.d, если нет chkconfig.

### **2.3.15**

> 08.02.2018

Считаем короткие номера (длина меньше 5) локальными.

### **2.3.14**

> 07.02.2018

Добавлена отчистка состояния по флагу -c, а именно:\
1\) Удаляет обработчики onexternalcallstart.\
2\) Чистит файлы state.json и token.json\
3\) Ставит текущее время в конфиг

### **2.3.13**

> 06.02.2018

1\) Сервис запускается от пользователя (Астериск).\
2\) Исправлены баги, связанные с логированием.

### **2.3.7**

> 02.02.2018

Получаем уровень логирования из конфига. Необходимо изменить скрипт /etc/init.d/bx24asterisk : удалить -level=debug

### **2.3.6**

> 01.02.2018

Доработано скрытие карточки разговора, автоматически открытой при клике по номеру

### **2.3.5**

> 01.02.2018

Теперь получаем служебные комбинации с Астериска (например, \*8 для pickup). Звонок на такую комбинацию рассматривается как внутренний.\
Комбинации можно посмотреть выполнив следующую команду в консоли Астериска: features show.

### **2.3.4**

> 31.01.2018

Изменилась особенность работы веб-сервера. Веб-сервер слушает на указанном в listen\_host по указанному в listen\_port порту.

### **2.3.3**

> 30.01.2018

1\) Исправлена обработка клик ту кол.\
2\) Изменение конфига:\
2.1) host заменили на listen\_host.\
2.2) port заменили на listen\_port.\
2.3) добавлен параметр address\_ext для указания адреса для внешних сервисов (например, Битрикс для клика)\
2.4) добавлен параметр address\_int для указания адреса для внутренних сервисов (например, для записи в локальной сети)\
3\) Исправлена обработка управляемого (условного) перевода.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.itgrix.ru/changelog-bx.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.