DOS AI/ Документация
ОтзывыДля когоАгентствамВозможностиЦенаFAQОбучениеДокиВойтиСтарт
← Документация/Руководство
↓ Скачать целиком
Старт
  • Что такое DOS AI
  • Как бот думает
  • Быстрый старт: первый бот за 30 минут
  • Карта кабинета (навигация)
  • Глоссарий
  • Как выбрать чат-бота для WhatsApp
Проект и бот
  • Создание проекта
  • Системный промпт (характер бота)
  • JSON-ответ бота (статусы, стадии, флаги)
  • Выбор AI-модели
  • Тестовый чат
  • Продвинутые настройки бота
  • Загрузить знания о бизнесе в бота (что куда)
Каналы
  • Обзор каналов
  • Подключить WhatsApp (по QR)
  • Подключить Telegram-бота
  • Гигиена и антибан (WhatsApp)
Инструменты бота
  • Функции (инструменты бота)
  • База знаний (RAG)
  • Медиа-библиотека
  • Дожимы (follow-up)
  • Теги и сегментация
  • Уведомления владельцу (Telegram, WhatsApp и почта)
  • Запись на время (Calendar и движок окошек)
  • Бот выставляет счёт (Kaspi)
  • Письмо клиенту
  • Рассылки по базе контактов
  • Исходящие диалоги (бот пишет первым)
Работа с клиентами
  • Диалоги, лента, перехват, «AI на паузе»
  • Лиды и их статусы
  • Стадии диалога (воронка)
  • Аналитика
  • Логи событий
  • Авто-отчёты владельцу (Telegram и почта)
Интеграции
  • Обзор интеграций + сервисный аккаунт Google
  • Google Sheets
  • Google Calendar
  • Gmail
  • CRM, Bitrix24 / amoCRM / AlphaCRM
  • Вебхуки и безопасность (SSRF)
  • МойСклад: наличие и цены в ответах бота
Деньги
  • Биллинг проекта: токены, подписка, пополнение
  • Сколько стоит сообщение
  • Приём оплат от клиентов (Kaspi)
  • Промокоды и партнёрская программа
Команда и аккаунт
  • Роли и права (viewer / tester / editor / admin / owner)
  • Участники и приглашения
  • Профиль, пароль, безопасность
  • Уведомления и личные настройки
  • Удаление, передача, дублирование проекта
Для разработчиков
  • Публичный API и ключи dos_sk_live_…
  • Кастомные вебхуки (продвинутый режим)
  • Язык выражений (expressions)
  • Формат данных и интеграция фронта
  • Подключить ИИ-агента: Claude Code, Codex, Cursor (MCP)
Решение проблем
  • Бот не отвечает, диагностика
  • Функция не вызывается / падает
  • Канал отвалился / WhatsApp забанили
  • Платёж не прошёл
  • Частые вопросы (FAQ)
  • Лиды из рекламы приходят с задержкой
Справочники
  • Каталог встроенных функций
  • Справочник настроек (agent_config)
  • Коды ошибок и состояния
  • Стадии, статусы лида, типы клиента
  • Лимиты и квоты
  • Переменные и хелперы выражений
  • Типы уведомлений

Документация › Каналы › Гигиена и антибан

Гигиена и антибан (WhatsApp)

WhatsApp подключается через WhatsApp Web, а Meta жёстко банит «холодные» номера в первые минуты. Эта статья, как не потерять номер. Касается только WhatsApp; Telegram банить нечего.

⏱ 9 мин · 👤 для владельца · 🟢 live

За 30 секунд:
  • Бан грозит только WhatsApp (там WhatsApp Web). Telegram: официальный бот, риска нет.
  • Главное правило: подключай только «живой», прогретый номер, на котором уже была реальная переписка. Новый/пустой номер забанят за минуты.
  • Анкеты перед сканом нет, платформа верит тебе на слово. Поэтому пять вопросов ниже задай себе сам: это требования Meta, не наша бюрократия.
  • Первые 15 минут после привязки бот молчит (прогрев номера). Сообщения клиентов при этом принимаются и видны в Диалогах, отвечает бот сам, когда окно пройдёт.
  • Если номер уже банился или проект уже ловил баны, заводи новый проект и новый прогретый номер, не реконнекть старый.

Почему WhatsApp вообще банит

