Как отправить сообщение с кнопками от имени бота

Для отправки сообщения с кнопками вам потребуется воспользоваться методом API Новое сообщение и полем message.buttons.

Кнопки под сообщением от бота отображаются в виде строк, которые полностью занимают вложенные в них кнопки. Поэтому, buttons — массив строк. Каждая строка — массив объектов кнопок.

У кнопки есть text (отображаемый текст на кнопке) и тип кнопки url или data.

URL-кнопки — предназначены для перенаправления пользователя по ссылке.
Data-кнопки — позволяют получать от пользователя данные и реагировать (например, изменять сообщение или отправлять новое).

Ограничения:

Максимальное количество кнопок в строке - 8
Максимальное число кнопок у сообщения - 100
Максимальная длина text на кнопке - 255 символов
Максимальная длина data у кнопки - 255 символов

Пример сообщения от бота с кнопками:

Пример URL-кнопки:

{
  "text": "Все мои проекты",
  "url": "https://projects.com/list"
}

Пример Data-кнопки:

{
  "text": "👍 Согласиться",
  "data": "vote_yes"
}

Пример запроса на отправку сообщения с кнопками методом POST https://api.pachca.com/api/shared/v1/messages

{
  "message": {
    "entity_type": "discussion",
    "entity_id": 82753212,
    "content": "Новый заказ [Создание одностраничного сайта](https://projects.com/inbox/534) на сумму 8000 руб.",
    "buttons": [
      /* Строка из двух кнопок */
      [
        {
          "text": "👍 Согласиться",
          "data": "vote_yes"
        },
        {
          "text": "❌ Отказаться",
          "data": "vote_no"
        }
      ],
      /* Одна кнопка */
      [
        {
          "text": "🕒 Перенести на неделю",
          "data": "pause_week"
        }
      ],
      /* Одна url-кнопка. */
      [
        {
          "text": "Все мои проекты",
          "url": "https://projects.com/list"
        }
      ]
    ]
  }
}

``‍Метод Редактирование сообщения также поддерживает поле message.buttons

URL-кнопки

При нажатии на URL-кнопку пользователю будет отображено модальное окно с подтверждением перехода по ссылке:

__wf_reserved_inherit

Data-кнопки

Для того чтобы получать события о нажатых пользователем кнопках, вам необходимо указать Webhook URL (куда вы будете получать события) в настройках исходящего вебхука бота и включить уведомления о событии «Нажатие кнопок».

Пример настроек «Исходящий вебхук» у бота:

__wf_reserved_inherit

Когда пользователь нажмет кнопку, на указанный Webhook URL будет отправлен JSON объект с информацией о сообщении, нажатой кнопке и пользователе, который эту кнопку нажал.

Пример исходящего вебхука о нажатии кнопки:

{
  "type": "button", //тип объекта
  "message_id": 21344124, //идентификатор сообщения, к которому относится кнопка
  "data": "vote_yes", //данные нажатой кнопки
  "user_id": 2412 //идентификатор пользователя, который нажал кнопку
}

После получения события вы можете дать обратную связь пользователю, например:

Через метод API Редактирование сообщения убрать уже не нужные кнопки и добавить новые, а в тексте сообщения показать, что действие совершено.
Через метод API Информация о сообщении получить идентификатор чата, в котором лежит сообщение от бота, и написать в этот чат сообщение с новыми кнопками или с результатом действия бота.

‍

Кнопки в чат-ботах

Как отправить сообщение с кнопками от имени бота

URL-кнопки

Data-кнопки

Другие статьи в разделе “Интеграции и доп. модули”