Сообщение

Когда вы создаете и открываете блок сообщения - вы видите внизу четыре иконки, которые создают контейнеры разных типов:

  1. Контейнер "Отправить сообщение"

  2. Контейнер "Отредактировать сообщение"

  3. Контейнер "Отправить картинку"

  4. Контейнер "Исправить картинку"

Контейнер "Отправить сообщение"

Здесь вы можете написать ваше сообщение.

Поле сообщения поддерживает:

  • Любые символы

  • Unicode-символы (◕‿◕) - поддерживаемые платформой, куда отправляется сообщение.

  • Смайлы (например, вы можете скопировать смайл из любого места и вставить его сюда)

  • Переменные. Список стандартных переменных можно найти по [ссылке].

  • Html-теги <>, поддерживаемые платформой, куда отправляется сообщение.

Также вы можете добавить кнопки к сообщению.

Каждая кнопка имеет порт выхода:

При добавлении кнопки необходимо добавить текст этой кнопки. Также можно выбрать цвет, однако он будет отображаться только во ВКонтакте. В Telegram будет отображаться стандартный цвет, в независимости от выбранного вами. Вы можете использовать цвета просто для красоты.

С помощью перетаскивания вы можете менять порядок кнопок. Ставить их в ряд или в столбик.

Тип кнопки "Ссылка"

Тип кнопки "Ссылка" работает только для инлайн-кнопок.

Текст кнопки - здесь всё просто, но учитывайте длину текста. Если она будет превышать допустимое значение платформы ВК/ТГ, то сообщение просто не будет отправлено.

Ссылка - здесь вставьте ссылку на ваш сайт.

Цвет для данной кнопки нельзя изменить - это ограничение платформ.

Тип кнопки "Приложение

ВКонтакте

Для ВКонтакте в ссылку вставляется ссылка на ВК-приложение.

Важно!

Для ВК работает только обычный тип кнопки.

Инлайн-кнопка не откроет приложение!

Пример:

Telegram

Для Telegram приложение используется как браузерная версия формата WebApp.

Важно!

Для Telegram работает и обычная кнопка и инлайн.

И перед открытием отправит пользователю уведомление.

Для примера, вставили ссылку на наш сайт. Всё прекрасно открывается и работает. Можно работать в Малти прямо из Телеграм)))

Но вообще, в Telegram возможностей для webapp множество. Особенно для тех, у кого есть свой сайт. Можно добавить из инструкций Telegram, скрипт, и отправлять боту информацию о том, что нажимает пользователь на сайте в этом окне. Использовать как корзину магазина, регистрацию и т.д.

Тип кнопки "Запрос данных"

Есть типа объекта:

  • Номер телефона

  • Пользователь / Бот

  • Чат / Канал

  • Опрос

  • Геолокация

Важно!

Для типа кнопки "Запрос данных" поддерживаются только обычные кнопки. Инлайн-кнопки не поддерживаются.

Для Telegram поддерживаются все типы.

Для ВКонтакте поддерживается только Геолокация и только в режиме обычной кнопки. Текст мы можем задать, но ВК все равно переименует кнопку на "Отправить свое местоположения". Плюс на данный момент некорректно отдает данные. Так что можно сказать, что функция в основном для Telegram.

Для всех пунктов можно поставить реакцию через блок события "Входящее сообщение" и условием "Тип вложения" и вывести результат с помощью переменной {var:object}

Например, при нажатии на кнопку с типом "Номер телефона", мы получим следующий массив:

{"id":3818,"text":"","type":"contact","reply":{"id":3817,"text":"Тест"},"attachments":[{"type":"contact"}],"contact":{"phone_number":"+79876543210","first_name":"Кирилл","last_name":"Аксёнов","user_id":399640976}}

Соответственно, если мы хотим получить только телефон, то исходя из данного JSON объекта, переменная для телефона будет: {var:object.contact.phone_number}

И так по аналогии с каждой кнопкой. Смотря какие данные вам нужны.

Дополнительные параметры

Также при нажатии на шестеренку откроются дополнительные опции.

Инлайн кнопки (прикрепить к сообщению)

Так выглядят обычные кнопки:

Так выглядят Инлайн (Inline) кнопки (встроенные в сообщение):

Постоянные кнопки

Постоянные кнопки не исчезают после их нажатия.

Соответственно, если не ставить галочку, то по умолчанию кнопки будут исчезать после нажатия.

Создать массив клавиатуры из переменных

Заменяет стандартный редактор кнопок JSON-массивом.

Удалить кнопки из диалога

Если ранее вы использовали постоянные кнопки, то с помощью этой галочки вы сможете их скрыть у пользователя.

Прикреплять превью (сниппет) ссылки к сообщения

Сниппет — это предпросмотр ссылок.

Важно! Если не включить эту галочку, то статья в ВК будет отображаться просто как ссылка.

Пустое сообщение - НЕ ошибка

По умолчанию эта функция включена.

Сообщения без текста или вложений не отправляются, даже с кнопками и переменными без текста. Если убрать эту галочку, и пользователь наткнется на блок с пустым сообщением, то схема перестанет работать. Вы можете убирать эту галочку, например, при тестировании.

Ответить на сообщение

В чатах есть функция "Ответить на сообщение". Бот будет использовать её, чтобы цитировать пользователя и отвечая на сообщение. По умолчанию цитирует последнее сообщение пользователя, вызванное событием.

Переслать сообщение

По умолчанию пересылает предыдущее сообщение пользователя в этот же чат. Через переменные можно перенаправить его в другой указав id сообщения.

Добавить вложения к сообщению

Вы можете добавить/прикрепить к сообщению вложения. Например, если во ВКонтакте открыть изображение и посмотреть его ссылку, то мы найдем вот такую строку: photo-208994661_457239195, которую необходимо вставить в поле вложения. Это сокращенный путь фотографии, где первое число - это id сообщества, второе - id объекта (изображения).

Работает только во ВКонтакте

Для отправки вложений в Telegram можно использовать блок действия "Отправить вложение в Telegram".

Запретить пересылку и скачивание

Платформа попытается запретить распространение этого сообщения. Сообщение нельзя будет сохранить или переслать. Вложения нельзя будет скачать. Работает только в Telegram

Контейнер "Отредактировать сообщение"

С помощью этой функции вы можете отредактировать последнее сообщение, отправленное ботом, либо конкретное, если вы ранее его сохраняли в переменную.

Это актуально, например, когда вы используете Инлайн-кнопки и не хотите плодить сообщения с ними. В этом случае текст и кнопки будут постоянно обновляться у пользователя.

Контейнер "Отправить картинку"

Вы можете загрузить изображение со своего устройства ПК или телефона.

Ограничение по размеру файла — 10мб.

Поддерживаются форматы: "jpg", "jpeg", "png".

Запретить пересылку и скачивание

Телеграм попытается запретить распространение этого вложения. Сообщение нельзя будет сохранить или переслать, видео и фото нельзя будет скачать. Работает только в Telegram!

Добавить описание

По возможности добавляет текст к изображению. Актуально в основном для Telegram.

Включить клавиатуру бота

Изображение — это тоже сообщение, поэтому вы можете добавить к нему кнопки.

Last updated