Получить сообщения чата im.dialog.messages.get

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

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

Scope: im

Кто может выполнять метод: участник чата или пользователь с доступом к открытому чату

Метод im.dialog.messages.get возвращает сообщения чата, в том числе системные.

Без участия в чате метод отдает сообщения открытых чатов, например Общего чата. Историю чата открытой линии получают методом imopenlines.session.history.get. Чат открытой линии — это переписка с клиентом из внешнего канала, например из Telegram.

Параметры метода

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

Название `тип`	Описание
DIALOG_ID `string`	Идентификатор диалога в формате: `chatXXX` — групповой чат, где `XXX` — идентификатор чата `sgXXX` — чат группы или проекта, где `XXX` — идентификатор группы `XXX` — личный диалог, где `XXX` — идентификатор пользователя Идентификатор чата вернет метод im.chat.get, идентификатор пользователя — методы user.get и user.search
CHAT_ID `integer`	Идентификатор чата без префикса `chat`, например `2935`
LAST_ID `integer`	Идентификатор сообщения. Метод вернет сообщения старше него — с идентификатором меньше указанного. Для первого запроса не передавайте. Как листать историю — в разделе Как получить всю историю
FIRST_ID `integer`	Идентификатор сообщения. Метод вернет сообщения новее него — с идентификатором больше указанного. Например, при `FIRST_ID=123` и `LIMIT=10` — до 10 сообщений с `id` больше `123`. Если переданы и `FIRST_ID`, и `LAST_ID`, метод учитывает только `FIRST_ID`
LIMIT `integer`	Сколько сообщений вернуть. Если в чате есть непрочитанные сообщения, метод может вернуть больше, чем указано в `LIMIT`. По умолчанию — `20`. Максимальное значение — `50`
CONVERT_TEXT `string`	`Y` — добавить в каждое сообщение поле `text_converted` с текстом, в котором BB-коды преобразованы в HTML

Передайте один из параметров: DIALOG_ID или CHAT_ID. Если переданы оба, метод использует CHAT_ID.

Как получить всю историю

Стандартной постраничной навигации у метода нет: историю загружают частями через LAST_ID и FIRST_ID.

Запросите сообщения чата без LAST_ID и FIRST_ID. Если непрочитанных больше, чем LIMIT, метод вернет сообщения начиная с первого непрочитанного, иначе — последние сообщения
Чтобы загрузить более старые, передайте в LAST_ID наименьший id из массива messages. Повторяйте, пока метод не вернет пустой массив messages
Чтобы загрузить более новые, передайте в FIRST_ID наибольший id из массива messages. Повторяйте, пока метод не вернет пустой массив messages

Примеры кода

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

cURL (Webhook)

cURL (OAuth)

JS (TS)

JS (UMD)

Python

PHP

BX24.js

PHP CRest

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"DIALOG_ID":"chat1489","FIRST_ID":84868,"LIMIT":10}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.dialog.messages.get

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"DIALOG_ID":"chat1489","FIRST_ID":84868,"LIMIT":10,"auth":"**put_access_token_here**"}' \
  https://**put_your_bitrix24_address**/rest/im.dialog.messages.get

// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'

declare const $b24: B24Frame

// Shape of the payload returned in result (match the "response handling" section of the page)
type DialogMessagesGetResult = {
  chat_id: number
  messages: {
    id: number
    chat_id: number
    author_id: number
    date: ISODate
    text: string
    unread: boolean
    uuid: string | null
    replaces: unknown[]
    params: Record<string, unknown> | unknown[]
    disappearing_date: ISODate | null
  }[]
  users: {
    id: number
    active: boolean
    name: string
    first_name: string
    last_name: string
    status: string
    last_activity_date: ISODate | false
    type: string
  }[]
  files: {
    id: number
    chatId: number
    date: ISODate
    type: string
    name: string
    size: number
    status: string
    authorId: number
    authorName: string
    urlDownload: string
    isTranscribable: boolean
    isVideoNote: boolean
    isVoiceNote: boolean
  }[]
}

