REST API v1.0 LIVE

Нейрокомментинг и автоответчик
через REST API

Управляйте нейрокомментингом, автоответчиком и AI-настройками через REST API. Создавайте задания, запускайте AI-воркеры, получайте статус и логи — полностью программно.

Содержание

01. Аутентификация

Все запросы к API требуют API-ключ. Ключ генерируется автоматически при первом обращении к API и доступен в панели управления.

01
Перейдите в Настройки → API — скопируйте ваш ключ
02
Передавайте ключ в заголовке X-API-Key: <ключ> или Authorization: Bearer <ключ>
03
Проверьте ключ запросом GET /api/me — вернёт ваш профиль
API-ключ — это 64-символьная hex-строка. Храните его в безопасности. Ключ даёт полный доступ к вашему аккаунту.

02. Профиль и AI-настройки

Базовый URL: https://telecobra.com

GET /api/me Профиль пользователя
curl
curl https://telecobra.com/api/me \
  -H "X-API-Key: e3b0c44298fc1c149afbf4c8996fb924..."
JSON
{
  "id": 151,
  "username": "DimasHEL51",
  "role": "user",
  "is_active": true,
  "ai_model": "deepseek-chat",
  "ai_base_url": "https://api.deepseek.com/v1",
  "ai_api_key_set": true,
  "api_key": "e3b0c44298fc1c149afbf4c8996fb924...",
  "subscription_expires": "2026-08-01T00:00:00"
}
PATCH /api/me Обновить AI-настройки

Настройте ваш AI-провайдер: API-ключ, базовый URL и модель.

ai_api_key
API-ключ вашего AI-провайдера (DeepSeek, OpenAI, Together.ai) (строка)
ai_base_url
Базовый URL OpenAI-compatible API (по умолчанию: https://api.openai.com/v1)
ai_model
Модель: deepseek-chat, gpt-4o-mini, claude-3.5-sonnet и др. (строка)
curl
curl -X PATCH https://telecobra.com/api/me \
  -H "X-API-Key: e3b0c44298fc..." \
  -H "Content-Type: application/json" \
  -d '{
    "ai_api_key": "sk-deepseek-xxxxxxxxxxxxxxxx",
    "ai_base_url": "https://api.deepseek.com/v1",
    "ai_model": "deepseek-chat"
  }'
Как работает AI в Telecobra: вы указываете свой ключ и модель через PATCH /api/me. При запуске нейрокомментинга или автоответчика система использует ваш ключ для генерации комментариев через стандартный OpenAI-совместимый API (/chat/completions). Telecobra не хранит и не использует свой ключ — всё через ваш.

03. Нейрокомментинг

Создание, запуск и мониторинг AI-комментинга. Воркер читает посты в указанных каналах и генерирует комментарии через ваш AI-провайдер.

Создать задание

POST /api/comments Создать задание нейрокомментинга
name
Название задания (строка, по умолчанию «Комментинг»)
channels
Список каналов (через запятую или перенос строки) (обязательно)
account_ids
ID аккаунтов через запятую (пусто = все активные)
ai_prompt
Системный промпт для AI (строка, опционально)
posts_per_run
Постов за один запуск (число, по умолчанию 5)
delay_min / delay_max
Задержка между комментариями в секундах (число, по умолчанию 30–120)
daily_limit
Дневной лимит комментариев (число, по умолчанию 50)
curl
curl -X POST https://telecobra.com/api/comments \
  -H "X-API-Key: e3b0c44298fc..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Крипто-комментинг",
    "channels": "@crypto_news,@defi_pulse",
    "account_ids": "405,421,422",
    "ai_prompt": "Ты криптоэнтузиаст. Пиши коротко, со знанием дела.",
    "posts_per_run": 10,
    "delay_min": 60,
    "delay_max": 180
  }'
Ответ
JSON
{"id": 46, "name": "Крипто-комментинг", "status": "draft"}

Управление заданием

МетодURLОписание
GET/api/commentsСписок всех заданий
POST/api/comments/<id>/startЗапустить воркер
POST/api/comments/<id>/stopОстановить воркер
GET/api/comments/<id>/statusСтатус: commented, errors, log
DELETE/api/comments/<id>Удалить задание
curl
# Запустить
curl -X POST https://telecobra.com/api/comments/46/start \
  -H "X-API-Key: e3b0c44298fc..."

# Проверить статус
curl https://telecobra.com/api/comments/46/status \
  -H "X-API-Key: e3b0c44298fc..."
Воркер нейрокомментинга запускается в фоновом потоке. Он читает посты из указанных каналов, генерирует AI-комментарии через ваш ключ, и отправляет их с указанных аккаунтов. Статус обновляется в реальном времени.

