Инструкция для разработчиков чат-ботов

Параметр	Описание	Тип	Обязательный
`email`	Адрес электронной почты пользователя	string	*
`password`	Пароль пользователя	string	*

Параметр	Описание	Тип	Обязательный
`access_token`	Токен доступа ТУЗ	string	*
`user`	Данные ТУЗ		*
	`id`	Данные ТУЗ	uuid	*
	`email`	Адрес электронной почты	string	*
	`initials`	Инициалы	string
	`name`	ФИО	string
	`avatar_http_path`	Путь к изображению (аватару)	string
	`position`	Должность	string
	`roles`	Роли	string[]	*
	`is_profile_filled_in`	Признак заполненности профиля	boolean

Параметр	Описание	Тип
`offset`	Идентификатор первого обновления `update_id`	int64
`limit`	Максимальное количество обновлений: минимальное значение: 1; максимальное значение: 100; значение по умолчанию: 100	int
`timeout`	Таймаут Long Polling в секундах: минимальное значение: 0; максимальное значение: 50; значение по умолчанию: 0	int
`allowed_updates`	Типы обновлений для получения: `message` `edited_message` `my_chat_member` `chat_member` `message_failed`	string[]
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/getUpdates?offset=1770714680415030001&limit=100&timeout=30' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY'

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно; `false` — ошибка.	boolean	*
`result`	Массив объектов с обновлениями. Если обновлений нет, массив пустой.	object[]
	`attachments`	Список вложений	Attachment[]
		`type`	Тип вложения. Возможные значения: `photo` `video` `document` `audio`	string	*
		`photo`	Изображение (если `type=photo`)	Photo
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`video`	Видео (если `type=video`)	Video
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность видео в секундах	int	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_name`	Название файла	string	*
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
		`document`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`thumbnail`	Изображение миниатюры/обложки	Photo
			`file_name`	Название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`audio`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность аудиозаписи в секундах	int64	*
			`performer`	Исполнитель аудиозаписи, указанный в аудиотегах	string
			`title`	Название аудиозаписи, указанное в аудиотегах	string
			`file_name`	Оригинальное название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
	`chat`	Информация о чате	Chat
		`id`	UUID-идентификатор чата	string	*
		`members_count`	Количество участников в чате	int
		`name`	Название чата/собеседника	string
		`parent_conversation_id`	UUID-идентификатор родительского чата (для тредов)	string
		`parent_message_id`	UUID-идентификатор родительского сообщения (для тредов)	string
		`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
	`date`	Дата отправки сообщения (Unix-время)	int64	*
	`edit_date`	Дата редактирования сообщения (Unix-время)	int64
	`from`	Объект автора сообщения	User	*
		`id`	UUID-идентификатор пользователя	string	*
		`is_bot`	Является ли ботом	boolean	*
		`name`	Имя пользователя	string	*
		`can_send_dm`	Может ли бот отправлять личные сообщения (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_groups`	Может ли бот вступать в группы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_channels`	Может ли бот вступать в каналы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`description`	Описание	string
	`message_id`	UUID-идентификатор сообщения	string	*
	`message_type`	Тип сообщения. Возможные значения: `regular` — обычное сообщение; `user_join` — системное сообщение (вступление/добавление пользователя в чат); `user_leave` — системное сообщение (выход/удаление пользователя из чата); `chat_create` — системное сообщение (создание чата); `chat_update` — системное сообщение (обновление чата); `deleted` — удаленное сообщение	string	*
	`text`	Текст сообщения	string
	`reply_to_message`	Объект исходного сообщения, на которое сделан ответ	Message
Пример ответа `{ "ok": true, "result": { "message_id": "87e1a4ad-d07b-40b4-aa2e-307ac4740d5c", "from": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "can_send_dm": false, "can_join_groups": false, "can_join_channels": false }, "date": 1770733369, "chat": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 }, "text": "Hello from Bot API v2!", "message_type": "regular" } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательность
Параметры тела запроса
`chat_id`	UUID-идентификатор чата	string	*
`message_id`	UUID-идентификатор сообщения. Можно передать как `intermediate_id` , полученный из `sendMessage`, так и реальный `message_id` полученный из `getUpdates` .	string	*
`text`	Текст сообщения: минимальная длина — 1 символ; максимальная длина — 4096 символов	string	*
`parse_mode`	Режим форматирования текста. Возможные значения: `Markdown` — базовый Markdown; `MarkdownV2` — расширенный Markdown; `HTML` — HTML-теги Значение по умолчанию: `Markdown`	string
`entities`	Массив объектов форматирования/специального элемента в тексте сообщения	object[]
	`language`	Язык программирования для типа `pre` (блок кода)	string
	`length`	Длина сущности в кодовых единицах UTF-16	int	*
	`offset`	Смещение от начала текста в кодовых единицах UTF-16	int	*
	`type`	Тип сущности. Возможные значения: bold — жирный текст; italic — курсив; underline — подчеркнутый текст; strikethrough — зачеркнутый текст; code — моноширинный текст; pre — блок кода; text_link — текстовая гиперссылка; url — прямая ссылка; mention — упоминание через @username; text_mention — текстовое упоминание пользователя; bot_command — команда бота; blockquote — цитата	string	*
	`url`	URL-адрес для сущностей типа `text_link`	string
	`user`	Данные пользователя для сущностей типа `text_mention`	User
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/editMessageText' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "chat_id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "message_id": "87e1a4ad-d07b-40b4-aa2e-307ac4740d5c", "text": "Edited message text from BOT v2" }'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно; `false` — ошибка.	boolean	*
`result`	Массив объектов с обновлениями. Если обновлений нет, массив пустой.	object[]
	`attachments`	Список вложений	Attachment[]
		`type`	Тип вложения. Возможные значения: `photo` `video` `document` `audio`	string	*
		`photo`	Изображение (если `type=photo`)	Photo
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`video`	Видео (если `type=video`)	Video
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность видео в секундах	int	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_name`	Название файла	string	*
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
		`document`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`thumbnail`	Изображение миниатюры/обложки	Photo
			`file_name`	Название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`audio`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность аудиозаписи в секундах	int64	*
			`performer`	Исполнитель аудиозаписи, указанный в аудиотегах	string
			`title`	Название аудиозаписи, указанное в аудиотегах	string
			`file_name`	Оригинальное название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
	`chat`	Информация о чате	Chat
		`id`	UUID-идентификатор чата	string	*
		`members_count`	Количество участников в чате	int
		`name`	Название чата/собеседника	string
		`parent_conversation_id`	UUID-идентификатор родительского чата (для тредов)	string
		`parent_message_id`	UUID-идентификатор родительского сообщения (для тредов)	string
		`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
	`date`	Дата отправки сообщения (Unix-время)	int	*
	`edit_date`	Дата редактирования сообщения (Unix-время)	int
	`from`	Объект автора сообщения	User	*
		`id`	UUID-идентификатор пользователя	string	*
		`is_bot`	Является ли ботом	boolean	*
		`name`	Имя пользователя	string	*
		`can_send_dm`	Может ли бот отправлять личные сообщения (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_groups`	Может ли бот вступать в группы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_channels`	Может ли бот вступать в каналы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`description`	Описание	string
	`message_id`	UUID-идентификатор сообщения	string	*
	`message_type`	Тип сообщения. Возможные значения: `regular` — обычное сообщение; `user_join` — системное сообщение (вступление/добавление пользователя в чат); `user_leave` — системное сообщение (выход/удаление пользователя из чата); `chat_create` — системное сообщение (создание чата); `chat_update` — системное сообщение (обновление чата); `deleted` — удаленное сообщение	string	*
	`text`	Текст сообщения	string
	`reply_to_message`	Объект исходного сообщения, на которое сделан ответ	Message
Пример ответа `{ "ok": true, "result": { "message_id": "87e1a4ad-d07b-40b4-aa2e-307ac4740d5c", "from": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "can_send_dm": false, "can_join_groups": false, "can_join_channels": false }, "date": 1770733369, "chat": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 }, "edit_date": 1770733489, "text": "Edited message text from BOT v2", "message_type": "regular" } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
Параметры тела запроса
`chat_id`	UUID-идентификатор чата	string	*
`message_id`	UUID-идентификатор сообщения. Можно передать как `intermediate_id`, полученный из `sendMessage`, так и реальный `message_id`, полученный из `getUpdates`	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/deleteMessage' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "chat_id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "message_id": "87e1a4ad-d07b-40b4-aa2e-307ac4740d5c" }'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Объект с результатом операции	object
	`message_id`	UUID-идентификатор удаляемого сообщения	string
