Max бот - как создать

max-bot/
-- Корневая директория проекта
|
+-- src/                    -- Исходный код бота
|   +-- index.js           -- Точка входа приложения
|   +-- bot.js             -- Основная логика бота
|   +-- config.js          -- Конфигурация и переменные
|   |
|   +-- handlers/          -- Обработчики событий
|   |   +-- message.js     -- Обработка сообщений
|   |   +-- callback.js    -- Обработка нажатий кнопок
|   |   +-- command.js     -- Обработка команд
|   |
|   +-- keyboards/         -- Шаблоны клавиатур
|   |   +-- main.js        -- Главное меню
|   |   +-- inline.js      -- Inline-клавиатуры
|   |
|   +-- services/          -- Внешние сервисы
|   |   +-- api.js         -- Запросы к API MAX
|   |   +-- database.js    -- Работа с базой данных
|   |
|   +-- utils/             -- Вспомогательные функции
|       +-- helpers.js     -- Утилиты и хелперы
|       +-- logger.js      -- Логирование
|
+-- .env                   -- Переменные окружения (токен)
+-- .gitignore             -- Исключения для Git
+-- package.json           -- Зависимости проекта
+-- README.md              -- Документация

// Пример GET-запроса к API MAX
const response = await fetch('https://platform-api.max.ru/me', {
    method: 'GET',
    headers: {
        // Токен передаётся в заголовке Authorization
        'Authorization': process.env.BOT_TOKEN,
        'Content-Type': 'application/json'
    }
});
const botInfo = await response.json();

{
    "user_id": 1,           // Уникальный ID бота
    "name": "My Bot",        // Отображаемое имя
    "username": "my_bot",    // Ник бота
    "is_bot": true,          // Флаг: это бот
    "last_activity_time": 1737500130100
}

// Формирование сообщения с inline-клавиатурой
const messageWithKeyboard = {
    text: "Выберите действие:",
    attachments: [
        {
            type: "inline_keyboard",
            payload: {
                // Двумерный массив: ряды и кнопки
                buttons: [
                    [
                        // Первый ряд — две callback-кнопки
                        {
                            type: "callback",
                            text: "Информация",
                            payload: "action_info"
                        },
                        {
                            type: "callback",
                            text: "Настройки",
                            payload: "action_settings"
                        }
                    ],
                    [
                        // Второй ряд — кнопка-ссылка
                        {
                            type: "link",
                            text: "Открыть сайт",
                            url: "https://max.ru"
                        }
                    ]
                ]
            }
        }
    ]
};

// Обработчик callback-событий от кнопок
export function handleCallback(event) {
    const { payload, user, chat_id } = event;
    
    // Определяем действие по payload кнопки
    switch (payload) {
        case 'action_info':
            sendInfoMessage(chat_id);
            break;
        case 'action_settings':
            showSettings(chat_id, user);
            break;
        default:
            sendDefaultResponse(chat_id);
    }
}

const API_URL = 'https://platform-api.max.ru';
const TOKEN = process.env.BOT_TOKEN;

// Функция получения обновлений через Long Polling
async function getUpdates(offset = 0) {
    const response = await fetch(
        `${API_URL}/updates?offset=${offset}&timeout=30`,
        {
            headers: { 'Authorization': TOKEN }
        }
    );
    return response.json();
}

// Основной цикл опроса сервера
async function startPolling() {
    let offset = 0;
    while (true) {
        const updates = await getUpdates(offset);
        for (const update of updates) {
            processUpdate(update);
            offset = update.update_id + 1;
        }
    }
}

import express from 'express';

const app = express();
app.use(express.json());

// Эндпоинт для приёма webhook-событий
app.post('/webhook', (req, res) => {
    const update = req.body;
    // Обрабатываем входящее событие
    processUpdate(update);
    // Отвечаем серверу MAX статусом 200
    res.sendStatus(200);
});

// Запуск HTTPS-сервера на порту 443
app.listen(443);

