Событие при удалении сообщения ONIMBOTMESSAGEDELETE

Scope: imbot

Кто может подписаться: пользователь приложения, которое зарегистрировало чат-бота

DEPRECATED

Развитие события остановлено. Используйте ONIMBOTV2MESSAGEDELETE.

Событие ONIMBOTMESSAGEDELETE срабатывает при удалении сообщения в диалоге с чат-ботом. Событие работает только в контексте приложения чат-бота.

Для ботов с TYPE=B/H и OPENLINE=N параметр EVENT_MESSAGE_DELETE игнорируется в методе imbot.register. Чтобы событие срабатывало для таких ботов, привяжите обработчик EVENT_MESSAGE_DELETE с помощью метода imbot.update.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Правило срабатывания события

Событие срабатывает, если привязан обработчик EVENT_MESSAGE_DELETE и сообщение соответствует логике типа бота:

TYPE=B/H:
- личный чат с ботом: событие срабатывает независимо от упоминаний,
- групповой чат: срабатывает только при упоминании бота,
TYPE=S — событие срабатывает независимо от упоминаний,
TYPE=O — событие срабатывает в чатах открытых линий, где участвует бот.

Без EVENT_MESSAGE_DELETE событие не сработает независимо от упоминаний.

Что получает обработчик

Данные передаются в виде POST-запроса

Личный чат с ботом

Групповой чат

{
            "event": "ONIMBOTMESSAGEDELETE",
            "event_handler_id": "457",
            "data": {
                "BOT": {
                    "571": {
                        "access_token": "9a0aa06900071b0000084400023bf0f107e7cd778b0dbccd0155cea",
                        "expires": "1772096154",
                        "expires_in": "3600",
                        "scope": "imbot",
                        "domain": "some-domain.bitrix24.ru",
                        "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                        "status": "F",
                        "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                        "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                        "refresh_token": "9a0aa06900071b000844000023bf0f107e7cd778b0dbccd0155cea",
                        "user_id": "571",
                        "client_id": "a7eff906dd1d950269258a599214f69e",
                        "application_token": "831c76b092f9f135d9b6b36c3a720757",
                        "AUTH": {
                            "access_token": "9a0aa06900071b0000084400023bf0f107e7cd778b0dbccd0155cea",
                            "expires": "1772096154",
                            "expires_in": "3600",
                            "scope": "imbot",
                            "domain": "some-domain.bitrix24.ru",
                            "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                            "status": "F",
                            "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                            "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                            "refresh_token": "9a0aa06900071b000844000023bf0f107e7cd778b0dbccd0155cea",
                            "user_id": "571",
                            "client_id": "a7eff906dd1d950269258a599214f69e",
                            "application_token": "831c76b092f9f135d9b6b36c3a720757"
                        },
                        "BOT_ID": "571",
                        "BOT_CODE": "BOT"
                    }
                },
                "PARAMS": {
                    "ID": "84525",
                    "CHAT_ID": "1453",
                    "AUTHOR_ID": "27",
                    "MESSAGE": "Сообщение от 26.02.2026 09:27:30 было удалено",
                    "MESSAGE_TYPE": "P",
                    "CHAT_AUTHOR_ID": "571",
                    "CHAT_ENTITY_ID": "",
                    "CHAT_ENTITY_DATA_1": "",
                    "CHAT_ENTITY_DATA_2": "",
                    "CHAT_ENTITY_DATA_3": "",
                    "FROM_USER_ID": "27",
                    "TO_USER_ID": "571",
                    "DIALOG_ID": "27",
                    "MESSAGE_ID": "84525",
                    "CHAT_TYPE": "P",
                    "LANGUAGE": "ru"
                },
                "USER": {
                    "ID": "27",
                    "NAME": "Светлана Иванова",
                    "FIRST_NAME": "Светлана",
                    "LAST_NAME": "Иванова",
                    "WORK_POSITION": "",
                    "GENDER": "F",
                    "IS_BOT": "N",
                    "IS_CONNECTOR": "N",
                    "IS_NETWORK": "N",
                    "IS_EXTRANET": "N"
                }
            },
            "ts": "1772092554",
            "auth": {
                "access_token": "9a0aa06900071b00084400001b0000781c0546d93491d81d",
                "expires": "1772096154",
                "expires_in": "3600",
                "scope": "imbot",
                "domain": "some-domain.bitrix24.ru",
                "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                "status": "F",
                "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                "user_id": "27",
                "refresh_token": "8a89c769000071b00084400001b000c1b724e4652017b0ea7051ffb8e",
                "application_token": "831c76b092f9f135d9b6b36c3a720757"
            }
        }

