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

Мануалы и FAQ
TeleCobra

Основания рекомендаций. Директивы ожидания и типы ошибок описаны в документации Telegram. Практические разборы: отправка и ошибки, участники и комментаторы, автоответчик. Проверено 15 сентября 2026 года.

Пошаговые инструкции по каждой функции, ответы на частые вопросы и пояснения к настройкам и ограничениям.

Быстрый старт
Настройте платформу за 5 шагов

Чтобы начать работу с TeleCobra, выполните следующие шаги по порядку. Пропуск любого из них приведёт к ошибкам на следующих этапах.

1
Добавьте прокси
Перейдите в ПроксиДобавить прокси. Вставьте SOCKS5 в формате socks5://user:pass@host:port. Ротируемые мобильные прокси не работают с Telegram через сервер.
2
Добавьте Telegram-аккаунты
Перейдите в АккаунтыДобавить аккаунт. Введите номер телефона в формате +7XXXXXXXXXX и подтвердите SMS-код. После добавления назначьте каждому аккаунту прокси.
3
Прогрейте аккаунты
Проверьте доступ аккаунта, состояние сессии и выбранный сценарий. Раздел Прогрев описывает набор действий; длительность его работы не гарантирует отсутствие ограничений Telegram.
4
Соберите аудиторию
Перейдите в Парсинг, вставьте ссылку на канал или группу, запустите парсинг. Результаты сохраняются в Базы пользователей.
5
Запустите рассылку
Перейдите в ОповещениеНовая кампания. Выберите аудиторию, напишите текст, настройте задержки и запустите. Выбранная задержка организует выполнение, но не гарантирует отсутствие ограничений. Учитывайте фактические ответы Telegram.
Совет: Включите ИИ-автоответчик сразу после запуска рассылки. Пока сообщения доставляются, ИИ уже ведёт диалоги с теми, кто ответил — это максимизирует конверсию.
Аккаунты
Управление Telegram-аккаунтами

TeleCobra работает через реальные Telegram-аккаунты по протоколу MTProto — не через Bot API. Это даёт доступ ко всем функциям, недоступным ботам.

Добавление аккаунта

1
Перейдите в Аккаунты → Добавить
Введите номер телефона в формате +7XXXXXXXXXX. Убедитесь, что у вас есть доступ к этому номеру для получения кода.
2
Введите код из Telegram
Telegram пришлёт код в приложение (или SMS). Введите его в течение 5 минут. Если аккаунт с двухфакторной аутентификацией — введите пароль.
3
Назначьте прокси
После добавления нажмите Назначить прокси или используйте Авто-назначить для всех аккаунтов сразу. Без прокси аккаунт не будет работать.

Параметры аккаунта

ПараметрОписание
Статусactive — готов к работе, banned — заблокирован Telegram, flood — временное ограничение
ПроксиПодключение для этого аккаунта. Совместимость и доступность проверяются отдельно; число аккаунтов на адрес не является гарантией отсутствия ограничений
Отправлено сегодняСчётчик сообщений за сутки. Telegram ограничивает ~40–50 новых диалогов в день
FingerprintПараметры клиента (модель, язык). Сами по себе не подтверждают снижение риска ограничений
Важно: Не запускайте один аккаунт одновременно в нескольких функциях. Это приводит к ошибкам сессии и возможной блокировке.
Прокси
Настройка и проверка прокси

Для сценариев платформы настройте поддерживаемое подключение и проверьте доступность Telegram с сервера. Доступ зависит от провайдера, маршрута, авторизации и конфигурации; общего запрета всех серверных IP из этого не следует.

Поддерживаемые форматы

socks5://user:pass@host:1080
http://user:pass@host:8080
host:port:user:pass
host:port

Как проверить совместимость

ПараметрЧто проверить
Протокол и авторизацияСоответствие формата подключения и учётных данных
Подключение с сервераУсловия провайдера и разрешённые источники подключения
Маршрут до TelegramРезультат штатной проверки и точная ошибка
СтабильностьПовторяемость соединения в вашем сценарии