try {
  const response = await $b24.actions.v2.call.make<DialogMessagesGetResult>({
    method: 'im.dialog.messages.get',
    params: {
      DIALOG_ID: 'chat1489',
      FIRST_ID: 84868,
      LIMIT: 10,
    },
    requestId: Text.getUuidRfc4122()
  })

  // The payload is available only on a successful response
  if (!response.isSuccess) {
    console.error(response.getErrorMessages().join('; '))
  } else {
    const result = response.getData()!.result
    console.info(result.chat_id, result.messages.length, result.messages)
  }
} catch (error) {
  // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
  console.error(error)
}

<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
  async function getDialogMessages() {
    try {
      // Initialize the SDK inside a Bitrix24 frame
      const $b24 = await B24Js.initializeB24Frame()

      const response = await $b24.actions.v2.call.make({
        method: 'im.dialog.messages.get',
        params: {
          DIALOG_ID: 'chat1489',
          FIRST_ID: 84868,
          LIMIT: 10,
        },
        requestId: B24Js.Text.getUuidRfc4122()
      })

      // The payload is available only on a successful response
      if (!response.isSuccess) {
        console.error(response.getErrorMessages().join('; '))
        return
      }

      const result = response.getData().result
      console.info(result.chat_id, result.messages.length, result.messages)
    } catch (error) {
      // Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
      console.error(error)
    }
  }

  document.addEventListener('DOMContentLoaded', getDialogMessages)
</script>

from b24pysdk.errors import BitrixAPIError, BitrixSDKException

try:
    bitrix_response = client.im.dialog.messages.get(
        dialog_id="chat1489",
        first_id=84868,
        limit=10,
    ).response
    result = bitrix_response.result
    print(result)
except BitrixAPIError as error:
    print(
        "Ошибка Bitrix API",
        f"error: {error.error}",
        f"error_description: {error.error_description}",
        sep="\n",
    )
except BitrixSDKException as error:
    print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
    print(f"Непредвиденная ошибка: {error}")

try {
    $response = $b24Service->core->call(
        'im.dialog.messages.get',
        [
            'DIALOG_ID' => 'chat1489',
            'FIRST_ID' => 84868,
            'LIMIT' => 10,
        ]
    );

    $result = $response->getResponseData()->getResult();
    print_r($result);
} catch (Throwable $e) {
    error_log($e->getMessage());
}

BX24.callMethod(
    'im.dialog.messages.get',
    {
        DIALOG_ID: 'chat1489',
        FIRST_ID: 84868,
        LIMIT: 10
    },
    function(result)
    {
        if (result.error())
        {
            console.error(result.error());
        }
        else
        {
            console.log(result.data());
        }
    }
);

require_once('crest.php');

$result = CRest::call(
    'im.dialog.messages.get',
    [
        'DIALOG_ID' => 'chat1489',
        'FIRST_ID' => 84868,
        'LIMIT' => 10,
    ]
);

print_r($result);

// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "im.dialog.messages.get", b24.Params{
	"DIALOG_ID": "chat1489",
	"FIRST_ID":  84868,
	"LIMIT":     10,
}, b24.WithIdempotent())
if err != nil {
	return fmt.Errorf("im.dialog.messages.get: %w", err)
}

// Ответ приходит как json.RawMessage — разберите его
// в структуру под форму ответа, показанную ниже на этой странице.
fmt.Printf("%s\n", res.Result)

Обработка ответа

HTTP-статус: 200

