Событие при удалении чат-бота ONIMBOTDELETE
Scope:
imbotКто может подписаться: пользователь приложения, которое зарегистрировало чат-бота
DEPRECATED
Развитие события остановлено. Используйте ONIMBOTV2DELETE.
Событие ONIMBOTDELETE срабатывает при удалении чат-бота. Событие работает только в контексте приложения чат-бота.
События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения
Что получает обработчик
Данные передаются в виде POST-запроса
{
"event": "ONIMBOTDELETE",
"event_handler_id": "439",
"data": {
"BOT_ID": "567",
"BOT_CODE": "BOT"
},
"ts": "1772090363",
"auth": {
"access_token": "0b02a0690000071b0008440001b0007a16b39202c2490f015",
"expires": "1772093963",
"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",
"application_token": "831c76b092f9f135d9b6b36c3a720757"
}
}
|
Параметр |
Описание |
|
event |
Символьный код события. В данном случае — |
|
event_handler_id |
Идентификатор обработчика события |
|
data |
Объект с данными удаленного чат-бота. Структура описана ниже |
|
ts |
Дата и время отправки события из очереди событий |
|
auth |
Объект с параметрами авторизации пользователя, от имени которого сработало событие. Структура описана ниже |
Параметр data
|
Параметр |
Описание |
|
BOT_ID |
Идентификатор удаленного чат-бота |
|
BOT_CODE |
Символьный код удаленного чат-бота |
Параметр auth
Обязательные параметры отмечены *
|
Название |
Описание |
|
access_token |
Токен авторизации OAuth 2.0 |
|
expires_in |
Время в секундах до истечения срока действия токена |
|
scope* |
Скоуп, в рамках которого произошло событие |
|
domain* |
Адрес Битрикс24, на котором произошло событие |
|
server_endpoint* |
Адрес сервера авторизации Битрикс24, необходимый для обновления токенов OAuth 2.0 |
|
status* |
Статус приложения, подписавшегося на это событие:
|
|
client_endpoint* |
Общий путь для вызовов методов REST API для Битрикс24, на котором произошло событие |
|
member_id* |
Идентификатор Битрикс24, на котором произошло событие |
|
refresh_token |
Токен продления авторизации OAuth 2.0 |
|
application_token* |
Токен для безопасной обработки событий |
Токены авторизации не всегда передаются в обработчик события. Если хит, инициировавший событие, не удалось привязать к конкретному пользователю Битрикс24, токены не передаются. Обязательно проверяйте содержимое ключа auth в коде.
Рекомендуем хранить токены, полученные ранее при установке приложения. Используйте их при работе с интерфейсом приложения в виде встроек, виджетов и так далее.
Продолжите изучение
- Удалить чат-бота imbot.unregister
- Событие при добавлении бота в чат ONIMBOTJOINCHAT
- Событие при отправке сообщения ONIMBOTMESSAGEADD
- Событие при изменении сообщения ONIMBOTMESSAGEUPDATE
- Событие при удалении сообщения ONIMBOTMESSAGEDELETE
- Событие при вызове команды чат-бота ONIMCOMMANDADD