ИИ-агент, который управляет Telecobra за вас

Как это работает

Три участника: ваш бот, REST API Telecobra и функции сервиса. Вы общаетесь только с ботом.

Что понадобится

• аккаунт Telecobra — telecobra.com/app
• бот: Telegram (раздел 3) или Discord (раздел 4)
• место, где агент живёт: свой VPS (раздел 5) или установщик в одну команду (раздел 2)
• модель ИИ: хаб или нейросеть (раздел 7)
• API-ключ Telecobra (раздел 8)

Быстрый путь: установщик в одну команду

Агент на вашем сервере без ручной установки: одна команда со всеми ключами — дальше всё делает скрипт.

Подготовьте три значения: токен бота из BotFather (раздел 3), API-ключ Telecobra (раздел 8) и ключ модели ИИ (раздел 7). Подключитесь к вашему VPS по SSH и выполните:

curl -fsSL https://telecobra.com/static/hermes/install.sh | bash -s -- \
  --tg "токен_бота_из_BotFather" \
  --tc "ключ_telecobra_из_профиля" \
  --ai-key "ключ_модели" \
  --ai-url "Base_URL_модели" \
  --ai-model "имя_модели"

Что делает скрипт сам: ставит Python и зависимости, скачивает агента с telecobra.com/static/hermes/, записывает ключи в файл с правами 600 и включает системный сервис с автозапуском и автоперезапуском при сбоях.

После установки напишите боту /status — он проверит связь с Telecobra. Команды бота: /status, /help, /commands. Список команд API агент получает из живой спецификации openapi.json.

Создание бота в Telegram

Около 5 минут. Понадобится только Telegram.

1. Откройте официального бота @BotFather — это единственный официальный способ создать бота.
2. Нажмите Start и отправьте команду /newbot.
3. BotFather спросит имя бота — любое, например Telecobra Agent.
4. Затем username — латиницей, обязательно заканчивается на bot, например my_telecobra_agent_bot. Если имя занято — BotFather попросит другое.
5. В ответ придёт сообщение с HTTP API токеном — строка вида 1234567890:AAF... Это ключ управления ботом. Скопируйте и сохраните: он нужен при установке агента (раздел 6 или 2).
6. Рекомендуется: отправьте /setprivacy, выберите вашего бота и включите Disable — так бот будет видеть все сообщения в чатах, а не только команды.
7. Проверка: найдите бота по username в поиске Telegram и нажмите Start — бот появится в списке чатов. Отвечать он начнёт после установки агента.

Создание бота в Discord

Около 10 минут. Нужен аккаунт Discord и свой сервер или права администратора на чужом.

1. Откройте портал разработчиков: discord.com/developers/applications.
2. Нажмите New Application, введите имя (например Telecobra Agent), нажмите Create.
3. Слева выберите раздел Bot: нажмите Reset Token и скопируйте токен бота — он показывается один раз, сразу сохраните. Затем включите переключатель MESSAGE CONTENT INTENT (без него бот не читает текст сообщений) и нажмите Save Changes.
4. Добавьте бота на сервер: слева раздел OAuth2, затем URL Generator. В Scopes отметьте bot; в Bot Permissions — Send Messages, Read Message History, Embed Links.
5. Скопируйте сгенерированную ссылку снизу, откройте её в браузере, выберите сервер и нажмите Authorize.
6. Проверка: бот появился в списке участников сервера. Отвечать начнёт после установки агента.

VPS-сервер: где купить и какой выбрать

VPS нужен, чтобы агент работал круглосуточно, даже когда ваш компьютер выключен. Раздел только для ручного пути и установщика из раздела 2.

Требования

Минимум для агента: 1 vCPU, 1 ГБ RAM (лучше 2 ГБ), 10 ГБ диска, Ubuntu 22.04 или 24.04. Агент лёгкий — достаточно тарифа начального уровня.

Провайдеры с оплатой картами РФ

Зарубежные (могут не принимать карты РФ): Hetzner, DigitalOcean.

Подключение к серверу

После покупки у вас будут IP-адрес, логин root и пароль или SSH-ключ — приходят на почту или в панель провайдера.

ssh root@IP_ВАШЕГО_СЕРВЕРА

Windows: встроенный ssh в PowerShell, либо PuTTY. Первое, что сделать на сервере:

apt update && apt upgrade -y

Установка агента Hermes на VPS

Готовой «программы Hermes», которую можно просто скачать, не существует: агент Hermes собирается из трёх частей — бот (раздел 3 или 4), модель ИИ (раздел 7) и ключ Telecobra API (раздел 8). Ниже — рабочий стартовый шаблон. Хотите без ручных шагов — используйте установщик из раздела 2.

apt install -y python3 python3-pip python3-venv
mkdir -p /opt/hermes && cd /opt/hermes
python3 -m venv venv
source venv/bin/activate
pip install python-telegram-bot requests

nano /opt/hermes/.env

TELEGRAM_BOT_TOKEN=токен_из_BotFather
TELECOBRA_API_KEY=ключ_из_профиля_telecobra
AI_API_KEY=ключ_модели_из_раздела_7
AI_BASE_URL=адрес_из_раздела_7
AI_MODEL=модель_из_раздела_7

import os, requests
from telegram import Update
from telegram.ext import Application, CommandHandler, MessageHandler, filters, ContextTypes

# загружаем .env вручную, без лишних библиотек
for line in open(os.path.join(os.path.dirname(__file__), ".env")):
    if "=" in line and not line.startswith("#"):
        k, v = line.strip().split("=", 1)
        os.environ.setdefault(k, v)