Проверка прокси

Используйте штатную проверку прокси и прочитайте результат по доступным направлениям. FAIL означает неуспех этой проверки; причина может быть в авторизации, маршруте, адресе, провайдере или конфигурации. Один статус не определяет виновную сторону.

Используйте папки прокси для организации: например, «RU мобильные», «EU статические». Это упрощает назначение аккаунтам по гео.
Парсинг аудитории
Сбор участников из каналов и групп

Парсинг собирает список участников из Telegram-каналов и групп. Результат сохраняется в базу пользователей для использования в рассылках и инвайтинге.

Автоопределение режима

Система автоматически определяет тип источника:

  • Канал → собирает комментаторов из раздела комментариев
  • Группа / чат → собирает список участников, затем тех, кто писал

Пошаговый запуск

1
Перейдите в Парсинг
Выберите режим ввода: Один канал или Список (несколько сразу, по одному на строку).
2
Вставьте ссылку(и)
Форматы: @username, https://t.me/channel, https://t.me/c/1234567890. Приватные каналы: аккаунт должен быть участником.
3
Выберите аккаунт и запустите
Система автоматически подберёт доступный аккаунт. Для крупных групп (10 000+ участников) парсинг занимает несколько минут.
4
Сохраните в базу
После завершения нажмите Сохранить в базу. База появится в разделе Базы пользователей.
Для парсинга нескольких каналов используйте режим «Список» — все результаты объединяются в одну базу. Дубли автоматически удаляются при объединении через Инструменты → Объединить базы.
Чек номеров
Проверка телефонных номеров в Telegram

Инструмент принимает список телефонных номеров и определяет, зарегистрированы ли они в Telegram. Показывает username, имя, Telegram ID и наличие Premium.

Поддерживаемые форматы

+79001234567
79001234567
89001234567
9001234567

Все форматы автоматически нормализуются в +7XXXXXXXXXX.

Запуск

1
Вставьте список номеров
По одному на строку. Максимум зависит от количества аккаунтов — каждый аккаунт обрабатывает свою часть.
2
Выберите аккаунты
Чем больше аккаунтов — тем быстрее проверка. Рекомендуется не более 100 номеров на аккаунт за сессию.
3
Запустите и экспортируйте
После завершения скачайте CSV с результатами: номер, username, имя, Telegram ID, Premium-статус.
Некоторые пользователи скрывают номер телефона в настройках приватности. Для них используется резервный метод через ResolvePhoneRequest, но результат может быть неполным.
Инструменты баз NEW
Объединение, вычитание, определение пола

Расширенные операции с базами пользователей. Доступны через кнопку Инструменты в разделе Базы пользователей.

Объединить базы

Создаёт новую базу из нескольких существующих. Дублирующиеся записи (по Telegram ID или username) автоматически исключаются.

  1. Нажмите Инструменты → Объединить базы
  2. Отметьте галочками нужные базы (минимум 2)
  3. Введите название новой базы
  4. Нажмите Объединить

Вычесть базу

Убирает из базы А всех пользователей, которые присутствуют в базе Б. Используется для исключения уже охваченной аудитории.

Пример применения: вы уже рассылали по базе «Клиенты» — вычтите её из базы «Лиды» перед следующей кампанией, чтобы не спамить по одним и тем же.

Определить пол

Анализирует имена участников базы и определяет пол (М/Ж) по базе русских имён и морфологическим признакам. Результат записывается в поле gender каждого участника.

Рассылки (Оповещение)
Массовые сообщения по базе пользователей

Рассылки отправляют личные сообщения участникам из выбранной базы. Каждый получает сообщение от лица одного из ваших аккаунтов.

Создание кампании

1
Выберите аудиторию
Выберите из созданных баз. Рекомендуется использовать аудитории из тематически релевантных источников.
2
Напишите текст
Поддерживается HTML-форматирование (<b>, <i>, <a href="...">) и спинтаксис ({вариант1|вариант2}).
3
Настройте задержки
Задайте задержки и объём под задачу, затем учитывайте фактический ответ Telegram. Универсальной подтверждённой безопасной квоты нет. При требовании ожидания не повторяйте действие до его окончания.
4
Выберите аккаунты и запустите
Нагрузка автоматически распределяется между выбранными аккаунтами. Каждый аккаунт работает через свой прокси.

