73  /  166

im.dialog.messages.get

Просмотров: 25861
Дата последнего изменения: 19.11.2021
Александр Суворов
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
1
2
3
4
5

Получение списка последних сообщений в чате

Ревизия Получить информацию о текущей ревизии API (версии платформы) – im.revision.get : 18

Обратите внимание! Метод указан с использованием функции restCommand - это метод отправки данных в Битрикс24, данный метод есть в примере ЭхоБота, и представлен здесь в качестве примера. Вы можете использовать свою функцию или javascript-метод BX24.callMethod или bitrix24-php-sdk.

Параметры

Параметр Пример Обязат. Описание Ревизия
DIALOG_ID chat29
или
256
Да Идентификатор диалога. Формат:
chatXXX – чат получателя, если сообщение для чата
или XXX – идентификатор получателя, если сообщение для приватного диалога
19
LAST_ID 28561624 Нет Идентификатор последнего загруженного сообщения 19
FIRST_ID 454322 Нет Идентификатор первого загруженного сообщения 19
LIMIT 20 Нет Ограничение на выборку сообщений в диалоге 19
  • Если не переданы ключи LAST_ID и FIRST_ID, будут загружены последние 20 сообщений чата.
  • Для загрузки предыдущих 20 сообщений, необходимо передать LAST_ID с идентификатором минимального ID сообщения, полученного из последней выборки.
  • Если вам необходимо загрузить следующие 20 сообщений, необходимо передать FIRST_ID с идентификатором максимального ID сообщения, полученного из последней выборки.
  • Если вам необходимо загрузить первые 20 сообщений, необходимо передать FIRST_ID с идентификатором 0, вам будет возвращен результат с самым первым доступным вам сообщением в этом чате.

Обратите внимание! Из-за потенциально большого обьема данных, этот метод не поддерживает стандартную постраничную навигацию Bitrix24 Rest Api.



Вызов метода и ответ

JavaScript

BX24.callMethod('im.dialog.messages.get', {
	DIALOG_ID: 'chat29'
}, function(result){
	if(result.error())
	{
		console.error(result.error().ex);
	}
	else
	{
		console.log(result.data());
	}
});

PHP

$result = restCommand('im.dialog.messages.get', Array(
	'DIALOG_ID': 'chat29'
), $_REQUEST["auth"]);

Пример ответа

{
    "result": {
        "messages": [
          {
            "id": 28561624,
            "chat_id": 29,
            "author_id": 1,
            "date": "2018-01-29T16:58:47+03:00",
            "text": "http://yandex.ru",
            "params": {
              "URL_ID": [
                5
              ],
              "URL_ONLY": "Y",
              "ATTACH": [
                {
                  "ID": "5",
                  "BLOCKS": [
                    {
                      "RICH_LINK": [
                        {
                          "NAME": "яндекс",
                          "LINK": "http://yandex.ru/",
                          "DESC": "Найдется все",
                          "PREVIEW": "https://yastatic.net/morda-logo/i/share-logo-ru.png"
                        }
                      ]
                    }
                  ],
                  "COLOR": "transparent"
                }
              ]
            }
          },
          {
            "id": 28561623,
            "chat_id": 29,
            "author_id": 28,
            "date": "2018-01-29T16:43:38+03:00",
            "text": "",
            "params": {
              "FILE_ID": [
                540
              ]
            }
          },
          {
            "id": 28561622,
            "chat_id": 29,
            "author_id": 1,
            "date": "2018-01-29T16:43:12+03:00",
            "text": "Работает да :) :)",
            "params": {
              "IS_EDITED": "Y"
            }
          },
          {
            "id": 28561618,
            "chat_id": 29,
            "author_id": 0,
            "date": "2018-01-25T15:15:22+03:00",
            "text": "Евгений Шеленков изменил тему чата на \"Большой чат\"",
            "params": null
          },
        ],
        "users": [
          {
            "id": 1,
            "name": "Евгений Шеленков",
            "first_name": "Евгений",
            "last_name": "Шеленков",
            "work_position": "",
            "color": "#df532d",
            "avatar": "http://192.168.2.232/upload/resize_cache/main/1d3/100_100_2/shelenkov.png",
            "gender": "M",
            "birthday": "",
            "extranet": false,
            "network": false,
            "bot": false,
            "connector": false,
            "external_auth_id": "default",
            "status": "online",
            "idle": false,
            "last_activity_date": "2018-01-29T17:35:31+03:00",
            "mobile_last_date": false,
            "departments": [
              50
            ],
            "absent": false,
            "phones": {
              "work_phone": "",
              "personal_mobile": "",
              "personal_phone": ""
            }
          },
          {
            "id": 28,
            "name": "Иван Елпидин",
            "first_name": "Иван",
            "last_name": "Елпидин",
            "work_position": "менеджер",
            "color": "#728f7a",
            "avatar": "http://192.168.2.232/upload/resize_cache/main/8b8/100_100_2/26.jpg",
            "gender": "M",
            "birthday": "26-01",
            "extranet": false,
            "network": false,
            "bot": false,
            "connector": false,
            "external_auth_id": "default",
            "status": "online",
            "idle": false,
            "last_activity_date": false,
            "mobile_last_date": false,
            "departments": [
              58
            ],
            "absent": false,
            "phones": {
              "work_phone": "8 (495) 222-33-55",
              "personal_mobile": "8 (495) 123-55-65",
              "personal_phone": ""
            }
          },
        ],
        "files": [
            {
                "id": 540,
                "chatId": 29,
                "date": "2018-01-29T16:43:39+03:00",
                "type": "image",
                "preview": "",
                "name": "1176297_698081120237288_696773366_n.jpeg",
                "size": 55013,
                "image": {
                    "width": 960,
                    "height": 640
                },
                "status": "done",
                "progress": 100,
                "authorId": 1,
                "authorName": "Евгений Шеленков",
                "urlPreview": "http://192.168.2.232/bitrix/components/bitrix/im.messenger/show.file.php?fileId=540&preview=Y&fileName=1176297_698081120237288_696773366_n.jpeg",
                "urlShow": "http://192.168.2.232/bitrix/components/bitrix/im.messenger/show.file.php?fileId=540&fileName=1176297_698081120237288_696773366_n.jpeg",
                "urlDownload": "http://192.168.2.232/bitrix/components/bitrix/im.messenger/download.file.php?fileId=540"
            }
        ],
        "chat_id": 29
    }
}

