Что нового?

Просмотров: 26097
Дата последнего изменения: 07.02.2024

Новинки API Бот платформы Битрикс24.

Январь 2022

Новые методы в Chat API (REST ревизии 30):

Получение информации об участниках чата (поддерживается пагинация) – im.dialog.users.list
Отправка статуса «вам пишут...» – im.dialog.writing
Установка метки «прочитано» для всех диалогов – im.dialog.read.all
Использование команды бота – im.message.command
Создание новых сущностей по сообщению в чате: новый чат, задача, пост в Новостях, событие в календаре – im.message.share
Установка метки «не прочитан» на чат или диалог – im.recent.unread
Получение списка последних диалогов пользователя (с поддержкой пагинации) – im.recent.list
«Прочтение» списка уведомлений, исключая уведомления типа CONFIRM – im.notify.read.list
Ответ на уведомление, поддерживающее быстрый ответ – im.notify.answer
Взаимодействие с кнопками нотификаций – im.notify.confirm

Август 2020
Новые методы в IMOPENLINES REST API в ревизии 2: imopenlines.revision.get - получение информации о ревизиях OPENLINES REST API. imopenlines.dialog.get - получение информации о диалоге (чате) оператора открытой линии. Репозиторий примеров чат-ботов переехал с Bitbucket-а на GitHub.

Август 2020

Июль 2020
Поддержка действий `ACTION` и `ACTION_VALUE` (REST ревизии 28): в клавиатурах в контекстных меню

Июль 2020

Поддержка действий ACTION и ACTION_VALUE (REST ревизии 28):

Декабрь 2019
Новые методы в Chat API: Получение информации о диалоге – im.dialog.get Новые методы в Bot API: Получение информации о диалоге – imbot.dialog.get

Декабрь 2019

Июль 2019
В метод Список последних диалогов пользователя (im.recent.get) с ревизии 23 добавился новый параметр LAST_UPDATE – ограничение выборки для минимизации переданных данных, дата в формате ATOM. В методе Изменение факта прочтения сообщений (im.dialog.read) с ревизии 23 поменялся формат ответа.

Июль 2019

Апрель 2019
Добавились новые параметры WIDTH (ширина) и HEIGHT (высота) в блоках, где используются изображения: Блок со ссылками Блок с изображениями Поля WIDTH (ширина) и HEIGHT (высота) не являются обязательными, но рекомендуется их указывать уже сейчас, чтобы правильно отобразить изображение.

Апрель 2019

Февраль 2019
Новые методы в Chat API: Сохранение файла в свой Битрикс24.Диск - im.disk.file.save Изменение факта прочтения сообщений: все сообщения до указанного (включая само сообщение) помечаются как прочитанные - im.dialog.read Изменение факта прочтения сообщений: все сообщения после указанного (включая само сообщение) помечаются как непрочитанные - im.dialog.unread

Февраль 2019

Август 2018
Новые методы в Chat API: Версия платформы - im.revision.get Отключение уведомлений в чате - im.chat.mute Получение списка последних сообщений в чате - im.dialog.messages.get Получение информации о папке хранения файлов для чата - im.disk.folder.get Публикация загруженного файла в чат - im.disk.file.commit Удаление файлов внутри папки чата - im.disk.file.delete Получение данных о пользователе - im.user.get Получение данных о пользователях - im.user.list.get Получение списка бизнес-пользователей - im.user.business.list Получение информации об установленном статусе пользователя - im.user.status.get Установка статуса пользователя - im.user.status.set Установка автоматического статуса «Отошел» - im.user.status.idle.start Отключение автоматического статуса «Отошел» - im.user.status.idle.end Получение данных о подразделении - im.department.get Получение списка пользователей, состоящих в вашем отделе - im.department.colleagues.list Получение списка руководителей подразделений - im.department.managers.get Получение списка сотрудников в подразделении - im.department.employees.get Поиск пользователей - im.search.user.list Поиск чатов - im.search.chat.list Поиск подразделений - im.search.department.list Получение списка элементов последнего поиска - im.search.last.get Добавление элемента истории последнего поиска - im.search.last.add Удаление элемента истории последнего поиска - im.search.last.delete Список последних диалогов пользователя - im.recent.get Закрепление диалога в избранном - im.recent.pin Удаление диалога из списка последних чатов - im.recent.hide Получение счетчиков - im.counters.get Установка отмены о прочитанных уведомлениях - im.notify.read