Параметры кампании

ПараметрРекомендация
delay_min / delay_maxНижняя и верхняя граница паузы между действиями. Настройка не гарантирует отсутствие ограничений; учитывайте FLOOD_WAIT из ответа Telegram
limit_per_hourОграничение объёма в настройках кампании. Это не универсальная квота Telegram
post_per_acc_limitМаксимум сообщений с одного аккаунта в рамках настройки задачи; не гарантия безопасного дневного объёма
Фильтр PremiumОтбор по признаку Premium. Активность, интерес и вероятность отказа этим признаком не подтверждаются
Фильтр с usernameОтбор по наличию username. Наличие поля не подтверждает прочтение или интерес к сообщению
Спинтаксис: используйте {Привет|Здравствуйте|Добрый день} в начале сообщения — выбирается один из вариантов. Варианты могут повторяться; снижение жалоб требует собственных измерений.
Telegram считает аккаунт спамером если за сутки он начинает слишком много новых диалогов. Используйте разные аккаунты и не превышайте 30 новых диалогов в день на один аккаунт.
ИИ-Автоответчик AI
Автоматические ответы с ИИ-диалогом

Автоответчик отвечает на входящие сообщения от лица ваших аккаунтов. Режим ИИ поддерживает полноценный диалог, ведёт пользователя к целевому действию и фиксирует конверсию.

Режимы работы

  • Шаблон — статичный ответ или спинтаксис. Быстро, предсказуемо
  • ИИ-диалог — GPT/Claude ведёт переписку по вашему системному промту. Понимает контекст, отвечает естественно

Настройка ИИ-правила

1
Перейдите в Автоответчик → Создать правило
Выберите режим ИИ, укажите аккаунты для работы.
2
Напишите системный промт
Опишите роль ИИ: «Ты менеджер по продажам курса по трейдингу. Отвечай дружелюбно, выясняй потребность и предлагай демо-урок. Цель — записать на бесплатный вебинар.»
3
Укажите целевое действие
Поле Цель — описание конверсии (например, «перейти по ссылке на регистрацию»). Поле Ссылка CTA — URL, который ИИ отправит при достижении цели.
4
Установите лимит диалога
Макс. реплик — сколько сообщений ИИ отправит в одном диалоге (рекомендуется 5–10). После лимита диалог завершается.
Лучшая практика: Запустите рассылку + включите автоответчик на те же аккаунты. Пока рассылка доставляет сообщения, автоответчик уже обрабатывает первые ответы — конверсия растёт в 2–3 раза.
Автопостинг NEW
Публикация в каналы и чаты

Автопостинг публикует сообщения в указанные каналы и группы от лица ваших аккаунтов. Поддерживает спинтаксис — вариант текста выбирается из подготовленных; разные каналы могут получить одинаковый вариант.

Запуск

  1. Перейдите в Автопостинг → Новое задание
  2. Вставьте список каналов/чатов (по одному на строку)
  3. Напишите текст. Используйте {вариант1|вариант2} для уникальности
  4. Опционально укажите URL изображения
  5. Настройте задержку между постами (рекомендуется 5–15 сек)
  6. Нажмите Запустить
Аккаунт должен быть участником канала или иметь права публикации. Для публичных каналов нужно быть админом.
Нейрокомментинг AI
Комментарии к постам в каналах

Инструмент автоматически оставляет комментарии к новым постам в указанных каналах. ИИ генерирует естественные, тематические комментарии.

Настройка

  1. Перейдите в Нейрокомментинг → Создать задачу
  2. Укажите каналы для мониторинга (аккаунт должен быть подписан)
  3. Настройте системный промт для ИИ: опишите стиль и тему комментариев
  4. Установите задержку (рекомендуется 30–120 сек после публикации поста)
  5. Запустите задачу
