Мощный API для создания ботов с 50,000+ функциями. Создавайте ботов для автоматизации, игр, платежей и многого другого.
Начните создавать ботов за несколько минут. Все запросы к API выполняются через HTTPS.
Перейдите на страницу /bots и создайте нового бота. Вы получите токен для доступа к API. Токен можно посмотреть, нажав кнопку "Показать токен" (потребуется ввести пароль от аккаунта).
Все запросы к API имеют следующий формат:
https://api.xipher.pro/bot<token>/METHOD_NAME
Важно: Токен вставляется без символов < и >.
Например, если токен abc123, то URL будет: https://api.xipher.pro/botabc123/getMe
import requests
TOKEN = "YOUR_BOT_TOKEN" # Получите токен на странице /bots
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
# Получить информацию о боте
response = requests.get(f"{BASE_URL}/getMe")
bot_info = response.json()
print(bot_info)
# Отправить сообщение
# chat_id - это user_id получателя (UUID строка)
response = requests.post(f"{BASE_URL}/sendMessage", json={
"chat_id": "user-uuid-here", # UUID пользователя
"text": "Привет! 👋"
})
print(response.json())Следующие методы Bot API полностью реализованы и готовы к использованию:
Все запросы к API требуют токен бота в URL. Токен выдается при создании бота на странице /bots. Для просмотра токена нажмите кнопку "Показать токен" и введите пароль от аккаунта.
Проверяет токен бота и возвращает основную информацию о боте.
curl https://api.xipher.pro/bot<token>/getMe{
"ok": true,
"result": {
"id": 123456789,
"is_bot": true,
"first_name": "My Bot",
"username": "mybot",
"can_join_groups": true,
"can_read_all_group_messages": false
}
}Inline keyboard позволяет добавлять кнопки под сообщениями. Кнопки могут отправлять callback_data или открывать URL.
Параметр reply_markup используется в методах sendMessage, sendPhoto и других для добавления кнопок.
{
"inline_keyboard": [
[
{"text": "Кнопка 1", "callback_data": "button1"},
{"text": "Кнопка 2", "callback_data": "button2"}
],
[
{"text": "Открыть сайт", "url": "https://example.com"}
]
]
}import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
# Создать клавиатуру с кнопками
keyboard = {
"inline_keyboard": [
[
{"text": "✅ Да", "callback_data": "yes"},
{"text": "❌ Нет", "callback_data": "no"}
],
[
{"text": "📖 Документация", "url": "https://xipher.pro/api"}
]
]
}
# Отправить сообщение с кнопками
response = requests.post(f"{BASE_URL}/sendMessage", json={
"chat_id": "USER_UUID",
"text": "Хотите продолжить?",
"reply_markup": keyboard
})Есть два способа получения обновлений: Long Polling (getUpdates) и Webhooks.
Получает обновления через Long Polling. Используется для получения новых сообщений, callback query и других событий.
import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
# Получить обновления
response = requests.get(f"{BASE_URL}/getUpdates?offset=0&limit=100&timeout=30")
updates = response.json()
print(updates)Отправка, редактирование и управление сообщениями в чатах.
Отправляет текстовое сообщение в указанный чат.
{"inline_keyboard": [[{"text": "Кнопка", "callback_data": "data"}]]}import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
response = requests.post(f"{BASE_URL}/sendMessage", json={
"chat_id": "user-uuid-here", # UUID пользователя (строка)
"text": "Привет! Это мой первый бот 🤖",
"parse_mode": "HTML"
})
print(response.json())import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
# Отправить сообщение с inline кнопками
response = requests.post(f"{BASE_URL}/sendMessage", json={
"chat_id": "user-uuid-here",
"text": "Выберите действие:",
"reply_markup": {
"inline_keyboard": [
[
{"text": "✅ Принять", "callback_data": "accept"},
{"text": "❌ Отклонить", "callback_data": "reject"}
],
[
{"text": "🌐 Открыть сайт", "url": "https://xipher.pro"}
]
]
}
})
print(response.json())Редактирует текст отправленного сообщения.
Удаляет сообщение из чата.
Пересылает сообщение из одного чата в другой. Сохраняет информацию об исходном отправителе.
Копирует сообщение из одного чата в другой. Не сохраняет информацию об исходном отправителе.
Отправка фотографий, видео, аудио, документов и других медиафайлов.
Отправляет фотографию в чат. Поддерживаются файлы до 10 ГБ.
Отправляет аудиофайл в чат.
Отправляет документ любого формата (до 10 ГБ).
Отправляет видеофайл.
Отправляет голосовое сообщение (OGG Opus).
Создание интерактивных клавиатур и кнопок для взаимодействия с пользователями.
Создает кнопки под сообщением. Кнопки могут открывать URL, отправлять callback или запускать Mini Apps.
import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
keyboard = {
"inline_keyboard": [
[
{"text": "Кнопка 1", "callback_data": "button1"},
{"text": "Кнопка 2", "callback_data": "button2"}
],
[
{"text": "Открыть сайт", "url": "https://example.com"}
]
]
}
requests.post(f"{BASE_URL}/sendMessage", json={
"chat_id": 123456789,
"text": "Выберите действие:",
"reply_markup": keyboard
})Отвечает на нажатие inline-кнопки. Может показать уведомление или открыть URL.
Управление чатами, пользователями и правами доступа.
Банит пользователя в группе или канале.
Назначает пользователя администратором с настраиваемыми правами.
Изменяет название группы или канала.
Закрепляет сообщение в чате.
Интеграция платежей с поддержкой криптовалют (USDT, TON, BTC).
Отправляет счет на оплату в чат.
Создает ссылку на оплату для использования в кнопках или вне мессенджера.
Подтверждает или отклоняет запрос на оплату перед списанием средств.
Получение информации о файлах и управление стикерами.
Получает информацию о файле по его file_id.
Создает новый набор стикеров.
Настройка webhooks для получения обновлений в реальном времени.
Устанавливает URL для получения обновлений через webhook.
import requests
TOKEN = "YOUR_BOT_TOKEN"
BASE_URL = f"https://api.xipher.pro/bot{TOKEN}"
requests.post(f"{BASE_URL}/setWebhook", json={
"url": "https://yourdomain.com/webhook",
"secret_token": "your_secret_token",
"allowed_updates": ["message", "callback_query"]
})Получает информацию о текущем webhook.
Удаляет webhook и переключает бота на Long Polling.
Позволяет пользователям использовать бота в любом чате через @username.
Отвечает на inline-запрос пользователя.
Создание веб-приложений, которые работают внутри мессенджера.
Открывает веб-страницу внутри мессенджера (на весь экран или половину).
Визуальный редактор для создания ботов без написания кода.
Сохраняет сценарий бота, созданный в визуальном редакторе.
{
"nodes": [
{
"id": 1,
"type": "trigger_text",
"data": {"match": "/start"}
},
{
"id": 2,
"type": "send_message",
"data": {"text": "Привет! 👋"}
},
{
"id": 3,
"type": "send_buttons",
"data": {
"buttons": [
{"text": "Кнопка 1", "callback": "action1"},
{"text": "Кнопка 2", "callback": "action2"}
]
}
}
],
"edges": [
{"from": 1, "to": 2},
{"from": 2, "to": 3}
]
}