Блок с изображениями IMAGE

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

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

Блок IMAGE выводит одно или несколько изображений внутри вложения: скриншот, фото товара, схему. Значение ключа IMAGE — массив объектов, по одному на изображение. Одиночный объект тоже принимается. Блок передается элементом массива BLOCKS вложения — общие правила и лимиты описаны на странице Вложения в сообщениях ATTACH.

Чтобы приложить файл для скачивания, используйте блок FILE.

Блок с изображениями

Параметры элемента IMAGE

Название `тип`	Описание
LINK* `string`	URL исходного изображения: абсолютный `http://`/`https://` или путь от корня Битрикс24. Элемент без допустимого URL пропускается без ошибки
NAME `string`	Название изображения
PREVIEW `string`	URL уменьшенной версии изображения, в том же формате, что `LINK`. Если не задан, для предпросмотра используется `LINK`. Для стабильного отображения в разных клиентах рекомендуется указывать явно
WIDTH `integer`	Ширина изображения в пикселях
HEIGHT `integer`	Высота изображения в пикселях

Пример

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

Пример показывает один элемент массива BLOCKS с двумя изображениями. Для каждого изображения в сообщении выводится уменьшенная копия из PREVIEW, по клику открывается оригинал из LINK.

Python

PHP

{
    IMAGE: [
        {
            NAME: 'Это Mantis',
            LINK: 'https://example.com/images/mantis.jpg',
            PREVIEW: 'https://example.com/images/mantis-preview.jpg',
            WIDTH: 1000,
            HEIGHT: 638
        },
        {
            NAME: 'Схема процесса',
            LINK: 'https://example.com/images/scheme.png',
            PREVIEW: 'https://example.com/images/scheme-preview.png',
            WIDTH: 800,
            HEIGHT: 600
        }
    ]
}

block = {
    "IMAGE": [
        {
            "NAME": "Это Mantis",
            "LINK": "https://example.com/images/mantis.jpg",
            "PREVIEW": "https://example.com/images/mantis-preview.jpg",
            "WIDTH": 1000,
            "HEIGHT": 638,
        },
        {
            "NAME": "Схема процесса",
            "LINK": "https://example.com/images/scheme.png",
            "PREVIEW": "https://example.com/images/scheme-preview.png",
            "WIDTH": 800,
            "HEIGHT": 600,
        },
    ],
}

[
    'IMAGE' => [
        [
            'NAME' => 'Это Mantis',
            'LINK' => 'https://example.com/images/mantis.jpg',
            'PREVIEW' => 'https://example.com/images/mantis-preview.jpg',
            'WIDTH' => 1000,
            'HEIGHT' => 638
        ],
        [
            'NAME' => 'Схема процесса',
            'LINK' => 'https://example.com/images/scheme.png',
            'PREVIEW' => 'https://example.com/images/scheme-preview.png',
            'WIDTH' => 800,
            'HEIGHT' => 600
        ]
    ]
]