Используйте промт: «Ты эксперт в [вашей теме]. Пиши короткие (1–2 предложения), полезные и вовлекающие комментарии. Иногда задавай вопрос автору.»
Прогрев аккаунтов
Имитация живой активности для новых аккаунтов

Раздел «Прогрев» объединяет действия аккаунта по выбранному сценарию. Показатель «доверия» здесь не измеряется; наличие таких действий не доказывает рост доступных лимитов.

Что делает прогрев

  • Вступает в каналы и группы из вашего списка
  • Читает сообщения (имитирует чтение)
  • Ставит реакции на посты
  • Просматривает истории
  • Пишет ИИ-комментарии (если указан AI-ключ)

Что проверить перед использованием

ПроверкаКритерий
Доступ к аккаунтуДействующая авторизация и понятное происхождение сессии
СценарийДействия соответствуют задаче и правилам сообщества
Ответ TelegramОшибки и обязательное ожидание учтены до повтора
Оценивайте фактическое состояние аккаунта и ответы Telegram. История активности и выбранное число дней не гарантируют отсутствие ограничений или доставку сообщений.
Масслукинг
Массовый просмотр историй пользователей

Аккаунты просматривают истории (stories) пользователей из вашей базы. Пользователи видят, кто смотрел их истории, и могут перейти на ваш профиль — это бесплатный трафик без прямого сообщения.

Запуск

  1. Перейдите в Масслукинг → Создать задачу
  2. Выберите базу пользователей (из раздела Базы пользователей)
  3. Выберите аккаунты, которые будут «смотреть» истории
  4. Настройте задержку между просмотрами (3–10 сек)
  5. Запустите задачу
Работает только с пользователями, у которых настроена публичная история. Пользователи без историй пропускаются.
Массовые реакции
Накрутка реакций на посты в каналах

Автоматически расставляет реакции на посты в указанных каналах от лица ваших аккаунтов. Повышает видимость контента и engagement.

Параметры

ПараметрОписание
Канал@username или ссылка на канал. Аккаунты должны быть подписаны
Тип реакцииВыберите эмодзи-реакцию или «случайная»
Последние N постовРеагировать на последние N публикаций канала
ЗадержкаРекомендуется 2–5 сек между реакциями
Подписка / Отписка NEW
Массовые действия аккаунтов с каналами

Подписывает или отписывает выбранные аккаунты от списка каналов и групп. Удобно для подготовки аккаунтов перед прогревом или освобождения от ненужных подписок.

Запуск

  1. Перейдите в Подписка / Отписка → Новое задание
  2. Выберите действие: Подписка или Отписка
  3. Вставьте список каналов (по одному на строку)
  4. Выберите аккаунты и настройте задержку
  5. Запустите — прогресс отображается в реальном времени
Выбирайте подписки по содержанию и задаче. Сам факт подписки на каналы не доказывает снижение риска ограничений.
Инвайтинг
Приглашение пользователей в группу или канал

Автоматически добавляет пользователей из базы в указанную группу. Работает только с группами (не каналами) — аккаунт должен быть администратором с правами добавления участников.

Требования

  • Целевая группа — ваша группа, где аккаунты являются администраторами
  • Аккаунты должны иметь права «Добавление участников»
  • Пользователи, которых добавляют, должны иметь открытые настройки приватности

Настройка

  1. Перейдите в Инвайтинг → Создать задачу
  2. Укажите ссылку на вашу группу
  3. Выберите базу пользователей или введите usernames вручную
  4. Установите ограничение объёма задачи и учитывайте фактические ответы Telegram; универсальной безопасной дневной квоты нет
  5. Задержка: минимум 30–60 сек между добавлениями
Если пользователь ранее покинул вашу группу через «Выйти» — его нельзя добавить повторно без его согласия. Такие пользователи будут помечены как skipped.
Сторис-отметки
Упоминания пользователей в историях

Публикует истории в Telegram с упоминанием (@mention) пользователей из вашей базы. Отмеченные получают уведомление и видят историю.