Пример ответа `{ "ok": true, "result": { "message_id": "87e1a4ad-d07b-40b4-aa2e-307ac4740d5c" } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
Параметры тела запроса
`file_id`	UUID-идентификатор файла из сообщения (`document.file_id`, `photo[].file_id` и т.д.).	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/file/f1b0b380-adfa-422b-9adc-8b07131d9b4f' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY'

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
Параметры тела запроса
`file_id`	UUID-идентификатор файла из сообщения (`document.file_id`, `photo[].file_id` и т.д.)	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/getFile?file_id=f1b0b380-adfa-422b-9adc-8b07131d9b4f' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Объект с результатом операции	object
	`file_id`	UUID-идентификатор файла	string
	`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int
	`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string
Пример ответа `{ "ok": true, "result": { "file_id": "f1b0b380-adfa-422b-9adc-8b07131d9b4f", "file_unique_id": "c867696ca6044fbc", "file_size": 77073 } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
Параметры тела запроса
`chat_id`	UUID-идентификатор чата	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/getChat?chat_id=d095de53-06f3-4588-ab64-a3245ffe0a65' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор чата	string	*
	`members_count`	Количество участников в чате	int
	`name`	Название чата/собеседника	string
	`parent_conversation_id`	UUID-идентификатор родительского чата. Актуально для типа `thread`	string
	`parent_message_id`	UUID-идентификатор родительского сообщения, из которого начался тред. Актуально для типа `thread`	string
	`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
Пример ответа `{ "ok": true, "result": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор	string	*
	`is_bot`	Является ли ботом	boolean	*
	`name`	Имя	string	*
	`can_send_dm`	Может ли бот отправлять личные сообщения (актуально для `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
	`can_join_groups`	Может ли бот вступать в группы (актуально для `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
	`can_join_channels`	Может ли бот вступать в каналы (актуально для `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
	`description`	Описание	string
Пример ответа `{ "ok": true, "result": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "can_send_dm": true, "can_join_groups": true, "can_join_channels": true } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Массив объектов с командами бота	object[]
	`command`	Название команды. Должно начинаться с «/» Ограничения: длина строки: 1-32 символов; символы: только латиница, цифры и нижнее подчеркивание «_»	string
	`description`	Описание команды. Ограничения: длина строки: 1-64 символов	string
Пример ответа `{ "ok": true, "result": [ { "command": "/start", "description": "Start the bot" }, { "command": "/help", "description": "Show help message" }, { "command": "/settings", "description": "Bot settings" } ] }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Массив объектов с командами бота	object[]
	`description`	Описание команды. Ограничения: длина строки: 1-64 символов	string
Пример ответа `{ "ok": true, "result": { "description": "Какой-то бот" } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`result`	Массив объектов с командами бота	object[]
	`name`	Отображаемое имя/название бота. Ограничение по длине строки: 3-255 символов	string	*
Пример ответа `{ "ok": true, "result": { "name": "Тестовый третий бот Антона" } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`commands`	Список команд бота. Максимум 20 команд. Пустой массив удаляет все команды	object[]	*
	`command`	Название команды. Должно начинаться с «/» Ограничение по длине строки: 1-32 символов. Ограничения по символам: английские буквы, цифры и «_»	string	*
	`description`	Описание команды. Ограничение по длине строки: 1-64 символов	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/setMyCommands' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "commands": [ {"command": "/start", "description": "Start the bot"}, {"command": "/help", "description": "Show help message"}, {"command": "/settings", "description": "Bot settings"} ] }'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: - `true` – успешно, запрос отправлен на обработку; - `false` – ошибка	boolean	*
`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор	string	*
	`is_bot`	Является ли ботом	boolean	*
	`name`	Имя	string	*
	`can_send_dm`	Может ли бот отправлять личные сообщения. Актуально для пользователей с `is_bot=true`. - `true` – может; - `false` – не может	boolean	*
	`can_join_groups`	Может ли бот вступать в группы. Актуально для пользователей с `is_bot=true`	boolean	*
	`can_join_channels`	Может ли бот вступать в каналы. Актуально для пользователей с `is_bot=true`	boolean	*
	`description`	Описание	string	`description`
Пример ответа `{ "ok": true, "result": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "description": "Какой-то бот", "can_send_dm": true, "can_join_groups": true, "can_join_channels": true } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
Параметры тела запроса
`description`	Описание бота. Ограничения по длине строки: 3-64 символов	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/setMyDescription' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "description": "Какой-то бот" }'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` – успешно, запрос отправлен на обработку; `false` – ошибка	boolean	*
`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор	string	*
	`is_bot`	Является ли ботом	boolean	*
	`name`	Имя	string	*
	`can_send_dm`	Может ли бот отправлять личные сообщения. Актуально для пользователей с `is_bot=true`. Возможные значения: - `true` – может; - `false` – не может	boolean	*
	`can_join_groups`	Может ли бот вступать в группы. Актуально для пользователей с `is_bot=true`	boolean	*
	`can_join_channels`	Может ли бот вступать в каналы. Актуально для пользователей с `is_bot=true`	boolean	*
	`description`	Описание	string	`description`
Пример ответа `{ "ok": true, "result": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "description": "Какой-то бот", "can_send_dm": true, "can_join_groups": true, "can_join_channels": true } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
`name`	Отображаемое имя/название бота. Ограничения по длине строки: 3-255 символов	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/setMyName' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "name": "Третий тестовый бот Антона" }'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: - `true` – успешно, запрос отправлен на обработку; - `false` – ошибка	boolean	*
`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор	string	*
	`is_bot`	Является ли ботом	boolean	*
	`name`	Имя	string	*
	`can_send_dm`	Может ли бот отправлять личные сообщения. Актуально для пользователей с `is_bot=true`. Возможные значения: - `true` – может; - `false` – не может	boolean	*
	`can_join_groups`	Может ли бот вступать в группы. Актуально для пользователей с `is_bot=true`	boolean	*
	`can_join_channels`	Может ли бот вступать в каналы. Актуально для пользователей с `is_bot=true`	boolean	*
	`description`	Описание	string	`description`
Пример ответа `{ "ok": true, "result": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Третий тестовый бот Антона", "description": "Какой-то бот", "can_send_dm": true, "can_join_groups": true, "can_join_channels": true } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип
`can_send_dm`	Может ли бот отправлять личные сообщения. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean
`can_join_groups`	Может ли бот вступать в группы. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean
`can_join_channels`	Может ли бот вступать в каналы. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/setMySettings' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "can_send_dm": true, "can_join_groups": true, "can_join_channels": false }

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` – успешно, запрос отправлен на обработку; `false` – ошибка	boolean	*
	`result`	Объект с результатом операции	object
	`id`	UUID-идентификатор	string	*
	`is_bot`	Является ли ботом	boolean	*
	`name`	Имя	string	*
	`can_send_dm`	Может ли бот отправлять личные сообщения. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean	*
	`can_join_groups`	Может ли бот вступать в группы. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean	*
	`can_join_channels`	Может ли бот вступать в каналы. Актуально для пользователей с `is_bot=true`. Возможные значения: `true` – может; `false` – не может	boolean	*
	`description`	Описание	string	`description`
Пример ответа `{ "ok": true, "result": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Третий тестовый бот Антона", "description": "Какой-то бот", "can_send_dm": true, "can_join_groups": true, "can_join_channels": false } }`

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
form-data
`chat_id`	UUID-идентификатор чата.	string	*
`document`	Файл документа	File	*
`text`	Текст к сообщению с документом. минимальная длина: 1 символ; максимальная длина: 4096 символов	string
`parse_mode`	Режим форматирования текста. Возможные значения: `Markdown` – базовый Markdown (жирный, курсив, код); `MarkdownV2` – расширенный Markdown с экранированием; `HTML` – HTML-теги (b, i, code, a)	string
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/sendDocument' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --form 'chat_id="d095de53-06f3-4588-ab64-a3245ffe0a65"' \ --form 'document=@"/{file_path}"' \ --form 'text="Document description"'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно; `false` — ошибка.	boolean	*
`result`	Массив объектов с обновлениями. Если обновлений нет, массив пустой.	object[]
	`attachments`	Список вложений	Attachment[]
		`type`	Тип вложения. Возможные значения: `photo` `video` `document` `audio`	string	*
		`photo`	Изображение (если `type=photo`)	Photo
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`video`	Видео (если `type=video`)	Video
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность видео в секундах	int	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_name`	Название файла	string	*
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
		`document`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`thumbnail`	Изображение миниатюры/обложки	Photo
			`file_name`	Название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`audio`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность аудиозаписи в секундах	int64	*
			`performer`	Исполнитель аудиозаписи, указанный в аудиотегах	string
			`title`	Название аудиозаписи, указанное в аудиотегах	string
			`file_name`	Оригинальное название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
	`chat`	Информация о чате	Chat
		`id`	UUID-идентификатор чата	string	*
		`members_count`	Количество участников в чате	int
		`name`	Название чата/собеседника	string
		`parent_conversation_id`	UUID-идентификатор родительского чата (для тредов)	string
		`parent_message_id`	UUID-идентификатор родительского сообщения (для тредов)	string
		`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
	`date`	Дата отправки сообщения (Unix-время)	int	*
	`edit_date`	Дата редактирования сообщения (Unix-время)	int
	`from`	Объект автора сообщения	User	*
		`id`	UUID-идентификатор пользователя	string	*
		`is_bot`	Является ли ботом	boolean	*
		`name`	Имя пользователя	string	*
		`can_send_dm`	Может ли бот отправлять личные сообщения (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_groups`	Может ли бот вступать в группы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_channels`	Может ли бот вступать в каналы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`description`	Описание	string
	`message_id`	UUID-идентификатор сообщения	string	*
	`message_type`	Тип сообщения. Возможные значения: `regular` — обычное сообщение; `user_join` — системное сообщение (вступление/добавление пользователя в чат); `user_leave` — системное сообщение (выход/удаление пользователя из чата); `chat_create` — системное сообщение (создание чата); `chat_update` — системное сообщение (обновление чата); `deleted` — удаленное сообщение	string	*
	`text`	Текст сообщения	string
	`reply_to_message`	Объект исходного сообщения, на которое сделан ответ	Message
Пример ответа { "ok": true, "result": { "message_id": "204b6e8e-59bd-424d-a54f-ad04cfd4be31", "from": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Третий тестовый бот Антона", "can_send_dm": false, "can_join_groups": false, "can_join_channels": false }, "date": 1770736484, "chat": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 }, "text": "Document description", "attachments": [ { "type": "document", "document": { "file_id": "d097ae5c-6717-4507-83ce-3a3ab7417b26", "file_unique_id": "72f54e28722bc7d6", "file_name": "authc.py", "mime_type": "text/plain; charset=utf-8", "file_size": 1695 } } ] } }

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
form-data
`chat_id`	UUID-идентификатор чата.	string	*
`document`	Файл документа	File	*
`text`	Текст к сообщению с документом. минимальная длина: 1 символ; максимальная длина: 4096 символов	string
`parse_mode`	Режим форматирования текста. Возможные значения: `Markdown` – базовый Markdown (жирный, курсив, код); `MarkdownV2` – расширенный Markdown с экранированием; `HTML` – HTML-теги (b, i, code, a)	string
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/sendPhoto' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --form 'chat_id="d095de53-06f3-4588-ab64-a3245ffe0a65"' \ --form 'photo=@"{file_path}"' \ --form 'text="Photo description"'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно; `false` — ошибка.	boolean	*
`result`	Массив объектов с обновлениями. Если обновлений нет, массив пустой.	object[]
	`attachments`	Список вложений	Attachment[]
		`type`	Тип вложения. Возможные значения: `photo` `video` `document` `audio`	string	*
		`photo`	Изображение (если `type=photo`)	Photo
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`video`	Видео (если `type=video`)	Video
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность видео в секундах	int	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_name`	Название файла	string	*
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
		`document`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`thumbnail`	Изображение миниатюры/обложки	Photo
			`file_name`	Название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`audio`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность аудиозаписи в секундах	int64	*
			`performer`	Исполнитель аудиозаписи, указанный в аудиотегах	string
			`title`	Название аудиозаписи, указанное в аудиотегах	string
			`file_name`	Оригинальное название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
	`chat`	Информация о чате	Chat
		`id`	UUID-идентификатор чата	string	*
		`members_count`	Количество участников в чате	int
		`name`	Название чата/собеседника	string
		`parent_conversation_id`	UUID-идентификатор родительского чата (для тредов)	string
		`parent_message_id`	UUID-идентификатор родительского сообщения (для тредов)	string
		`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
	`date`	Дата отправки сообщения (Unix-время)	int	*
	`edit_date`	Дата редактирования сообщения (Unix-время)	int
	`from`	Объект автора сообщения	User	*
		`id`	UUID-идентификатор пользователя	string	*
		`is_bot`	Является ли ботом	boolean	*
		`name`	Имя пользователя	string	*
		`can_send_dm`	Может ли бот отправлять личные сообщения (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_groups`	Может ли бот вступать в группы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_channels`	Может ли бот вступать в каналы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`description`	Описание	string
	`message_id`	UUID-идентификатор сообщения	string	*
	`message_type`	Тип сообщения. Возможные значения: `regular` — обычное сообщение; `user_join` — системное сообщение (вступление/добавление пользователя в чат); `user_leave` — системное сообщение (выход/удаление пользователя из чата); `chat_create` — системное сообщение (создание чата); `chat_update` — системное сообщение (обновление чата); `deleted` — удаленное сообщение	string	*
	`text`	Текст сообщения	string
	`reply_to_message`	Объект исходного сообщения, на которое сделан ответ	Message
Пример ответа { "ok": true, "result": { "message_id": "9f2518ac-63f4-4c7f-951b-ac34d80b7bae", "from": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Тестовый третий бот Антона", "can_send_dm": false, "can_join_groups": false, "can_join_channels": false }, "date": 1770733805, "chat": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 }, "text": "Photo description", "attachments": [ { "type": "photo", "photo": { "file_id": "f1b0b380-adfa-422b-9adc-8b07131d9b4f", "file_unique_id": "c867696ca6044fbc", "width": 0, "height": 0, "file_size": 77045 } } ] } }

Параметр	Описание	Тип	Обязательность
`ok`	Статус операции. Возможные значения: `true` — успешно, запрос отправлен на обработку; `false` — ошибка	boolean	*
`error_code`	Код ошибки	int
`description`	Описание ошибки	string

Параметр	Описание	Тип	Обязательный
form-data
`chat_id`	UUID-идентификатор чата.	string	*
`document`	Файл документа	File	*
`text`	Текст к сообщению с документом. минимальная длина: 1 символ; максимальная длина: 4096 символов	string
`parse_mode`	Режим форматирования текста. Возможные значения: `Markdown` – базовый Markdown (жирный, курсив, код); `MarkdownV2` – расширенный Markdown с экранированием; `HTML` – HTML-теги (b, i, code, a)	string
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/sendVideo' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --form 'chat_id="d095de53-06f3-4588-ab64-a3245ffe0a65"' \ --form 'video=@"{file_path}"' \ --form 'text="Video description"'

Параметр	Описание	Тип	Обязательный
`ok`	Статус операции. Возможные значения: `true` — успешно; `false` — ошибка.	boolean	*
`result`	Массив объектов с обновлениями. Если обновлений нет, массив пустой.	object[]
	`attachments`	Список вложений	Attachment[]
		`type`	Тип вложения. Возможные значения: `photo` `video` `document` `audio`	string	*
		`photo`	Изображение (если `type=photo`)	Photo
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`video`	Видео (если `type=video`)	Video
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность видео в секундах	int	*
			`width`	Ширина	int	*
			`height`	Высота	int	*
			`file_name`	Название файла	string	*
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
		`document`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`thumbnail`	Изображение миниатюры/обложки	Photo
			`file_name`	Название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
		`audio`	Документ (приходит, если `type=document`)	Document
			`file_id`	UUID-идентификатор файла	string	*
			`file_unique_id`	Уникальный идентификатор файла (первые 16 символов fingerprint)	string	*
			`duration`	Длительность аудиозаписи в секундах	int64	*
			`performer`	Исполнитель аудиозаписи, указанный в аудиотегах	string
			`title`	Название аудиозаписи, указанное в аудиотегах	string
			`file_name`	Оригинальное название файла	string
			`mime_type`	MIME-тип файла	string
			`file_size`	Размер файла в байтах (оригинальный, до шифрования)	int64
			`thumbnail`	Изображение миниатюры/обложки	Photo
	`chat`	Информация о чате	Chat
		`id`	UUID-идентификатор чата	string	*
		`members_count`	Количество участников в чате	int
		`name`	Название чата/собеседника	string
		`parent_conversation_id`	UUID-идентификатор родительского чата (для тредов)	string
		`parent_message_id`	UUID-идентификатор родительского сообщения (для тредов)	string
		`type`	Тип чата. Возможные значения: `dm` — ДМ-чат (1 на 1); `group` — групповой чат; `event_group` — групповой чат конференции; `channel` — канал; `thread` — тред	string	*
	`date`	Дата отправки сообщения (Unix-время)	int64	*
	`edit_date`	Дата редактирования сообщения (Unix-время)	int64
	`from`	Объект автора сообщения	User	*
		`id`	UUID-идентификатор пользователя	string	*
		`is_bot`	Является ли ботом	boolean	*
		`name`	Имя пользователя	string	*
		`can_send_dm`	Может ли бот отправлять личные сообщения (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_groups`	Может ли бот вступать в группы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`can_join_channels`	Может ли бот вступать в каналы (актуально при `is_bot=true`). Возможные значения: `true` — может; `false` — не может	boolean	*
		`description`	Описание	string
	`message_id`	UUID-идентификатор сообщения	string	*
	`message_type`	Тип сообщения. Возможные значения: `regular` — обычное сообщение; `user_join` — системное сообщение (вступление/добавление пользователя в чат); `user_leave` — системное сообщение (выход/удаление пользователя из чата); `chat_create` — системное сообщение (создание чата); `chat_update` — системное сообщение (обновление чата); `deleted` — удаленное сообщение	string	*
	`text`	Текст сообщения	string
	`reply_to_message`	Объект исходного сообщения, на которое сделан ответ	Message
Пример ответа { "ok": true, "result": { "message_id": "a1603bdf-6129-4f47-a70e-41e609161ed4", "from": { "id": "13420c0e-bb2d-4ac6-9149-ebeb5ce741a4", "is_bot": true, "name": "Третий тестовый бот Антона", "can_send_dm": false, "can_join_groups": false, "can_join_channels": false }, "date": 1770736196, "chat": { "id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "type": "dm", "members_count": 2 }, "text": "Video description", "attachments": [ { "type": "video", "video": { "file_id": "568d7b6f-fabb-4502-a1f8-3ab98484b2dd", "file_unique_id": "be998e5fed5a9065", "width": 0, "height": 0, "duration": 0, "file_name": "sample-10s.mp4", "mime_type": "video/mp4", "file_size": 5485935 } } ] } }

¶ Создание ТУЗ чат-бота в административной панели

¶ Авторизация чат-бота

¶ Настройка бота

¶ Получение токена доступа

¶ POST /platform/v1/token

¶ Доступные методы для работы в Dion.Чаты

¶ GET /chats/v2/getUpdates

¶ POST /chats/v2/sendMessage

¶ POST /chats/v2/editMessageText

¶ POST /chats/v2/deleteMessage

¶ GET /chats/v2/file/{file_id}

¶ GET /chats/v2/getFile

¶ GET /chats/v2/getChat

¶ GET /chats/v2/getMe

¶ GET /chats/v2/getMyCommands

¶ GET /chats/v2/getMyDescription

¶ GET /chats/v2/getMyName

¶ POST /chats/v2/setMyCommands

¶ POST /chats/v2/setMyDescription

¶ POST /chats/v2/setMyName

¶ POST /chats/v2/setMySettings

¶ POST /chats/v2/sendDocument

¶ POST /chats/v2/sendPhoto

¶ POST /chats/v2/sendVideo

¶ POST /chats/v2/sendMediaGroup

¶ SDK для быстрого старта разработки ботов

Параметр		Описание	Тип	Обязательный
Параметры тела запроса
`chat_id`		UUID-идентификатор чата	string	*
`text`		Текст сообщения: минимальная длина — 1 символ; максимальная длина — 4096 символов	string	*
`parse_mode`		Режим форматирования текста. Возможные значения: `Markdown` — базовый Markdown (жирный, курсив, код); `MarkdownV2` — расширенный Markdown с экранированием; `HTML` — HTML-теги (b, i, code, a) Значение по умолчанию: `Markdown`	string
`entities`		Массив объектов форматирования в тексте. Имеет приоритет над `parse_mode`	object[]
	`language`	Язык программирования для типа `pre` (блок кода)	string
	`length`	Длина сущности в кодовых единицах UTF-16	int	*
	`offset`	Смещение относительно начала текста в кодовых единицах UTF-16	int	*
	`type`	Тип сущности. Возможные значения: bold — жирный текст; italic — курсив; underline — подчеркнутый текст; strikethrough — зачеркнутый текст; code — внутристрочный код; pre — блок кода; text_link — текстовая гиперссылка; url — прямая ссылка; mention — упоминание через @username; text_mention — текстовое упоминание; bot_command — команда бота; blockquote — цитата	string	*
	`url`	URL-адрес для типа `text_link`	string
	`user`	Упоминание пользователя для типа text_mention	User
`reply_parameters`		Параметры ответа на сообщение	object
	`message_id`	UUID сообщения (`intermediate_id` или `message_id`), на которое отправляется ответ	string	*
Пример запроса (cURL) curl --location 'https://bots-api.dion.vc/chats/v2/sendMessage' \ --header 'Content-Type: application/json' \ --header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsImtpZCI6ImRpb24tYWNjZXNzLWp3dC12MiIsInR5cCI6IkpXVCJ9.eyJhdXRoX3Byb3ZpZGVyIjoiQ0xPVUQtTE9DQUwiLCJleHAiOjE3NzA3NDkxMDUsIm9yZ19pZCI6Ijk4ODdlMzk3LTgwMDktNDAyMi1hNTFkLTFmNzZmMjJkYzliMiIsInJvbGVzIjoiY2hhdF9ib3QiLCJzaWQiOiJlYjQzOTBiMy05ZDI5LTQ3MzgtODQyYi05MjAxMzBmOGY4NzIiLCJ0ZWNoIjp0cnVlLCJ1c2VyX2lkIjoiMTM0MjBjMGUtYmIyZC00YWM2LTkxNDktZWJlYjVjZTc0MWE0In0.29ZhiC0H2qZFOKR5HgfhDkQ2lWJWJMvr8wmicRdQ9hY' \ --data '{ "chat_id": "d095de53-06f3-4588-ab64-a3245ffe0a65", "text": "Hello from Bot API v2!", "parse_mode": "Markdown" }'