Senler Docs
senler.ru
  • Документация
  • Начало работы
    • О сервисе
    • Терминология
    • Регистрация
  • Проект
    • О проектах
    • Тарифы
    • Уведомления
  • Каналы
    • ВКонтакте
      • Подключение
      • Настройка сообщества
      • Получение шаблонов ботов и подписной страницы
      • Подписчики
        • Способы сбора базы подписчиков
        • Статусы
        • Действия с подписчиками
        • Импорт подписчиков
        • Экспорт подписчиков
        • Черный список
        • Способы отписаться
        • Обновление данных
        • Источники подписки
      • Группы подписчиков
        • Создание группы подписчиков
        • Настройки группы
        • Автоматическая подписка при переходе
        • Страница после подписки
        • Рекомендации для баннеров
        • Платная подписка
        • Автоисключение
        • Удаление группы
      • Рассылки
        • Создание рассылки
        • Разовая рассылка
        • Целевая рассылка
        • Статусы рассылок
        • Вложения
        • Шаблоны
        • Статистика рассылок
        • Открываемость
        • Ускоренная рассылка
        • Удаление
      • Чат-боты
        • Создание чат-бота
        • Блок - сообщение
        • Блок - таймер
        • Блок - действие
        • Блок - условие
        • Блок - группа условий
        • Клавиатура
        • Карусель
        • Переменные в ботах
        • Ответ на сообщение
        • Реакции на сообщение
        • Прочтение сообщения
        • Переход по ссылке
        • Настройки
        • Зацикливание
        • Запуск чат-бота
        • Активация новых связей
        • Тестирование
        • Публикация изменений
        • Статистика
        • Копирование
        • Удаление
      • Форматирование
      • Процессы
      • Триггеры
      • Метки
      • Переменные
        • Стандартные переменные
        • Глобальные переменные
        • Пользовательские переменные
      • Аналитика
        • Логирование действий в сообществе
        • Статистика
          • Воронки
        • Ретаргетинг ВКонтакте
        • Пиксель ВКонтакте
        • Яндекс Метрика
        • Google Analytics
        • Пиксель Facebook
        • Google Tag Manager
        • UTM-метки
        • UTM-генератор
        • REF-метки
        • Сквозная аналитика
      • Заказы
      • Интеграции
        • Интеграция с Prodamus
        • Интеграция с Robokassa
        • Интеграция с ApiX-Drive
        • Интеграция с Unitpay
        • Интеграция с VK Pay
        • Интеграция с ЮMoney
        • Интеграция с Пиксель ВКонтакте
        • Интеграция с Яндекс Метрика
        • Интеграция с Google Analytics
        • Интеграция с Facebook Pixel
        • Интеграция с Google Tag Manager
        • Интеграция с Google Sheets
        • Интеграция Уведомления в Telegram
        • Интеграция с ChatGPT (OpenAI)
    • Telegram
      • Подключение
      • Подписчики
        • Способы сбора базы подписчиков
        • Статусы
        • Действия с подписчиками
        • Импорт подписчиков
        • Экспорт подписчиков
        • Черный список
      • Группы подписчиков
        • Создание и настройки
        • Удаление
      • Рассылки
        • Создание рассылки
        • Разовая рассылка
        • Целевая рассылка
        • Статусы рассылок
        • Вложения
        • Шаблоны
        • Статистика рассылок
        • Удаление
      • Чат-боты
        • Создание чат-бота
        • Блок - сообщение
        • Блок - таймер
        • Блок - действие
        • Блок - группа условий
        • Клавиатура
        • Переменные в ботах
        • Ответ на сообщение
        • Реакции на сообщение
        • Переход по ссылке
        • Настройки
        • Зацикливание
        • Запуск чат-бота
        • Активация новых связей
        • Тестирование
        • Публикация изменений
        • Статистика
        • Копирование
        • Удаление
      • Форматирование
      • Процессы
      • Триггеры
      • Метки
      • Переменные
        • Стандартные переменные
        • Глобальные переменные
        • Пользовательские переменные
      • Аналитика
        • UTM-генератор
      • Интеграции
        • Интеграция Уведомления в Telegram
      • Проксирование
        • Серверы
  • Сервис
    • Мини-приложение ВКонтакте
      • Установка приложения
      • Главная страница
      • Подписные страницы
      • Мои подписки
      • Настройки
        • Вид главной страницы
        • Метрики
      • Виджеты
        • Создание виджета
        • Типы виджетов
        • Изображения
        • Аудитории
        • Массовые действия
        • Видимость
        • Публикация
        • Кеширование
      • Лендинги
        • Создание лендинга
        • Блоки
        • Текстовый редактор
        • Публикация изменений
        • Заявка с номером телефона
    • Партнерская программа
    • Отчёты
    • Корпоративным клиентам
    • Короткие ссылки
  • Помощь
    • Правила
      • Правила VK
    • FAQ
      • Общие вопросы
        • Как запретить сообщения от сообщества ВКонтакте?
        • Как разрешить сообщения от сообщества ВКонтакте?
        • Как отписаться от рассылок ВКонтакте?
        • Как получить идентификатор аудиозаписи?
        • Как получить идентификатор голосового сообщения?
        • Как получить ссылку на опрос?
        • Как получить идентификатор ответа в опросе?
        • Настройка сниппета
        • Не открывается ссылка на пост
        • Пишут слово Начать
        • Как получить токен в Telegram
        • Регулярные выражения
        • Удаление сообщений
        • Что такое мультиссылка?
        • Что такое теги?
        • Как узнать свой идентификатор в Telegram?
      • Вопросы о сообществах
        • Как подключить сообщество в Senler?
        • Кто подключил сообщество в Senler?
        • Как перенести сообщество?
        • Как отключить сообщество в Senler?
        • Удаление ключей API в сообществе ВКонтакте
      • Вопросы о рассылках
        • Не отправляются сообщения
        • Может массовая рассылка привести к блокировке сообщества?
      • Вопросы о подписчиках
        • Не добавляются подписчики
        • Не работает триггер
        • Почему важно хранить неактивных подписчиков?
      • Вопросы о чат-ботах
        • Бот не отвечает
        • Не отправляется определенный шаг
        • Не работает условие Ответ на сообщение
        • Изменение бота
        • Не открывается редактирование шага
      • Вопросы о сотрудниках
      • Вопросы о мини-приложении ВКонтакте
        • Почему показывается инструкция?
        • Почему не открывается приложение?
        • Как удалить приложение ВКонтакте?
        • Как вставить видео?
    • Ошибки
      • Ошибки VK
        • VK Oauth: Security Error
        • Only group admins have access to group tokens
        • Group is not allowed to send messages
        • Invalid request: modifying contacts in a shared group is not allowed
        • Error 1 - Unknown error occured
        • Error 5 - User authorization failed: invalid session
        • Error 10 - Internal server error
        • Error 15 - Access denied: group messages are disabled
        • Error 15 Access denied: share post forbidden
        • Error 15 - Access denied: no access to call this method
        • Error 15 - Access denied: at first group admin should install app widget in group
        • Error 15 - Access denied: no access to call this method. It cannot be called with current scopes
        • Error 27 - Group authorization failed: group revoke access for this token
        • Error 27 - Group authorization failed: group is banned
        • Error 100 - One of the parameters specified was missing or invalid: message is empty or invalid
        • Error 100 - One of the parameters specified was missing or invalid: file is undefined
        • Error 121 - Invalid hash
        • Error 129 - Invalid photo
        • Error 600 - Permission denied. You have no access to operations specified with given object(s)
        • Error 901 - Cant send messages for users without permission
        • Error 902 - Can't send messages to this user due to their privacy settings
        • Error 912 - This is a chat bot feature, change this status in settings
        • Error 914 - Message is too long
        • Error 936 - Contact not found
        • Error 2000 - Servers number limit is reached
        • Другие ошибки
      • Сетевые ошибки
        • Сайт отправил недействительный ответ или ERR_SSL_PROTOCOL_ERROR
        • Ошибка ERR_BLOCKED_BY_RESPONSE
        • Ошибка SSL_ERROR_ACCESS_DENIED_ALERT
        • Ошибка ERR_CONNECTION_REFUSED
        • Ошибка ERR_SSL_VERSION_INTERFERENCE
    • Обучающие материалы
    • Разработчикам
      • API
        • Версии API
        • Ключи доступа
        • Формирование подписи
        • Методы
          • Subscribers
            • add
            • del
            • get
            • statSubscribe
            • statCount
          • Subscriptions
            • get
            • add
            • edit
            • del
          • Utms
            • add
            • edit
            • del
            • get
            • getLink
            • statCount
            • statSubscribe
          • Deliveries
            • get
            • stat
            • statCount
          • Bots
            • get
            • getSteps
            • addSubscriber
            • delSubscriber
          • Vars
            • set
            • get
            • del
          • Vars_global
            • get
            • set
            • del
        • Возвращаемые ошибки
      • WebHook API
        • Серверы
        • Шаблоны
        • Обработка ответа запроса
      • Кнопка для сайта
      • Приложения
        • Создание приложения
        • Настройки
        • Руководство
        • Варианты интеграций
          • Шаг в чат-боте
          • Встроенная страница приложения
          • OAuth
        • Интеграции
          • Пользовательский интерфейс
          • Сохранение настроек
          • Чтение настроек
          • Вебхук
          • Публикация
          • Дополнительно
            • dev ссылка iframe
          • Пример #1. react ui
            • front dev
            • front prod
            • backend
          • Библиотеки
    • Техподдержка
