К содержанию

RuMaxBot.ru теперь с кнопками

На RuMaxBot можно отправлять сообщения в мессенджер MAX через простое REST API: один запрос с ключом — и текст уходит в личный или групповой чат. Токен бота и ретраи остаются на стороне сервиса.

Свежее обновление — inline-кнопки в сообщениях и исходящий вебхук на ваш URL.

Что появилось

В POST /api/v1/messages по-прежнему достаточно поля text. Дополнительно можно передать attachments с клавиатурой в формате MAX (inline_keyboard): кнопки «Принять» / «Отклонить» и любые другие callback или link.

Пример кнопки — в payload ваша строка-идентификатор действия; она же придёт в вебхуке при нажатии:

{
  "type": "callback",
  "text": "Принять",
  "payload": "order:accept"
}
После нажатия кнопки клавиатура снимается, в сообщении остаётся пометка «Выбрано: …» с текстом выбранной кнопки.

У API-ключа в кабинете задаётся URL вебхука: при нажатии RuMaxBot пришлёт событие на ваш сервер с HMAC-подписью. Если на один канал несколько ключей — ответ уходит тому клиенту, которым сообщение отправили.

Пример тела вебхука:

{
  "event": "message_callback",
  "timestamp": 1730000000,
  "channel_id": "uuid",
  "api_key_id": "uuid",
  "external_message_id": "550e8400-e29b-41d4-a716-446655440000",
  "chat_id": "…",
  "callback": {
    "callback_id": "…",
    "payload": "order:accept",
    "text": "Принять"
  },
  "user": {
    "user_id": 123,
    "name": "Иван",
    "username": null
  },
  "message": {
    "mid": "…",
    "text": "Выберите действие"
  }
}
Для склейки с вашей системой есть опциональный external_message_id (UUID): тот же идентификатор вернётся в вебхуке.

Старые интеграции без кнопок и вебхука продолжают работать без изменений.

Документация

Примеры запросов, формат вебхука и описание API — в репозитории:

https://github.com/ww-site/RuMaxBot

Сервис: https://rumaxbot.ru · новости: https://rumaxbot.ru/novoe

Проект не аффилирован с MAX Messenger. Используется публичный Bot API.
Stepan
Stepan
Вчера в 03:42
modx.pro
70
Реклама

Комментарии: 0

Авторизуйтесь или зарегистрируйтесь, чтобы оставлять комментарии.
0