Комментарии 11
Подтверждаю. Битрикс это лютая дичь. Код очень низкого качества
В битриксе так устроено буквально всё, не только боты.
Их документация:
А) Разбросана как попало по множеству страниц.
Б) Неполная
В) Недостоверная, то есть часто там вообще описано что-то не то, что реально есть в битриксе.
Можно было бы применять вместо документации глаза и логику. Но элементы внутри самой системы:
А) Разбросаны внутри с грубыми нарушениями логики
Б) Не содержат функций, которые ожидаешь увидеть в любом интерфейсе.
В) Делают не то, что на них написано.
Г) Имеют незадокументированные исключения в применимости.
Д) Однотипные элементы работают по разной логике.
Обычная фильтрация может в одном месте действительно фильтровать, как ожидается, а в другом месте фильтровать, но совсем не так.
Я долго думал - действительно ли разработчики битрикс настолько плохи.
Но отгадку я услышал случайно на одной из их конференций с партнёрами-интеграторами. Они сказали, что и так дают тем заработать...
Спасибо за статью! Разобраться с особенностями ботов - не самая простая история. Это достаточно старый функционал, который по мере развития, оброс рядом костылей в REST API, к сожалению. И пока мы еще не до конца актуализировали материалы по ботам в доке. Как раз в ближайших планах обновление по этому поводу от команды коммуникаций.
И да, текущая версия REST API - это зоопарк, получившийся в силу интенсивного наращивания пользовательского функционала, прежде всего. Битрикс24, признаем, не API first продукт. Но мы стараемся исправиться в новой версии REST API, которая уже жестко регламентирована для внутренней разработки. Думаю, скоро первые методы уже выкатим.
Было бы очень круто, если бы вы этот материал в виде туториала закинули в доку - https://github.com/bitrix-tools/b24-rest-docs. Уверен, что много людей были бы очень благодарны за подробный разбор особенностей bot api в Битрикс24 :).
Пока дочитаешь до конца, уже забыл с чего начал. Половина советов норм, другая - будто для людей с тремя руками. Но да, пара идей реально может сэкономить нервы, особенно если раньше сам через всё это проходил.
Не касаемо Битрикс апи, а в целом:
Про структуру запроса - обычно подобные косяки с добавлением информации по API POST/PUT и т.д.
- Если не получилось с копипэйста из документации, как правило имеет смысл GET и уже по полученной структуре разгребать.
- не редко всё настолько непонятно, что приходится заполнить все поля в UI сначала данными типа field_name и цифрами/датами остальное :))
- бывает нужна магия, например в Zoho CRM был глюк один их методов работал только со строчной переменной, хотя и в документации и в том, что приходило по GET был массив. Как я догадался? естественно случайно :)
- с другой стороны это то почему я не верю в скорую победу ИИ над кожанными мешками :)
Понятно что глянуть через Get можно, даже есть такой запрос, но вот вопрос? А как узнать какие в этом загадочном API параметры на вход идут))
Гуглинг, реверс-инженирнг чужик поделок, просмотр доков на другие языки. :)
Кто подбирал нужную версию .dll с компакт дисков пиратских почитав предварительно .inf файлы тот на такой фигне не пасуют. Интернеты есть, llm есть (не редко врёт, но и на мысли может натолкнуть :)
Аминь. Недавно разбирался как ботом отправить файл.
сначала узнать id папки куда файл будет сохранен.
потом получить уникальную ссылку, куда надо отправить файл
потом загрузить по ней файл, получить его ID. или может быть FILE_ID? В ответе есть и то и то
потом только этот файл можно прикрепить к сообщению
Во этих 4 методах одни и те же сущности могут обзываться по разному. Разумеется это требует десятка неочевидных прав. Конечно, рандомные ошибки будут всплывать в любых местах.
Сколько запросов нужно чтобы ботом отправить файл в чат например в телеграме? Правильно, один.

Разработка Битрикс-бота: история о том, как документация врала, а облака смеялись