Запуск

  1. Перейдите в Сторис-отметки → Создать задачу
  2. Загрузите фото/видео или выберите медиафайл
  3. Выберите базу пользователей для отметки
  4. Настройте количество отметок на одну историю (рекомендуется 1–3)
  5. Запустите задачу
Telegram позволяет отмечать в историях только тех, кто входит в ваши контакты или подписан на аккаунт. Пользователи без взаимной связи могут не получить уведомление.
Мониторинг упоминаний
Отслеживание ключевых слов в каналах

Мониторит публичные каналы и группы в реальном времени. При обнаружении ключевого слова или ссылки — уведомляет и позволяет автоматически реагировать.

Настройка

  1. Перейдите в Мониторинг → Создать монитор
  2. Добавьте ключевые слова (одно на строку)
  3. Укажите каналы/группы для мониторинга
  4. Опционально настройте автоответ при обнаружении
  5. Укажите Telegram-аккаунт для уведомлений
Разбор ограничений
Ошибки, права и обязательное ожидание

Сначала определите, какое действие не выполнено и какой ответ вернула платформа. Ошибка авторизации, отсутствие прав, приватность получателя и временное ожидание требуют разных действий.

  1. Сохраните текст ошибки и контекст задачи без публикации данных аккаунта.
  2. Проверьте доступ, права и настройки целевого сообщества.
  3. При требовании ожидания учитывайте указанную сервером длительность.
  4. Если причина неясна, передайте описание проблемы в поддержку через согласованный контакт.

Программа не может гарантировать снятие ограничений Telegram. Подробнее — разбор отправок и ошибок.

ИИ-функции AI
Настройка и использование ИИ

TeleCobra поддерживает любые OpenAI-совместимые API: GPT-4o, Claude, DeepSeek, Gemini, Mistral и другие. Ключ настраивается в профиле.

Подключение ИИ

  1. Перейдите в Профиль / API
  2. Вставьте API-ключ в поле AI API Key
  3. Укажите Base URL (для GPT — оставьте пустым, для других API — укажите эндпоинт)
  4. Выберите модель (например, gpt-4o-mini, claude-3-5-haiku)
  5. Нажмите Сохранить и проверьте через кнопку Тест

Где используется ИИ

  • Автоответчик — полноценный диалог с пользователем
  • Нейрокомментинг — генерация тематических комментариев
  • Рассылки — персонализация текста под каждого получателя
  • Прогрев — написание ИИ-комментариев в каналах
  • Редактор тем — генерация цветовой схемы панели по описанию
Экономия токенов: для автоответчика и комментинга используйте gpt-4o-mini или deepseek-chat — они в 10–20 раз дешевле GPT-4 и достаточно умны для переписки.
Спинтаксис NEW
Вариативные тексты сообщений

Спинтаксис позволяет писать одно сообщение с несколькими вариантами — каждый получатель видит случайно выбранный вариант. Поддерживается в рассылках и автопостинге.

Синтаксис

{вариант1|вариант2|вариант3}

Примеры

{Привет|Здравствуйте|Добрый день}, {коллега|друг|партнёр}!

Хочу поделиться {отличной|интересной|важной} новостью...

Записывайтесь на {бесплатный вебинар|демо-урок|пробное занятие} по ссылке: https://...

Поддерживается вложенность: {{вариант A1|вариант A2}|вариант B}

