Uma Uma Developer Portal

Мои боты

Создавайте и управляйте своими ботами

0 / 3 ботов

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

Руководство по созданию ботов для Uma

Быстрый старт

  1. Создайте бота в разделе "Мои боты"
  2. Скопируйте токен вашего бота
  3. Установите Webhook URL для получения обновлений
  4. Используйте Bot API для отправки сообщений

Webhook

Когда пользователь отправляет сообщение вашему боту, Uma отправит POST-запрос на ваш Webhook URL с данными в формате:

{
  "update_id": 123456789,
  "message": {
    "message_id": "abc123",
    "from": {
      "id": "user_id",
      "is_bot": false,
      "first_name": "Имя",
      "username": "username"
    },
    "chat": {
      "id": "chat_id",
      "type": "private"
    },
    "date": 1704067200,
    "text": "Текст сообщения"
  }
}

Формат токена

Токен бота имеет формат: BOT_ID:RANDOM_HASH

Пример: 507f1f77bcf86cd799439011:a1b2c3d4e5f6...

Совместимость с pyTeleBot

Uma Bot API совместим с библиотекой pyTeleBot. Для миграции измените API URL:

import telebot

# Укажите ваш сервер Uma
API_URL = "https://your-uma-server.com/bot{token}/{method}"

bot = telebot.TeleBot(
    "YOUR_BOT_TOKEN",
    api_url=API_URL
)

API Reference

Полный список методов Uma Bot API

GET /bot<TOKEN>/getMe

Проверка токена и получение информации о боте.

Ответ:

{
  "ok": true,
  "result": {
    "id": "bot_id",
    "is_bot": true,
    "first_name": "Bot Name",
    "username": "mybotbot"
  }
}
POST /bot<TOKEN>/sendMessage

Отправка текстового сообщения пользователю.

Параметры:

chat_idstringID чата или пользователя
textstringТекст сообщения
parse_modestringОпционально: "Markdown" или "HTML"
reply_to_message_idstringОпционально: ID сообщения для ответа
POST /bot<TOKEN>/setWebhook

Установка URL для получения обновлений.

Параметры:

urlstringHTTPS URL для webhook
secret_tokenstringОпционально: секретный токен для проверки
POST /bot<TOKEN>/deleteWebhook

Удаление webhook.

GET /bot<TOKEN>/getWebhookInfo

Получение информации о текущем webhook.