{
            "event": "ONIMBOTMESSAGEDELETE",
            "event_handler_id": "457",
            "data": {
                "BOT": {
                    "571": {
                        "access_token": "9a0aa0690000071b000008440001b000781c0546d82fee9e8c",
                        "expires": "1772100933",
                        "expires_in": "3600",
                        "scope": "imbot",
                        "domain": "some-domain.bitrix24.ru",
                        "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                        "status": "F",
                        "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                        "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                        "refresh_token": "9a0aa0690071b0000084400001b000781c0546d82fee9e8c",
                        "user_id": "571",
                        "client_id": "a7eff906dd1d950269258a599214f69e",
                        "application_token": "831c76b092f9f135d9b6b36c3a720757",
                        "AUTH": {
                            "access_token": "9a0aa0690000071b000008440001b000781c0546d82fee9e8c",
                            "expires": "1772100933",
                            "expires_in": "3600",
                            "scope": "imbot",
                            "domain": "some-domain.bitrix24.ru",
                            "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                            "status": "F",
                            "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                            "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                            "refresh_token": "9a0aa0690071b0000084400001b000781c0546d82fee9e8c",
                            "user_id": "571",
                            "client_id": "a7eff906dd1d950269258a599214f69e",
                            "application_token": "831c76b092f9f135d9b6b36c3a720757"
                        },
                        "BOT_ID": "571",
                        "BOT_CODE": "BOT"
                    }
                },
                "PARAMS": {
                    "ID": "84537",
                    "CHAT_ID": "1157",
                    "AUTHOR_ID": "27",
                    "MESSAGE": "Сообщение от 26.02.2026 11:14:02 было удалено",
                    "MESSAGE_TYPE": "C",
                    "CHAT_AUTHOR_ID": "27",
                    "CHAT_ENTITY_TYPE": "THREAD",
                    "CHAT_ENTITY_ID": "",
                    "CHAT_ENTITY_DATA_1": "",
                    "CHAT_ENTITY_DATA_2": "",
                    "CHAT_ENTITY_DATA_3": "",
                    "DIALOG_ID": "chat1157",
                    "MESSAGE_ID": "84537",
                    "CHAT_TYPE": "C",
                    "LANGUAGE": "ru"
                }
            },
            "ts": "1772097333",
            "auth": {
                "access_token": "451da069000071b00084400001b00075b8bc870e6dbc3",
                "expires": "1772100933",
                "expires_in": "3600",
                "scope": "imbot",
                "domain": "some-domain.bitrix24.ru",
                "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                "status": "F",
                "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                "member_id": "bac1cd5c8940947a75e0d71b1a84e348",
                "user_id": "27",
                "refresh_token": "359cc76900071b0000084400001b00071a54cd7aad70b5d2fa",
                "application_token": "831c76b092f9f135d9b6b36c3a720757"
            }
        }

Параметр `тип`	Описание
event `string`	Символьный код события. В данном случае — `ONIMBOTMESSAGEDELETE`
event_handler_id `integer`	Идентификатор обработчика события
data `object`	Объект с данными события. Структура описана ниже
ts `timestamp`	Дата и время отправки события из очереди событий
auth `object`	Объект с параметрами авторизации пользователя, от имени которого сработало событие. Структура описана ниже

Параметр data

Параметр `тип`	Описание
BOT `object`	Набор параметров авторизации ботов, которым предназначено сообщение. Ключ объекта — идентификатор бота `BOT_ID`. Структура описана ниже
PARAMS `object`	Параметры удаленного сообщения. Структура описана ниже
USER `object`	Данные автора удаленного сообщения. Может быть пустым объектом, если `FROM_USER_ID = 0`. Структура описана ниже

Параметр BOT

Параметр
тип

Описание

{BOT_ID}
object

Объект данных конкретного бота. Ключ соответствует идентификатору бота, например 571.

Структура описана ниже

Элемент /

Параметр `тип`	Описание
access_token `string`	OAuth-токен авторизации бота
expires `timestamp`	Момент окончания действия токена
expires_in `integer`	Время жизни токена в секундах
scope `string`	Скоуп, в рамках которого произошло событие
domain `string`	Адрес Битрикс24, на котором произошло событие
server_endpoint `string`	Адрес OAuth-сервера для REST-запросов
status `string`	Признак состояния приложения на портале
client_endpoint `string`	Общий путь для вызовов методов REST API на портале, где произошло событие
member_id `string`	Уникальный идентификатор Битрикс24
refresh_token `string`	OAuth-токен продления авторизации бота
user_id `integer`	Идентификатор пользователя-бота
client_id `string`	Идентификатор приложения, выданный при регистрации
application_token `string`	Токен приложения
AUTH `object`	Параметры авторизации бота в формате `auth`. Структура описана ниже
BOT_ID `integer`	Идентификатор бота
BOT_CODE `string`	Символьный код бота

