Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «На получение команды ONIMCOMMANDADD». Вы узнаете экспертные методики работы с получение команды и научитесь избегать типичных ошибок начинающих разработчиков.
На получение команды ONIMCOMMANDADD
Тут может не хватать некоторых данных — дополним в ближайшее время
- нужны правки под стандарт написания
- не указаны типы параметров
- не указана обязательность параметров
- таблицы параметров сгенерированы по примеру. Что такое [14] в примере???
> Scope: im
>
> Кто может подписаться: любой пользователь
Событие ONIMCOMMANDADD на установку приложения.
Описанные ниже поля — это содержимое поля [data] в событии. Данные авторизации в ключе [auth] содержат данные пользователя инициатора события, для получения данных авторизации бота, необходимо использовать [data][BOT][__BOT_CODE__].
| Поле | Описание | Ревизия |
|---|---|---|
COMMAND unknown | Массив команд, которые были вызваны пользователем | |
PARAMS unknown | Массив данных сообщения | |
USER unknown | Массив данных автора сообщения, может быть пустым, если ID = 0 |
COMMAND / [14]???
| Поле | Описание | Ревизия |
|---|---|---|
AUTH unknown | Параметры для авторизации под чат-ботом для выполнения действий | |
BOT_ID unknown | Идентификатор чат-бота | |
BOT_CODE unknown | Код чат-бота | |
COMMAND unknown | Вызванная команда | |
COMMAND_ID unknown | Идентификатор команды | |
COMMAND_PARAMS unknown | Параметры, с которыми была вызвана команда | |
COMMAND_CONTEXT unknown | Контекст выполнения команды. — TEXTAREA, если команда введена руками — KEYBOARD, если нажал на кнопку в клавиатуре | |
MESSAGE_ID unknown | Идентификатор сообщения, на которое необходимо ответить |
PARAMS
| Поле | Описание | Ревизия |
|---|---|---|
DIALOG_ID unknown | Идентификатор диалога | |
CHAT_TYPE unknown | Тип сообщения и чата — P (чат один-на-один), — C (с ограниченным количеством участников), — O (публичный чат) | |
MESSAGE_ID unknown | Идентификатор сообщения | |
MESSAGE unknown | Сообщение | |
MESSAGE_ORIGINAL unknown | Оригинальное сообщение с BB-кодом бота (параметр доступен только в групповых чатах) | |
FROM_USER_ID unknown | Идентификатор пользователя отправившего сообщение | |
TO_USER_ID unknown | Идентификатор другого пользователя (параметр доступен только в чатах один-на-один) | |
TO_CHAT_ID unknown | Идентификатор чата (параметр доступен только в групповых чатах) | |
LANGUAGE unknown | Идентификатор языка портала по умолчанию |
USER
| Поле | Описание | Ревизия |
|---|---|---|
ID unknown | Идентификатор пользователя | |
NAME unknown | Имя и фамилия пользователя | |
FIRST_NAME unknown | Имя пользователя | |
LAST_NAME unknown | Фамилия пользователя | |
WORK_POSITION unknown | Занимаемая должность | |
GENDER unknown | Пол, может быть либо M (мужской), либо F (женский) |
Практические примеры использования в коде
- JS
[COMMAND] => Array (
[14] => Array (
[AUTH] => Array (
[domain] => b24.hazz
[member_id] => d41d8cd98f00b204e9800998ecf8427e
[application_token] => 8006ddd764e69deb28af0c768b10ed65
)
[BOT_ID] => 62
[BOT_CODE] => echobot
[COMMAND] => echo
[COMMAND_ID] => 14
[COMMAND_PARAMS] => test
[COMMAND_CONTEXT] => TEXTAREA
[MESSAGE_ID] => 1221
)
)
[PARAMS] => Array (
[DIALOG_ID] => 1
[CHAT_TYPE] => P
[MESSAGE_ID] => 1221
[MESSAGE] => /echo test
[MESSAGE_ORIGINAL] => /echo test
[FROM_USER_ID] => 1
[TO_USER_ID] => 2
[TO_CHAT_ID] => 6
[LANGUAGE] => ru
)
[USER] => Array (
[ID] => 1
[NAME] => Евгений Шеленков
[FIRST_NAME] => Евгений
[LAST_NAME] => Шеленков
[WORK_POSITION] =>
[GENDER] => M
)💡 Экспертное мнение и рекомендации
Практические рекомендации:
- При написании кастомных компонентов для «На получение команды ONIMCOMMANDADD» всегда разделяйте бизнес-логику и представление (шаблон).
- Используйте отладку SQL-запросов через конструкцию
$wpdb->last_queryили стандартный трекер Битрикса, чтобы контролировать нагрузку.
Похожая задача в бизнесе?
Помогу автоматизировать процессы и внедрить ИИ
Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.
или на почту: gorandvas@yandex.ru