Class VkRequest

Класс для взаимодействия с API ВКонтакте. Предоставляет методы для отправки сообщений, загрузки файлов и работы с другими функциями API.

See

https://vk.ru/dev/bots_docs

Example

import { VkRequest } from 'umbot/plugins';

// Создание экземпляра (appContext обязателен)
const vk = new VkRequest(appContext);
vk.initToken('your-vk-token');

// Отправка простого сообщения
await vk.messagesSend(12345, 'Привет!');

// Отправка сообщения с клавиатурой
const keyboard = {
  one_time: true,
  buttons: [[{
    action: {
      type: 'text',
      label: 'Кнопка',
      payload: '{"button": 1}'
    },
    color: 'primary'
  }]]
};

await vk.messagesSend(12345, 'Выберите действие:', {
  keyboard: JSON.stringify(keyboard)
});

// Загрузка и отправка фото.
// Поля photo/server/hash у IVkUploadFile опциональны —
// перед вызовом photosSaveMessagesPhoto проверяем их наличие
const server = await vk.photosGetMessagesUploadServer(12345);
if (server) {
  const upload = await vk.upload(server.upload_url, 'path/to/photo.jpg');
  if (upload?.photo && upload?.server && upload?.hash) {
    const photo = await vk.photosSaveMessagesPhoto(
      upload.photo,
      upload.server,
      upload.hash
    );
    if (photo?.[0]) {
      await vk.messagesSend(12345, 'Фото:', {
        attachments: [`photo${photo[0].owner_id}_${photo[0].id}`]
      });
    }
  }
}

Hierarchy (View Summary)

VkRequest
- MarusiaRequest

Index

Constructors

constructor

new VkRequest(appContext: AppContext): VkRequest
Создает экземпляр класса для работы с API ВКонтакте Устанавливает токен из конфигурации приложения, если он доступен
Parameters
- appContext: AppContext
  Контекст приложения (обязателен)
Returns VkRequest
- Defined in plugins/platforms/API/VkRequest.ts:127

Properties

`Protected`_appContext

_appContext: AppContext

Контекст приложения.

`Protected`_error

_error: string | object | null

Последняя ошибка (объект ответа API, Error или текст)

`Protected`_request

_request: Request

Экземпляр класса для выполнения HTTP-запросов

isAttachContent

isAttachContent: boolean

Флаг для прямой передачи содержимого файла По умолчанию: false

token

token: string | null

Токен доступа к VK API

Methods

`Protected`_log

_log(error?: string | Error): void
Пишет информацию об ошибках через AppContext.logError (структурированный логгер)
Parameters
- error: string | Error = ''
  Текст или объект ошибки для логирования
Returns void
- Defined in plugins/platforms/API/VkRequest.ts:605

call

call<T extends IVkApi<unknown>>(method: string): Promise<T | null>
Выполняет вызов метода VK API
Type Parameters
- T extends IVkApi<unknown>
Parameters
- method: string
  Название метода VK API
Returns Promise<T | null>
Результат выполнения метода или null при ошибке
- Defined in plugins/platforms/API/VkRequest.ts:160

docsGetMessagesUploadServer

docsGetMessagesUploadServer(
peerId: TVkPeerId,
type: TVkDocType,
): Promise<IVkUploadServer | null>
Получает URL для загрузки документов в сообщения
Parameters
- peerId: TVkPeerId
  ID получателя сообщения
- type: TVkDocType
  Тип документа:
  
  'doc': обычный документ (PDF, ZIP и т.д.)
  
  'audio_message': голосовое сообщение
  
  'graffiti': граффити
Returns Promise<IVkUploadServer | null>
Данные для загрузки или null при ошибке
Example
```
// Загрузка обычного документа
const server = await vk.docsGetMessagesUploadServer(12345, 'doc');

// Загрузка голосового сообщения
const server = await vk.docsGetMessagesUploadServer(12345, 'audio_message');

// Загрузка граффити
const server = await vk.docsGetMessagesUploadServer(12345, 'graffiti');
```
- Defined in plugins/platforms/API/VkRequest.ts:498

docsSave

docsSave(
    file: string,
    title: string,
    tags?: string | null,
): Promise<IVkDocSave | null>
Сохраняет загруженный документ
Parameters
- file: string
  Идентификатор документа
- title: string
  Название документа
- tags: string | null = null
  Теги документа