{
    "result": {
        "chat_id": 1489,
        "messages": [
            {
                "id": 84877,
                "chat_id": 1489,
                "author_id": 503,
                "date": "2026-03-04T09:43:26+03:00",
                "text": "Рады тебе очень!",
                "unread": false,
                "uuid": "0c42a08f-4235-49fc-994f-c9bccd499ac1",
                "replaces": [],
                "params": {
                    "LIKE": [547],
                    "FILE_ID": [5255]
                },
                "disappearing_date": null
            },
            {
                "id": 84875,
                "chat_id": 1489,
                "author_id": 503,
                "date": "2026-03-04T09:43:21+03:00",
                "text": "Привет, Анна! Здесь будем обсуждать проект.",
                "unread": false,
                "uuid": "db2e826a-dd18-4ab5-b76c-4084e106ee28",
                "replaces": [],
                "params": [],
                "disappearing_date": null
            },
            {
                "id": 84869,
                "chat_id": 1489,
                "author_id": 0,
                "date": "2026-03-04T09:42:31+03:00",
                "text": "[USER=503 REPLACE]Иван Иванов[/USER] пригласил в чат [USER=547 REPLACE]Анна Петрова[/USER]",
                "unread": false,
                "uuid": null,
                "replaces": [],
                "params": {
                    "CODE": ["CHAT_JOIN"],
                    "NOTIFY": "N"
                },
                "disappearing_date": null
            }
        ],
        "users": [
            {
                "id": 503,
                "active": true,
                "name": "Иван Иванов",
                "first_name": "Иван",
                "last_name": "Иванов",
                "work_position": "админ",
                "color": "#4ba984",
                "avatar": "https://mysite.ru/upload/resize_cache/main/avatar.jpg",
                "avatar_hr": "https://mysite.ru/upload/resize_cache/main/avatar.jpg",
                "gender": "M",
                "birthday": "",
                "extranet": false,
                "network": false,
                "bot": false,
                "connector": false,
                "external_auth_id": "socservices",
                "status": "online",
                "idle": false,
                "last_activity_date": "2026-03-04T10:13:14+03:00",
                "mobile_last_date": false,
                "desktop_last_date": false,
                "absent": false,
                "departments": [667],
                "phones": false,
                "bot_data": null,
                "type": "user",
                "website": "",
                "email": "ivanov@mysite.ru"
            },
            {
                "id": 547,
                "active": true,
                "name": "Анна Петрова",
                "first_name": "Анна",
                "last_name": "Петрова",
                "work_position": "Менеджер",
                "color": "#df532d",
                "avatar": "",
                "avatar_hr": "",
                "gender": "F",
                "birthday": "",
                "extranet": false,
                "network": false,
                "bot": false,
                "connector": false,
                "external_auth_id": "default",
                "status": "online",
                "idle": false,
                "last_activity_date": "2026-03-04T10:11:02+03:00",
                "mobile_last_date": false,
                "desktop_last_date": false,
                "absent": false,
                "departments": [667],
                "phones": false,
                "bot_data": null,
                "type": "user",
                "website": "",
                "email": "petrova@mysite.ru"
            }
        ],
        "files": [
            {
                "id": 5255,
                "chatId": 1489,
                "date": "2026-03-04T09:43:27+03:00",
                "type": "image",
                "name": "image.png",
                "extension": "png",
                "size": 2144,
                "image": {
                    "height": 61,
                    "width": 72
                },
                "status": "done",
                "progress": 100,
                "authorId": 503,
                "authorName": "Иван Иванов",
                "urlPreview": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png",
                "urlShow": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.showImage&SITE_ID=s1&humanRE=1&fileId=5255&width=1280&height=1280&signature=4b6b2bbba680d3bccd8b70e398d94c1c3cfcb018f813089c32db3bb25df594f5&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png",
                "urlDownload": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png",
                "viewerAttrs": {
                    "viewer": "",
                    "viewerType": "image",
                    "src": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png",
                    "viewerResized": "",
                    "objectId": "5255",
                    "viewerGroupBy": "1489",
                    "imChatId": 1489,
                    "title": "image.png",
                    "actions": "[{\"type\":\"download\"},{\"type\":\"copyToMe\",\"text\":\"Сохранить на Диск\",\"action\":\"BXIM.disk.saveToDiskAction\",\"params\":{\"fileId\":\"5255\"},\"extension\":\"disk.viewer.actions\",\"buttonIconClass\":\"ui-btn-icon-cloud\"}]"
                },
                "mediaUrl": {
                    "preview": {
                        "250": "https://mysite.ru/bitrix/services/main/ajax.php?action=disk.api.file.download&SITE_ID=s1&humanRE=1&fileId=5255&exact=N&_esd=s6P3x5qDBEKU0NiS7sczr69Y%2FHHR8Za8EXa7STOAXIVOylYhMsnMj5nGU0VXeQ1PIsqm%2F0GNxOju5wR1jNj76d%2FZnVgpyqeIcJ4UiWXm8CJsrmARXWpxWe%2BgJ%2BpGqx0M5CxgjNzIopQp2cwM&fileName=image.png"
                    }
                },
                "isTranscribable": false,
                "isVideoNote": false,
                "isVoiceNote": false
            }
        ]
    },
    "time": {
        "start": 1772608704,
        "finish": 1772608704.545697,
        "duration": 0.5456969738006592,
        "processing": 0,
        "date_start": "2026-03-04T10:18:24+03:00",
        "date_finish": "2026-03-04T10:18:24+03:00",
        "operating_reset_at": 1772609304,
        "operating": 0
    }
}

