Home

Getting Started

Требования

• Ruby ≥ 3.2
• Токен бота (кабинет MAX → Чат-боты → Интеграция → Получить токен)

Установка

В Gemfile:

gem 'max_bot', '~> 0.3'

Затем:

bundle install

Настройка

require 'max_bot'

Max::Bot.configure do |config|
  config.connection_timeout      = 95  # секунды (должно быть > long-poll timeout)
  config.connection_open_timeout = 20
  config.adapter                 = Faraday.default_adapter
end

Получение токена

1. Откройте dev.max.ru
2. Перейдите в раздел Чат-боты → Интеграция
3. Нажмите Получить токен
4. Задайте переменную окружения:

export MAX_BOT_TOKEN="ваш_токен"

Первый запуск

require 'max_bot'

api = Max::Bot::Api.new(ENV.fetch('MAX_BOT_TOKEN'))

# Отправить сообщение в группу
api.send_message('Привет!', chat_id: 123)

# Отправить в личку
api.send_message('Привет!', user_id: 456)

Long polling (для разработки)

api = Max::Bot::Api.new(ENV.fetch('MAX_BOT_TOKEN'))

Max::Bot::Client.new(
  api.token,
  timeout: 30,
  types: %w[message_created],
  logger: Logger.new($stdout)
).run do |update|
  next unless Max::Bot::UpdateHelpers.message_created?(update)

  message = Max::Bot::UpdateHelpers.message_from(update)
  text    = Max::Bot::UpdateHelpers.message_text(message)
  dest    = Max::Bot::UpdateHelpers.message_destination(message)
  next if text.to_s.empty? || dest.nil?

  kind, id = dest
  api.send_message("Echo: #{text}", kind => id)
end

Пример проекта

В репозитории есть готовый пример:

export MAX_BOT_TOKEN="your_token"
bundle exec ruby examples/polling_bot.rb