Август 2018

Новые методы в Chat API:

Версия платформы - im.revision.get
Отключение уведомлений в чате - im.chat.mute
Получение списка последних сообщений в чате - im.dialog.messages.get
Получение информации о папке хранения файлов для чата - im.disk.folder.get
Публикация загруженного файла в чат - im.disk.file.commit
Удаление файлов внутри папки чата - im.disk.file.delete
Получение данных о пользователе - im.user.get
Получение данных о пользователях - im.user.list.get
Получение списка бизнес-пользователей - im.user.business.list
Получение информации об установленном статусе пользователя - im.user.status.get
Установка статуса пользователя - im.user.status.set
Установка автоматического статуса «Отошел» - im.user.status.idle.start
Отключение автоматического статуса «Отошел» - im.user.status.idle.end
Получение данных о подразделении - im.department.get
Получение списка пользователей, состоящих в вашем отделе - im.department.colleagues.list
Получение списка руководителей подразделений - im.department.managers.get
Получение списка сотрудников в подразделении - im.department.employees.get
Поиск пользователей - im.search.user.list
Поиск чатов - im.search.chat.list
Поиск подразделений - im.search.department.list
Получение списка элементов последнего поиска - im.search.last.get
Добавление элемента истории последнего поиска - im.search.last.add
Удаление элемента истории последнего поиска - im.search.last.delete
Список последних диалогов пользователя - im.recent.get
Закрепление диалога в избранном - im.recent.pin
Удаление диалога из списка последних чатов - im.recent.hide
Получение счетчиков - im.counters.get
Установка отмены о прочитанных уведомлениях - im.notify.read

Февраль 2018
В методы imbot.register и imbot.update были добавлены поля `EVENT_MESSAGE_UPDATE` и `EVENT_MESSAGE_DELETE` для подписки на события изменения и удаления сообщений. Добавлен новый тип чат-бота с повышенными привилегиями (supervisor) - бот, получающий доступ ко всем сообщениям в чатах, где он состоит (ко всем, если его пригласили с доступом к истории, и к новым, если доступ к истории ему не доступен). Для создания чат-бота с повышенными привилегиями в метод imbot.register в поле `TYPE` укажите тип `S`. Обратите внимание, если это не требуется логикой вашего приложения, то рекомендуется отвечать боту на сообщения пользователя только при упоминании этого чат-бота. Проверить это можно по полю `TO_USER_ID`, которое будет передано в событие. Кроме этого добавлены обработчики для отслеживания изменения и удаления сообщений (доступны для этого типа бота). В метод im.chat.add добавлены новые поля `ENTITY_TYPE` и `ENTITY_ID`, с помощью которых вы можете осуществить быстрый поиск и идентификацию чата в событиях EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE, EVENT_MESSAGE_DELETE. Метод imbot.update больше не поддерживает изменение полей `TYPE` и `OPENLINE`. Добавлен новый метод im.chat.get, который с помощью `ENTITY_TYPE` и `ENTITY_ID` позволяет получить идентификатор чата. В события EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE, EVENT_MESSAGE_DELETE добавлены поля `CHAT_ENTITY_TYPE` и `CHAT_ENTITY_ID` для идентификации чата (данные поля вы можете задать в момент создания). В события EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE добавлено поле `TO_USER_ID`, в котором будет идентификатор упомянутого пользователя. Благодаря этому, в случае бота с типом S вы сможете понять, нужно ли вам отвечать или нет. Обновление в imbot.register и imbot.update: если все обработчики событий у вас ведут на один и тот же адрес, вы вместо указания `EVENT_MESSAGE_ADD`, `EVENT_MESSAGE_UPDATE`, `EVENT_MESSAGE_DELETE`, `EVENT_WELCOME_MESSAGE`, `EVENT_BOT_DELETE` - можете указать только `EVENT_HANDLER` - значение из него автоматически пропишется во все обработчики. В метод im.chat.add добавлено новое поле `OWNER_ID`, с помощью которого вы сможете указать владельца чата. В раздел Работа с чатами (Bot API) добавлены методы: imbot.chat.add - создание чата от лица чат-бота; imbot.chat.get - получение идентификатора чата; imbot.chat.setOwner - смена владельца чата от лица чат-бота. Во все методы Работа с чатами (Bot API) добавлен параметр `BOT_ID`.