Powered by GitBook
On this page
  • Типы кнопок
  • Стандартная клавиатура
  • Клавиатура внутри сообщения
  • Скрытие клавиатуры после нажатия
  • Переменные
  • Удаление старых кнопок
  • Не работают кнопки
  • Команда не найдена
  • Полезные материалы
  1. Каналы
  2. ВКонтакте
  3. Чат-боты

Клавиатура

PreviousБлок - группа условийNextКарусель

К сообщению можно прикреплять кнопки, удалять их и менять местами. Текст отображается по центру кнопки и обрезается, если не помещается полностью при текущем размере экрана.

Кнопки можно перемещать между собой в строке и между строк с помощью зажатия левой кнопкой мыши или долгим зажатием на мобильном.

Типы кнопок

  1. Текстовая кнопка - отправляет определенный текст, указанный на кнопке;

  2. Местоположение - отправляет карту с текущим местоположением подписчика;

  3. Оплата - позволяет оплатить платную подписку через VK Pay;

  4. Приложение - позволяет открыть любое приложение из Vk Mini Apps;

  5. Ссылка - позволяет открыть любую ссылку.

Текстовые кнопки не работают в качестве ключевых слов.

Открытие приложений и ссылок по кнопками никак не отслеживается.

VK Pay

  • кнопка не показываться, если не найдена платная подписка с ненулевой стоимостью

  • кнопка не показываться, если стоимость меньше 1 руб.

  • кнопка не показываться, если пользователь уже подписан, и подписка не периодическая.