04. Автоответчик

AI-автоответчик для Telegram. Создавайте правила, которые автоматически отвечают на входящие сообщения — по шаблону или через AI с историей диалога.

Создать правило

POST /api/autoreply Создать правило автоответчика
name
Название правила (строка)
account_ids
ID аккаунтов через запятую (пусто = все)
keywords
Ключевые слова-триггеры (по одному на строку) (пусто = все сообщения)
reply_mode
template — шаблонный ответ, ai — AI с историей диалога
reply_text
Текст ответа (для режима template) (строка)
ai_prompt
Системный промпт для AI (строка)
goal / goal_link
Целевое действие и ссылка (строка)
max_turns
Максимум сообщений в диалоге (число, по умолчанию 10)
is_active
Активировать сразу (bool, по умолчанию false)
curl
curl -X POST https://telecobra.com/api/autoreply \
  -H "X-API-Key: e3b0c44298fc..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "AI-консультант",
    "account_ids": "405,421",
    "keywords": "цена\nстоимость\nпрайс",
    "reply_mode": "ai",
    "ai_prompt": "Ты менеджер по продажам. Отвечай вежливо, предлагай скидку 10%.",
    "goal": "Запись на консультацию",
    "goal_link": "https://t.me/manager_bot",
    "max_turns": 15,
    "is_active": true
  }'

Управление правилами

МетодURLОписание
GET/api/autoreplyСписок всех правил
GET/api/autoreply/<id>Детали правила
PATCH/api/autoreply/<id>Обновить параметры
POST/api/autoreply/<id>/toggleВкл/выкл ({"active": true})
GET/api/autoreply/<id>/logЛог ответов
GET/api/autoreply/<id>/conversationsИстория диалогов
DELETE/api/autoreply/<id>Удалить правило
Автоответчик работает циклически: раз в ~30 секунд бот проверяет новые сообщения и отвечает по активным правилам. В режиме ai ведётся полная история диалога с каждым контактом — AI «помнит» контекст переписки.

05. Примеры интеграции

Python — полный цикл нейрокомментинга

Python
import requests
import time

BASE = "https://telecobra.com"
KEY  = "e3b0c44298fc1c149afbf4c8996fb924..."
HDR  = {"X-API-Key": KEY, "Content-Type": "application/json"}

# 1. Настроить AI-провайдера
requests.patch(f"{BASE}/api/me", headers=HDR, json={
    "ai_api_key": "sk-deepseek-xxx",
    "ai_base_url": "https://api.deepseek.com/v1",
    "ai_model": "deepseek-chat"
})

# 2. Создать задание
r = requests.post(f"{BASE}/api/comments", headers=HDR, json={
    "name": "Автокомментинг",
    "channels": "@crypto_news,@defi_pulse",
    "ai_prompt": "Ты криптоэнтузиаст. Пиши коротко.",
    "posts_per_run": 10
})
job_id = r.json()["id"]
print(f"Job #{job_id} created")

# 3. Запустить
requests.post(f"{BASE}/api/comments/{job_id}/start", headers=HDR)

# 4. Мониторить
while True:
    s = requests.get(f"{BASE}/api/comments/{job_id}/status", headers=HDR).json()
    print(f"  commented={s['commented']}, errors={s['errors']}")
    if s['status'] != 'running': break
    time.sleep(30)

Python — создать и включить автоответчик

Python
import requests

BASE = "https://telecobra.com"
KEY  = "e3b0c44298fc1c149afbf4c8996fb924..."
HDR  = {"X-API-Key": KEY, "Content-Type": "application/json"}

# Создать правило
r = requests.post(f"{BASE}/api/autoreply", headers=HDR, json={
    "name": "AI-поддержка",
    "account_ids": "405,421",
    "reply_mode": "ai",
    "ai_prompt": "Ты сотрудник поддержки. Вежливый, полезный.",
    "is_active": True
})
rule_id = r.json()["id"]

# Проверить диалоги через 10 минут
import time; time.sleep(600)
convs = requests.get(
    f"{BASE}/api/autoreply/{rule_id}/conversations", headers=HDR
).json()
print(f"Диалогов: {len(convs)}")

06. Коды ошибок

HTTPСообщениеПричина
401API key requiredНе передан X-API-Key
403Invalid API keyКлюч не найден в базе
403Account inactiveАккаунт деактивирован
403Subscription expiredПодписка истекла
400channels is requiredНе указаны каналы для комментинга
404Not FoundЗадание/правило не найдено
409Already runningЗадание уже запущено
503БД временно занятаПовторите через несколько секунд