Описание ключей:

  • messages – массив сообщений:

    • id – идентификатор сообщения
    • chat_id – идентификатор чата
    • author_id – автор сообщения (0 - если сообщение системное)
    • date – дата сообщения в формате ATOM
    • text – текст сообщения
    • params – параметры сообщения, обьект параметров, если параметры не переданы null (ниже будут описаны основные типы)
  • users – обьекты описания данных пользователя:

    • id – идентификатор пользователя
    • name – имя и фамилия пользователя
    • first_name – имя пользователя
    • last_name – фамилия пользователя
    • work_position – должность
    • color – цвет пользователя в формате hex
    • avatar – ссылка на аватар (если пусто, значит аватар не задан)
    • gender – пол пользователя
    • birthday – день рождения пользователя в формате DD-MM, если пусто – не задан
    • extranet – признак внешнего экстранет-пользователя (true/false)
    • network – признак пользователя Битрикс24.Network (true/false)
    • bot – признак бота (true/false)
    • connector – признак пользователя открытых линий (true/false)
    • external_auth_id – код внешней авторизации
    • status – выбранный статус пользователя
    • idle – дата, когда пользователь отошел от компьютера, в формате АТОМ (если не задано, false)
    • last_activity_date – дата последнего действия пользователя в формате АТОМ
    • mobile_last_date – дата последнего действия в мобильном приложении в формате АТОМ (если не задано, false)
    • absent – дата, по какое число у пользователя отпуск, в формате АТОМ (если не задано, false)
  • files – обьект, описывающий файлы в выбранных сообщениях:

    • id – идентификатор файла
    • chatId – идентификатор чата
    • date – дата модификации файла
    • type – тип файла: image – изображение, file – файл
    • name – имя загруженного файла
    • size – фактический размер изображения в байтах
    • image – фактический размер изображения в px
    • width – ширина в px
    • height – высота в px
    • status – текущий статус: done – загружен, upload – идет загрузка
    • progress – статус загрузки в процентах: 100 – загружен, -1 – текущий статус не доступен
    • authorId – идентификатор пользователя, загрузившего обьект
    • authorName – имя и фамилия пользователя, загрузившего объект
    • urlPreview – ссылка на предпросмотр изображения (доступна для картинок)
    • urlShow – ссылка для перехода к объекту в режиме "просмотра"
    • urlDownload – ссылка для начала загрузки
  • chat_id – идентификатор чата

Описание дополнительных параметров:

  • ATTACH – объект, содержащий богатое оформление
  • KEYBOARD – объект, содержащий описание клавиатуры
  • IS_DELETED – флаг, обозначающий, что сообщение удалено
  • IS_EDITED – флаг, обозначающий, что сообщение отредактировано
  • FILE_ID – массив идентификаторов файлов
  • LIKE – массив идентификаторов пользователей, которые проголосовали за сообщение


Пример ответа при возникновении ошибки

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

Описание ключей:

  • error – код возникшей ошибки
  • error_description – краткое описание возникшей ошибки

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

Код Описание
DIALOG_ID_EMPTY Не передан идентификатор диалога
ACCESS_ERROR Текущий пользователь не имеет прав доступа к диалогу


3
Курсы разработаны в компании «1С-Битрикс»
Доступна новая документация по REST: понятнее описания, больше примеров, удобнее поиск
Перейти