Функции для отправки и редактирования сообщений
Как отправить сообщение во Вконтакте
Описание:
vk_send_message(platform_id, message, keyboard, reply_to, forward_messages, sticker_id, dont_parse_links, disable_mentions, attachments_photo, attachments_files, parse_mode)
Параметры:
! platform_id
id клиента в мессенджере *
! message
текст сообщения
keyboard
кнопки в сообщении **
reply_to
id сообщения для ответа/цитаты
forward_messages
id пересылаемых сообщений (формат списка "{#айдипервогосообщения}, #{второго}, #{итакдалее}"
sticker_id
id стикера
dont_parse_links
создавать сниппет или нет, может принимать значение 1 — создавать, 0 — нет
disable_mentions
отключить уведомление об упоминании в сообщении, для отключения уведомлений передайте в этот параметр что угодно, иначе оставьте пустым
attachments_photo
добавить в медиавложения сообщения фотографии, которые пока не загружены во ВКонтакте, в виде списка ссылок на фотографии в формате:
'["#{url1}","#{url2}"]', где
url - это ссылка на фотографию на доступных ресурсах в Интернете.
attachments_files
различные вложения из ВКонтакте. Для использования attachments_files потребуется строка с вложениями, перечисленными через запятую и уже находящимися во ВКонтакте, имеющая следующий вид:
'doc-182762603_638918266, photo-182762603_638918266'
Каждое вложение описываем следующим образом:
<type>-<owner_id>_<media_id> - где:
<type> — тип медиа-вложения:
photo— фотография;video— видеозапись;audio— аудиозапись;doc— документ;wall— запись на стене;market— товар;poll— опрос.
<owner_id> — идентификатор владельца медиа-вложения.
<media_id> — идентификатор медиа-вложения.
Обратите внимание, если прикрепляется объект, принадлежащий другому пользователю, следует добавлять к вложению его access_key в формате
-<owner_id><media_id>_<access_key>
parse_mode
необязательный параметр. Включает разметку текста в сообщении. Возможные значения - "html" и "markdown"
Если присвоить функцию переменной, то в переменную будет помещен id сообщения, который будет необходим для возможно последующего редактирования сообщения.
Примеры:
Отправим сообщение с кнопками и с картинкой, заранее загруженной в нашу группу:
Тестируем
Обратите внимание на значение переменной soob, в которую мы записали результат отправки сообщения
Как видите функция вернула идентификатор отправленного сообщения. Это позволяет нам проводить дальнейшие манипуляции над сообщением
Пример кода для копирования:
Чтобы в переменную записать текст с переносами строк, укажите значение следующим образом:
message = "Текст первой строки" + "\n" + "Текст второй строки" + "\n" +"Третья строка"
Как редактировать сообщение во ВКонтакте
Описание:
vk_edit_message(platform_id, message_id, text, attachments_photo, attachments_files, keyboard, keep_forward_messages, keep_snippets, dont_parse_links, disable_mentions, parse_mode)
Параметры:
! platform_id
id клиента в мессенджере *
! message_id
id редактируемого сообщения
text
текст сообщения
attachments_photo
добавить в медиа вложения сообщения фотографии, которые пока не загружены во ВКонтакте, в виде списка ссылок на фотографии в формате:
'["#{url1}","#{url2}"]', где
url - это ссылка на фотографию на доступных ресурсах в Интернете.
attachments_files
различные вложения из ВКонтакте. Для использования attachments_files потребуется строка с вложениями, перечисленными через запятую и уже находящимися во ВКонтакте, имеющая следующий вид:
'doc-182762603_638918266, photo-182762603638918266'.
Каждое вложение описываем следующим образом:
<type>-<owner_id>_<media_id> - где:
<type> — тип медиа-вложения:
photo— фотография;video— видеозапись;audio— аудиозапись;doc— документ;wall— запись на стене;market— товар;poll— опрос.
<owner_id> — идентификатор владельца медиа-вложения.
<media_id> — идентификатор медиа-вложения.
Обратите внимание, если прикрепляется объект, принадлежащий другому пользователю, следует добавлять к вложению его access_key в формате -<owner_id><media_id>_<access_key>
keyboard
кнопки в сообщении **
keep_forward_messages
признак необходимости сохранить прикреплённые пересланные сообщения (любое значение)
keep_snippets
признак необходимости сохранить прикреплённые внешние ссылки (сниппеты)(любое значение)
dont_parse_links
признак того, что не надо создавать сниппет (любое значение)
disable_mentions
признак того, что надо отключить уведомление об упоминании в сообщении (любое значение)
parse_mode
необязательный параметр. Включает разметку текста в сообщении. Возможные значения - "html" и "markdown"
Примеры:
Продолжим с Вами предыдущий пример - отредактируем сообщение через 5 секунд
Тестируем:
Пример кода для копирования:
Блок отправки сообщения:
Блок редактирования:
Последнее обновление