messages.send

Идентификатор пользователя, которому отправляется сообщение.

Число в пределах int32 — уникальный (в привязке к API_ID и ID отправителя) идентификатор, предназначенный для предотвращения повторной отправки одинакового сообщения. Сохраняется вместе с сообщением и доступен в истории сообщений.

Переданный в запросе random_id используется для проверки уникальности, проверяя в заданном диалоге сообщения за последний час (но не более 100 последних сообщений).

Идентификатор назначения.

Для пользователя:

• •
  id пользователя.

Для групповой беседы:

• •
  2000000000 + id беседы.

Для сообщества:

• •
  -id сообщества.

Идентификаторы получателей сообщения (при необходимости отправить сообщение сразу нескольким пользователям). Доступно только для ключа доступа сообщества. Максимальное количество идентификаторов: 100.

Короткий адрес пользователя (например, illarionov).

Идентификатор беседы, к которой будет относиться сообщение.

Идентификаторы получателей сообщения (при необходимости отправить сообщение сразу нескольким пользователям). Доступно только для ключа доступа сообщества. Максимальное количество идентификаторов: 100.

Текст личного сообщения. Обязательный параметр, если не задан параметр attachment.

Уникальный идентификатор, предназначенный для предотвращения повторной отправки одинакового сообщения.

Географическая широта (от -90 до 90).

Географическая долгота (от -180 до 180).

Медиавложения к личному сообщению, перечисленные через запятую. Каждое прикрепление представлено в формате:

<type> — тип медиавложения:

• •
  photo — фотография;
• •
  video — видеозапись;
• •
  audio — аудиозапись;
• •
  doc — документ;
• •
  wall — запись на стене;
• •
  market — товар;
• •
  poll — опрос.

<owner_id> — идентификатор владельца медиавложения (обратите внимание, если объект находится в сообществе, этот параметр должен быть отрицательным). <media_id> — идентификатор медиавложения.

Например:

Параметр является обязательным, если не задан параметр message.

В случае, если прикрепляется объект, принадлежащий другому пользователю следует добавлять к вложению его access_key в формате <type><owner_id>_<media_id>_<access_key>, Например:

Идентификатор сообщения, на которое требуется ответить.

Идентификаторы пересылаемых сообщений, перечисленные через запятую. Перечисленные сообщения отправителя будут отображаться в теле письма у получателя. Не более 100 значений на верхнем уровне, максимальный уровень вложенности — 45, максимальное количество пересылаемых сообщений — 500.

Например:

JSON-объект со следующими полями:

• •
  owner_id — владелец сообщений. Стоит передавать, если вы хотите переслать сообщения из сообщества в диалог;
• •
  peer_id — идентификатор места, из которого необходимо переслать сообщения;
• •
  conversation_message_ids — массив conversation_message_id сообщений, которые необходимо переслать. В массив conversation_message_ids можно передать сообщения:

  • •
    находящиеся в личном диалоге с ботом;
  • •
    являющиеся исходящими сообщениями бота;
  • •
    написанными после того, как бот вступил в беседу и появился доступ к сообщениям.
• •
  message_ids — массив id сообщений;
• •
  is_reply — ответ на сообщения. Стоит передавать, если вы хотите ответить на сообщения в том чате, в котором находятся сообщения. При этом в conversation_message_ids или message_ids должен находиться только один элемент.

Идентификатор стикера.

Идентификатор сообщества (для сообщений сообщества с ключом доступа пользователя).

Объект, описывающий клавиатуру бота.

Объект, описывающий шаблон сообщения.

Полезная нагрузка.

Объект в формате JSON, описывающий источник пользовательского контента для чат-ботов.

1 — не создавать сниппет ссылки из сообщения.

1 - отключить уведомление об упоминании в сообщении.

Строка, описывающая интенты.

Параметр зарезервирован для использования в будущем. Число, которое будет использоваться для работы с интентами.