Стандартная клавиатура

По умолчанию, клавиатура показывается под полем ввода в диалоге с пользователем.

Внимание! Максимальный размер стандартной клавиатуры — 5 столбцов × 10 строк. При этом максимальное количество кнопок: 40.

Если установить опцию Скрыть клавиатуру после нажатия, то стандартная клавиатура будет скрываться после нажатия на кнопку.

Если в момент прохождения пользователем бота ему пришло сообщение из массовой рассылки, кнопки от бота сохранятся.

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

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

Клавиатура с кнопками может быть скрыта. Чтобы ее показать, нужно нажать на кнопку с четырьмя точками.

Особенности стандартной клавиатуры:

  • Располагается под формой для ввода сообщения

  • Удаляется после получения нового сообщения от бота

  • Скрывается под иконкой с четырьмя точками (можно не заметить эту иконку и потерять клавиатуру)

Клавиатура внутри сообщения

Inline-клавиатура (или inline-кнопки) - это клавиатура, которая показывается под определенным сообщением.

Внимание! Максимальный размер встроенной клавиатуры — 5 столбцов × 6 строк. При этом максимальное количество кнопок: 10.

Особенности Inline-клавиатуры:

  • Располагается под определенным сообщением

  • Cохраняется в истории сообщений

  • Не скрывается (с одной стороны это плюс - ее нельзя не заметить, с другой стороны - на эти кнопки можно нажимать бесконечное количество раз и их никак не удалить)

Скрытие клавиатуры после нажатия

Внимание! Эта опция касается только стандартной клавиатуры. Inline кнопки не скрываются.

Опция Скрыть клавиатуру после нажатия позволяет убрать клавиатуру, чтобы пользователь больше не смог нажать на кнопки. Данная опция будет полезна, если не нужны повторные нажатия, и после кнопки нет дальнейших сообщений.

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

Внимание! Кнопки скрываются даже если вместо нажатия на кнопку пользователь написал сообщение.

Переменные

Внимание! Если переменная не будет найдена или будет иметь пустое значение, кнопка не будет показываться.

Удаление старых кнопок

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

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

Внимание! При повторном включении возможностей ботов кнопки не появятся.

Не работают кнопки

Если бот не реагирует на нажатие кнопок, выполните автоматическую настройку в разделе Настройки. Это должно решить проблему, так как в редких случаях Callback API ВКонтакте перестает работать (причины пока не выявлены), из-за этого сервис не получает информации о нажатии на кнопки.

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

Команда не найдена

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

Извините, команда не найдена.

Такое сообщение отправляем в следующих случаях:

  • пользователь не находится в базе подписчиков

  • пользователь не находится в боте

  • чат-бот был удален

  • шаг с кнопкой в боте был удален

  • пользователь находится в черном списке

Полезные материалы

Стандартная клавиатура

В тексте кнопок можно использовать или переменные.

глобальные
пользовательские
Интеграция | Чат-боты | Разработка | Клавиатура | VK для разработчиков
Источник
API for Chatbots, part 3 | Developers | VK
Logo
Logo
Клавиатура в сообщении
Показать клавиатуру ВКонтакте
Клавиатура внутри сообщения
Пример кнопки, которая содержит переменную
Автоматическая настройка подключения ВК