Возвращаемые данные

Название `тип`	Описание
result `object`	Корневой элемент ответа (подробное описание)
time `time`	Информация о времени выполнения запроса

Объект result

Название `тип`	Описание
chat_id `integer`	Идентификатор чата
messages `array`	Массив сообщений (подробное описание). Метод вернет пустой массив, если в чате нет сообщений до `LAST_ID` или после `FIRST_ID`
users `array`	Пользователи из выборки (подробное описание). Пустой массив в тех же случаях, что и `messages`
files `array`	Файлы из выборки (подробное описание). Пустой массив в тех же случаях, что и `messages`

Объект message

Название `тип`	Описание
id `integer`	Идентификатор сообщения
chat_id `integer`	Идентификатор чата
author_id `integer`	Идентификатор автора, `0` для системного сообщения
date `datetime`	Дата сообщения в формате ISO 8601
text `string`	Текст сообщения
text_converted `string`	Текст сообщения в HTML. Приходит, если передан `CONVERT_TEXT=Y`
unread `boolean`	Признак непрочитанного сообщения
uuid `string`	Уникальный идентификатор сообщения, `null` для системных сообщений
replaces `array`	Даты, которые Битрикс24 распознал в тексте сообщения (подробное описание). Если дат нет — пустой массив
params `object`	Дополнительные параметры сообщения (подробное описание). Набор полей объекта зависит от типа сообщения: обычное или системное. Если параметров нет, приходит пустой массив `[]`
disappearing_date `datetime`	Дата исчезновения сообщения, `null`, если не задана

Объект params

Название `тип`	Описание
LIKE `array`	Идентификаторы пользователей, которые поставили реакцию сообщению
CODE `array`	Коды системных событий, например: `CHAT_JOIN` — пользователь добавлен в чат `CHAT_LEAVE` — пользователь покинул чат
NOTIFY `string`	Признак отправки уведомления. Значение `N` — уведомление не отправляется
FILE_ID `array`	Идентификаторы файлов, которые прикреплены к сообщению
ATTACH `array`	Вложения сообщения. Формат описан в статье Вложения
KEYBOARD `array`	Кнопки под сообщением. Формат описан в статье Работа с клавиатурами
MENU `array`	Пункты контекстного меню сообщения. Формат описан в статье Контекстное меню
IS_EDITED `string`	`Y`, если сообщение изменено
IS_DELETED `string`	`Y`, если сообщение удалено
DATE_TEXT `array`	Даты из текста сообщения в том виде, как они написаны
DATE_TS `array`	Те же даты в формате Unix timestamp
CHAT_ID `integer`	Идентификатор чата, который создан из этого сообщения методом im.message.share. Приходит в системном сообщении о создании чата

Ключи с пустыми значениями и значениями по умолчанию в params не приходят.

Объект replaces

Название `тип`	Описание
type `string`	Тип замены. Сейчас всегда `DATE`
text `string`	Фрагмент текста с датой, например `12.11.2026 в 15:00`
value `datetime`	Распознанная дата в формате ISO 8601
start `integer`	Позиция начала фрагмента в тексте сообщения
end `integer`	Позиция конца фрагмента в тексте сообщения

Объект user