Февраль 2018

В методы imbot.register и imbot.update были добавлены поля EVENT_MESSAGE_UPDATE и EVENT_MESSAGE_DELETE для подписки на события изменения и удаления сообщений.
Добавлен новый тип чат-бота с повышенными привилегиями (supervisor) - бот, получающий доступ ко всем сообщениям в чатах, где он состоит (ко всем, если его пригласили с доступом к истории, и к новым, если доступ к истории ему не доступен).
Для создания чат-бота с повышенными привилегиями в метод imbot.register в поле TYPE укажите тип S.

Обратите внимание, если это не требуется логикой вашего приложения, то рекомендуется отвечать боту на сообщения пользователя только при упоминании этого чат-бота. Проверить это можно по полю TO_USER_ID, которое будет передано в событие.

Кроме этого добавлены обработчики для отслеживания изменения и удаления сообщений (доступны для этого типа бота).
В метод im.chat.add добавлены новые поля ENTITY_TYPE и ENTITY_ID, с помощью которых вы можете осуществить быстрый поиск и идентификацию чата в событиях EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE, EVENT_MESSAGE_DELETE.
Метод imbot.update больше не поддерживает изменение полей TYPE и OPENLINE.
Добавлен новый метод im.chat.get, который с помощью ENTITY_TYPE и ENTITY_ID позволяет получить идентификатор чата.
В события EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE, EVENT_MESSAGE_DELETE добавлены поля CHAT_ENTITY_TYPE и CHAT_ENTITY_ID для идентификации чата (данные поля вы можете задать в момент создания).
В события EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE добавлено поле TO_USER_ID, в котором будет идентификатор упомянутого пользователя. Благодаря этому, в случае бота с типом S вы сможете понять, нужно ли вам отвечать или нет.
Обновление в imbot.register и imbot.update: если все обработчики событий у вас ведут на один и тот же адрес, вы вместо указания EVENT_MESSAGE_ADD, EVENT_MESSAGE_UPDATE, EVENT_MESSAGE_DELETE, EVENT_WELCOME_MESSAGE, EVENT_BOT_DELETE - можете указать только EVENT_HANDLER - значение из него автоматически пропишется во все обработчики.
В метод im.chat.add добавлено новое поле OWNER_ID, с помощью которого вы сможете указать владельца чата.
В раздел Работа с чатами (Bot API) добавлены методы:
- imbot.chat.add - создание чата от лица чат-бота;
- imbot.chat.get - получение идентификатора чата;
- imbot.chat.setOwner - смена владельца чата от лица чат-бота.
Во все методы Работа с чатами (Bot API) добавлен параметр BOT_ID.

Декабрь 2017
В метод imbot.register был добавлен новый код ошибки `MAX_COUNT_ERROR` - достигнуто максимальное количество зарегистрированных ботов для одного приложения. Теперь максимальное количество ботов для одного приложения: 5.

Курсы разработаны в компании «1С-Битрикс»