Основная контентная область конфигурируемого дела

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

BodyDto — основная контентная область записи таймлайна: логотип и набор контентных блоков, из которых складывается содержимое записи. Объект передают в поле body структуры конфигурируемого дела при вызове методов crm.activity.configurable.add и crm.activity.configurable.update.

Типы блоков и их поля описаны на странице контентного блока. Готовые сочетания — запись с набором полей, с разными типами действий и на нескольких языках — собраны в примерах конфигураций дела.

Параметры объекта BodyDto

Обязательные параметры отмечены *

Поле

Описание

logo*
LogoDto

Логотип записи

blocks*
object

Контентные блоки записи: ключ — идентификатор блока, который вы задаете сами, значение — объект ContentBlockDto. В ключе допустимы латинские буквы, цифры, дефис и подчеркивание. Передайте хотя бы один блок, но не более 20

Если структура нарушает эти ограничения, метод вернет ошибку валидации. Коды ошибок перечислены на страницах crm.activity.configurable.add и crm.activity.configurable.update.

Объект LogoDto

Логотип записи таймлайна.

Параметры объекта LogoDto

Обязательные параметры отмечены *

Поле

Описание

code*
string

Код логотипа, например call-incoming или notification. Все доступные коды возвращает метод crm.timeline.logo.list. Свой логотип добавляет метод crm.timeline.logo.add

action
ActionDto

Действие по нажатию на логотип

Пример объекта

Значение поля body: логотип входящего звонка со ссылкой на сделку и один текстовый блок.

{
    "logo": {
        "code": "call-incoming",
        "action": {
            "type": "redirect",
            "uri": "/crm/deal/details/123/"
        }
    },
    "blocks": {
        "text": {
            "type": "text",
            "properties": {
                "value": "Клиент подтвердил встречу"
            }
        }
    }
}

Продолжите изучение