WhatsApp не даёт обычному аккаунту «кнопку бота». Платформа привязывается к твоему WhatsApp как WhatsApp Web (ещё одно устройство) и держит это устройство у себя (самохостинг). А Meta давно научилась ловить автоматизацию, если на свежеподключённом устройстве вдруг начинается рассылка незнакомым людям: это классический признак спам-бота, и номер улетает в бан за минуты.

Поэтому антибан это не про «обойти» правила Meta (это невозможно), а про то, чтобы бот вёл себя как живой человек с прогретого номера. Часть защиты делает платформа автоматически, часть зависит от тебя: выбора правильного номера.

🚫 Эмуляторы: мгновенный бан навсегда. Не подключай номер, который заводился на Android-эмуляторе (BlueStacks/NoxPlayer). Meta их детектит и банит без шансов на разбан.

Пять вопросов перед подключением

Окна с галочками перед QR нет: нажал «Подключить свой номер», получил код. Всё, что защищает номер до скана, это твой честный ответ на пять вопросов:

  1. ✅ Номер использовался в обычном WhatsApp минимум 24 часа с реальной перепиской.
  2. ✅ За последние сутки на нём было 10-15 живых чатов с людьми.
  3. ✅ Номер не подключён одновременно к другому сервису рассылок (два сервиса на одном номере = бан).
  4. ✅ Не использовали Android-эмуляторы (BlueStacks/NoxPlayer), Meta их детектит и банит навсегда.
  5. ✅ Этот номер раньше не был забанен в WhatsApp (забаненные не разбанивают).

Хотя бы одно «нет» → бери другой номер. Это рекомендации, проверенные на практике: что именно сделать с номером, решаешь ты.

⚠️ Если проект уже ловил баны. Meta помнит граф контактов даже после нашей чистки канала. Надёжнее создать новый проект и подключить там совершенно новый прогретый номер, который раньше не использовался в DOS AI, чем переподключать тот же. Тот же номер на том же проекте: на твой страх и риск.
💡 В самом блоке WhatsApp после подключения есть раскрывающаяся памятка «Что будет с вашим номером»: шесть коротких ответов про привязанное устройство, старые чаты, лимиты отправки, прогрев и телефон в сети. Полезно показать владельцу номера, если он волнуется.

Что платформа делает за тебя

Несколько защит встроены в код и работают автоматически:

  • Прогрев номера: первые 15 минут бот молчит. Сразу после привязки (и после каждого переподключения) платформа держит паузу 15 минут и не даёт боту автоматически отвечать (isOutboundGatedOnReconnect, OUTBOUND_RECONNECT_COOLDOWN_MINUTES = 15). Свежеавторизованный номер, который тут же начинает писать многим людям, для Meta красный флаг. Окно снимается по времени, а не «когда пойдут входящие»: сообщения клиентов всё это время принимаются, сохраняются и помечаются для оператора, просто ответ идёт после паузы. Исключение одно: если ты вручную включил ИИ в конкретном диалоге, там бот ответит сразу (это ровно случай «отсканировал QR и хочу проверить бота»).
  • Чистая отвязка канала. Кнопка «Отключить» делает на нашем шлюзе полный выход из аккаунта (logout) и стирает и авторизацию, и память о чатах: список известных контактов, буфер последних сообщений, офсайтную копию сессии. Иначе прежние контакты «переехали» бы на следующее подключение, и Meta увидела бы «новое устройство, те же контакты» = уклонение = мгновенный бан.
  • Защита от одинаковых рассылок. Платформа не даёт слать один и тот же шаблон пачкой: троттлинг 1 шаблонное сообщение на диалог в 5 секунд, а служебные автоответы («нет баланса», «нерабочее время» и т.п.) уходят один раз на диалог и повторяются не чаще раза в сутки. Одинаковые массовые сообщения: типовой триггер бана.
  • Жёсткие потолки отправки на самом шлюзе (страховка на случай, если что-то пойдёт вразнос выше по цепочке):
ПотолокЗначениеЗачем
Разных собеседников в минуту8главная защита от «блеска»: рассылка 20 незнакомцам в минуту не пройдёт. Ответ из 5 частей одному человеку стоит одного слота, а не пяти
Всего отправок в минуту30предохранитель от зацикливания
Отправок в час200ровный дневной темп
Отправок в сутки3000верхняя граница на сессию
Пауза между отправками1,5-5 сек (случайная, «человеческая»)вместе с индикатором «печатает»
Одинаковый текст подряд в один чат3-й блокируетсяловит случайную петлю-эхо

