Блог Горошко Андрея Bitrix24 На получение команды ONIMCOMMANDADD

На получение команды ONIMCOMMANDADD

Эффективная интеграция и кастомизация функционала в Битрикс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 и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Как использовать метод SDK crm.item.productrow.getAvailableForPayment в Битри…Как использовать метод SDK crm.item.productrow.getAvailableForPayment в Битри…

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Как использовать метод SDK crm.item.productrow.getAvailableForPayment в Битри…». Мы подготовили подробный разбор принципов работы и развернутые

Как использовать метод SDK crm.address.list в Битрикс24Как использовать метод SDK crm.address.list в Битрикс24

Эффективная интеграция и кастомизация функционала в Битрикс24 часто требует работы на уровне API. Сегодня мы подробно рассмотрим «Как использовать метод SDK crm.address.list в Битрикс24». Вы узнаете экспертные методики работы с

Добавить комментарий task.commentitem.addДобавить комментарий task.commentitem.add

При разработке и поддержке проектов на платформе 1С-Битрикс критически важно использовать современные стандарты D7 API. В этом руководстве мы детально изучим тему «Добавить комментарий task.commentitem.add», разберем архитектурные особенности и предоставим