Messagesmessages.send
Отправляет сообщение.
Этот метод можно вызвать с ключом доступа пользователя, полученным в Standalone-приложении через Implicit Flow. Требуются права доступа: messages.
Этот метод можно вызвать с ключом доступа сообщества. Требуются права доступа: messages.
Параметры
| user_id | идентификатор пользователя, которому отправляется сообщение. целое число |
| random_id | уникальный (в привязке к API_ID и ID отправителя) идентификатор, предназначенный для предотвращения повторной отправки одинакового сообщения. Сохраняется вместе с сообщением и доступен в истории сообщений. Заданный random_id используется для проверки уникальности за всю историю сообщений, поэтому используйте большой диапазон (до int64). целое число, доступен начиная с версии 5.45 |
| peer_id | идентификатор назначения. Для пользователя: целое число, доступен начиная с версии 5.38 |
| domain | короткий адрес пользователя (например, illarionov). строка |
| chat_id | идентификатор беседы, к которой будет относиться сообщение. положительное число, максимальное значение 100000000 |
| user_ids | идентификаторы получателей сообщения (при необходимости отправить сообщение сразу нескольким пользователям). Доступно только для ключа доступа сообщества. Максимальное количество идентификаторов: 100. список целых чисел, разделенных запятыми |
| message | текст личного сообщения. Обязательный параметр, если не задан параметр attachment. строка |
| lat | географическая широта (от -90 до 90). дробное число |
| long | географическая долгота (от -180 до 180). дробное число |
| attachment | медиавложения к личному сообщению, перечисленные через запятую. Каждое прикрепление представлено в формате:<type><owner_id>_<media_id> <type> — тип медиавложения:
<owner_id> — идентификатор владельца медиавложения (обратите внимание, если объект находится в сообществе, этот параметр должен быть отрицательным). <media_id> — идентификатор медиавложения. Например: photo100172_166443618 Параметр является обязательным, если не задан параметр message. В случае, если прикрепляется объект, принадлежащий другому пользователю следует добавлять к вложению его access_key в формате <type><owner_id>_<media_id>_<access_key>, Например: video85635407_165186811_69dff3de4372ae9b6e строка |
| reply_to | идентификатор сообщения, на которое требуется ответить. целое число, доступен начиная с версии 5.92 |
| forward_messages | идентификаторы пересылаемых сообщений, перечисленные через запятую. Перечисленные сообщения отправителя будут отображаться в теле письма у получателя. Не более 100 значений на верхнем уровне, максимальный уровень вложенности: 45, максимальное количество пересылаемых сообщений 500 Например: 123,431,544 список целых чисел, разделенных запятыми |
| forward | |
| sticker_id | идентификатор стикера. положительное число |
| group_id | идентификатор сообщества (для сообщений сообщества с ключом доступа пользователя). положительное число |
| keyboard | объект, описывающий клавиатуру бота. |
| payload | Полезная нагрузка максимальная длина 1000 |
| dont_parse_links | 1 — не создавать сниппет ссылки из сообщения флаг, может принимать значения 1 или 0, по умолчанию |
| disable_mentions | 1 - отключить уведомление об упоминании в сообщении флаг, может принимать значения 1 или 0, по умолчанию |
Результат
После успешного выполнения возвращает идентификатор отправленного сообщения.
Если передан параметр user_ids, возвращает массив объектов, каждый из которых содержит поля:
Если передан параметр user_ids, возвращает массив объектов, каждый из которых содержит поля:
- peer_id — идентификатор назначения;
- message_id — идентификатор сообщения;
- error — сообщение об ошибке, если сообщение не было доставлено получателю.
Коды ошибок
| 15 | Access denied |
| 900 | Нельзя отправлять сообщение пользователю из черного списка |
| 901 | Пользователь запретил отправку сообщений от имени сообщества |
| 902 | Нельзя отправлять сообщения этому пользователю в связи с настройками приватности |
| 911 | Keyboard format is invalid |
| 912 | This is a chat bot feature, change this status in settings |
| 913 | Слишком много пересланных сообщений |
| 914 | Сообщение слишком длинное |
| 917 | You don't have access to this chat |
| 921 | Невозможно переслать выбранные сообщения |
| 936 | Contact not found |
| 940 | Too many posts in messages |
Связанные методы
Актуальные версииПоказать все
5.90
Метод account.getBanned возвращает поля profiles (array) и groups (array) с данными пользователей и сообществ.
Новый формат ответа метода docs.save.
Параметр random_id в методе messages.send обязателен.
Новый формат ответа метода docs.save.
Параметр random_id в методе messages.send обязателен.
5.68
В объекте записи на стене добавлено поле groups_can_post с информацией о том, могут ли сообщества комментировать запись.
Метод messages.send возвращает массив статусов отправки при использовании параметра user_ids и вызове с ключом доступа сообщества.
Методы groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer устарели.
В методах groups.setCallbackSettings, groups.getCallbackSettings добавлен параметр server_id.
Метод messages.send возвращает массив статусов отправки при использовании параметра user_ids и вызове с ключом доступа сообщества.
Методы groups.getCallbackServerSettings, groups.setCallbackServerSettings и groups.setCallbackServer устарели.
В методах groups.setCallbackSettings, groups.getCallbackSettings добавлен параметр server_id.
5.46
Методы messages.send и messages.sendSticker принимают параметр random_id вместо guid. Метод account.getPushSettings возвращает поле peer_id вместо chat_id и user_id. Метод account.setSilenceMode принимает параметр peer_id вместо chat_id и user_id. Метод messages.getHistoryAttachments возвращает товары, записи со стены и комментарии в виде ссылок.
Влияет на методы messages.send, account.getPushSettings, account.setSilenceMode, messages.getHistoryAttachments
5.38
Методы apps.get и apps.getCatalog возвращают объект photo для полей screenshots. Добавлены поля in_read, out_read в ответы методов messages.getDialogs и messages.getHistory.
Добавлен параметр peer_id для методов messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity и messages.getHistory.
Добавлен параметр peer_id для методов messages.send, messages.sendSticker, messages.deleteDialog, messages.setActivity и messages.getHistory.
Влияет на методы messages.send, messages.deleteDialog, messages.setActivity, messages.getDialogs, messages.getHistory, apps.get, apps.getCatalog