// Отправка сообщения с Markdown-разметкой
const formattedMessage = {
    text: `**Добро пожаловать!**
    
Это _ваш персональный_ бот-помощник.

Доступные команды:
• \`/start\` — начать работу
• \`/help\` — справка
• \`/settings\` — настройки

[Подробнее на сайте](https://max.ru)`,
    // Указываем формат разметки
    format: "markdown"
};

// Markdown: упоминание пользователя
const mentionMd = {
    text: "[Иван Иванов](max://user/123456)",
    format: "markdown"
};

// HTML: упоминание пользователя
const mentionHtml = {
    text: '<a href="max://user/123456">Иван Иванов</a>',
    format: "html"
};

# Установка через npm
npm i @maxhub/max-ui

# Или через yarn
yarn add @maxhub/max-ui

# Или через pnpm
pnpm add @maxhub/max-ui

import { createRoot } from 'react-dom/client';
// Импортируем провайдер MAX UI
import { MaxUI } from '@maxhub/max-ui';
// Подключаем стили библиотеки
import '@maxhub/max-ui/dist/styles.css';
import App from './App.jsx';

// Оборачиваем приложение в провайдер
const Root = () => (
    <MaxUI>
        <App />
    </MaxUI>
);

createRoot(document.getElementById('root')).render(<Root />);

import { 
    Panel, 
    Grid, 
    Container, 
    Flex, 
    Avatar, 
    Typography 
} from '@maxhub/max-ui';

const App = () => (
    // Panel — контейнер с фоном
    <Panel mode="secondary">
        // Grid — сетка для размещения
        <Grid gap={12} cols={1}>
            <Container>
                // Flex — гибкий контейнер
                <Flex direction="column" align="center">
                    // Avatar — аватар пользователя
                    <Avatar.Container size={72} form="squircle">
                        <Avatar.Image src="avatar.jpg" />
                    </Avatar.Container>
                    <Typography.Title>Иван Иванов</Typography.Title>
                </Flex>
            </Container>
        </Grid>
    </Panel>
);

export default App;

import { Link } from 'react-router-dom';
import { Button } from '@maxhub/max-ui';

// Кнопка, которая работает как ссылка роутера
const NavigationButton = () => (
    <Button asChild>
        // Link получит все стили Button
        <Link to="/dashboard">
            Перейти в панель управления
        </Link>
    </Button>
);

/* Глобальное переопределение цветов */
:root {
    --max-ui-primary: #6366f1;
    --max-ui-background: #f8fafc;
}

/* Переопределение для конкретного компонента */
.custom-button {
    --button-bg: #10b981;
    --button-text: #ffffff;
}

import { Button } from '@maxhub/max-ui';
import { IconSettings } from './icons';

// Кастомизация внутренних элементов кнопки
const CustomButton = () => (
    <Button
        iconBefore={<IconSettings />}
        // Добавляем классы внутренним элементам
        innerClassNames={{
            iconBefore: 'custom-icon-style',
            content: 'custom-text-style'
        }}
    >
        Настройки
    </Button>
);

// Простой логгер для отладки бота
const LOG_LEVELS = {
    INFO: 'INFO',
    WARN: 'WARN',
    ERROR: 'ERROR'
};

export function log(level, message, data = {}) {
    const timestamp = new Date().toISOString();
    console.log(JSON.stringify({
        timestamp,
        level,
        message,
        ...data
    }));
}

// Использование в обработчике
export function processUpdate(update) {
    log(LOG_LEVELS.INFO, 'Получено обновление', { 
        update_id: update.update_id 
    });
}

// Обёртка для запросов с обработкой ошибок
async function apiRequest(endpoint, options = {}) {
    const url = `https://platform-api.max.ru${endpoint}`;
    
    try {
        const response = await fetch(url, {
            ...options,
            headers: {
                'Authorization': process.env.BOT_TOKEN,
                'Content-Type': 'application/json',
                ...options.headers
            }
        });

        // Проверяем статус ответа
        if (!response.ok) {
            const error = await response.json();
            throw new Error(`API Error: ${error.message}`);
        }

        return response.json();
    } catch (err) {
        log('ERROR', err.message);
        throw err;
    }
}