Returns Promise<IVkDocSave | null>
Информация о сохраненном документе или null при ошибке
- Defined in plugins/platforms/API/VkRequest.ts:516

initToken

initToken(token: string): void
Инициализирует токен доступа к VK API
Parameters
- token: string
  Токен доступа к VK API
Returns void
- Defined in plugins/platforms/API/VkRequest.ts:151

messagesSend

messagesSend(
    peerId: TVkPeerId,
    message: string,
    params?: IVkParams | null,
): Promise<IVKSendMessage | null>
Отправляет сообщение пользователю или в чат
Parameters
- peerId: TVkPeerId
  Идентификатор получателя:
  
  ID пользователя — передавайте числом (например, 12345)
  
  Короткое имя (screen_name) — передавайте строкой (например, 'durov'); строка уходит в параметр domain, а не peer_id
  
  ID чата: 2000000000 + chat_id — числом (например, для чата 1: 2000000001)
  
  ID сообщества: -ID сообщества — числом (например, -123456789)
- message: string
  Текст сообщения
- params: IVkParams | null = null
  Дополнительные параметры:
  
  random_id: уникальный ID для избежания повторов
  
  attachments: массив вложений "<owner_id>_<media_id>" (объединяются через запятую в параметр attachment) Примеры:
  
  Фото: "photo123456_789"
  
  Документ: "doc123456_789"
  
  Аудио: "audio123456_789"
  
  Видео: "video123456_789"
  
  keyboard: клавиатура в JSON формате или строкой
  
  template: шаблон карусели в JSON формате или строкой
Returns Promise<IVKSendMessage | null>
Информация об отправленном сообщении или null при ошибке
Example
```
// Простое сообщение
await vk.messagesSend(12345, 'Привет!');

// Сообщение с вложениями
await vk.messagesSend(12345, 'Фото:', {
  attachments: ['photo123_456', 'doc123_456']
});

// Сообщение с клавиатурой
const keyboard = {
  one_time: true,
  buttons: [[{
    action: {
      type: 'text',
      label: 'Кнопка',
      payload: '{"button": 1}'
    },
    color: 'primary'
  }]]
};
await vk.messagesSend(12345, 'Выберите:', {
  keyboard: JSON.stringify(keyboard)
});

// Сообщение с каруселью
const template = {
  type: 'carousel',
  elements: [{
    title: 'Заголовок',
    description: 'Описание',
    photo_id: '-123456_789',
    buttons: [{
      action: {
        type: 'text',
        label: 'Кнопка',
        payload: '{"button": 1}'
      }
    }]
  }]
};
await vk.messagesSend(12345, '', {
  template: JSON.stringify(template)
});
```
- Defined in plugins/platforms/API/VkRequest.ts:348

photosGetMessagesUploadServer

photosGetMessagesUploadServer(
peerId: TVkPeerId,
): Promise<IVkUploadServer | null>
Получает URL для загрузки фотографий в сообщения
Parameters
- peerId: TVkPeerId
  ID получателя сообщения
Returns Promise<IVkUploadServer | null>
Данные для загрузки или null при ошибке
- Defined in plugins/platforms/API/VkRequest.ts:450

photosSaveMessagesPhoto

photosSaveMessagesPhoto(
    photo: string,
    server: string,
    hash: string,
): Promise<IVkPhotosSave[] | null>
Сохраняет загруженную фотографию в сообщениях
Parameters
- photo: string
  Идентификатор фотографии
- server: string
  Идентификатор сервера
- hash: string
  Хэш-сумма фотографии
Returns Promise<IVkPhotosSave[] | null>
Информация о сохраненной фотографии или null при ошибке
- Defined in plugins/platforms/API/VkRequest.ts:462

sendMessageEvent

sendMessageEvent(
    userId: TVkPeerId,
    eventId: string,
    eventData?: {
        Intent?: string;
        link?: string;
        text?: string;
        title?: string;
        type: "show_snackbar" | "open_link" | "open_modal";
    },
    peerId?: TVkPeerId,
): Promise<IVKSendMessage | null>
Подтверждение получения callback-события от кнопки. Обязательный метод для обработки message_event в VK Bot API. Без этого вызова VK показывает пользователю "Бот недоступен" при нажатии callback-кнопки.
Parameters
- userId: TVkPeerId
  ID пользователя
- eventId: string
  ID события из message_event
