VK API: POST /method/messages.send — Отправка сообщения

Ключи: пользователя, сообщества.

Параметр	Где	Тип	Обяз.	Описание
`v`	body	string	да	Версия API
`peer_id`	body	integer	нет	Получатель: ID пользователя; 2000000000 + chat_id для беседы; -ID сообщества
`peer_ids`	body	array	нет	Несколько получателей, до 100
`user_id`	body	integer	нет	ID пользователя
`domain`	body	string	нет	Короткий адрес пользователя
`random_id`	body	integer	нет	Уникальный ID для защиты от повторной отправки
`message`	body	string	нет	Текст; обязателен, если нет attachment
`attachment`	body	string	нет	Вложения _ через запятую; обязательны, если нет message
`reply_to`	body	integer	нет	ID сообщения, на которое отвечаем
`forward_messages`	body	array	нет	ID пересылаемых сообщений через запятую
`keyboard`	body	string	нет	Клавиатура бота (JSON)
`payload`	body	string	нет	Полезная нагрузка
`group_id`	body	integer	нет	ID сообщества (с ключом сообщества)
`dont_parse_links`	body	boolean	нет	Не создавать сниппеты ссылок
`disable_mentions`	body	boolean	нет	Отключить уведомления об упоминаниях

Базовые URL

Боевой: https://api.vk.ru
URL метода: https://api.vk.ru/method/<имя-API-метода>

Авторизация

Тип: Bearer-токен

Ключ доступа передаётся в каждом запросе в заголовке Authorization: Bearer <КЛЮЧ_ДОСТУПА>. Тип ключа указан у каждого метода: ключ пользователя, ключ сообщества или сервисный ключ приложения.

Ответ:

curl 'https://api.vk.ru/method/users.get' \
  -H 'Authorization: Bearer <КЛЮЧ_ДОСТУПА>' \
  -F 'user_ids=743784474' \
  -F 'fields=bdate' \
  -F 'v=5.131'

Нюансы

HTTP-методы GET и POST равнозначны; только HTTPS.
Обязательный во всех запросах параметр v — версия API. В документации указана актуальная версия 5.131, а официальная JSON-схема методов VK описывает версию 5.199.
Тело POST — application/x-www-form-urlencoded или multipart/form-data (для файлов и данных больше 2 КБ); application/json не поддерживается.
Имя метода чувствительно к регистру.
Общие параметры для всех методов: lang (ru, uk, be, en, es, fi, de, it) и test_mode=1.
ID сообщества в owner_id передаётся со знаком минус.
Кроме ограничений частоты есть закрытые количественные лимиты на однотипные методы: при превышении метод может стать временно недоступен или потребовать капчу.

Сценарии с этим методом

Если этого недостаточно — официальная документация: https://dev.vk.com/ru/api/api-requests Вся интеграция одним документом: https://mcp-everything.ru/integrations/vk-api.md