Удаление приложений
Выберите инструмент для разработки с AI-агентом:
- используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
- используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации
Когда администратор удаляет приложение, Битрикс24 снимает его подписки на события, встройки и другие регистрации, через которые приложение работает. Что станет с данными приложения, зависит от его типа. Локальное приложение Битрикс24 всегда удаляет с очисткой данных. При удалении тиражного приложения администратор сам решает, удалить данные или оставить их на случай повторной установки.
Например, если администратор удалил тиражное приложение платежной системы и не отметил удаление данных, приложение перестанет работать, а его платежная система останется в Битрикс24.
Что происходит при обновлении приложения до новой версии, описано в статье Обновление приложений.
Как приложение узнает об удалении
Приложение узнает об удалении по событию OnAppUninstall, если заранее подписалось на него. Тиражному приложению событие нужно, чтобы вовремя прекратить запросы к этому Битрикс24: после удаления приложение теряет доступ к REST API. Например, на вызов с прежним токеном Битрикс24 отвечает ошибкой APPLICATION_NOT_FOUND.
В поле CLEAN события Битрикс24 передает признак очистки данных: у тиражного приложения он зависит от выбора администратора, у локального очистка включена всегда.
Прежде чем прекратить работу по этому событию, проверьте, что его отправил Битрикс24: сверьте application_token из события с актуальным значением, которое приложение сохраняет при установке и обновляет по событию ONAPPUPDATE. Как это сделать, описано в статье Безопасность в обработчиках.
Что удаляется всегда
Независимо от типа приложения и выбора очистки данных Битрикс24 удаляет:
- подписки на события
- встройки и пользовательские типы полей
- роботов и действия бизнес-процессов
- чат-ботов
- коннекторы открытых линий
- провайдеры сообщений
- внешние линии телефонии
Если у тиражного приложения есть системный пользователь, Битрикс24 деактивирует его независимо от выбора очистки данных.
Что зависит от очистки данных
При удалении тиражного приложения Битрикс24 предлагает опцию Удалить настройки и данные приложения. Для платежных систем, касс и служб доставки очистка касается обработчиков приложения и всех объектов, которые их используют.
|
Данные и объекты приложения |
Опция не выбрана |
Опция выбрана или приложение локальное |
|
Остаются |
Удаляются |
|
|
Остаются |
Удаляются |
|
|
Остаются |
Удаляются только у пользователя, который удалил приложение. У остальных пользователей остаются |
|
|
Остаются |
Удаляются |
|
|
Остаются |
Удаляются |
|
|
Остаются |
Удаляются |
Что остается после удаления
Удаление приложения не затрагивает объекты, которые приложение создало в инструментах Битрикс24:
- пользовательские поля и их значения
- типы дел CRM
- смарт-процессы
Поля собственного типа приложения останутся, но перестанут отображаться в карточке — подробнее в описании метода userfieldtype.delete.
Повторная установка
Отменить удаление нельзя.
Тиражное приложение можно установить на тот же Битрикс24 повторно. Если администратор оставил данные при удалении, приложение снова получит доступ к своим хранилищам и настройкам. Подписки на события, встройки и другие регистрации из раздела Что удаляется всегда приложению нужно создать заново.
Локальное приложение после удаления можно только создать заново. Новое приложение получит новую пару client_id и client_secret для OAuth-авторизации, даже если адреса обработчиков совпадают со старыми.