- OptionaleventData: {
      Intent?: string;
      link?: string;
      text?: string;
      title?: string;
      type: "show_snackbar" | "open_link" | "open_modal";
  }
  Данные события (опционально): show_snackbar, open_link или open_modal
- OptionalpeerId: TVkPeerId
  ID диалога из message_event. Для обратной совместимости используется userId
Returns Promise<IVKSendMessage | null>
Результат выполнения или null при ошибке
Example
```
// Простое подтверждение
await vkApi.sendMessageEvent(userId, eventId);

// С показом всплывающего уведомления
await vkApi.sendMessageEvent(userId, eventId, {
    type: 'show_snackbar',
    text: 'Действие выполнено!'
});
```
- Defined in plugins/platforms/API/VkRequest.ts:554

upload

upload(
    url: string,
    file: string,
    fieldName?: "photo" | "file",
): Promise<IVkUploadFile | null>
Загружает файл на сервера ВКонтакте
Parameters
- url: string
  URL для загрузки файла
- file: string
  Путь к файлу или его содержимое
- fieldName: "photo" | "file" = 'file'
  Имя multipart-поля с файлом. Сервер загрузки фото (photos.getMessagesUploadServer) принимает файл только в поле photo — с полем file он возвращает пустой photo: "[]", и сохранение фото падает. Документы и голосовые (docs.getMessagesUploadServer) ждут поле file (значение по умолчанию).
Returns Promise<IVkUploadFile | null>
Информация о загруженном файле или null при ошибке
Remarks
Для фотографий возвращает:
- photo: строка, содержащая информацию о фото
- server: строка, идентификатор сервера
- hash: строка, хеш загруженного файла
Для документов возвращает:
- file: строка, информация о загруженном файле
Example
```
// Загрузка фото.
// Поля photo/server/hash у IVkUploadFile опциональны —
// перед вызовом photosSaveMessagesPhoto проверяем их наличие
const server = await vk.photosGetMessagesUploadServer(12345);
if (server) {
  const upload = await vk.upload(server.upload_url, 'photo.jpg', 'photo');
  if (upload?.photo && upload?.server && upload?.hash) {
    const photo = await vk.photosSaveMessagesPhoto(
      upload.photo,
      upload.server,
      upload.hash
    ); // IVkPhotosSave[] — берём первый элемент
  }
}

// Загрузка документа
const server = await vk.docsGetMessagesUploadServer(12345, 'doc');
if (server) {
  const upload = await vk.upload(server.upload_url, 'document.pdf');
  if (upload) {
    const doc = await vk.docsSave(
      upload.file,
      'Документ',
      'тег1,тег2'
    );
  }
}
```
- Defined in plugins/platforms/API/VkRequest.ts:247

usersGet

usersGet(
userId: string[] | TVkPeerId,
params?: IVkParamsUsersGet | null,
): Promise<IVkUsersGet[] | null>
Получает информацию о пользователе или списке пользователей
Parameters
- userId: string[] | TVkPeerId
  ID пользователя, список ID через запятую или массив ID
- params: IVkParamsUsersGet | null = null
  Дополнительные параметры запроса
Returns Promise<IVkUsersGet[] | null>
Массив пользователей или null при ошибке
- Defined in plugins/platforms/API/VkRequest.ts:427

Class VkRequest

See

Example

Hierarchy (View Summary)

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns VkRequest

Properties

Protected_appContext

Protected_error

Protected_request

isAttachContent

token

Methods

Protected_log

Parameters

Returns void

call

Type Parameters

Parameters

Returns Promise<T | null>

docsGetMessagesUploadServer

Parameters

Returns Promise<IVkUploadServer | null>

Example

docsSave

Parameters

Returns Promise<IVkDocSave | null>

initToken

Parameters

Returns void

messagesSend

Parameters

Returns Promise<IVKSendMessage | null>

Example

photosGetMessagesUploadServer

Parameters

Returns Promise<IVkUploadServer | null>

photosSaveMessagesPhoto

Parameters

Returns Promise<IVkPhotosSave[] | null>

sendMessageEvent

Parameters

Returns Promise<IVKSendMessage | null>

Example

upload

Parameters

Returns Promise<IVkUploadFile | null>

Remarks

Example

usersGet

Parameters

Returns Promise<IVkUsersGet[] | null>

Settings

On This Page

`Protected`_appContext

`Protected`_error

`Protected`_request

`Protected`_log