Блок со ссылками LINK

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

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

Блок LINK выводит ссылку с заголовком, описанием и необязательным изображением-превью. Блок передается элементом массива BLOCKS вложения — общие правила и лимиты описаны на странице Вложения в сообщениях ATTACH.

Блок со ссылками

Используйте LINK, когда ссылку нужно показать отдельной карточкой: с заголовком, описанием и превью. Например, ссылка на задачу, документ или сделку в уведомлении бота.

Выберите другой блок, если:

  • ссылка — часть текста. Используйте BB-код [URL=https://example.com]текст[/URL] в блоке MESSAGE
  • нужно показать сотрудника с аватаром. Используйте блок USER
  • ссылка — значение в карточке свойств. Используйте поле LINK элемента блока GRID

Параметры блока

Название
тип

Описание

LINK*
string

URL ссылки. Допускаются абсолютные URL (http://, https://) и относительные пути от корня Битрикс24, например /crm/deal/details/142/. Единственное поле, которое делает блок кликабельным. Блок с недопустимым URL пропускается без ошибки

NAME
string

Заголовок ссылки. Если не задан, отображается LINK

DESC
string

Описание под заголовком ссылки

HTML
string

Устаревшая альтернатива DESC. Веб-клиент выводит теги как текст, мобильное приложение поле не показывает, а при заданном HTML игнорируются PREVIEW, WIDTH и HEIGHT. Используйте DESC

PREVIEW
string

URL изображения-превью

WIDTH
integer

Ширина превью в пикселях. Учитывается только вместе с PREVIEW

HEIGHT
integer

Высота превью в пикселях. Учитывается только вместе с PREVIEW

USER_ID
integer

ID пользователя Битрикс24. Сохраняется во вложении, но переход по нему в веб-клиенте не реализован

CHAT_ID
integer

ID чата Битрикс24. Сохраняется во вложении, но переход по нему в веб-клиенте не реализован

NETWORK_ID
string

Идентификатор сетевого пользователя Bitrix24 Network: буква и число. Если переданы несколько ID, сохраняется один по приоритету: NETWORK_ID, USER_ID, CHAT_ID

Примеры

Как использовать примеры в документации

Примеры показывают один элемент массива BLOCKS.

{
    LINK: {
        PREVIEW: 'https://dev.1c-bitrix.ru/bitrix/templates/1c-bitrix-new/images/logo.png',
        WIDTH: 1000,
        HEIGHT: 638,
        NAME: 'Тикет #12345: новое API для модуля "Веб-мессенджер"',
        DESC: 'Необходимо реализовать к релизу!',
        LINK: 'https://api.bitrix24.com/'
    }
}

block = {
    "LINK": {
        "PREVIEW": "https://dev.1c-bitrix.ru/bitrix/templates/1c-bitrix-new/images/logo.png",
        "WIDTH": 1000,
        "HEIGHT": 638,
        "NAME": 'Тикет #12345: новое API для модуля "Веб-мессенджер"',
        "DESC": "Необходимо реализовать к релизу!",
        "LINK": "https://api.bitrix24.com/",
    },
}

[
    'LINK' => [
        'PREVIEW' => 'https://dev.1c-bitrix.ru/bitrix/templates/1c-bitrix-new/images/logo.png',
        'WIDTH' => 1000,
        'HEIGHT' => 638,
        'NAME' => 'Тикет #12345: новое API для модуля "Веб-мессенджер"',
        'DESC' => 'Необходимо реализовать к релизу!',
        'LINK' => 'https://api.bitrix24.com/'
    ]
]

Относительный путь открывает страницу на том же Битрикс24, из которого отправлено сообщение.

{
    LINK: {
        NAME: 'Сделка #142: поставка оборудования',
        DESC: 'Ответственный: Иван Иванов',
        LINK: '/crm/deal/details/142/'
    }
}

block = {
    "LINK": {
        "NAME": "Сделка #142: поставка оборудования",
        "DESC": "Ответственный: Иван Иванов",
        "LINK": "/crm/deal/details/142/",
    },
}

[
    'LINK' => [
        'NAME' => 'Сделка #142: поставка оборудования',
        'DESC' => 'Ответственный: Иван Иванов',
        'LINK' => '/crm/deal/details/142/'
    ]
]

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

Предыдущая
Блок пользователя
Следующая
Блок с текстом