maxapigo

Подключение

go get github.com/kebrick/maxapigo

Конфигурация клиента

client, err := maxapi.NewClient(maxapi.Config{
 Token: "<BOT_TOKEN>", // токен бота из раздела «Интеграция» → «Получить токен»
 Logger: maxapi.NewStdLogger(nil), // опционально: логирование запросов
 Debug: true, // подробные логи (метод, URL, статус, тело ответа)
})

Получение информации о боте

ctx := context.Background()
me, err := client.Bots().Me(ctx)
if err != nil {
 log.Fatal(err)
}
log.Printf("Bot: %s (id=%d)", me.Name, me.UserID)

Отправка сообщения

msg, err := client.Messages().SendToChat(ctx, 123456,
 maxapi.NewMessageBody{
 Text: "Привет из Go!",
 Format: "markdown",
 })
if err != nil {
 log.Fatal(err)
}
log.Printf("sent at %d, text=%q", msg.Timestamp, msg.Text())

Long polling (GET /updates)

// Router с автоподдержкой упоминаний бота (@username /start).
router := maxapi.NewRouterForClient(ctx, client)
// Реакция на команду /start.
router.HandleCommand("/start", func(ctx context.Context, msg *maxapi.Message) error {
 _, err := client.Messages().SendToChat(ctx, msg.Recipient.ChatID,
 maxapi.NewMessageBody{
 Text: "Привет! Я бот на Go для MAX.",
 Format: "markdown",
 })
 return err
})
// Реакция на смайлик 😀 в сообщении.
router.HandleEmoji("😀", func(ctx context.Context, msg *maxapi.Message) error {
 _, err := client.Messages().SendToChat(ctx, msg.Recipient.ChatID,
 maxapi.NewMessageBody{
 Text: "Вижу хороший настрой! 😀",
 Format: "markdown",
 })
 return err
})
poller := maxapi.NewLongPoller(client, router.HandleUpdate, maxapi.LongPollerConfig{})
if err := poller.Run(ctx); err != nil {
 log.Fatal(err)
}

Маршрутизация сообщений (Router)

// Router с автоподдержкой упоминаний бота (@username /start).
router := maxapi.NewRouterForClient(ctx, client)
// Хендлер для конкретной команды.
router.HandleCommand("/start", startHandler)
// Хендлер для смайлика.
router.HandleEmoji("🔥", fireHandler)
// Хендлер по типу обновления (например, message_created).
router.HandleUpdateType("message_created", func(ctx context.Context, upd maxapi.Update) error {
 // общий лог/метрика по всем новым сообщениям
 return nil
})
// Хендлер по умолчанию — срабатывает, если ни одна команда/смайлик не подошли.
router.HandleDefaultMessage(func(ctx context.Context, msg *maxapi.Message) error {
 _, err := client.Messages().SendToChat(ctx, msg.Recipient.ChatID,
 maxapi.NewMessageBody{
 Text: "Я пока не знаю эту команду. Напишите /start.",
 })
 return err
})

Примеры

Подробная документация