Используйте спинтаксис минимум для первых двух предложений — именно первые слова Telegram показывает в превью уведомления. Разные превью → меньше жалоб на спам.
Часто задаваемые вопросы
Что такое TeleCobra и как это работает?
TeleCobra — облачная платформа для автоматизации работы в Telegram через протокол MTProto. В отличие от Bot API, MTProto даёт полный доступ к функционалу обычного пользователя: рассылки в личку, парсинг участников, просмотр историй, добавление в группы и всё остальное. Платформа работает на сервере 24/7 — не требует держать ПК включённым.
Почему аккаунты блокируются?
Сначала прочитайте точную ошибку: авторизация, приватность, права, сеть и требование ожидания имеют разные причины. При FLOOD_WAIT учитывайте указанную сервером длительность. Прогрев, отдельный прокси или выбранная задержка не гарантируют отсутствие ограничений. Не повторяйте действие при неизменной причине отказа.
Какие прокси подходят для работы?
Проверьте поддерживаемый протокол, авторизацию, разрешение подключений с сервера и фактическую доступность Telegram. Название провайдера, мобильный или статический адрес сами по себе не доказывают совместимость. При ошибке сохраните её текст и проверьте условия тарифа и маршрут подключения.
Как добавить аккаунт без SMS (через QR или сессию)?
Перейдите в Аккаунты → Добавить. При вводе номера можно перейти в режим QR-кода или импортировать готовую .session / string session. Файлы сессий позволяют добавить аккаунт без нового кода подтверждения.
Что означает ошибка FloodWaitError?
Telegram временно ограничил аккаунт из-за слишком частых запросов. Платформа автоматически делает паузу на указанное время и продолжает. Если FloodWait происходит постоянно — увеличьте задержку в настройках задачи.
Сколько аккаунтов нужно для эффективной работы?
Зависит от задачи: для рассылки 1000 сообщений в день нужно 30–50 прогретых аккаунтов (по 20–30 в день каждый). Для прогрева достаточно 5–10 аккаунтов. Для инвайтинга — не менее 10 аккаунтов-администраторов в целевой группе.
Поддерживает ли платформа работу с приватными каналами?
Да, аккаунт должен быть участником приватного канала/группы. Используйте invite-ссылку для вступления через интерфейс Telegram, затем аккаунт сможет парсить и выполнять другие действия в этом чате.
Как работает спинтаксис в рассылках?
Спинтаксис — это {вариант1|вариант2|вариант3} в тексте сообщения. При каждой отправке платформа случайно выбирает один вариант. Варианты могут повторяться. Сам по себе спинтаксис не доказывает уникальность каждого сообщения или снижение жалоб. Поддерживается вложенность: {Привет {друг|коллега}|Здравствуйте}.
Как подключить ИИ и какие модели поддерживаются?
Перейдите в Профиль / API. Поддерживается любой OpenAI-совместимый API: GPT-4o, GPT-4o-mini, Claude (Anthropic), DeepSeek, Gemini (через прокси), Mistral, LLaMA (через Groq/Together). Укажите API-ключ и Base URL (для не-OpenAI провайдеров).
Можно ли использовать платформу без знания программирования?
Да, TeleCobra — это веб-интерфейс без кода. Все функции управляются через браузер. Технические знания не требуются — достаточно следовать пошаговым инструкциям в этой документации.
Частые ошибки и решения
ОшибкаПричина и решение
FloodWaitError N secTelegram ввёл временное ограничение. Платформа автоматически делает паузу. Если повторяется — увеличьте задержку в настройках.
UserPrivacyRestrictedErrorПользователь запретил добавление в группы или получение сообщений от незнакомых. Участник будет помечен как skipped.
ChatWriteForbiddenErrorАккаунт не имеет прав писать в этот чат или получил временный запрет на комментирование.
SessionPasswordNeededНа аккаунте включена двухфакторная аутентификация. Введите пароль при добавлении.
AuthKeyUnregisteredСессия аккаунта устарела или была сброшена Telegram. Нужно повторно авторизоваться.
Прокси недоступенПроверьте прокси через кнопку Wi-Fi. Если все DC=FAIL — прокси несовместим с Telegram. Смените на статический SOCKS5.
Ошибка 500 при открытии страницыВременная ошибка сервера. Обновите страницу. Если повторяется — обратитесь в поддержку.
Парсинг завершён с 0 участниковКанал закрыл комментарии или группа пустая. Проверьте доступность источника вручную в Telegram.
Попробуйте сейчас

Готовы начать работу?

Все функции из этой документации доступны в вашей панели TeleCobra прямо сейчас.

Открыть панель управления