Прогрева «в первый день можно меньше» у нас нет намеренно: бот всегда отвечает тем, кто написал первым, а это низкорисковое поведение. Лимит первого дня только заставлял бы бота замолкать посреди разговора.

  • Лимит к API. Запросы на подключение и ручную отправку ограничены 30 в минуту на аккаунт: ровный темп вместо всплесков.
📌 Статус «Сессия разлогинена» сразу после подключения платформа считает «жёстким» сбоем (реальный обрыв, а не временная заминка): на холодном номере это чаще всего замаскированный бан, а не «отвалился на секунду».

Если связь оборвалась

  • Не отключай и не переподключай руками на телефоне. Короткие обрывы платформа чинит сама («Переподключаемся...»). Если устройство отвязано совсем («Сессия разлогинена»), подключи заново по QR на сайте: в обзоре проекта и в диалогах для этого есть ссылка «Переподключить».
  • На неоплаченном истёкшем пробном периоде реконнект заблокирован до оплаты (isWhatsAppReconnectBlocked): пока окно просрочено, новый QR не выдаётся, сначала подписка.
  • Поймал бан на холодном номере: реконнект того же номера обычно бесполезен. Заведи новый проект и подключи новый прогретый номер.

→ Подробный разбор сбоев: Канал отвалился / WhatsApp забанили


Если переносишь бота на другой номер

Переписки при смене номера никуда не деваются: диалог привязан к номеру клиента, поэтому вся история остаётся в Диалогах. Меняется одно: люди, которые писали на прежний номер, новый не знают.

  • Первым писать им с нового номера нельзя. Для WhatsApp сообщение незнакомцу с номера, которого он никогда не видел, выглядит как рассылка, а за это банят. Поэтому в таких диалогах поле ввода закрыто, в списке стоит пометка «прежний номер», а отложенные сообщения, досылки и напоминания им не уходят. Читать переписку можно всегда.
  • Когда человек напишет на новый номер сам, диалог открывается автоматически, и отвечать можно как обычно, и тебе, и боту.
  • Исключение: если человек уже есть в переписках самого нового телефона, он этот номер знает, и диалог не закрывается.
  • Не рассылай «мы сменили номер» с нового номера. Это как раз массовое сообщение незнакомцам. Сообщить о новом номере можно только со старого телефона, руками и не всем сразу.
  • Новый номер должен быть живым: WhatsApp на нём давно, заполнен профиль, нет чужих личных переписок (при подключении они подгрузятся в кабинет).
  • Не забудь поменять номер там, где тебя находят люди: карточки на картах, соцсети, сайт, реклама. Пока там старый номер, новые люди пишут на него.

Telegram: без этих забот

Всё выше, только про WhatsApp. Telegram работает через официальный Bot API: там нет «прогрева», нет WhatsApp Web, нет банов за автоматизацию. Если риск бана для тебя критичен, а номер прогреть негде, начни с Telegram.


Простыми словами

WhatsApp подключается так же, как «WhatsApp на компьютере». И у этого есть одна опасность: WhatsApp очень не любит, когда с нового, пустого номера вдруг начинается рассылка незнакомым людям, он сразу решает «это спам-бот» и блокирует номер за пару минут. Разбана почти не бывает.

Поэтому правило простое: подключай только тот номер, которым реально пользовались с которого писали людям хотя бы сутки, где есть живые переписки. Перед сканированием QR задай себе пять вопросов из этой статьи: это и есть проверка «номер живой?». Не относись к ним как к формальности: они спасают твой номер.

Многое платформа делает сама: например, сразу после подключения она держит бота молча первые 15 минут, чтобы не насторожить WhatsApp (сообщения клиентов в это время не теряются, они видны в Диалогах), и не даёт ему писать слишком многим людям за минуту. Но выбор номера: на тебе. Никогда не подключай номера с эмуляторов (BlueStacks и подобных): это бан навсегда. И если номер уже когда-то банился, не пытайся его реанимировать, возьми новый.

А если все эти сложности не хочется, просто используй Telegram: там ничего не банят, подключается за минуту.


Дальше: → Функции (инструменты бота)
Связано: Обзор каналов · Подключить WhatsApp · Подключить Telegram
Не получилось? → Канал отвалился / WhatsApp забанили