TC = "https://telecobra.com"
HDR = {"X-API-Key": os.environ["TELECOBRA_API_KEY"]}

async def start(update: Update, ctx: ContextTypes.DEFAULT_TYPE):
    await update.message.reply_text("Привет! Я агент Hermes. Напишите /status — проверю связь с Telecobra.")

async def status(update: Update, ctx: ContextTypes.DEFAULT_TYPE):
    r = requests.get(f"{TC}/api/me", headers=HDR, timeout=30)
    p = r.json()
    await update.message.reply_text(f"Telecobra: пользователь {p.get('username')}, подписка до {p.get('subscription_expires')}")

async def on_text(update: Update, ctx: ContextTypes.DEFAULT_TYPE):
    # Здесь подключите свою логику: модель ИИ разбирает фразу
    # и вызывает нужные эндпоинты из https://telecobra.com/openapi.json
    await update.message.reply_text("Команда получена. Логика вызова API добавляется сюда (см. раздел 9 инструкции).")

app = Application.builder().token(os.environ["TELEGRAM_BOT_TOKEN"]).build()
app.add_handler(CommandHandler("start", start))
app.add_handler(CommandHandler("status", status))
app.add_handler(MessageHandler(filters.TEXT & ~filters.COMMAND, on_text))
app.run_polling()

cd /opt/hermes && source venv/bin/activate && python3 bot.py

nano /etc/systemd/system/hermes.service

[Unit]
Description=Hermes agent for Telecobra
After=network.target

[Service]
WorkingDirectory=/opt/hermes
ExecStart=/opt/hermes/venv/bin/python3 /opt/hermes/bot.py
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

systemctl daemon-reload
systemctl enable --now hermes
systemctl status hermes

Выбор и подключение модели ИИ

Telecobra и агент работают с любым провайдером в формате OpenAI-совместимого API: везде три параметра — ключ, Base URL, модель. Провайдеры делятся на два типа.

Три правила

• ключи провайдеров обычно показываются один раз — сразу сохраняйте;
• цены меняются — смотрите на сайте провайдера, не в инструкции;
• Base URL обязан совпадать с провайдером, иначе ИИ будет молчать.

Получение API-ключа Telecobra

Четыре шага в панели.

1. Войдите в панель: telecobra.com/app.
2. Откройте Профиль: telecobra.com/app/profile.
3. Найдите раздел «REST API доступ».
4. Нажмите «Сгенерировать ключ» и сразу сохраните его.

Что важно знать

• ключ даёт доступ только к вашему аккаунту и данным;
• передаётся в заголовке X-API-Key: ключ; работает также Authorization: Bearer ключ;
• базовый URL API: https://telecobra.com;
• проверка ключа: GET https://telecobra.com/api/me вернёт ваш профиль;
• скомпрометировали ключ — там же нажмите «Перегенерировать», старый перестанет работать.

Запуск функций через REST API

Схема у всех функций одинаковая: создать задание, запустить, проверять статус.

Проверить ключ:

curl https://telecobra.com/api/me -H "X-API-Key: ваш_ключ"

Пример — рассылка: список и запуск:

curl https://telecobra.com/api/campaigns -H "X-API-Key: ваш_ключ"
curl -X POST https://telecobra.com/api/campaigns/<id>/start -H "X-API-Key: ваш_ключ"

Пример — нейрокомментинг: создать и запустить:

curl -X POST https://telecobra.com/api/comments \
  -H "X-API-Key: ваш_ключ" -H "Content-Type: application/json" \
  -d '{"name":"Комментинг","channels":"@канал1,@канал2"}'

curl -X POST https://telecobra.com/api/comments/<id>/start -H "X-API-Key: ваш_ключ"

Полный справочник команд

• Swagger UI (интерактивный, открывается в браузере): telecobra.com/openapi.json
• Спецификация JSON — именно её читают агенты: telecobra.com/api/openapi.json
• Страница API: telecobra.com/api/docs

API покрывает: аккаунты, парсинг, нейрокомментинг, автоответчик, прогрев, инвайтинг, рассылки, автопостинг, подписки, масслукинг и массреакции, сторис, мониторинг, аудитории, прокси и другое. Точные тела запросов для каждой функции — в Swagger UI.

Встроенный ИИ в функциях Telecobra

Отдельно от агента: сами функции сервиса — Автоответчик, Нейрокомментинг, Прогрев, Монитор диалогов — умеют генерировать тексты через вашего AI-провайдера из раздела 7.

Настройка: Профиль, раздел «AI провайдеры».

1. Нажмите кнопку-пресет — поля заполнятся сами. Готовые пресеты: DeepSeek, OpenAI, OpenRouter, Groq, Mistral, GLM5.
2. Вставьте ваш ключ в поле API ключ.
3. Для провайдеров вне пресетов (Grok, MiniMax, Qwen, Gemini и др.) введите Base URL и модель вручную из таблицы раздела 7.
4. Нажмите «Сохранить».

Подробный гайд по встроенному ИИ: telecobra.com/app/hermes-guide.

Ошибки и поддержка

ИИ молчит? Проверьте баланс у провайдера и что Base URL совпадает с провайдером. Бот не отвечает? На VPS выполните systemctl status hermes и journalctl -u hermes -n 50.

Поддержка

• t.me/cybercobraonline2
• t.me/cybercobraonline3