Название `тип`	Описание
id `integer`	Идентификатор пользователя
active `boolean`	Признак активного пользователя
name `string`	Имя и фамилия
first_name `string`	Имя
last_name `string`	Фамилия
work_position `string`	Должность
color `string`	Цвет аватара в формате hex
avatar `string`	Ссылка на аватар
avatar_hr `string`	Ссылка на аватар в высоком разрешении
gender `string`	Пол. `M` — мужской `F` — женский
birthday `string`	Дата рождения
extranet `boolean`	Признак экстранет-пользователя
intranet_user `boolean`	`true`, если пользователь — сотрудник: состоит в отделе компании и его учетная запись не внешняя
internal_account `boolean`	`true`, если учетная запись не внешняя, например не принадлежит клиенту открытой линии
network `boolean`	Признак пользователя сети Bitrix24
bot `boolean`	Признак бота
connector `boolean`	Признак пользователя открытых линий
external_auth_id `string`	Тип авторизации
status `string`	Статус пользователя
idle `datetime`	Дата в формате ISO 8601, если пользователь неактивен, иначе `false`
last_activity_date `datetime`	Дата последней активности или `false`
mobile_last_date `datetime`	Дата последней активности в мобильном приложении, `false`, если приложение не использовалось
desktop_last_date `datetime`	Дата последней активности в десктопном приложении, `false`, если приложение не использовалось
absent `datetime`	Дата в формате ISO 8601, если пользователь отсутствует, иначе `false`
departments `array`	Идентификаторы отделов пользователя
phones `object`	Телефоны пользователя или `false`, если телефоны не заданы
bot_data `object`	Данные бота, `null` для обычного пользователя
type `string`	Тип пользователя
website `string`	Сайт пользователя
email `string`	E-mail пользователя

Объект file

Название `тип`	Описание
id `integer`	Идентификатор файла
chatId `integer`	Идентификатор чата
date `datetime`	Дата загрузки файла
type `string`	Тип файла: `image`, `video`, `audio`, `file`
name `string`	Имя файла
extension `string`	Расширение файла
size `integer`	Размер в байтах
image `object`	Размеры изображения для файлов типа `image` (подробное описание)
status `string`	Статус файла: `done` — загружен
progress `integer`	Процент загрузки файла
authorId `integer`	Идентификатор автора файла
authorName `string`	Имя автора файла
urlPreview `string`	Ссылка для предпросмотра файла
urlShow `string`	Ссылка для отображения файла
urlDownload `string`	Ссылка для скачивания файла
viewerAttrs `object`	Атрибуты для просмотрщика файлов (подробное описание)
mediaUrl `object`	URL медиафайла для предпросмотра (подробное описание)
isTranscribable `boolean`	Признак возможности транскрибации
isVideoNote `boolean`	Признак видеозаметки
isVoiceNote `boolean`	Признак голосовой заметки

Объект image

Название `тип`	Описание
height `integer`	Высота изображения в пикселях
width `integer`	Ширина изображения в пикселях

Объект viewerAttrs

Название `тип`	Описание
viewer `string`	Тип просмотрщика
viewerType `string`	Тип отображения файла
src `string`	Ссылка на файл
viewerResized `string`	Ссылка на уменьшенную версию файла
objectId `string`	Идентификатор объекта файла
viewerGroupBy `string`	Идентификатор группы для просмотра файлов в чате
imChatId `integer`	Идентификатор чата
title `string`	Имя файла
actions `string`	Доступные действия с файлом в формате JSON

Объект mediaUrl

Название `тип`	Описание
preview `object`	Ссылки для предпросмотра файла. Ключи объекта — размеры изображения в пикселях

Обработка ошибок

HTTP-статус: 400, 403

{
    "error": "DIALOG_ID_EMPTY",
    "error_description": "Dialog ID can't be empty"
}

Название `тип`	Описание
error `string`	Строковый код ошибки. Состоит из цифр, латинских букв и знака подчеркивания. Может прийти пустым — тогда причину показывает только `error_description`
error_description `string`	Текст ошибки для разработчика. Не показывайте его конечному пользователю без обработки

Возможные коды ошибок