Параметр PARAMS

Параметр `тип`	Описание
ID `integer`	Идентификатор сообщения в таблице чата
CHAT_ID `integer`	Идентификатор чата. Для группового чата и чата открытой линии параметр передается всегда. Для личного диалога параметр может отсутствовать
AUTHOR_ID `integer`	Идентификатор автора удаленного сообщения
MESSAGE `string`	Текст системного уведомления об удалении сообщения
MESSAGE_TYPE `string`	Тип сообщения. Возможные значения: `P` — private, личный чат `C` — group chat, групповой чат `O` — open chat, открытый чат `L` — open line, чат открытой линии `S` — system/notify, системное уведомление `N` — channel, канал `J` — open channel, открытый канал `T` — comment thread, ветка комментариев `A` — copilot chat, чат CoPilot `B` — collab, коллаб `X` — external, внешний чат
CHAT_AUTHOR_ID `integer`	Идентификатор владельца чата
CHAT_ENTITY_TYPE `string`	Тип объекта, к которому привязан чат
CHAT_ENTITY_ID `string`	Идентификатор объекта, к которому привязан чат
CHAT_ENTITY_DATA_1 `string`	Дополнительные данные объекта чата — поле 1
CHAT_ENTITY_DATA_2 `string`	Дополнительные данные объекта чата — поле 2
CHAT_ENTITY_DATA_3 `string`	Дополнительные данные объекта чата — поле 3
DIALOG_ID `string`	Идентификатор диалога
MESSAGE_ID `integer`	Идентификатор удаленного сообщения. Добавляется в обработчике события из второго аргумента события
CHAT_TYPE `string`	Тип чата. Возможные значения: `P` — private, личный чат `C` — group chat, групповой чат `O` — open chat, открытый чат `L` — open line, чат открытой линии `S` — system/notify, системное уведомление `N` — channel, канал `J` — open channel, открытый канал `T` — comment thread, ветка комментариев `A` — copilot chat, чат CoPilot `B` — collab, коллаб `X` — external, внешний чат
LANGUAGE `string`	Язык Битрикс24 по умолчанию

Параметр USER

Параметр `тип`	Описание
ID `integer`	Идентификатор пользователя
NAME `string`	Имя и фамилия пользователя
FIRST_NAME `string`	Имя пользователя
LAST_NAME `string`	Фамилия пользователя
WORK_POSITION `string`	Должность пользователя
GENDER `string`	Пол пользователя: `M` или `F`
IS_BOT `string`	Признак пользователя-бота: `Y` или `N`
IS_CONNECTOR `string`	Признак пользователя-коннектора: `Y` или `N`
IS_NETWORK `string`	Признак внешнего сетевого пользователя: `Y` или `N`
IS_EXTRANET `string`	Признак экстранет-пользователя: `Y` или `N`

Параметр auth

Обязательные параметры отмечены *

Название `тип`	Описание
access_token `string`	Токен авторизации OAuth 2.0
expires_in `integer`	Время в секундах до истечения срока действия токена
scope* `string`	Скоуп, в рамках которого произошло событие
domain* `string`	Адрес Битрикс24, на котором произошло событие
server_endpoint* `string`	Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0
status* `string`	Статус приложения, подписавшегося на это событие: `L` — локальное приложение `F` — бесплатное тиражное приложение `S` — подписное тиражное приложение
client_endpoint* `string`	Общий путь для вызовов методов REST API для Битрикс24, на котором произошло событие
member_id* `string`	Идентификатор Битрикс24, на котором произошло событие
refresh_token `string`	Токен продления авторизации OAuth 2.0
application_token* `string`	Токен для безопасной обработки событий

Токены авторизации не всегда передаются в обработчик события. Если хит, инициировавший событие, не удалось привязать к конкретному пользователю Битрикс24, токены не передаются. Обязательно проверяйте содержимое ключа auth в коде.

Рекомендуем хранить токены, полученные ранее при установке приложения. Используйте их при работе с интерфейсом приложения в виде встроек, виджетов и так далее.

Продолжите изучение

При изменении сообщения

О командах чат-ботов

Событие при удалении сообщения ONIMBOTMESSAGEDELETE

Правило срабатывания событияПравило срабатывания события

Что получает обработчикЧто получает обработчик

Параметр dataПараметр data

Параметр BOTПараметр BOT

Элемент /{BOT_ID/}Элемент /

Параметр PARAMSПараметр PARAMS

Параметр USERПараметр USER

Параметр authПараметр auth

Продолжите изучениеПродолжите изучение