Статус	Код	Описание	Значение
`400`	`DIALOG_ID_EMPTY`	Dialog ID can't be empty	Параметр `DIALOG_ID` не передан, передан пустым или в неверном формате
`400`	`FIRST_ID_STRING`	First ID can't be string	Значение `FIRST_ID` состоит не только из цифр, например `abc`, `-1` или `1.5`
`400`	`LAST_ID_STRING`	Last ID can't be string	Значение `LAST_ID` состоит не только из цифр, например `abc`, `-1` или `1.5`
`403`	`ACCESS_ERROR`	You do not have access to the specified dialog	У пользователя нет доступа к чату

Статусы и коды системных ошибок

HTTP-статус: 4xx, 5xx

Описанные ниже ошибки возвращает сам REST API, а не логика конкретного метода. Они могут прийти в ответ на любой метод.

Статус	Код Текст ошибки	Описание
`500`	`INTERNAL_SERVER_ERROR` Internal server error	Возникла внутренняя ошибка сервера. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`500`	`ERROR_UNEXPECTED_ANSWER` Server returned an unexpected response	Сервер вернул неожиданный ответ. Повторите вызов, а если ошибка сохраняется, обратитесь к администратору сервера или в техническую поддержку Битрикс24
`503`	`QUERY_LIMIT_EXCEEDED` Too many requests	Превышен лимит на интенсивность запросов
`429`	`OPERATION_TIME_LIMIT` Method is blocked due to operation time limit	Метод заблокирован из-за превышения лимита на ресурсоемкость запросов. Блокировка снимается автоматически, когда накопленное время выполнения метода перестает превышать лимит
`401`	`NO_AUTH_FOUND` Wrong authorization data	В запросе нет авторизационных данных: не передан ни access-токен, ни код вебхука
`401`	`INVALID_REQUEST` Https required	Методы вызываются только по протоколу HTTPS
`401`	`OVERLOAD_LIMIT` REST API is blocked due to overload	REST API заблокирован из-за перегрузки. Это ручная индивидуальная блокировка. Чтобы ее снять, обратитесь в техническую поддержку Битрикс24
`401`	`ACCESS_DENIED` REST is available only on commercial plans	REST API доступен только на коммерческих тарифах. У вебхука текст ошибки другой — `REST is available only by subscription`
`401`	`INVALID_CREDENTIALS` Invalid request credentials	Не найден активный вебхук с указанным идентификатором пользователя и секретным кодом
`404`	`ERROR_METHOD_NOT_FOUND` Method not found!	Метод с таким именем не найден. Имя написано с ошибкой, метода нет в REST API или он недоступен без нужного скоупа
`401`	`insufficient_scope` The request requires higher privileges than provided by the webhook token	Запрос требует более широких прав, чем есть у токена: у вебхука это выданные ему права, у приложения — скоуп. У приложения текст ошибки заканчивается на `provided by the access token`
`401`	`expired_token` The access token provided has expired	Срок действия access-токена истек
`401`	`user_access_error` The user does not have access to the application	Приложение установлено, но администратор Битрикс24 открыл доступ к нему только конкретным пользователям
`403`	`PORTAL_DELETED` Portal was deleted	Публичная часть сайта закрыта. Чтобы открыть ее на коробочной установке, отключите опцию «Временное закрытие публичной части сайта». Путь к настройке: Рабочий стол > Настройки > Настройки продукта > Настройки модулей > Главный модуль > Временное закрытие публичной части сайта

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

Была ли статья полезна?

Выполнить команду чат-бота

Найти сообщения в чате

Получить сообщения чата im.dialog.messages.get

Параметры методаПараметры метода

Как получить всю историюКак получить всю историю

Примеры кодаПримеры кода

Обработка ответаОбработка ответа

Возвращаемые данныеВозвращаемые данные

Объект resultОбъект result

Объект messageОбъект message

Объект paramsОбъект params

Объект replacesОбъект replaces

Объект userОбъект user

Объект fileОбъект file

Объект imageОбъект image

Объект viewerAttrsОбъект viewerAttrs

Объект mediaUrlОбъект mediaUrl

Обработка ошибокОбработка ошибок

Возможные коды ошибокВозможные коды ошибок

Статусы и коды системных ошибокСтатусы и коды системных ошибок

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