Документация › Старт › Что такое DOS AI

Что такое DOS AI

Платформа, на которой ты собираешь ИИ-бота для своего бизнеса: он сам отвечает клиентам в WhatsApp, Telegram и Instagram, собирает заявки и ведёт их в CRM.

⏱ 6 мин · 👤 для всех · 🟢 live

За 30 секунд:

• DOS AI: конструктор умного бота для WhatsApp, Telegram и Instagram, без программирования.
• Бот отвечает клиентам словами (ты задаёшь его «характер» текстом) и умеет действия, записать, посчитать, выставить счёт через функции.
• Все переписки и заявки складываются в CRM, ты видишь аналитику и можешь вмешаться вручную.
• Платишь за то, что бот реально работает (токены за сообщения + подписка за канал).

Проблема, которую это решает

Клиенты пишут в WhatsApp круглосуточно: «сколько стоит?», «вы работаете завтра?», «запишите меня». Живой человек не успевает отвечать мгновенно 24/7, а медленный ответ = потерянный клиент. Нанять оператора дорого, и он всё равно спит ночью.

DOS AI ставит между клиентом и тобой умного бота. Он отвечает за секунды, на твоём языке, по твоим правилам, ловит заявку и кладёт её тебе в CRM. Ты подключаешься, только когда это реально нужно.

Из чего состоит платформа

Думай о DOS AI как о конструкторе из нескольких блоков:

Один проект = один бот = один бизнес (или одна точка). Если у тебя две стоматологии это два проекта.

Все три канала подключаются на вкладке «Каналы»: WhatsApp по QR, Telegram своим ботом, Instagram через официальный вход Meta (Подключить Instagram).

Для кого это

• Малый и средний бизнес в любой стране: стоматологии, барбершопы, салоны, рестораны, автосервисы, школы, магазины: те, кому клиенты пишут в мессенджеры. Платформа облачная и к стране не привязана: нужен только мессенджер. Больше всего клиентов сейчас в Казахстане, поэтому там есть местные удобства вроде оплаты через Kaspi, но это дополнение, а не условие.
• Не нужны навыки программирования. Бот настраивается обычным текстом: ты описываешь, как он должен себя вести, словами.
• Разработчикам платформа даёт API и вебхуки: можно интегрировать со своими системами, но это опционально.

Что бот умеет, а что нет

✅ Умеет: отвечать на вопросы по твоим правилам и прайсу, записывать клиентов (Google Календарь, Таблицы, АльфаCRM, iiko), считать стоимость, выставлять счета на оплату (Kaspi), заводить сделки в твоей CRM, уведомлять тебя о горячих заявках, вести лида по воронке, догонять «потеряшек» напоминаниями, отправлять фото и видео из библиотеки, понимать голосовые и картинки.

🚫 Не умеет (и это правильно): ставить медицинские диагнозы, давать юридические заключения, обещать то, чего ты не разрешал. Бот работает строго в рамках, которые ты задал в промпте.

📌 Пример. Барбершоп: клиент пишет «во сколько завтра свободно к Артуру?» → бот смотрит расписание в Google Календаре → предлагает «12:00 или 15:30» → клиент выбирает → бот записывает и подтверждает. Владелец утром видит заявку в CRM, не нажав ни одной кнопки ночью.

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

DOS AI это место, где ты делаешь себе «робота-секретаря» для WhatsApp, Telegram и Instagram. Ты не программируешь, ты просто описываешь словами, как он должен общаться с клиентами и что про твой бизнес знать. Дальше он сам отвечает людям днём и ночью: подсказывает цены, записывает на приём, принимает оплату и собирает все заявки в одном месте, чтобы ты ничего не потерял. А если нужно, ты в любой момент сам вступаешь в переписку.

Дальше: → Как бот думает
Связано: Карта кабинета · Глоссарий · Быстрый старт

Документация › Старт › Как бот думает

Как бот думает

Понять за 8 минут, что происходит между сообщением клиента и ответом бота: тогда станет ясно, почему бот отвечает так, и где это чинить.

⏱ 8 мин · 👤 для всех · 🟢 live

За 30 секунд:

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

Что происходит на каждое сообщение

Когда клиент пишет, бот проходит такой путь (обычно ответ приходит через 10-40 секунд):

Сообщение клиента
      │
      ▼
0. Сработало правило с точным ответом? → ответ уходит без модели
      │ нет
      ▼
1. Собрать контекст:  системный промпт (характер + правила)
                    + история этого диалога
                    + подходящие куски базы знаний (RAG)
                    + текст страниц по ссылкам из сообщения клиента
                    + меню включённых функций
      │
      ▼
2. Решить:  «ответить словами»  ИЛИ  «вызвать функцию»
      │                                  │
      │                                  ▼
      │                         выполнить действие
      │                         (календарь / таблица / счёт …)
      │                                  │
      │                                  ▼
      │                         получить результат, подумать снова
      ▼                                  │
3. Сформулировать ответ клиенту ◄────────┘
      │
      ▼
4. Сверить слова с делами: «выставил», «записал», «передал»
   без вызова функции → один круг на исправление
      │
      ▼
Ответ уходит в WhatsApp / Telegram / Instagram

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

Ссылки на шаге 1. Клиент прислал ссылку на сайт, Instagram или объявление: бот открывает до двух ссылок из сообщения, читает заголовок, описание и начало текста страницы и отвечает по сути, а не гадает по словам в адресе. На одну ссылку не больше восьми секунд, закрытые и внутренние адреса не открываются; не открылось, бот знает причину и не выдумывает, что там было. Выключается в настройках бота: «Расширенные настройки» → «Читать ссылки из сообщений».

Проверка на шаге 4. Модель иногда пишет «счёт отправил» или «передала менеджеру», не вызвав функцию. Платформа после каждого ответа сверяет такие заявления (на русском, казахском и английском) с журналом вызовов этого хода. Расхождение есть, бот получает один круг на исправление: вызвать функцию или ответить честно. Не исправился, в рабочем чате клиенту уходит нейтральный ответ, а диалог получает пометку «ответьте руками» и запись action_claim_unbacked в логах. В тест-чате бот ещё и прямо говорит, что здесь счёт, бронь или сделка не выставляются, и что получил бы клиент в рабочем чате.

Ключевое: различать два вида знаний. Общие вещи о мире бот уже знает из обучения, что такое кариес, как вежливо общаться, базовую логику и счёт: это объяснять не нужно. А вот факты про твой бизнес, услуги, цены, расписание, адрес, он не знает, пока ты не дашь их в промпте, поле «Информация о компании» или базе знаний. Плюс бот не ищет в интернете и не знает, что происходит прямо сейчас за пределами диалога. Правило простое: общему учить не надо: давай ему только то, что специфично для тебя.

Источники, из которых бот берёт ответ

💡 Правило большого пальца: как общаться в промпт; коротко о бизнесе в «Информацию о компании»; много фактов / документы в базу знаний; что делать в функции.

Что значит «бот вызвал функцию»

Сам по себе ИИ умеет только писать текст. Функции дают ему «руки». Ты не прописываешь сценарий «если X то Y», ты описываешь каждую функцию словами, и бот сам решает в нужный момент её вызвать.

📌 Пример. Подключены функции «проверить свободное время» и «записать клиента». Клиент: «хочу завтра после обеда». Бот сам: проверяет слоты → предлагает время → после согласия записывает → подтверждает. Никто этот сценарий по шагам не программировал.

За один ход бот может вызвать несколько функций подряд (проверил → записал), но не больше 15 раз. Подробно в гайде по функциям.

Решение «вызвать функцию» бот принимает по смыслу сообщения, а не по языку и точным словам: «напишу в четверг», «кейін жазамын» и «I'll text you later» одинаково ставят напоминания на паузу. У необратимых действий (счёт, запись, подтверждение оплаты) можно поставить предохранитель: платформа сама проверит факт в диалоге (есть ли чек, телефон, прошла ли оплата) и не даст функции сработать раньше времени.

Где бот работает одинаково

Один и тот же «мозг» (промпт, факты, функции, модель) отвечает:

1. в тестовом чате кабинета (песочница: без реальных клиентов, но ответы бота списываются с баланса проекта, как обычные) → Тест-чат;
2. в боевых WhatsApp и Instagram → Подключить WhatsApp · Подключить Instagram;
3. в боевом Telegram → Подключить Telegram;
4. в ответе после оплаты: клиент оплатил счёт Kaspi, и бот сам продолжает разговор.

Два места устроены иначе. Дожимы бот пишет по тому же промпту и той же переписке, но функций в них не вызывает: дожим это только текст (Дожимы). Чат на главной странице сайта это наш консультант DOS AI, а не твой бот: твои настройки на него не влияют.

⚠️ Важно. Если что-то работает в тест-чате, так же сработает в бою. Поэтому всегда проверяй изменения в тест-чате перед тем, как выпускать к клиентам.

Почему бот иногда «тупит», и где чинить

💡 Запомни: плохой ответ бота это почти всегда не «глупый ИИ», а неполный промпт или знания. Бот честно работает с тем, что ты ему дал. Что именно он делал на каждом шаге, видно в логах событий.

Под капотом (для разработчиков)

• Каждый ответ, non-streaming вызов модели (в DOS AI streaming запрещён: ломает авторитетный подсчёт токенов, refund при обрывах, round-trip функций). «Постепенный» эффект печати: клиентский, через паузы между частями ответа.
• Функции отдаются модели как OpenAI tools; вызов функции → выполнение → результат возвращается модели → она формулирует финальный текст (tool-call round-trip).
• База знаний подмешивается через RAG (семантический поиск релевантных кусков), а не «весь документ в каждый запрос».
• Ответ модели, структурированный JSON (текст для клиента + служебные поля: статус лида, стадия диалога, флаги). Формат в статье JSON-ответ бота.
• Тест-чат, вебхуки каналов (WhatsApp, Instagram, Telegram) и ответ после оплаты зовут один пайплайн (executeAIPipeline), поэтому поведение одинаковое. Дожим зовёт модель отдельным вызовом без функций (drip-followup.ts), демо-чат сайта живёт своим маршрутом (/api/demo-chat). Память диалога = история сообщений из БД, а не «глобальная память».
• Ссылки из сообщения читаются до хода модели (inbound-links.ts: до 2 ссылок, 8 секунд, 3 переадресации, защита от внутренних адресов), событие inbound_link_read. Сторож заявлений (action-claim-guard.ts) сверяет глаголы действия в ответе с журналом вызовов хода: один исправляющий круг с функциями, второй отказ в бою даёт нейтральную строку и пометку «ответьте руками», событие action_claim_unbacked. В тест-чате функции кассы, CRM, iiko, АльфаCRM и лид-функции отвечают холостым результатом с performed: false и словами для собеседника.
• Повторный текст промпта и информации о компании кешируется у OpenAI на каждом ходу: второй и следующий ответы в том же проекте обходятся дешевле первого.

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

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

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

Дальше: → Быстрый старт: первый бот за 30 минут
Связано: Системный промпт · Функции · База знаний · Тест-чат
Не получилось? → Бот не отвечает

Документация › Старт › Быстрый старт

Быстрый старт: первый бот за 30 минут

Сквозной путь, от пустого кабинета до живого бота, который отвечает тебе в WhatsApp. Делай по шагам: ничего не пропуская.

⏱ 10 мин чтения · ≈30 мин на практике · 👤 для владельца · 🟢 live

За 30 секунд (что будем делать):

1. Создать проект · 2. Задать «характер» бота · 3. Загрузить факты о бизнесе · 4. Проверить в тест-чате · 5. Подключить WhatsApp · 6. Получить первую заявку.

💡 Перед стартом полезно (но не обязательно) прочесть Что такое DOS AI и Как бот думает, тогда каждый шаг будет очевиден.

Что нужно приготовить заранее

• ☐ Аккаунт на платформе (регистрация по email или через Google). При регистрации спросим номер WhatsApp: на него напишет наш помощник DOS и поможет собрать первого ассистента;
• ☐ Телефон с «живым» рабочим WhatsApp (см. какой номер);
• ☐ Под рукой: твой прайс/услуги, часы работы, адрес, чтобы бот ими оперировал.

⚠️ Бесплатный период WhatsApp: 14 дней, число диалогов не ограничено. Ограничивает только баланс проекта (при создании кладём на него $5), поэтому канал лучше подключать, когда бот уже настроен (шаги 1-4), чтобы пробные дни не ушли на пустого бота.

Шаг 1. Создай проект (3 мин)

Левое меню → «+» рядом с заголовком «Проекты» (или кнопка на Дашборде).

• Дай проекту понятное имя (например «Стоматология Смайл»);
• По желанию укажи сферу бизнеса: под неё конструктор подставит примеры и запреты;
• Ответь на три вопроса, по одному на экран (кто вы, что спрашивают клиенты, что бот должен сделать), и на последнем нажми «Собрать бота».

Платформа создаёт проект и сразу собирает промпт бота по ответам, за $0.30 с баланса. Отвечай как администратору при приёме на работу, чем подробнее, тем лучше. Вместе с промптом включаются функции остановок и тегов, заводятся теги и выключенный ежедневный отчёт, а настройки бота выставляются под нормальную работу (что именно, в статье Создание проекта). Через полминуты откроется тест-чат. Не хочешь отвечать, нажми «Опишу бота сам, без вопросов» и переходи к шагу 2 вручную; промпт при создании платформа не заполняет.

Шаг 2. Проверь или допиши характер бота (8 мин)

Если конструктор уже собрал промпт, он лежит здесь: вкладка Промпт → поле «Системный промпт». Прочитай и поправь под себя, это набросок. Факты из твоих ответов (адрес, часы, цены) конструктор положил ниже, в поле «Информация о компании» (шаг 3). Если писал сам, тут описывается поведение бота, как он себя ведёт (факты про бизнес, отдельно, шаг 3). Опиши своими словами:

• Тон: как общаться (вежливо на «вы» / дружелюбно на «ты», с эмодзи или строго);
• Правила: что можно и чего нельзя (не ставить диагноз, не обещать скидок без согласования);
• Цель: что считать успехом (записать / взять телефон / довести до оплаты);
• Как вести диалог: что уточнить у клиента, что предложить, когда позвать живого человека.

📌 Всё это пишется обычным текстом в одно поле: отдельных переключателей «тон» или «услуги» в интерфейсе нет, ты просто формулируешь инструкцию словами, как новому сотруднику.

💡 Совет. «Ты: администратор стоматологии. Общайся вежливо на вы. Уточни, что беспокоит, предложи удобное время, возьми имя и телефон. Диагнозы не ставь, это к врачу». Глубоко: Системный промпт.

🚫 Факты о бизнесе (услуги, цены, адрес, часы) сюда не вписывай, для них есть отдельные места (шаг 3).

Шаг 3. Дай боту факты о бизнесе (5 мин)

Факты живут в двух местах (это не промпт, промпт про поведение, а тут про что бот знает):

1. Поле «Информация о компании»: там же, на вкладке Промпт. Сюда коротко и то, что нужно всегда, чем занимаетесь, ключевые услуги, цены, адрес, часы работы. Эта информация целиком добавляется в каждый ответ бота. Лимит до 40 000 символов.

2. «База знаний»: вкладка проекта «База знаний». Сюда объёмное и меняющееся: большой прайс на 100 позиций, условия, частые вопросы, документы. Бот сам подмешивает нужные куски в ответ (это RAG, см. Как бот думает).

📌 Правило. Короткий факт (адрес, часы) → «Информация о компании». Большой документ (полный прайс, FAQ) → «База знаний». Тон и правила → системный промпт (шаг 2). Так бот и говорит правильно, и факты не путает.

Шаг 4. Проверь в тест-чате (5 мин). НЕ пропускай

Левое меню → «Тестовый чат». Это песочница: бот думает точно как в бою, но без реальных клиентов. Ответы при этом оплачиваются с баланса проекта, как настоящие, поэтому на старте достаточно пары десятков реплик.

Прогони реальные сценарии:

• «Сколько стоит чистка?»: называет цену из базы знаний?
• «Запишите меня на завтра»: ведёт к записи?
• «А вы рядом с метро?»: отвечает по фактам, не выдумывает?

⚠️ Если бот ошибается это нормально на старте. Почти всегда лечится так: ответил не по фактам → добавь факт в Базу знаний; ведёт себя не так → поправь промпт. Покрути, пока не понравится. Подробно, Тест-чат.

Шаг 5. Подключи WhatsApp (5 мин)

Теперь, когда бот толковый, выпускаем в эфир. Вкладка проекта «Каналы» → карточка WhatsApp → «Подключить свой номер». Клиенты пишут вам в Telegram или Instagram, подключайте их так же: Каналы.

Это отдельная подробная статья (там чек-лист антибана и QR): → Подключить WhatsApp.

Коротко: убедись, что номер «живой» (на нём уже переписывались) → нажми «Подключить свой номер» → отсканируй QR телефоном (WhatsApp → Связанные устройства) → дождись статуса «Подключён». Первые 15 минут бот молчит, это прогрев номера.

Шаг 6. Получи первую заявку (2 мин)

1. Напиши боту с другого телефона, как клиент;
2. Бот отвечает, поздравляю, он в эфире;
3. Открой в левом меню «Диалоги»: там твоя переписка;
4. Если бот собрал имя/телефон/запрос в «Лиды» появится заявка.

🎉 Готово. Дальше бот работает сам круглосуточно.

Что делать дальше

Если что-то пошло не так

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

Запустить бота это полчаса по шагам. Сначала ты создаёшь «проект» (это твой бот) и пишешь обычным текстом инструкцию, как общаться, как себя вести. Потом отдельно даёшь ему факты про бизнес: короткое (услуги, цены, адрес) в поле «Информация о компании», объёмное (большой прайс, FAQ) в «Базу знаний». Дальше обязательно проверяешь бота в «тестовом чате»: это как поговорить с ним самому, без клиентов, если он где-то ошибается, ты просто дописываешь инструкцию или факты, пока не станет хорошо. И только когда бот толковый, подключаешь WhatsApp по QR-коду и пишешь ему с другого телефона. Если он ответил, всё, он работает сам, а заявки сами падают тебе в список.

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

Документация › Старт › Карта кабинета

Карта кабинета (навигация)

Чтобы не теряться: что где лежит в кабинете DOS AI. Слева меню аккаунта и список проектов, сверху вкладки открытого проекта.

⏱ 7 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Слева всегда одно меню: оплата, дашборд, уведомления, CRM, список проектов и рабочие разделы открытого проекта (тестовый чат, диалоги, лиды, рассылки, аналитика).
• Сверху, когда проект открыт, идут его вкладки с настройками: Обзор · Общие настройки · Промпт · LLM · Автоматизации · База знаний · Функции · Каналы · Интеграции. У части вкладок под ними есть подвкладки.
• В шапке выбор проекта, поиск по кабинету, баланс и меню аккаунта.
• Что ты видишь и можешь, зависит от роли.

На «Обзоре» проекта сверху вниз стоит то, что нужно каждый день:

• Состояние бота одной строкой и кнопка «Поставить на паузу» или «Включить бота».
• Требует внимания: список дел, если они есть. Кончается баланс или подписка, отключился WhatsApp, горячий клиент написал последним и не получил ответа. У каждой строки кнопка, которая ведёт туда, где это чинится. Когда всё в порядке, списка нет.
• За 7 дней: диалоги, лиды, доля диалогов, ставших лидами, и время ответа бота. Те же числа, что в аналитике.
• Каналы связи: WhatsApp, Telegram и Instagram одной строкой, у неподключённого канала переход к подключению.
• Подробные цифры и справка раскрываются нажатием: неделя к неделе, качество ответов, статусы лидов, источники диалогов, итоги за всё время.

У нового проекта, пока бот не запущен, главным на «Обзоре» стоит список шагов запуска.

Как устроена навигация

У тебя есть аккаунт, в нём проекты (по одному на каждого бота или бизнес). Кабинет разложен так, чтобы ежедневная работа была под рукой слева, а настройка бота собрана в одном ряду сверху:

1. Левое меню одно на весь кабинет. В нём общее (оплата, дашборд, уведомления, CRM), список проектов и пять рабочих разделов того проекта, который сейчас открыт.
2. Вкладки проекта появляются сверху, когда ты зашёл в проект. Это всё, что настраивают один раз и потом правят изредка.
3. Шапка держит выбор проекта, поиск, баланс и меню аккаунта.

💡 Аналогия. Левое меню это «касса и зал», куда ходишь каждый день. Вкладки сверху это «подсобка», где один раз расставил всё по местам.

Левое меню (всегда на месте)

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

Шапка

На телефоне главные разделы проекта стоят внизу экрана: Обзор, Диалоги, Лиды и Тест-чат, а всё остальное меню открывает кнопка «Ещё» рядом с ними. Шапка на телефоне одна строка: слева выбор проекта, справа уведомления, баланс и профиль; справка и остальное лежат в меню «Ещё». Окна на телефоне выезжают снизу во всю ширину экрана.

Вкладки проекта (сверху, когда зашёл в бота)

Первая вкладка со значком домика это Обзор: главная страница проекта, состояние бота, чек-лист запуска и быстрые цифры. Видна всем (от viewer).

Рабочие разделы слева тоже держат подвкладки: у Лидов есть «Теги», у Рассылок «Исходящие» (бот сам пишет первым по базе номеров → гайд), у Аналитики «Отчёты» и «Логи».

📌 Биллинг проекта (тариф, отчёт по оплатам, калькулятор) открывается из окна «Оплата и подписки» и со страницы «Обзор».

⚠️ Не нашёл раздел / всё серое? Скорее всего, у тебя роль ниже нужной. Например, промпт правит только admin, подключение кассы Kaspi и отчёты только owner. Попроси владельца проекта повысить роль.

Куда идти под частую задачу

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

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

Если какой-то раздел не открывается или кнопки серые, почти всегда дело в правах: например, менять «характер» бота разрешено не всем, а только администратору. Тогда просто попроси владельца дать тебе доступ повыше.

Дальше: → Быстрый старт: первый бот за 30 минут
Связано: Что такое DOS AI · Роли и права · Глоссарий

Документация › Старт › Глоссарий

Глоссарий

Все термины платформы простым языком. Сюда ведут ссылки из других статей, если встретил незнакомое слово, ищи его здесь.

⏱ 6 мин (как справочник) · 👤 для всех · 🟢 live

Как пользоваться: жми Ctrl/Cmd+F и ищи слово. Каждый термин даёт короткое определение и ссылку на полную статью.

Основные понятия

Проект

Один бот для одного бизнеса (или точки). Внутри проекта: промпт, каналы, функции, CRM. У тебя может быть много проектов. → Что такое DOS AI

Бот / агент

AI-ассистент проекта, который отвечает клиентам. Его поведение задаёшь ты, текстом в промпте. «Бот» и «агент», синонимы.

Системный промпт

Текст, описывающий «характер» и правила бота: как общаться, что предлагать, что запрещено. Главная настройка бота. → Промпт

Канал

Мессенджер, через который бот общается: WhatsApp, Telegram или Instagram. Один номер, бот или аккаунт = один проект. → Каналы

Функция (инструмент / tool)

Действие, которое бот может выполнить: записать в календарь, посчитать, выставить счёт, уведомить владельца. Бот сам решает, когда вызвать. → Функции

Параметр (функции)

Данные, которые бот собирает у клиента и передаёт в функцию (имя, телефон, дата, сумма). → Функции

Предохранитель (функции)

Условие, без которого функция не выполнится, даже если бот решил её вызвать: клиент прислал чек, заполнен телефон, оплата реально прошла, другая функция уже отработала. Проверяет платформа, а не модель. → Функции

Правки владельца

Раздел в конце промпта, куда ссылка «Не так ответил? Поправить словами» в тест-чате дословно записывает твои замечания правилами. → Промпт

Сверка слов с делами

Проверка после каждого ответа: бот написал «выставил», «записал», «передал», а функцию не вызвал, значит получает один круг на исправление. В логах такой случай называется action_claim_unbacked. → Как бот думает

База знаний (RAG)

Большие документы, которые ты загружаешь (прайс на много позиций, каталог, условия). Бот автоматически подмешивает нужные куски в ответ. Короткие факты (адрес, часы, несколько цен) удобнее в поле «Информация о компании». RAG = технология поиска по этим документам. → База знаний

Дожим (follow-up)

Автоматическое напоминание клиенту, который заинтересовался и пропал. Бот мягко возвращает его в диалог. → Дожимы

Медиа-библиотека

Хранилище фото/видео/отзывов проекта, которые бот может отправить клиенту в нужный момент. → Медиа

Правило (автоматизация)

«Когда, если, то»: повод (клиент написал слово, бот создал заявку), условия и до трёх действий (точный ответ без модели, тег, уведомление, вебхук). → Правила и комментарии

Рассылка

Разовое сообщение сразу многим своим контактам в Telegram, с сегментом, кнопками и отложенным запуском. В WhatsApp массовых рассылок нет: за них банят номер. → Рассылки

Исходящие

Режим, где бот сам пишет первым по вашей базе номеров WhatsApp, по капле и с дневным лимитом; риск блокировки принимает владелец. → Исходящие

Записи и напоминания

Раздел «Автоматизации → Записи»: подтверждение «вы записаны» и напоминания перед визитом для записи из любого источника (календарь бота, своя функция, CRM). → Записи

Страница записи

Публичная страница dosai.pro/b/<адрес>, где клиент сам выбирает услугу, день и время и вносит предоплату в Kaspi, без переписки. → Записи

Не доставляется

Пометка на контакте, которому наши сообщения три дня висят на одной галочке: так WhatsApp намекает на блокировку. Дожимы такому человеку отменяются, в массовую отправку он не попадает. → Дожимы

Интеграция

Связь бота с сервисом бизнеса: CRM, касса ресторана, Google, склад, свой API. → Что можно подключить

CRM и клиенты

Диалог (conversation)

Одна переписка с одним клиентом в канале. Все диалоги видны в разделе «Диалоги». → Диалоги

Лид

Потенциальный клиент: человек, который написал и которого стоит «вести». Каждый диалог может стать лидом с данными (имя, телефон, что хочет). → Лиды

«Это заявка» (галочка функции)

Галочка в разделе «После вызова» у функции, которая передаёт заявку человеку. Функция сработала, значит у клиента появляется карточка в «Лидах» и сделка в CRM, даже если бот оценил его осторожнее. → Функции

Статус лида

Насколько клиент готов купить: «Без статуса», «Потенциальный», «Квалифицированный», «Горячий», «Резерв», «Сделка закрыта», «Потерян». Бот ставит статус сам по ходу разговора, итог сделки обычно ставит человек. → Лиды

Стадия диалога

Этап разговора: Приветствие → Квалификация → Презентация → Возражения → Закрытие → Завершено. Помогает аналитике и боту понимать контекст. → Стадии

Тег / метка

Пометка на лиде для фильтрации (VIP, опт, жалоба). Бот или оператор ставит вручную/функцией. → Теги

Перехват (ручной режим)

Когда оператор сам вступает в диалог. Бота на этом чате можно поставить на паузу, чтобы он не встревал. → Диалоги

AI на паузе

Состояние диалога, когда бот временно молчит (оператор работает вручную или клиент попросил не писать). → Диалоги

Кому отвечает бот

Настройка проекта: всем новым обращениям, ещё и контактам, которые писали на номер до подключения, или только лидам с рекламы. У Instagram свой режим. → Расширенные настройки

«Ответьте руками»

Пометка на диалоге, которую платформа ставит, когда боту нельзя доверить ответ: функция упала, бот дошёл до потолка ответов, дважды заявил то, чего не делал. Такие диалоги ждут человека. → Диалоги

Что понял бот / Действия бота

Панель в тест-чате: какие функции бот вызвал, что записал в карточку клиента, сколько стоил ответ. → Тест-чат

Деньги

Токен

Единица расхода ИИ. Каждое сообщение бота тратит токены (зависит от длины и модели). Баланс пополняешь в окне «Оплата и подписки». → Сколько стоит сообщение

Подписка

Регулярная оплата за работающий канал WhatsApp или Instagram (Telegram работает без неё). Без активной подписки бот после пробного периода перестаёт отвечать клиентам: номер остаётся привязанным, переписка и настройки на месте. → Биллинг

Триал (пробный период)

Бесплатные дни работы WhatsApp-канала: 14 дней с момента подключения номера, 30 дней, если к проекту применён промокод. Число диалогов не ограничено, ответы бота всё это время идут с баланса проекта. Даётся один раз на проект и только до первой оплаты: у проекта, за который уже платили подписку, бесплатные дни заново не открываются, там продление подписки. → Подключить WhatsApp

Окно активации

14 дней после подключения канала, когда подписку можно купить со сниженной ценой (месяц −20%, 3 мес −15%, 6 мес −25%, год −30%). Даётся один раз на проект. → Биллинг

Приём оплат (Flow B)

Функция, когда бот выставляет твоему клиенту счёт прямо в чате (Kaspi-push), деньги идут на твою кассу. → Приём оплат

Реферал

Приглашённый тобой пользователь; за него начисляется комиссия. → Рефералы

Роли

viewer / tester / editor / admin / owner

Уровни доступа в проекте: viewer, только смотреть, tester, то же + тест-чат (гонять бота, без правок), editor, функции, база знаний, дожимы, интеграции и ручные ответы клиентам, admin, + промпт, настройки проекта, подключение каналов, приглашения и оплата, owner: всё + касса, роли, передача и удаление. → Роли и права

Технические термины

QRDOS (подключение WhatsApp)

Самохостинг-механизм, которым платформа подключает WhatsApp: привязанное устройство по QR (как WhatsApp Web), всё держится на стороне платформы: отдельный сторонний сервис не нужен. (Ранее эту роль играл сервис-посредник Wazzup; убран в 2026-06.) → WhatsApp

Код привязки

Восемь знаков, которые вводят в WhatsApp на телефоне вместо сканирования QR: так номер подключают с самого телефона, где стоит WhatsApp. Код живёт около двух с половиной минут. → WhatsApp

Что нового

Страница на сайте со списком изменений платформы по месяцам, с «было» и «стало». Ссылка в меню помощи в шапке кабинета.

Сервисный аккаунт (Google)

Технический Google-аккаунт DOS AI, которому ты даёшь доступ к своей таблице/календарю, чтобы бот мог с ними работать. → Интеграции

Вебхук (webhook)

HTTP-запрос на внешний адрес: способ боту «дёрнуть» твой сервер или CRM. Основа кастомных функций. → Своя интеграция по API · Вебхуки событий

Где работает бот

Тест-чат, WhatsApp, Instagram, Telegram и ответ после оплаты: везде одинаково, с теми же функциями. Дожимы бот пишет по тому же промпту, но без функций. Чат на главной странице сайта это наш консультант, а не твой бот. → Как бот думает

QStash / крон

Планировщики, которые запускают регулярные задачи (дожимы, проверки). Тебе настраивать не нужно, работает само.

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

Это словарик. Если в любой статье встретилось слово, которое непонятно, заходи сюда, ищи его поиском (Ctrl+F) и читай короткое объяснение. А если хочешь разобраться глубже, рядом с каждым словом есть ссылка на полную статью.

Дальше: → Быстрый старт: первый бот за 30 минут
Связано: Что такое DOS AI · Как бот думает · Карта кабинета

Документация › Старт › Как выбрать чат-бота

Как выбрать чат-бота для WhatsApp

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

Ниже шесть вопросов, которые стоит задать любому сервису до оплаты. В конце наши ответы на те же шесть, с цифрами, и список случаев, когда мы не подойдём.

1. Как бот попадёт в твой WhatsApp

Способов два, и они отличаются сильнее, чем всё остальное вместе взятое.

Официальный WhatsApp Business API. Номер регистрируется у Meta через провайдера. Плюс: правила игры прописаны, за рассылки не банят, есть верификация бизнеса. Минус: подключение идёт через проверку, шаблоны сообщений проходят модерацию, а платить обычно приходится и провайдеру, и за диалоги по тарифам Meta.

Привязанное устройство (QR). Бот входит на твой номер так же, как WhatsApp Web: сканируешь код, номер остаётся твоим. Плюс: подключение за минуту, номер уже прогрет перепиской, платить за каждый диалог никому не нужно. Минус: это не официальный API, поэтому дисциплина обязательна, и рассылки по холодной базе тут запрещены не капризом сервиса, а здравым смыслом.

Что спросить: какой из двух способов, и если QR, то что сервис делает против блокировки. Ответ «ничего, просто не спамьте» это плохой ответ.

2. Чем бот отвечает

Тут два подхода, и многие сервисы сегодня умеют оба.

Сценарий. Ты рисуешь ветки: кнопка, ответ, следующая кнопка. Работает предсказуемо ровно до первого вопроса, которого нет в ветке.

Модель. Ты описываешь словами, кто твой бот, что продаёшь, по каким ценам и как себя вести. Дальше он сам разбирает, что человек написал. Работает с любой формулировкой, но зависит от того, насколько подробно ты его описал.

Что спросить: что будет, когда клиент напишет то, чего ты не предусмотрел. И отдельно: можно ли забрать свой промпт с собой, если решишь уйти.

3. За что с тебя возьмут деньги

Моделей тарификации несколько, и они дают очень разный счёт при росте.

• За подписчиков или контакты. Дёшево на старте, растёт вместе с базой, даже если половина базы молчит.
• За сообщения или диалоги. Считаешь по трафику, но нужно понимать, что именно считается диалогом.
• За канал или рабочее место. Фиксировано, не зависит от того, сколько тебе написали.
• Отдельно за ИИ. Если бот отвечает моделью, эти ответы кто-то оплачивает. Либо это зашито в тариф, либо идёт отдельной строкой.

Что спросить: посчитайте мой месяц на моих числах. Возьми свой реальный поток обращений и попроси назвать сумму. Если сумму называть отказываются, скорее всего она тебе не понравится.

4. Что будет с перепиской и заявками

Бот собирает то, ради чего всё затевалось: имена, телефоны, что человек хотел, на когда записался.

Что спросить: где это лежит и как забрать. Есть ли встроенная CRM или заявки надо самому перекладывать в таблицу. Отдаётся ли выгрузка. Есть ли интеграция с той CRM, где ты уже работаешь.

5. Кто настраивает и сколько это займёт

Часть рынка продаёт не сервис, а внедрение: платишь за настройку отдельно, и без интегратора продукт не запускается.

Что спросить: запущусь ли я сам и за какое время. И проверить это до оплаты: попроси доступ и попробуй.

6. Что происходит, когда бот ошибётся

Он ошибётся, это вопрос времени. Дальше всё зависит от того, узнаешь ли ты об этом вовремя.

Что спросить: как бот передаёт разговор человеку, придёт ли мне уведомление и вижу ли я всю переписку целиком. Худший вариант это когда бот наговорил клиенту лишнего, а ты узнал об этом от самого клиента.

Наши ответы на те же шесть

Всё ниже проверяется в кабинете, цифры действуют на 2 октября 2026 года.

Подключение. Привязанное устройство по QR, номер остаётся твоим. В обычной работе бот отвечает только тем, кто написал сам, и держит паузы между сообщениями. Написать первым можно, но через отдельный раздел «Исходящие», и там стоит потолок: по умолчанию 20 сообщений в сутки на номер, первые дни идёт разгон с пяти, а поднять потолок выше двадцати можно только с отдельным подтверждением.

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

Деньги. Telegram бесплатно. WhatsApp: $25 в месяц за канал. Ответы ИИ идут отдельно по факту: один доллар это примерно 80 ответов бота на быстрой модели и около 20 на самой сильной (замер по реальным диалогам; длина описания и ответов сдвигает цифру). Первые 14 дней после подключения номера канал работает бесплатно, по промокоду 30 дней. При регистрации на баланс кладём $5, по промокоду $10. Карта для старта не нужна. Прикинуть свой месяц можно калькулятором расхода в кабинете, в разделе «Баланс».

Заявки. Встроенная CRM: стадии, теги, заметки, ответственные, вся переписка рядом. Есть готовые интеграции с Bitrix24, amoCRM, АльфаCRM, кассой ресторанов iiko, Google Таблицами и Календарём и МоимСкладом, а свою систему можно подключить вебхуком или по API. Все интеграции на одной странице: Что можно подключить. Есть публичный API.

Запуск. Сам, без интегратора. Первый ответ клиенту обычно уходит через 10-15 минут после регистрации. Отдельно за настройку платить не нужно. Если хочется, чтобы бота собрали за тебя, есть платная услуга «Настроим за вас»: $50 разово до 16.10.2026, с 17.10.2026 $75 (предложение действует до 31.12.2026), подписка при этом остаётся отдельно. Заявка оставляется формой на главной (блок после цены) или на странице dosai.pro/pod-klyuch, дальше мы сами пишем в WhatsApp.

Ошибки. Бот передаёт разговор тебе, когда не знает ответа, и присылает уведомление в Telegram. Переписку видно целиком, в неё можно вмешаться в любой момент, бот при этом замолкает.

Когда мы не подойдём

Честный список, чтобы не тратить твоё время.

• Нужно разослать тысячам за день. Отправка первым у нас есть, но с потолком в 20 сообщений в сутки на номер и разгоном в первые дни. Потолок стоит не для того, чтобы придержать тебя, а чтобы номер дожил до конца рассылки.
• Нужен официальный статус WhatsApp Business API, галочка верификации и шаблоны, согласованные с Meta. Мы работаем иначе.
• Клиенты пишут в основном не в мессенджеры, а звонят или приходят с сайта. Тогда начинать надо не с бота в WhatsApp.
• Нужен бот, который ходит по жёсткому сценарию с кнопками и никогда не отклоняется от скрипта. Наш отвечает словами.

Дальше

• Что такое DOS AI, если хочешь понять продукт целиком
• Запуск за 10 минут, если хочешь просто попробовать
• Каналы, про WhatsApp, Instagram и Telegram подробно
• Лимиты и цифры, все числа в одном месте

Документация › Проект и бот › Создание проекта

Создание проекта

Первый шаг к боту: создать проект под один бизнес. В мастере из трёх коротких экранов ты отвечаешь на три вопроса о бизнесе, и платформа собирает бота целиком: промпт, функции, настройки, теги и отчёт. Дальше сразу тест-чат.

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

За 30 секунд:

• Проект = один бот для одного бизнеса или точки.
• Мастер из трёх экранов, по вопросу на экран. На первом: название проекта (обязательно), сфера бизнеса (по желанию) и вопрос «кто вы и чем занимаетесь». На втором: услуги, цены и частые вопросы клиентов. На третьем: что бот должен сделать с клиентом. Между экранами кнопки «Далее» и «Назад», справа видно, что уже заполнено.
• Кнопка «Собрать бота»: проект создаётся, по твоим ответам пишутся промпт (как бот себя ведёт) и «Информация о компании» (адрес, часы, услуги, цены), 30 центов с баланса проекта; включаются функции и настройки, заводятся теги и ежедневный отчёт.
• Через 20-40 секунд ты в тест-чате, в поле ввода уже стоит первое сообщение «клиента».
• Хочешь писать промпт сам: кнопка «Опишу бота сам, без вопросов» (есть на каждом экране). Функции, настройки и отчёт ставятся и в этом случае.

Зачем это нужно

Проект это «папка» твоего бота: внутри живут его характер, каналы, функции, переписки и заявки. Один бизнес = один проект. Две точки или два разных бизнеса = два проекта (у каждого свой бот и свой номер WhatsApp).

Шаги

1. Открой создание проекта

Левое меню → «+» рядом с заголовком «Проекты» (или кнопка на Дашборде).

2. Заполни название и сферу

3. Ответь на три вопроса

Бот будет знать ровно то, что ты напишешь: назвал цену, он её назовёт; не назвал, скажет, что уточнит у администратора. Второе и третье поле можно оставить пустыми: чего не хватает, попадёт в промпт отдельным списком «чего владелец не указал», и его легко дописать потом в поле «Информация о компании».

Пока ты заполняешь мастер, ответы хранятся в браузере: ушёл со страницы и вернулся, они на месте (мастер откроется с первого экрана, поля уже заполнены). Если до регистрации ты писал боту на главной, чем занимаешься, эта фраза уже стоит в первом ответе.

4. Нажми «Собрать бота»

Во время сборки на экране видно шаги: проект и настройки, функции и отчёт, промпт бота, теги. Обычно это 20-40 секунд. Потом открывается тест-чат: отправь подставленное сообщение и посмотри, как бот отвечает. После первого ответа там же можно перейти к подключению канала или к правке описания.

Что собирается вместе с проектом

Всё это меняется потом: настройки бота на вкладке «Промпт → Расширенные настройки», остальное на страницах функций, тегов и отчётов. Полный список значений в справочнике настроек.

Если что-то пошло не так

Под капотом

• Создание: POST /api/projects. Сразу после записи проекта сервер ставит настройки нового проекта (NEW_PROJECT_AGENT_CONFIG), включает функции поведения и создаёт выключенную строку отчёта. Сбой любого из этих шагов не отменяет создание проекта.
• Сборка промпта: POST /api/projects/{id}/prompt/compose, 30 центов списываются только после успешной сборки. Словарь тегов (created_by = ai) заводится только проекту, у которого тегов ещё нет: пересборка промпта в настройках живого проекта теги не добавляет.
• Не хватило баланса или сборка не удалась: ответы переносятся под созданный проект, открывается /projects/{id}/setup с заполненными полями.
• «Опишу бота сам, без вопросов» ведёт на /projects/{id}/settings?tab=bot.
• Лимит 50 проектов на пользователя. Бесплатный стартовый баланс даётся на первый проект (при регистрации по реферальной ссылке на первые 3); дальше проект создаётся с нулевым балансом.
• Название компании отдельно не спрашивается: в базу уходит название проекта (company_name = name), потом его можно поменять в настройках.

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

Создать проект это завести отдельного бота под один бизнес. На трёх коротких экранах ты пишешь, как проект называется, и отвечаешь на три вопроса, как новому администратору: кто вы, что продаёте и почём, чем должен закончиться разговор. Нажал кнопку, и через полминуты бот готов: знает твои цены, умеет замолчать, если клиент попросил не писать, сам раскладывает клиентов по категориям, а утренний отчёт ждёт только того, чтобы ты сказал, куда его слать. Остаётся проверить бота в тест-чате и подключить WhatsApp.

Дальше: → Системный промпт
Связано: Быстрый старт · Карта кабинета

Документация › Проект и бот › Системный промпт

Системный промпт (характер бота)

Самая важная настройка: текст, который задаёт, как бот общается и по каким правилам. От него зависит 80% качества бота.

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

За 30 секунд:

• Промпт это инструкция боту, как новому сотруднику: тон, что предлагать, что запрещено, какая цель.
• Пиши правила и поведение в промпт; факты (адрес, часы, несколько цен) в поле «Информация о компании»; большие прайсы и документы в Базу знаний; действия в Функции.
• Не хочешь писать с нуля: кнопка «Составить за меня» над полем. Три вопроса о бизнесе, минута ожидания, готовый промпт на 6-12 тысяч знаков. Стоит $0.30 с баланса проекта.
• Есть история версий промпта, оценка стоимости и токенов.
• Любую правку сразу проверяй в Тест-чате.

Зачем это нужно

Бот не знает твой бизнес и не имеет «характера» по умолчанию. Системный промпт это то, что превращает абстрактный ИИ в твоего администратора: вежливого или дружелюбного, продающего или консультирующего, с твоими правилами и запретами. Плохой бот почти всегда = неполный промпт, а не «глупый ИИ» (см. Как бот думает).

Где это настраивается

Вкладка проекта «Промпт» (settings?tab=bot). Слева сам текст промпта, справа список «Рядом с промптом»: информация о компании, медиа бота, база знаний, помощь с настройкой и итоговый промпт. Каждая строка списка открывает свой раздел:

«Составить за меня»: три вопроса вместо пустого поля

В шапке блока с текстом промпта всегда стоит кнопка «Составить за меня». Она открывает три вопроса, на которые ты отвечаешь как администратору при приёме на работу:

1. Кто вы и чем занимаетесь? Название, город, что делаете, чем отличаетесь, часы работы. Это единственный обязательный ответ.
2. Услуги, цены, что клиенты спрашивают и что вы отвечаете. Чем подробнее, тем меньше бот будет говорить «уточню у администратора».
3. Что бот должен сделать с клиентом в итоге? Кнопки: записать на приём, собрать имя и телефон, ответить на вопросы, передать менеджеру, оформить заказ, выставить счёт. Можно несколько, плюс уточнение своими словами.

Под каждым вопросом стоит живой пример ответа под твою нишу, он не пропадает, когда начинаешь печатать. Пиши как угодно: списком, сплошным текстом или надиктуй голосом и вставь, ИИ разберёт.

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

Порядок разговора зависит от того, что ты продаёшь. Услуги с расписанием (клиника, салон, автосервис, зал, кафе с бронью) ведут к записи на день и время. Товар (магазин, доставка) ведёт к заказу: что именно, размер, доставка или самовывоз, и никакого «удобного дня», у товара нет расписания. Сложные услуги, где цену нельзя назвать в переписке (ремонт, логистика, IT, реклама, недвижимость), ведут к заявке и передаче менеджеру. Платформа выбирает это по нише проекта; ниша не выбрана, выбирает ИИ по твоему первому ответу.

А если продавать не надо? Отметь в третьем вопросе только «отвечать на вопросы» (можно вместе с «передать менеджеру») и ничего больше. Тогда бот получит справочный порядок: отвечает по фактам, а сам к записи и заказу не тянет и телефон не просит. Попросишь его о записи в разговоре, поможет и доведёт до конца, отказывать он не будет. Отметил рядом «записать» или «оформить заказ», значит бот снова продающий.

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

• Стоит $0.30 с баланса проекта. Списывается только после удачной сборки и сохранения: если ИИ не справился, денег не берут. Баланса не хватает: плашка об этом стоит над кнопкой сразу, до ввода. Лимит 5 сборок в час и 20 в сутки на проект.
• Ответил только на первый вопрос? Собрать всё равно можно. Платформа переспросит один раз («бот будет знать только это») и соберёт. Всё, чего ты не написал, попадёт в раздел «чего владелец не указал», и на такие вопросы бот будет отвечать «уточню у администратора», а не выдумывать. Дописать можно потом: факты (адрес, часы, цены) в поле «Информация о компании», правила поведения в текст промпта.
• Цены проверяются на запись. Двойные единицы («24000 тыс») и точку вместо пробела («17.000») платформа приводит к обычному виду и отдельной строкой просит тебя проверить цифру. Твои числа при этом не меняются по смыслу. Знак валюты бот ставит только если ты сам его написал: не написал, цена останется голым числом.
• Ответы не пропадают. Ушёл пополнять баланс, закрыл вкладку, вернулся через час: три поля заполнены тем, что ты писал. Черновик хранится в браузере до удачной сборки.
• Куда ложится результат. Поведение (манера, порядок разговора, запреты, примеры) в «Системный промпт». Факты из ответов (кто вы, адрес, часы, услуги, цены, ответы на частые вопросы) в поле «Информация о компании», если оно пустое. Если там уже есть твой текст, конструктор его не трогает, и факты из ответов встают в промпт, как раньше.
• Уже есть промпт? Конструктор прочитает его и информацию о компании, заполнит три поля тем, что ты уже писал, и покажет плашку «учёл то, что вы уже написали». Перед заменой предупредит: старый текст уходит в историю версий, вернуть можно одной кнопкой.
• Это набросок, а не готовый продукт. Под полем так и написано: промпт требует работы и проверки на живых диалогах. Пиши боту в тест-чате как клиент, читай ответы, правь текст.
• Сразу после сборки тебя ведут в тест-чат, где в поле уже лежит первое сообщение «клиента» под твою нишу. Нажми «Отправить» и посмотри, как бот отвечает.

💡 Поля сохраняются автоматически при правке (через ~1 секунду). Есть история версий: можно откатиться к прошлой формулировке.

«Поправить словами»: правило без поиска места в тексте

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

• Это бесплатно: модель ради правки не зовётся, текст встаёт как есть.
• Раздел «Правки владельца» один, новые замечания добавляются в конец; прежний текст промпта остаётся в истории версий.
• Открой промпт и прочитай раздел после пары недель: правки, которые противоречат друг другу, лучше свести в одно правило руками.

Как написать хороший промпт

Думай как про инструктаж нового администратора. Структура, которая работает:

1. Кто ты. «Ты: администратор стоматологии "Смайл" в Астане».
2. Тон. «Общайся вежливо на "вы", коротко, без канцелярита. Эмодзи: редко».
3. Что делаешь. «Отвечай на вопросы об услугах и ценах, помогай записаться».
4. Цель. «Главная задача, записать клиента: узнай услугу, предложи время, возьми имя и телефон».
5. Правила и запреты. «Не ставь диагнозы. Не обещай скидок без согласования. Если не знаешь, предложи перезвонить».
6. Что делать при неясности. «Если клиент пишет не по теме, мягко верни к записи».

💬 Приветствие пишется здесь же, в промпте. Отдельного поля «Приветственное сообщение» у проекта больше нет (убрано 2026-08-06): один и тот же текст в двух местах разъезжался, а поле к тому же намекало на автоотправку, которой никогда не было. Хочешь, чтобы бот здоровался определённым образом, скажи это строкой промпта: «Первым сообщением поздоровайся и представься: "Здравствуйте! Это Айнур из центра Профи"». У проектов, где поле было заполнено, текст уже перенесён в начало промпта.

📌 Пример мини-промпта (барбершоп):

Ты это администратор барбершопа BroozMan. Общайся дружелюбно на «ты», коротко. Помогай записаться к мастеру: узнай услугу (стрижка/борода/комплекс), предложи свободное время, возьми имя и телефон. Цены бери из базы знаний, не выдумывай. Если клиент сомневается, предложи показать работы. Не груби, не спорь.

⚠️ Не пихай в промпт большие списки фактов (весь прайс на 80 позиций, расписание на месяц). Для этого есть База знаний: она дешевле и бот не путает цифры. Промпт = поведение, база знаний = факты.

📌 Не уверен, что в промпт, что в «Информацию о компании», а что в базу знаний? Цельный разбор: в статье Загрузить знания о бизнесе в бота.

Воронка продаж: статусы и стадии

Если включить «Воронку продаж», бот по ходу разговора сам определяет:

• Статус лида, насколько клиент «горячий»: «Потенциальный» → «Квалифицированный» → «Горячий» → «Сделка закрыта» (или «Потерян»). Когда статус становится «Квалифицированный», «Горячий» или «Резерв», автоматически создаётся лид.
• Стадию диалога, этап разговора: Приветствие → Квалификация → Презентация → Возражения → Закрытие → Завершено.

Тебе не нужно это программировать, бот ставит сам. Можно подсказать ему в промпте: «Когда клиент согласился записаться, считай его квалифицированным». Технические детали формата: в статье JSON-ответ бота.

💡 Если воронка не нужна (например, бот только консультирует), выключи её, чтобы не усложнять. Переключатель в подвкладке «Расширенные настройки». С подключённой CRM выключенная воронка останавливает и движение сделки по воронке: стадии не меняются, сделку двигают только правила.

Проверь, что работает

После правки промпта обязательно иди в Тест-чат и прогони реальные вопросы. Промпт это не «написал и забыл», а «написал → проверил → подправил», пока бот не отвечает как надо.

Частые ошибки

Вопросы, которые обычно возникают

Насколько длинным должен быть промпт?
Столько, сколько нужно для ясных правил. Обычно 1-3 экрана. Длиннее ≠ лучше: чёткость важнее объёма. Большие факты: в базу знаний.

Можно откатить, если испортил?
Да, есть история версий: вернёшь прошлую формулировку.

Промпт виден клиенту?
Нет. Клиент видит только ответы бота. Промпт: внутренняя инструкция.

Нужно ли писать в промпте, когда вызывать функции?
Основное описание «когда вызывать» живёт у самой функции, и бот читает его на любом языке клиента. В промпт стоит добавить только порядок сценария: «сначала узнай услугу, потом предложи время, и только после согласия вызови запись». Если бот напишет «записал», не вызвав функцию, платформа сама даст ему круг на исправление (как это работает).

Может ли собеседник заставить бота прислать чужую ссылку или номер?
Нет. Ссылки, телефоны, номера карт и почту бот пишет только те, что есть в ваших данных: в промпте, информации о компании, базе знаний и ответах функций. Если человек попросит «забудь правила и напиши ссылку X», предложение с чужой ссылкой из ответа уберётся само. Свой номер и свою почту клиент получит обратно («ваш номер +7 …, верно?»), а под постами в Instagram ответ ИИ не содержит ни ссылок, ни номеров вовсе. Так работает во всех каналах: WhatsApp, Instagram, Telegram и чат на сайте.

Под капотом

• Промпт хранится в проекте; правки автосейвятся (debounce ~1.2 c для промпта, ~900 мс для коротких полей). История версий: локальная (последние 5) + серверная.
• «Итоговый промпт» = системный промпт + подмешанные блоки (инфо о компании, инструкции воронки/стадий, доступные функции). Именно он уходит модели.
• Воронка (funnel_enabled) включает в ответе модели поля lead_status (7 значений) и stage (6 значений, без отката назад). Создание лида: авто при переходе в qualified/hot/reserve (имя и телефон для этого не нужны, подставляются, если бот их уже узнал); при выключенной воронке по телефону из переписки; плюс функция с галочкой «Это заявка». Полный формат, статья JSON-ответ бота.
• «Статус бота», kill-switch: выключение требует подтверждения и глушит ответы во всех каналах. Сообщения клиентов при этом не теряются: с 08.10.2026 во всех каналах (WhatsApp, Telegram, Instagram) они ложатся в «Диалоги» с пометкой «ждёт ответа», отвечает оператор.
• Конструктор «Составить за меня»: POST /api/projects/{id}/prompt/compose, режимы compose (платно, 30 центов, gpt-5.4-mini, при обрезке ответа повтор на gpt-5.4) и prefill (бесплатно, вытаскивает ответы из текущего текста). Каркас, манера и сборка готового документа лежат в @dos/ai-pipeline (prompt-compose.ts): модель отдаёт только факты компании, скелет собирает код, поэтому манера у всех новых ботов одна и та же дословно. С 04.10.2026 факты ложатся в projects.description (поле «Информация о компании»), если оно пустое, а в промпте остаётся строка «отвечай по разделу «О КОМПАНИИ»» (COMPOSE_FACTS_POINTER); непустое поле не трогается, и факты идут в промпт. Пустой промпт больше не глушит бота: вместо заглушки он отвечает в общей манере и честно говорит, что про компанию ему ещё не рассказали.
• Тонкие настройки (расписание, буферизация, расщепление ответов, распознавание медиа, кому отвечает бот, антиспам): на вкладке Промпт → Расширенные настройки. Там же паузы на оператора и звонок и автовозобновление; функции остановок стоят в разделе «Функции» у каждого проекта с рождения.
• Язык ответа задавать не нужно. Бот отвечает на языке последнего сообщения клиента: по-казахски на казахский, по-русски на русский, зеркалит смешанный. Это правило платформы, оно стоит у всех ботов поверх промпта, даже если сам промпт и информация о компании написаны по-русски. Казахские голосовые расшифровываются с подсказкой языка.

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

Системный промпт это просто текст, которым ты объясняешь боту, как себя вести, как разговаривать, что предлагать, чего нельзя и к чему вести клиента. Пиши его как инструкцию новому сотруднику в первый день. Главное правило: «как общаться» в промпт, а «сколько стоит и что у нас есть» в отдельную Базу знаний, чтобы бот не путал цифры. Написал промпт: сразу проверь бота в тестовом чате и поправь, если где-то не так. Это нормально подкручивать несколько раз: так и получается хороший бот.

Дальше: → Тестовый чат
Связано: Как бот думает · База знаний · Функции
Не получилось? → Бот не отвечает

Документация › Проект и бот › JSON-ответ бота

JSON-ответ бота (статусы, стадии, флаги)

[для продвинутых] Бот отвечает структурированным JSON, а не голым текстом: текст ответа + что он понял про клиента (имя, телефон, стадия, статус лида). Эта статья, что внутри и зачем.

⏱ 8 мин · 👤 для разработчика и любопытного владельца · 🟢 live

За 30 секунд:

• Бот возвращает JSON, не «голый текст»: поле answer (ответ) + метаданные диалога.
• Из JSON платформа достаёт: имя/телефон/email клиента, стадию воронки, статус лида, нужно ли продолжать диалог.
• Никакого стриминга: ответ приходит целиком; «эффект печатания» делается разбивкой на части на стороне клиента.
• Удалённые поля (selected_service, services) бот иногда всё ещё шлёт, платформа их молча выкидывает.

Зачем боту JSON, а не текст

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

Поля ответа

Ответ проверяется по схеме (ai-response-schema.ts). Основные поля:

📌 stage и lead_status, обычные строки, а не жёсткий список, потому что проект может задать свой набор стадий/статусов. Платформа проверяет значение по разрешённому набору проекта; если значение «чужое», пишет предупреждение и оставляет старое, а не ломает диалог. Если воронка у проекта выключена, stage/lead_status из ответа игнорируются.

🛑 Бот НЕ останавливает диалог сам. Раньше бот мог сам решить «разговор окончен» и уйти на паузу (поля continue_to_talk/stage=done): это убрали, потому что модель делала это преждевременно (замолкала прямо после записи, игнорируя следующий вопрос клиента). Теперь диалог завершается только явной функцией: «Остановить диалог» или любой функцией с галочкой «Завершать диалог после выполнения». Так бот всегда дообщается, пока вы сами (или функция) его не остановите.

Разбивка на части (эффект печатания)

Бот может прислать message_parts, несколько коротких сообщений вместо одного длинного. Платформа отправляет их по очереди с паузой между ними (4 секунды у всех проектов), создавая ощущение «человек печатает».

⚠️ Это НЕ стриминг. Ответ модели приходит целиком и сразу; «постепенность» это клиентская пауза (setTimeout) между уже готовыми частями. Стриминг в платформе не используется (он ломал бы подсчёт токенов и возвраты). Управление разбивкой: в продвинутых настройках (split_*).

Игнорируемые поля

Модель по привычке иногда возвращает selected_service / services: это поля удалённой фичи «Услуги» (убрана 2026-04-22). Схема их принимает и молча отбрасывает, чтобы старый «мусор» от модели не ломал разбор ответа. Это не ошибка.

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

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

Тебе как владельцу в это лезть не нужно, всё работает само. Знать про это полезно в одном случае, если хочешь, чтобы бот точнее определял стадии и статусы под твой бизнес, опиши правила в промпте, и он будет аккуратнее заполнять эту «анкету».

Дальше: → Выбор AI-модели
Связано: Системный промпт · Стадии воронки · Лиды · Продвинутые настройки
Не получилось? → Бот не отвечает

Документация › Проект и бот › Выбор AI-модели

Выбор AI-модели

Бот работает на одной из моделей OpenAI. По умолчанию: быстрая и недорогая, её хватает 90% бизнесов. Можно поставить «умнее», но каждое сообщение будет дороже.

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

За 30 секунд:

• Модель выбирается на проект (не на каждый чат).
• По умолчанию, gpt-5.4-mini: быстрая, недорогая, для большинства задач достаточно.
• Есть модели мощнее (лучше рассуждают на сложных диалогах) и легче (ещё дешевле/быстрее).
• Чем мощнее модель, тем дороже каждое сообщение (быстрее тратится баланс). См. Сколько стоит сообщение.

📍 Где найти. Вкладка проекта «LLM» → блок «Выбор модели». Модель выбирается из списка: у каждой написано семейство, для чего она подходит и скорость, рядом цена за миллион токенов. Под списком «Глубина размышления», а в спойлере «Сравнение моделей» таблица всех моделей.

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

У проекта есть настройка модели (projects.openai_model). Если не менял, действует модель по умолчанию gpt-5.4-mini. Менять стоит осознанно: модель влияет на качество ответов и на стоимость каждого сообщения.

Доступны 11 моделей четырёх семейств OpenAI: GPT-5.5 (gpt-5.5), GPT-5.4 (gpt-5.4-mini, gpt-5.4, gpt-5.4-nano), GPT-5 (gpt-5-mini, gpt-5, gpt-5.1, gpt-5.2) и GPT-4.1 (gpt-4.1-mini, gpt-4.1, gpt-4.1-nano), от самой лёгкой nano до флагмана. Помечены как популярные две: gpt-5.4-mini (по умолчанию) и gpt-4.1-mini (самая экономная из рабочих). Модели отличаются по трём осям:

• Ум: насколько хорошо держит сложный диалог, следует инструкциям, рассуждает.
• Скорость, как быстро отвечает.
• Цена за сообщение: сколько баланса уходит на один ответ.

💡 Не гонись за самой мощной моделью «на всякий случай». Для записи в барбершоп или ответов по прайсу mini справляется не хуже, а баланс тратит в разы медленнее. Бери мощную, только если видишь, что бот реально «тупит» на твоих диалогах в тест-чате.

⚠️ Стоимость. Более мощная модель = больше списание за каждое сообщение. На потоке (сотни диалогов) разница в балансе ощутима. Прежде чем переключать весь проект, прогони сложные кейсы в тест-чате и реши, стоит ли качество денег.

Глубина размышления

Под выбором модели стоит вторая настройка: «Глубина размышления». Это скрытая работа модели перед ответом: она проверяет расписание, цифры и свои же выводы, и только потом пишет. Четыре положения:

⚠️ Почему прибавка больше, чем кажется. Один ответ клиенту это обычно не одно обращение к модели, а 4-5: бот вызывает функцию, читает результат, иногда вызывает вторую, и только потом пишет. Размышление оплачивается в КАЖДОМ обращении. Цифры в таблице это замер на живых ботах и уже учитывают это: «Обычная» примерно удваивает цену одного ответа (на нашем замере ответ стоил 1,2 цента без размышления и 2,0 цента с «Обычной»). Если считаешь бюджет на месяц, умножай прибавку на число ответов бота, а не диалогов.

Стоит ли ставить «Глубокую». Мы прогнали восемь боевых вопросов (возврат части пакета, «сколько всего выйдет», сроки, условия рассрочки) на «Обычной» и «Глубокой». Ошибок не было ни у той, ни у другой. Разница вышла в другом: «Глубокая» думает примерно вдвое дольше «Обычной» и делает ответ дороже ещё примерно на 40%. Поэтому по умолчанию стоит «Обычная», а «Глубокую» имеет смысл включать точечно: если видишь в тест-чате, что бот путается в многошаговых расчётах.

Работает для моделей семейства gpt-5 (кроме o-серии, она думает всегда по-своему). Пока положение не выбрано, под кнопками написано, что применяет платформа. Та же настройка есть в тест-чате, чтобы сравнить положения на своих диалогах перед тем, как менять для клиентов.

Креативность и повторы

У моделей семейства GPT-4.1 ниже на той же вкладке появляются три ползунка: «Креативность» (насколько свободно бот формулирует), «Штраф за повторения» (чтобы не повторял одни и те же слова) и «Разнообразие тем» (чтобы не возвращался к уже обсуждённому). У каждого есть подсказка с примером. Модели семейства GPT-5, включая модель по умолчанию, эти настройки не принимают, поэтому у них блока с ползунками нет. Если бот отвечает нормально, не трогайте.

Модель для дожимов отдельно

Для дожимов можно задать свою модель (обычно дешевле основной: дожимы проще), у каждого шага дожима отдельно. Если не задана, наследуется модель проекта.

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

«Модель» это мозг бота. Их несколько: попроще-побыстрее-подешевле и поумнее-помедленнее-подороже. По умолчанию стоит средне-лёгкая (gpt-5.4-mini), и для большинства задач: записать клиента, ответить по прайсу, снять простое возражение, её за глаза.

Включать самую мощную «чтобы наверняка» не надо: она будет отвечать так же, но баланс съест заметно быстрее. А вот «Глубину размышления» на «Обычной» держать стоит: это несколько секунд ожидания, зато бот не предложит клиенту занятое время. Менять модель есть смысл, только если ты в тест-чате видишь, что бот реально не вывозит сложные разговоры. Тогда поставь мощнее, но имей в виду, что каждое сообщение станет дороже.

Дальше: → Тестовый чат
Связано: Системный промпт · Продвинутые настройки · Сколько стоит сообщение
Не получилось? → Бот не отвечает

Документация › Проект и бот › Тестовый чат

Тестовый чат

Песочница, где ты говоришь с ботом сам: проверить промпт, функции и знания до того, как он попадёт к живым клиентам.

⏱ 7 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Тест-чат = безопасная репетиция: бот думает как в бою, но без реальных клиентов.
• Справа панель «Что понял бот»: стадия, статус лида, что узнал о клиенте, какие функции вызвал, токены.
• Меню «Инструменты теста»: сценарии, загрузить переписку, показать промпт, экспорт.
• Рубильник ИИ отсюда убран: здесь только индикатор; включается бот на вкладке «Промпт» → «Расширенные настройки» («Статус бота»).
• Работает и с пустым промптом: бот отвечает живо и честно говорит, что про компанию ему пока не рассказали, а в углу висит карточка «Составить за меня». Клик мимо карточки просто продолжает разговор.
• После сборки промпта в поле уже лежит первое сообщение «клиента»: нажми «Отправить».
• Проверяй тут каждое изменение промпта/функций/знаний.

Зачем это нужно

Менять промпт и сразу выпускать в WhatsApp, рискованно: ошибку увидят живые клиенты. Тест-чат даёт «прогнать» бота на реальных вопросах в безопасной среде. Это тот же самый «мозг», что и в бою (см. где бот работает одинаково): что работает здесь, так же сработает у клиента.

Где это

Левое меню → «Тестовый чат» (рабочие разделы открытого проекта). Нужна роль tester и выше (тестер может гонять бота, но ничего не меняет).

Что ты видишь

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

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

Справа: панель «Что понял бот» (главная ценность теста). Показывает «изнанку» каждого ответа:

Сверху, шапка: модель, индикатор «Бот включён / выключен» (только показывает; управление на вкладке «Промпт» → «Расширенные настройки») и меню «Инструменты теста».

«Как увидит клиент»: WhatsApp или Instagram. Переключатель в шапке. В положении Instagram бот отвечает по правилам директа (окно 24 часа, не обещает «напишу завтра»), а ответ показан так, как его получит клиент в Instagram: без жирного, длинный текст частями по 1000 байт, кнопки под последним сообщением. Выбор запоминается для проекта, переписку тест-чата он не стирает. В положении WhatsApp тест-чат отвечает как раньше.

Поправить ответ словами

Бот ответил не так? Под его последним ответом есть ссылка «Не так ответил? Поправить словами».

1. Нажми на неё и напиши, что не так, как сказал бы сотруднику: «цену называй сразу, чистка 15 000 тенге».
2. Ниже видно, что изменится: твоя фраза дословно встанет правилом в конец промпта, в раздел «Правки владельца».
3. Нажми «Применить и спросить снова»: правило сохраняется, и бот отвечает на тот же вопрос заново, уже с ним.

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

Инструменты теста

В меню «Инструменты теста»:

• Сценарии: готовые наборы сообщений для типовых проверок;
• Загрузить переписку: подставить реальный диалог, чтобы проверить на нём;
• Показать промпт: увидеть итоговый промпт, который уходит модели;
• Экспорт диалога: выгрузить тестовую переписку.

Кнопка «Очистить» сбрасывает тестовый диалог.

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

1. Внёс правку в промпт / функцию / базу знаний;
2. Открой тест-чат, прогони реальные вопросы клиентов:
3. типичный («сколько стоит?»),
4. целевой («запишите меня на завтра»),
5. каверзный («а если опоздаю?», «дорого»),
6. не по теме («а вы где находитесь?»);
7. Смотри панель справа: правильная ли стадия, вызвал ли нужную функцию, что собрал;
8. Не так → правь → повторяй, пока не понравится.

💡 Совет. Если бот должен вызывать функцию (записать, посчитать), проверь в «Действиях бота», что вызов был, а не только слово «записал» в ответе.

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

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

Счёт и запись в календарь в тест-чате настоящие. Касса выставляет настоящий счёт (push в Kaspi или ссылка на оплату) на номер, который ты назвал, а запись в календарь ставится по-настоящему с пометкой «ТЕСТ»: так ты видишь путь клиента до конца. Сумма тестового счёта всегда 100 ₸ (у кассы в сомах 100 сом), какой бы ни была цена услуги: настоящую сумму бот называет в ответе, а под строкой счёта в тест-чате видна пометка «Тестовый счёт на 100 ₸ вместо …». Через 10 минут всё откатывается само: оплата возвращается, неоплаченный счёт отменяется, тестовая запись удаляется. Бот предупреждает об этом в ответе, сбор платформы за тестовую оплату не берётся. Комиссию Kaspi за прошедшую оплату банк при возврате может не вернуть, поэтому платить по тестовому счёту не обязательно: достаточно увидеть push.

«Не так ответил? Поправить словами». Под последним ответом бота есть ссылка. Напиши, что не так, как сказал бы сотруднику («цену называй сразу, чистка 15 000»), и нажми «Предложить правку». Модель сама находит, куда относится замечание: в промпт, в информация о компании или в запись базы знаний, и показывает, что именно изменится (убранные и добавленные строки). «Применить и спросить снова» сохраняет правку и переспрашивает бота; прежний текст уходит в историю версий, и рядом есть «Вернуть как было». Для тебя это бесплатно, у платформы есть дневной запас на проект; если он кончился, правку можно внести руками на вкладке «Промпт».

⚠️ Важно: тест-чат, песочница, а не показатель готовности к бою. Здесь бот отвечает, даже когда он выключен для клиентов и подписки нет. Поэтому:

• если вверху «Бот выключен», в тест-чате бот отвечает, а реальные клиенты в WhatsApp ответа не получат;
• если кончились подписка или бесплатные дни, в тесте бот отвечает, а в WhatsApp и Instagram клиентам молчит (Telegram подписки не требует).

Баланс нужен и тесту: на нуле тест-чат не ответит и предложит пополнить. То есть «в тесте работает» ≠ «в бою работает». Перед запуском проверь, что бот включён, есть подписка или бесплатные дни, подключён канал и есть баланс.

Частые ошибки

Под капотом

• Тест-чат работает в sandbox-режиме: стоимость ответа списывается с баланса проекта, как в бою. Подписку и статус бота он не проверяет, а баланс проверяет: на нуле пайплайн бросает InsufficientBalanceError, и маршрут отвечает 402 с предложением пополнить.
• Панель «Что понял бот» рендерит реальный структурированный ответ модели: стадия, lead_status, собранные переменные (с % заполнения), tool-calls (имя/аргументы/результат), RAG-источники с % похожести, токены и стоимость (USD + ₸), сырой JSON.
• Рубильник ИИ из тест-чата убран осознанно (редизайн 2026-06-05): здесь индикатор + ссылка, управление, на settings?tab=bot (единый источник).
• «Проверить дожим» дёргает превью следующего follow-up-сообщения.
• У тест-чата дневной лимит по себестоимости ИИ: $5 на проект и $10 на всю платформу, сутки по Алматы. Он защищает общий счёт ИИ, на котором отвечают боты всех клиентов, от массовых прогонов. Ответы живым клиентам лимит не трогает, а тест-чат после него отвечает отказом до полуночи.

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

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

Дальше: → Подключить WhatsApp
Связано: Системный промпт · Функции · База знаний
Не получилось? → Бот не отвечает

Документация › Проект и бот › Продвинутые настройки

Продвинутые настройки бота

Помимо промпта, поведение бота тонко настраивается, как он разбивает ответы, ждёт ли, пока клиент допишет, в какие часы работает, как реагирует на оператора, что делает со спамом. Эта статья: карта всех рычагов.

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

За 30 секунд:

• Бот «печатает по частям», ждёт, пока клиент допишет, может работать по расписанию, уступать оператору, защищаться от спама.
• Всё это, настройки проекта (agent_config), у каждой есть разумное значение по умолчанию.
• Трогай по необходимости: дефолты подобраны так, чтобы работало «из коробки».

📍 Где найти. Вкладка проекта «Промпт» → подвкладка «Расширенные настройки». Разделы раскрываются по клику: История переписки, Расписание работы, Распознавание медиа, Буферизация сообщений, Длина и разбивка ответов, Видимость данных клиента, Контроль оператора, Лимиты, Спам-защита. Над разделами, в самом верху подвкладки, стоят «Статус бота» и карточка «Кому отвечает бот», а выбор модели живёт на отдельной вкладке «LLM».

Ответы: разбивка и темп

💡 Разбивка делает бота «живее»: клиент видит несколько коротких реплик вместо стены текста. Подробнее про механику: JSON-ответ бота.

📝 Каждая мысль с новой строки: у всех ботов, без кнопки. С 08.10.2026 платформа просит модель начинать новую мысль с новой строки, а перечисления (часы, адрес, цены нескольких услуг, шаги) писать по пункту на строку, чтобы ответ не читался сплошным абзацем. С 15.10.2026 это делает сама платформа перед отправкой: каждая фраза ответа встаёт с новой строки («Здравствуйте)» и с новой строки «Чем могу помочь?»), а списки, анкеты и реплики в кавычках остаются как написаны. Короткий ответ при этом по-прежнему приходит одним сообщением. Ссылки в ответе бота всегда уходят полным адресом с https://, чтобы клиент открыл их одним нажатием. С 15.10.2026 платформа также сама ставит пустую строку между блоками ответа (приветствие, ответ, список, вопрос), отделяет реплики сценки и приводит пункты списка к виду «- пункт»: это не зависит от модели. Кнопка «Выделять главное» добавляет к этому жирный на цену, время и адрес (платформа ставит его сама, если модель не поставила), короткий курсив для ремарок и нумерацию. С 15.10.2026 она включена по умолчанию у всех ботов. Если в вашей переписке жирный читается как реклама, выключите её: выбор за владельцем. В тест-чате выделение видно так же, как его увидит клиент в WhatsApp.

Буферизация: дождаться, пока клиент допишет

Клиенты часто пишут мысль несколькими сообщениями подряд («Здравствуйте» / «хочу записаться» / «на завтра»). Чтобы бот не отвечал на каждое по отдельности, есть буфер:

Бот ждёт паузы в наборе и отвечает на всё разом, как живой человек.

Одиночное сообщение бот берёт в работу через пару секунд, чтобы не тянуть с ответом. Если клиент дописал, пока бот сочинял ответ, этот ответ не уходит: бот отвечает на все сообщения сразу, одним ответом. Исключение одно: бот уже что-то сделал по первому сообщению (записал, создал заявку, выставил счёт), тогда клиент сначала получает подтверждение. За непосланный ответ деньги с баланса не списываются.

Кому отвечает бот

Одна настройка (engage_mode) с тремя взаимоисключающими вариантами. Живёт на вкладке «Промпт» → «Расширенные настройки»: карточка «Кому отвечает бот» стоит в самом верху, сразу под «Статусом бота», над свёрнутыми разделами.

В каких каналах действует. В WhatsApp и Instagram (в Instagram с 8 октября 2026, до этого настройка там не работала, хотя кабинет обещал «все каналы»). В Instagram «прежний контакт» это человек, с которым у аккаунта была переписка в директе до подключения бота: при первом сообщении нового собеседника платформа спрашивает об этом Meta, и если Meta не ответила, бот отвечает (новый клиент дороже). Свежий клик по рекламе возвращает боту диалог, который он пропустил как «прежний контакт» или «не с рекламы», если вы не писали в этот чат сами в последние полчаса. В Telegram бот отвечает всем, кто написал боту: прежних контактов у Telegram-бота не бывает, а рекламы с переходом в бота нет.

Отдельный режим для Instagram. Если Instagram подключён, в той же карточке ниже есть строка «В Instagram»: «Как выше» (по умолчанию, Instagram следует общему режиму) или один из трёх режимов. Так WhatsApp можно держать в режиме «Только новым обращениям», чтобы бот не писал знакомым, а в Instagram отвечать всем, кто напишет в директ, включая тех, кто писал до подключения бота. Переключение Instagram на «Всем, кто напишет» возвращает бота только в диалоги Instagram, общий режим их не трогает, и наоборот. В режиме «Всем, кто напишет» диалог Instagram, который бот раньше пропустил как «прежний контакт», возвращается боту и на следующем сообщении клиента, если вы не писали в этот чат сами в последние полчаса.

С 14 сентября 2026 новый проект стартует в режиме «Всем, кто напишет»: человек, подключивший номер, ждёт, что бот ответит всем, и молчание в половине чатов читается как поломка. Проекты, созданные раньше, остаются в режиме «Только новым обращениям», пока владелец его не сменит. Если рабочий номер это ещё и личная переписка, переключи на «Только новым обращениям»: в мягком режиме бот ответит и знакомым, и подрядчикам. В строгом режиме в диалоге со старым контактом кабинет показывает, что включён строгий режим, и кнопку включить бота здесь.

Что важно знать про режим «Всем, кто напишет»:

• переключение ничего не рассылает: оно только снимает паузу с пропущенных диалогов, а пишет бот лишь в ответ на следующее сообщение клиента;
• бот не отличает давнего клиента от личного контакта. Если номер рабочий и личный одновременно, он ответит и знакомым;
• чаты, где вы отвечаете сами, бот по-прежнему уступает вам (пауза при ответе оператора), а диалоги, из которых бота убрали руками или которые закрыты передачей менеджеру, режим не будит;
• расход баланса вырастет: старая база это дополнительные диалоги.

На сообщения, отправленные до подключения номера, бот не отвечает ни в одном режиме. Иначе после каждого сканирования QR он разослал бы ответы на старую переписку, а WhatsApp блокирует номера именно за такой всплеск.

Настройки рекламного фильтра

В список можно вставлять (по одному в строке):

• ID объявления из Ads Manager (числа вида 1202…), самый надёжный способ: передаётся со 100% рекламных лидов и виден ещё до запуска рекламы;
• ссылку на рекламный пост (https://www.instagram.com/p/…/), тоже работает заранее, но у части лидов ссылка не передаётся (короткие fb.me-переходы).

Как настроить фильтр ДО запуска рекламы (передайте таргетологу):

1. Создайте кампанию и объявления как обычно, запускать не обязательно, достаточно, чтобы объявления были созданы.
2. В Ads Manager откройте вкладку «Объявления» → «Столбцы: настроить столбцы» → включите столбец «ID объявления» (Ad ID).
3. Скопируйте ID нужных объявлений и вставьте их в поле настроек, по одному в строке.
4. ⚠️ При дублировании объявления или перезапуске креатива у копии появляется новый ID: добавьте и его. Один и тот же креатив, запущенный дважды: это два разных объявления с разными ID и разными ссылками на пост.

ID уже пришедшего лида виден в его диалоге: карточка справа → блок «Источник, реклама». Лид, отсечённый фильтром, не пропадает, он сохраняется в CRM с пометкой для оператора, просто бот на него не отвечает.

Перехват оператором и остановки

Позвонили клиенту сами: как выключить бота

Если клиент позвонил вам и вы взяли трубку, бот в этом чате замолкает сразу.

Если звонили вы, бот тоже замолчит, но не сразу. О звонке с вашего телефона WhatsApp сообщает подключённому устройству записью в чате, и приходит она с задержкой: обычно через несколько минут после разговора, иногда позже. Как только запись дошла, бот в этом чате выключается. Звонок старше двух часов бота уже не выключает: к тому моменту клиента мог вести бот, и обрывать его молча было бы хуже.

Выключить бота сразу после разговора можно за секунду: напишите что-нибудь в этот же чат («созвонились», «всё обсудили», что угодно). Бот увидит, что в диалог пришёл живой человек, и замолчит по обычному правилу перехвата. Это то же самое, что происходит, когда вы отвечаете клиенту руками.

Второй способ, если писать не хочется: откройте диалог в кабинете и нажмите переключатель «Отвечает бот» в шапке переписки, он сменится на «Бот молчит».

Три функции про остановки («Остановить диалог», «Отложить дожимы», «Отключить дожимы») стоят у каждого проекта с рождения и живут в разделе «Функции»: там же их можно выключить, поправить описание «когда вызывать» или удалить.

Подробно про перехват, Диалоги; про три функции, Функции, разделы 7.8-7.10.

Расписание работы (рабочие часы)

Вне рабочих часов бот не тратит токены: сохраняет сообщение клиента (оператор увидит его в CRM) и один раз на диалог шлёт автоответ «сейчас нерабочее время».

Память диалога

Защита от спама

⚠️ Автоблок срабатывает и на живом человеке: при пороге 3 три «ок» подряд за разговор уже считаются спамом, и бот на этом диалоге выключается, пока его не включат вручную. Поэтому новому проекту защита включена с порогами под флуд и без автоблока: сработав, бот пропускает ответ, а не теряет клиента.

Распознавание медиа

⚠️ Распознавание голоса и картинок тратит баланс (это отдельная обработка). Если не нужно, выключи. См. Сколько стоит сообщение.

Запись на приём (календарь)

Настройки записи живут не здесь, а внутри самой функции записи: открой Функции → функцию записи → её конфиг. Там задаются длительность приёма (по умолчанию 60 мин), горизонт показа свободных окошек (7 дней), рабочие часы и дни записи, перерыв между приёмами и минимальное предупреждение (60 мин).

⚠️ Раньше эти же параметры дублировались настройками проекта calendar_*. Их убрали 2026-06-13, потому что редактор писал в одно место, а бот читал другое, и половина настроек молча не работала. Сейчас источник один, конфиг функции. Если встретишь calendar_* в старых заметках, это уже мёртвые ключи.

Подробно: Запись на приём и Google Календарь.

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

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

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

Дальше: → Обзор каналов
Связано: Системный промпт · Выбор модели · Дожимы · Диалоги
Не получилось? → Бот не отвечает

Документация › Проект и бот › Загрузить знания о бизнесе

Загрузить знания о бизнесе в бота (что куда)

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

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

За 30 секунд:

• У бота три места для знаний, и у каждого своя работа: промпт (как себя вести + всегда-нужное продающее), «Информация о компании» (факты о тебе), База знаний (большие и меняющиеся справочники).
• Главная ошибка новичка: свалить всё в одно место. От этого бот тупеет: либо «деревянный», либо выдумывает, либо не находит нужное.
• Правило в одну строку: поведение → промпт, факты о компании → информация о компании, толстые справочники → база знаний.
• Ничего не нужно «вызывать», бот сам подмешивает всё это в каждый ответ (база знаний по релевантности, остальное: всегда).

Зачем это нужно

Бот знает ровно то, что ты ему дал, и где ты это дал. Один и тот же факт, положенный не в тот «карман», либо раздувает стоимость каждого ответа, либо вообще не доходит до бота. Поэтому «закинуть документацию в ИИ» это не «вставить всё в одно поле», а разложить её правильно. Сделаешь это один раз грамотно, бот сразу отвечает как живой менеджер, который выучил твой бизнес.

Три «кармана» бота, и что в каждый класть

💡 Простое правило выбора. Спроси себя про каждый кусок информации:

1. Это про то, как бот себя ведёт и продаёт? → промпт.
2. Это факт о компании, нужный почти в любом разговоре (услуги, адрес, часы)? → «Информация о компании».
3. Это большой справочник, из которого в одном ответе нужна одна строка (полный прайс, регламент)? → база знаний.

Шаги

1. Раздели свою документацию на три стопки

Собери всё, что есть про бизнес: сайт, прайс в Excel, скрипты продаж, регламенты, FAQ, презентации, и мысленно разложи по трём карманам выше. Это самый важный шаг: 10 минут сортировки экономят недели «бот тупит».

📌 Пример (барбершоп).

• Промпт: «Ты это администратор барбершопа BRUTAL. Дружелюбный, на «ты», всегда предлагаешь записаться. Если клиент сомневается, расскажи про бесплатную коррекцию через 2 недели.»
• Информация о компании: «Барбершоп BRUTAL, Астана, пр. Достык 5. Часы: 10:00-21:00 без выходных. Услуги: мужская стрижка, борода, камуфляж седины. Мастера: Арман, Данияр.»
• База знаний: полный прайс на 40 позиций + детальный FAQ по уходу.

2. Поведение и продающие приёмы → в промпт

Открой Системный промпт и опиши как бот работает: характер, тон, правила, шаги продажи, отработку частых возражений. Продающий контент, который нужен почти всегда (короткая презентация, ответ на «дорого»), держи прямо в промпте: так бот выдаёт его уверенно.

🚫 Не делай так. Не прячь характер и презентацию в базу знаний: оттуда бот достаёт текст только если вопрос «похож», и в половине диалогов промахнётся → бот выйдет деревянным.

3. Факты о компании → в «Информацию о компании»

В настройках проекта есть отдельное поле «Информация о компании» (не путай с промптом). Сюда, сухие факты: услуги, адреса, часы, условия, контакты. Платформа сама вставит это в каждый ответ отдельным блоком «О КОМПАНИИ», тебе не надо дублировать их в промпт.

⚠️ Важно. Не оставляй это поле пустым «потому что напишу в промпте». Поле сделано именно под факты и вмещает до 40 000 символов: это правильный дом для них. Пустое поле → бот чаще выдумывает детали.

4. Толстые и меняющиеся справочники → в базу знаний

Полный прайс, длинные регламенты, большой FAQ, документы и PDF: в Базу знаний. Бот на каждый вопрос сам находит там самые подходящие куски и подмешивает в ответ (это RAG, автоматически). Туда же, то, что часто меняется: обновил одну запись, и бот сразу отвечает по-новому, промпт трогать не надо.

📌 Пример (интернет-магазин). Каталог на 300 товаров в базу знаний. Клиент спрашивает про одну модель, бот достаёт именно её строку, а не зачитывает весь каталог.

Проверь, что работает

1. Прогони реальные вопросы клиентов в Тест-чате. В «технических деталях» ответа видно, какие источники бот подтянул, так проверишь, что факт дошёл.
2. Для базы знаний есть «Тест поиска»: вводишь вопрос → видишь, какие фрагменты бот найдёт и с каким % похожести.
3. Признак, что разложил верно: бот отвечает фактами точно (цены, адрес), звучит в своём характере и не «зачитывает простыню».

Частые ошибки

Вопросы, которые обычно возникают

Можно всё засунуть в промпт и не морочиться?
Маленький бизнес с парой услуг: да, проживёт. Но большой прайс в промпте = дорогой и «путающийся» бот: он тащит весь текст в каждый ответ. Факты в «Информацию о компании», объём: в базу знаний.

В чём разница между «Информацией о компании» и базой знаний?
«Информация о компании» идёт в ответ целиком и всегда (для коротких всегда-нужных фактов). База знаний, большая, и бот берёт из неё только релевантный кусок под вопрос. Прайс на 3 услуги в «Информацию о компании»; прайс на 100 в базу.

Я обновил прайс, где менять?
Там, куда положил. Если в базе знаний, отредактируй запись (бот сразу учтёт). Если в «Информации о компании», поправь поле. Поэтому меняющееся удобнее держать в базе знаний.

Под капотом

• Финальный системный промпт собирается из блоков: твой системный промпт + блок «## О КОМПАНИИ» (из поля «Информация о компании», projects.description, лимит ввода 40 000 символов) + подмешанные на лету чанки базы знаний (суммарно до 8 000 символов, гибридный поиск под текущее сообщение: по смыслу, по точным словам и с поправкой на опечатки).
• Промпт и «Информация о компании» идут в каждый запрос целиком, поэтому их размер прямо влияет на стоимость ответа. База знаний платится отдельно (≈1¢ за поиск) и тащит только релевантное.
• «Информация о компании» ограничена 40 000 символов на ввод; если фактуры больше, выноси объём в базу знаний (до 100 записей; вставленный текст до 1 000 000 символов, извлечённый из файла до 500 000).
• Персона/продающие приёмы держим inline в промпте, а не в RAG: RAG возвращает контент только при семантическом совпадении с сообщением, а характер нужен в каждом ответе.

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

Представь, что нанял нового продавца. Есть три способа его обучить. Первое, объяснить, как себя вести: будь вежлив, всегда предлагай записаться, на «дорого» отвечай так-то. Это «системный промпт». Второе, дать визитку компании: кто мы, где, во сколько работаем, что продаём. Это «Информация о компании». Третье, положить на стол толстую папку с прайсом и регламентами, в которую он заглядывает, когда нужен конкретный пункт. Это «база знаний». Если всё свалить в папку, продавец будет рыться в ней даже на «привет» и звучать как робот. Если папку не дать, начнёт выдумывать цены. Разложишь правильно, и бот с первого дня отвечает как менеджер, который выучил твой бизнес.

Дальше: → База знаний (RAG)
Связано: Системный промпт · Как бот думает · Тестовый чат
Не получилось? → Бот не отвечает

Документация › Каналы › Обзор каналов

Каналы, где бот отвечает клиентам

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

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

За 30 секунд:

• Каналы: WhatsApp (ваш номер по QR), Telegram (свой бот от @BotFather), Instagram (директ через вход Meta). Подключаются на вкладке проекта «Каналы». Все три открыты всем аккаунтам.
• Подключить можно любой один или все сразу. Настраивать бота под каждый канал отдельно не нужно.
• WhatsApp и Instagram входят в подписку проекта (первые 14 дней бесплатно), Telegram работает без подписки. Ответы бота везде оплачиваются с баланса.
• Тест-чат это не канал, а репетиция в кабинете: бот отвечает как в бою, но только вам.

Чем каналы отличаются

Подключение WhatsApp с компьютера идёт по QR-коду, а с телефона кодом привязки из восьми знаков: QR на экране того же телефона отсканировать нечем. Режим «Кому отвечает бот» настраивается в расширенных настройках, у Instagram он свой с 9 октября 2026.

С чего начать. Клиенты уже пишут вам в WhatsApp: начните с него, но прочитайте антибан. Хотите проверить бота в бою за пять минут без риска: начните с Telegram. Основной поток идёт из рекламы в Instagram: подключайте Instagram.

Как каналы видны в кабинете

• У каждого диалога метка канала, а над списком диалогов фильтр по каналу.
• Лиды и аналитика собираются вместе по всем каналам, в разрезе видно, откуда пришёл клиент.
• Состояние каждого канала (работает, ждёт подключения, доступ отозван) видно в обзоре проекта и на карточке канала.

Один номер WhatsApp, один бот Telegram и один аккаунт Instagram подключаются только к одному проекту. Два бизнеса значит два проекта.

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

Канал это мессенджер, где сидят ваши клиенты. Бот один, дверей к нему может быть три. Настраиваете бота один раз, и он одинаково отвечает в WhatsApp, Telegram и Instagram. Отличия только в правилах каждого мессенджера: WhatsApp требует живого номера, Instagram разрешает боту отвечать сутки после сообщения клиента, Telegram ничего такого не требует.

Дальше: → Подключить WhatsApp
Связано: Telegram · Instagram · Антибан · Как бот думает · Баланс и подписка
Не получилось? → Бот не отвечает · Канал отвалился

Документация › Каналы › Подключить WhatsApp

Подключить WhatsApp (по QR)

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

⏱ 12 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• WhatsApp подключается сканированием QR-кода, как обычный «WhatsApp на компьютере». Платформа держит привязанное устройство сама (самохостинг), отдельный сторонний сервис не нужен.
• Нужен «живой» рабочий номер (на котором уже переписывались), иначе WhatsApp забанит за спам.
• Никаких анкет перед сканом: нажал «Подключить свой номер», получил QR. Не читается камера, есть код по номеру телефона; номер у другого человека, есть ссылка, по которой он подключит его сам.
• Бесплатно: 14 дней, сколько угодно диалогов. Единственный ограничитель это баланс проекта: при регистрации мы кладём на него $5, и бот отвечает, пока эти деньги не кончатся. Дальше нужна подписка проекта.
• Телефоном можно продолжать пользоваться, бот работает как привязанное устройство, не вместо тебя.

Зачем это нужно

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

Каждая входящая переписка превращается в диалог, а заинтересованный клиент: в лида в твоей CRM. Ты в любой момент можешь перехватить разговор вручную (см. Диалоги).

Почему по QR, а не напрямую через API

У WhatsApp нет «кнопки подключить бота» для обычного аккаунта. Платформа привязывается к твоему WhatsApp как ещё одно устройство, точно так же, как WhatsApp Web на компьютере, и держит это привязанное устройство у себя (самохостинг). Тебе ничего настраивать не нужно: ты только сканируешь QR. Главное помнить, подключается обычный личный/рабочий WhatsApp по QR, а не official Business API.

Честно о том, что из этого следует: такой способ подключения Meta не гарантирует. Лимиты и паузы платформы снижают риск блокировки номера, но полностью исключить его не может никто, а Meta вправе ограничить сам способ подключения. Если Meta закроет его для всех, остальные функции продолжат работать, а неиспользованные дни подписки вернутся пропорционально: условия в Политике возврата, раздел 07.

⚠️ Важно с самого начала. WhatsApp очень не любит, когда «свежий» номер вдруг начинает отвечать как привязанное устройство. Подключишь «холодный» номер, Meta забанит его за минуты. Поэтому перед сканом честно ответь себе на пять вопросов из блока «Какой номер выбрать» ниже: по опыту, бóльшая часть банов именно из-за неправильного номера.

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

• ☐ Создан проект → Создание проекта
• ☐ Написан промпт бота, хотя бы черновой (иначе боту нечем отвечать) → Системный промпт
• ☐ Телефон с WhatsApp на номере, который уже использовался для обычной переписки (не только что куплен/зарегистрирован)
• ☐ Этот телефон под рукой: на нём надо открыть камеру для скана QR
• ☐ Роль в проекте admin или owner. Роль editor видит страницу, но кнопку подключения нажать не сможет → Роли и права. Если номер у другого человека (например, у владельца бизнеса, а настраиваешь ты), в проект его звать не нужно: есть ссылка для самостоятельного подключения, см. шаг 3.

Какой номер выбрать

💡 Совет. Один номер = один проект. Если у тебя два бизнеса (две стоматологии): это два проекта и два разных номера. Подключить два WhatsApp-номера в один проект нельзя.

Шаги

1. Открой раздел «Каналы»

Вкладка проекта «Каналы» → карточка WhatsApp (QRDOS). В ней текущее состояние и кнопка «Подключить свой номер».

2. Проверь номер (пять честных вопросов)

Анкеты перед сканом нет, платформа верит тебе на слово. Но именно от номера зависит, доживёт ли он до первой заявки: пройди пять вопросов перед подключением. Хотя бы одно «нет», и лучше взять другой номер.

3. Нажми «Подключить свой номер» и отсканируй QR

После нажатия статус меняется на «Поднимаем подключение...», через несколько секунд появляется QR-код и подсказка «Откройте WhatsApp → Связанные устройства → Привязать устройство и отсканируйте QR».

На телефоне с нужным номером:

1. Открой WhatsApp;
2. Связанные устройства (Linked Devices);
3. на iPhone: вкладка «Настройки» → «Связанные устройства»;
4. на Android: «⋮» (три точки) → «Связанные устройства»;
5. «Привязать устройство» → наведи камеру на QR-код на экране компьютера.

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

Подключаешь с телефона? QR на экране того же телефона отсканировать нечем, поэтому с телефона окно WhatsApp сразу начинается с привязки по коду: вводишь номер WhatsApp с кодом страны и жмёшь «Получить код». Код готовится обычно 10-30 секунд, страницу в это время не закрывай. Дальше WhatsApp сам пришлёт на этот номер уведомление «Введите код»: нажми его и введи код. Уведомления нет, тогда кнопка «Открыть WhatsApp» (код она заодно копирует) и путь «Связанные устройства» → «Привязать устройство» → «Привязать по номеру телефона», на экране он подписан под твой телефон, iPhone или Android. Под кодом идёт отсчёт: WhatsApp принимает код около двух с половиной минут. Истёк, окно само скажет «Код устарел» и даст «Получить новый код». Если WhatsApp стоит на другом телефоне, внизу есть «WhatsApp на другом телефоне? Показать QR-код», а ссылка для другого человека лежит ниже под спойлером.

Камера не читает QR? Под кодом есть переключатель «Не сканируется QR? Привязать по номеру телефона»: вводишь номер с кодом страны (например 77071234567), жмёшь «Получить код», а в WhatsApp идёшь в «Связанные устройства» → «Привязать устройство» → «Привязать по номеру телефона» и вводишь этот код.

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

4. Дождись статуса «Подключён»

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

Сразу после привязки над блоком висит плашка «Прогрев номера» с обратным отсчётом: «Бот начнёт отвечать новым клиентам через 14:59. Сразу после подключения номер прогревается: это защита от блокировки WhatsApp. Все сообщения при этом сохраняются, вы видите их в Диалогах». Это 15 минут тишины, а не поломка: см. Антибан.

Там же, в блоке, два полезных тумблера и подсказки:

• «Отмечать входящие прочитанными»: у нового подключения выключено, поэтому входящие остаются непрочитанными и телефон присылает уведомления, как раньше. Включи, если хочешь, чтобы собеседник видел синие галочки: тогда бот «прочитывает» сообщение, когда начинает отвечать, а телефон считает его уже прочитанным и уведомление не показывает;
• раскрывающийся блок «Что будет с вашим номером»: шесть коротких ответов про привязанное устройство, старые чаты, защиту от блокировки, прогрев и телефон в сети;
• совет про WhatsApp Business: если включены авто-ответы (приветствие, «сообщение об отсутствии»), выключи их, иначе платформа примет их за ответ оператора и поставит бота на паузу.

📌 Пример (стоматология). Подключают рабочий +7 705…. Через ~10 секунд после скана статус «Подключён (+7 705…)». Через 15 минут прогрева клиент пишет «сколько стоит чистка?», бот отвечает сам, заявка падает в Лиды.

📌 Пример (барбершоп). Мастер боится, что после подключения «телефон отвалится». Ничего подобного: он дальше переписывается в WhatsApp как обычно, а бот просто параллельно отвечает новым клиентам. Если мастер сам вступит в диалог, бот на этом чате встанет на паузу.

Проверь, что работает

1. Статус в блоке WhatsApp = «Подключён» + виден номер.
2. Напиши боту с другого телефона в этот WhatsApp: должен прийти ответ от бота (несколько секунд).
3. Открой Диалоги: там появится твоя тестовая переписка.

Если бот молчит, иди в Бот не отвечает.

Сколько это стоит

14 дней бесплатно (30 по промокоду), число диалогов не ограничено, карта не нужна. Бот отвечает, пока на балансе проекта есть деньги: при регистрации мы кладём $5 ($10 по промокоду). После пробного периода WhatsApp работает только с активной подпиской, и первые две недели после подключения она дешевле. Цены, скидка и оплата: Баланс и подписка.

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

Что доезжает из WhatsApp в кабинет

Подключение не сводится к «текст туда, текст обратно»: в Диалогах переписка выглядит так же, как в самом WhatsApp.

💡 Если файл почему-то не скачался, на его месте будет прямая подпись, почему именно: молчаливого пустого места не остаётся.

Частые ошибки

Если WhatsApp отвалился

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

⚠️ Не отвязывай устройство руками на телефоне ради «подключить заново по-новому». Отключай через кнопку «Отключить» на платформе: она делает полный выход на шлюзе и стирает память о чатах. Иначе WhatsApp увидит «то же устройство с теми же контактами» и расценит это как уклонение от бана. Подробнее: Гигиена и антибан.

Вопросы, которые обычно возникают

Смогу ли я дальше пользоваться WhatsApp на телефоне?
Да. Бот работает как привязанное устройство (как WhatsApp Web). Твой телефон остаётся главным, ты переписываешься как обычно. Бот отвечает параллельно на новые входящие.

Что будет с моими старыми чатами и контактами?
На твоём телефоне: ничего, всё остаётся. Подключение только «читает» новые входящие и отвечает на них.

А если я сам отвечу клиенту, бот не перебьёт?
Когда оператор вступает в диалог, бота на этом чате можно поставить на паузу, он не будет встревать. Подробно, Диалоги.

Подойдёт WhatsApp Business?
Да. И обычный WhatsApp, и WhatsApp Business подключаются одинаково по QR. Главное: «живой» номер.

⚠️ Если у тебя WhatsApp Business, отключи встроенные авто-ответы (приветственное сообщение и «сообщение об отсутствии»). Найти: в приложении WhatsApp Business → Настройки → Инструменты для бизнеса → Приветственное сообщение / Сообщение в нерабочее время → выключить. Зачем: эти авто-ответы уходят от твоего имени, и платформа считает их за «оператор сам вступил в диалог» → ставит бота на паузу в этом чате (он ответит один раз и замолчит). Бот и так сам здоровается с клиентами, поэтому родной авто-ответ WhatsApp Business только мешает, два приветствия конфликтуют.

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

Можно один номер на два проекта?
Нет. Один номер = один канал = один проект. Для второго бизнеса: отдельный проект и отдельный номер.

Нужно ли держать телефон постоянно онлайн?
Желательно. Как и у WhatsApp Web, привязанное устройство какое-то время работает и без телефона, но если телефон надолго пропадёт из сети, WhatsApp может разлогинить устройство, и придётся «Переподключить».

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

Под капотом (для разработчиков и любопытных)

Что происходит автоматически, пока ты сканируешь QR.

Где живёт WhatsApp. WhatsApp это самохостинг через Baileys (QRDOS): платформа держит привязанное к твоему номеру устройство на своём gateway-сервере (как WhatsApp Web, только всегда онлайн). Сторонний провайдер-посредник больше не используется (убран в июне 2026). Инвариант: 1 номер = 1 канал = 1 проект.

Поток подключения (POST /api/projects/[id]/baileys/connect):

• права admin+; рейт-лимит 30 запросов/мин на проект;
• гейт isWhatsAppReconnectBlocked(), если триал исчерпан и подписки нет, вернётся HTTP 402 TRIAL_EXPIRED_PAYMENT_REQUIRED с текстом «Пробный период WhatsApp завершён…»;
• проект переключается на провайдера QRDOS, gateway стартует сессию и выдаёт QR (/baileys/qr); фронт опрашивает /baileys/status и рисует статус в реальном времени;
• по скану gateway шлёт вебхук /api/webhook/baileys → проект помечается подключённым (projects.baileys_connected = true); страница видит это и рисует «Подключён».

Пробный период (с 2026-08-04). Активен, пока не истекло окно в 14 дней (30 дней, если к проекту применён реферальный/амбассадорский код: продление ставит apply-promo, ветка 14/30 живёт в триггере mirror_baileys_connected(), crm/sql/0123). Ограничения по числу диалогов больше нет: hasActiveWhatsAppTrial() смотрит только на дату. Тем же триггером один раз ставится projects.activation_offer_ends_at, конец 14-дневного окна скидки на подписку. Внутри окна ответы гейтит баланс проекта, как и на платной подписке. У QRDOS нет поканальной платы провайдеру, поэтому «ройщика» неоплаченных каналов нет: после окна без подписки просто срабатывает гейт допуска (checkProjectEligibility) и бот перестаёт отвечать.

Антибан в коде: прогрев 15 минут, полная отвязка с зачисткой памяти о чатах, потолки отправки на шлюзе. Все защиты и цифры в одном месте: Гигиена и антибан.

Гейт «можно ли отвечать» (checkProjectEligibility), для WhatsApp нужно project.status === 'active' И (активный триал ИЛИ активная подписка). Для Telegram только active, без подписки.

Таймлайн жизни триал-канала:

0ч ──────────── создан, QR отсканирован, бот в эфире
 │  бесплатно: 14 дней, диалогов сколько угодно (пока хватает баланса)
окно закрылось ─ если НЕ оплачено → гейт допуска останавливает ответы бота
                 если оплачено → канал живёт, пока активна подписка

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

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

Две недели бесплатно, и переписок сколько угодно (с промокодом партнёра, месяц). Тратится только баланс проекта, а при регистрации мы кладём на него $5, так что попробовать можно на реальном потоке клиентов, а не на паре сообщений. Дальше нужна подписка, и первые две недели после подключения она стоит дешевле обычного.

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

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

Документация › Каналы › Подключить Telegram

Подключить Telegram-бота

Самый быстрый и безопасный канал: создаёшь бота в @BotFather, копируешь токен, вставляешь в кабинет, и бот отвечает клиентам в Telegram. Подключение бесплатное, без риска бана.

⏱ 8 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Напиши @BotFather в Telegram → /newbot → получи токен вида 1234567:AAE….
• Кабинет → проект → «Каналы» → секция Telegram → вставь токен → «Подключить».
• Один бот = один проект. Подключение бесплатно (платишь только за ответы бота с баланса).
• Токен хранится в зашифрованном виде, входящие проверяются секретом: чужой к боту не подключится.
• Отключение не трогает токен в @BotFather и сохраняет историю, лиды и дожимы.

Зачем это нужно

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

Мозг у бота общий: тот же промпт, база знаний, функции и дожимы работают в Telegram точно так же, как в WhatsApp (см. Обзор каналов).

Шаг 1. Создать бота в @BotFather

1. Открой Telegram, найди @BotFather (официальный бот Telegram с синей галочкой).
2. Отправь команду /newbot.
3. Придумай имя бота (показывается в шапке чата) и username (должен заканчиваться на bot, например my_shop_bot).
4. BotFather пришлёт токен: длинную строку вида 1234567:AAExxxxxxxxxxxxxxxxxxxxxxxxxxxxx.

🔒 Токен это пароль от бота. Никому его не показывай. Если случайно засветил в @BotFather командой /revoke выпусти новый, старый перестанет работать.

Шаг 2. Подключить в кабинете

1. Вкладка проекта «Каналы» → карточка Telegram.
2. В секции Telegram вставь токен в поле. Когда курсор уходит из поля, токен прячется за точками.
3. Нажми «Подключить».

С телефона удобнее так: кнопка «Открыть @BotFather» открывает Telegram сразу на нужном боте, а кнопка «Вставить» рядом с полем берёт токен из буфера. Можно скопировать всё сообщение BotFather целиком, токен из него найдётся сам.

Что происходит за кулисами (/api/projects/<id>/telegram/connect):

• токен проверяется по формату ^\d+:[A-Za-z0-9_-]+$ (цифры, двоеточие, буквы/цифры), если не подходит, увидишь «Неверный формат токена. Скопируйте токен из @BotFather без пробелов и лишних символов»;
• платформа дёргает Telegram getMe: убеждается, что бот живой, и подтягивает его @username;
• вызывается setWebhook, платформа говорит Telegram «слать все сообщения сюда»; при этом задаётся секретный токен (случайный), которым Telegram подписывает каждый входящий запрос;
• проект из статуса «черновик» автоматически переходит в «активен»: бот сразу в эфире.

После успеха: тост «Telegram бот подключён!», в секции отображается @username бота.

📌 Защита от случайной перепривязки. Если токен такой же, как уже стоит, ничего не ломается. Если другой, старому боту платформа сначала снимет вебхук, потом поставит новый.

Шаг 3. Проверить

Рядом есть кнопка «Проверить подключение» (/api/projects/<id>/telegram/status):

• «Бот подключён и работает», всё ок;
• «Бот не отвечает. Проверьте токен.»: токен отозван или неверен, переподключи.

Дальше открой своего бота в Telegram (по его @username), напиши ему: он должен ответить как настроен в промпте.

⚠️ Если бот молчит, проверь, что ИИ включён и на балансе есть деньги: Telegram-подключение бесплатно, но каждый ответ бота списывает токены с баланса проекта, как и в WhatsApp. → Бот не отвечает

Что умеет бот в Telegram

• Текст: основной режим.
• Голосовые: расшифровываются в текст, бот отвечает по смыслу.
• Видео и видео-кружки: звуковая дорожка расшифровывается, бот отвечает по содержанию.
• Фото: бот «видит» картинку (описание изображения) и реагирует. Подпись под фото учитывается как вопрос клиента.
• Альбомы (несколько фото разом): собираются в один запрос, бот отвечает одним сообщением, а не на каждое фото отдельно.
• Файлы: принимаются до 20 МБ.
• Пересланные сообщения: бот понимает, что это форвард, и учитывает откуда.
• Стикеры: видны в диалоге, но бот на них не отвечает и денег за них не тратит. Стикер это реакция, а не вопрос; если клиент дальше напишет текстом, бот ответит.
• Telegram Business: поддерживаются бизнес-сообщения (если у тебя Telegram Business-аккаунт, бот отвечает и там).
• Кнопки под ответом (опция): бот может предлагать клиенту нажимаемые кнопки выбора (записаться / узнать цену / да-нет). Включается на вкладке Промпт → Расширенные настройки → «Длина и разбивка ответов» → «Кнопки под ответом бота». Нажатие кнопки бот воспринимает как ответ клиента и продолжает диалог.
• Группы и супергруппы (опция), бот может отвечать в групповых чатах, но только когда к нему обращаются: упомянули через @имя_бота или ответили на его сообщение. На остальную переписку он не реагирует. Включается там же: «Длина и разбивка ответов» → «Отвечать в Telegram-группах».
• Реакции: видны рядом с сообщением и попадают в аналитику вовлечённости. Боту их не показываем: эмодзи чаще означает вежливый кивок, чем ответ, и как реплику его читать нельзя.
• Меню команд: при подключении у бота автоматически появляются команды /start и /help (кнопка «/» в Telegram).

Всё это, тот же конвейер, что и в других каналах: функции, база знаний, лиды, дожимы.

Кампании и рассылки

Когда бот подключён, в разделе Каналы → Telegram появляется «Ссылка для рекламной кампании»: вводишь название кампании (например instagram_jan): получаешь ссылку вида t.me/твойбот?start=instagram_jan. Дай её в рекламе/постах: кто перейдёт и нажмёт «Старт», попадёт в Аналитику → раздел «Кампании»: увидишь по каждой кампании диалоги, лиды, конверсию и выручку. Это как реклама-атрибуция для WhatsApp, только для Telegram-ссылок.

Рассылки (раздел «Рассылки» в левом меню, нужны права администратора): отправь сообщение сразу всей своей базе контактов. Только Telegram: массовая отправка в WhatsApp грозит баном номера, поэтому рассылки работают исключительно по Telegram-контактам. Что умеет рассылка:

• Кнопки под сообщением: добавь к рассылке нажимаемые кнопки (ответ боту или ссылка). Рядом, живой предпросмотр, как сообщение увидит клиент.
• Сужение базы: можно сузить по статусу лида, тегу или рекламной кампании (кто пришёл по конкретной deep-link ссылке). Рядом сразу показывается сколько контактов попадёт под условия: видно охват ещё до отправки.
• Запланировать на потом: выбери «Запланировать» и укажи дату/время; рассылка сама уйдёт в нужный момент (до этого её можно отменить).
• Бережная доставка: сообщения уходят постепенно (анти-бан), а кто написал боту «стоп»/«отписаться», исключается автоматически.
• В истории видно, сколько отправлено, сколько ошибок, и можно остановить рассылку (или запланированную, и идущую) на ходу.

Профиль бота. В разделе Каналы → Telegram (когда бот подключён) есть свёрнутый блок «Профиль бота в Telegram», прямо из кабинета можно задать короткое описание (строка под именем бота) и описание (текст «Что умеет этот бот?», который клиент видит в пустом чате до первого сообщения). Не нужно открывать @BotFather.

Кнопки и аналитика вовлечённости. Если включены кнопки под ответом, оператор видит их прямо в диалоге, а когда клиент нажимает кнопку в переписке появляется пометка «Нажал кнопку» (видно, что это нажатие, а не набранный текст). В Аналитике появляется блок «Вовлечённость в Telegram»: показы кнопок, нажатия, кликабельность (CTR), какие кнопки нажимают чаще, реакции клиентов и разбивка диалогов на личные и групповые.

Отключить Telegram

Секция Telegram → «Отключить». Подтверждение предупредит: «Бот перестанет отвечать клиентам в Telegram. История диалогов, лиды и подписчики drip сохранятся. Подключить можно тот же или новый бот: токен в @BotFather не пострадает.»

При отключении (/api/projects/<id>/telegram/disconnect) платформа снимает вебхук в Telegram (deleteWebhook) и очищает все Telegram-поля проекта. Сам бот в @BotFather остаётся: токен живой, можно переподключить когда угодно.

Под капотом

Для технически любопытных, как устроено хранение и безопасность (по коду):

• Шифрование токена. telegram_bot_token хранится зашифрованным (AES-256-GCM, ключ ENCRYPTION_KEY, префикс enc:). В открытом виде в базе токена нет.
• Дедуп. Рядом лежит telegram_bot_token_hash (SHA-256), по нему за один запрос проверяется, не привязан ли этот бот к другому проекту. Если привязан, «Этот бот уже привязан к другому проекту. Создай нового бота в @BotFather или отключи от старого проекта.»
• Проверка входящих. Telegram шлёт обновления на /api/webhook/telegram/<projectId> с заголовком x-telegram-bot-api-secret-token. Платформа сравнивает его с сохранённым секретом timing-safe сравнением (safeStringEqual); не совпал, 401, сообщение отклонено. Так чужой не сможет слать боту фейковые апдейты.
• Подписанные типы апдейтов. Вебхук слушает: message, edited_message, callback_query, message_reaction, business_connection, business_message, edited_business_message, deleted_business_messages.
• Лимиты. Подключение/отключение, 5 запросов / 60 сек (admin-роль). Входящий вебхук, 60 запросов / 60 сек на проект. Токен в запросе: до 200 символов.
• Медиа без утечки токена. Файлы Telegram сохраняются как tg-file://…, чтобы токен бота не попал в ссылку.
• Ошибки подключения (понятные RU-тексты): Telegram не принял токен → «Telegram не принял токен. Скопируй токен заново: целиком, от @BotFather, без пробелов.»; Telegram недоступен → «Telegram сейчас недоступен. Попробуй через минуту.»; иное → «Не удалось подключить бот. Повтори ещё раз, если повторится, напиши в саппорт.»

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

Telegram: самый лёгкий способ запустить бота. Идёшь к @BotFather (это «фабрика ботов» внутри самого Telegram), пишешь /newbot, придумываешь имя, и он выдаёт тебе токен, такой длинный код. Этот код ты вставляешь в кабинете в разделе «Каналы» и жмёшь «Подключить». Всё, бот ожил, отвечает всем, кто ему напишет в Telegram.

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

Токен это как пароль, держи его при себе. Если что-то пошло не так, всегда можно нажать «Проверить подключение»: бот либо «работает», либо просит обновить токен. А отключение ничего не ломает, история переписок, лиды и дожимы остаются на месте, и бот в @BotFather никуда не девается.

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

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

Гигиена и антибан (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 секунд, а служебные автоответы («нет баланса», «нерабочее время» и т.п.) уходят один раз на диалог и повторяются не чаще раза в сутки. Одинаковые массовые сообщения: типовой триггер бана.
• Жёсткие потолки отправки на самом шлюзе (страховка на случай, если что-то пойдёт вразнос выше по цепочке):

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

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

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

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

• Не отключай и не переподключай руками на телефоне. Короткие обрывы платформа чинит сама («Переподключаемся...»). Если устройство отвязано совсем («Сессия разлогинена»), подключи заново по 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 забанили

Документация › Каналы › Подключить Instagram

Подключить Instagram

Бот отвечает клиентам в директе Instagram тем же умом, что в WhatsApp и Telegram. Подключение идёт через официальный вход Meta за минуту, без пароля в кабинете. Главное отличие от других каналов: Instagram разрешает отвечать только 24 часа после сообщения клиента, и боту, и вам.

⏱ 8 мин · 👤 для владельца и оператора · 🟢 live, открыт всем

За 30 секунд:

• Нужен профессиональный аккаунт Instagram (бизнес или автор). Переключиться бесплатно: в приложении Настройки → Тип аккаунта → Профессиональный.
• Каналы → Instagram → «Подключить Instagram», вход паролем Instagram или через Facebook, все галочки оставить включёнными.
• Ответить из кабинета можно 24 часа после последнего сообщения клиента, и боту, и оператору. Позже только из приложения Instagram. Первым написать человеку нельзя.
• Один аккаунт Instagram отвечает в одном проекте. Канал входит в подписку проекта, как WhatsApp.

ℹ️ Instagram открыт всем аккаунтам с 8 октября 2026. Кнопка «Подключить» на его карточке в «Каналах» есть у всех, как у WhatsApp и Telegram.

Подключение

1. Переключите аккаунт на профессиональный, если он личный: в приложении Instagram Настройки → Тип аккаунта → Профессиональный. Подписчики ничего не заметят.
2. В кабинете: Каналы → Instagram → «Подключить Instagram». Подключать может администратор проекта.
3. Откроется вход Instagram. Войдите в нужный аккаунт логином и паролем Instagram или кнопкой «Войти через Facebook», если в Instagram вы входите через Facebook. Оставьте все галочки включёнными: без галочки «сообщения» бот не увидит директ, без «комментариев» не заработают правила на комментарии.
4. Вас вернёт в кабинет со статусом «Ждём первое сообщение». Напишите в директ этого аккаунта с другого аккаунта: диалог появится в «Диалогах», и статус сменится на «Канал работает».

Не тот аккаунт: нажмите «Отключить» и подключите заново.

Если к аккаунту уже подключён другой сервис автоответов (ManyChat, SendPulse, чат-бот в amoCRM или Bitrix24), выключите его автоответы. Иначе в директе ответят два бота, а наш, увидев чужой ответ с вашего аккаунта, уступит его как ответу живого человека и встанет в этом диалоге на паузу. Переписка менеджеров из amoCRM или Bitrix24 тоже считается ответом человека, так и задумано.

Правила Instagram, которые надо знать

Окно 24 часа, и для бота, и для вас. Meta разрешает отвечать человеку из кабинета только в течение 24 часов после его последнего сообщения. Это касается всех: бота, дожимов, правил и оператора. Написал клиент снова, и окно открылось заново. В шапке диалога видно, сколько осталось, а после закрытия поле ответа подскажет, что делать. Ответить позже можно из приложения Instagram или дождаться, когда клиент напишет снова. Бот про окно знает: не обещает «напишу завтра», а если ответ займёт больше суток, просит телефон или WhatsApp для связи.

Дожимы в Instagram работают только внутри суток. Шаг дожима «через 2 часа» уйдёт, а шаги «через 2 дня» или «через 5 дней» в Instagram не уйдут: они не сгорают, а ждут, пока человек напишет сам. Если клиенты из Instagram для вас важны, ставьте первый шаг внутри суток, а длинную цепочку ведите в WhatsApp.

Первым написать нельзя. Ни бот, ни рассылка не начнут разговор в Instagram: только ответ человеку, который написал сам или оставил комментарий.

Диалог из комментария. Когда правило ответило автору комментария в директ, диалог появляется в «Диалогах» с пометкой «Ждём сообщения»: человек вам ещё не писал, и писать ему отсюда нельзя. Как только он ответит, окно 24 часа откроется и для вас, и для бота.

Перенос разговора в WhatsApp. Если клиент оставил телефон, в шапке Instagram-диалога появляется «Есть в WhatsApp» или, когда окно закрыто, «Продолжить в WhatsApp». Кнопка откроет диалог с этим номером в WhatsApp (первое сообщение пишете вы, переписка из Instagram не копируется).

Напоминание о закрытии окна. Если тёплый клиент ждёт ответа, а до закрытия окна осталось меньше трёх часов, платформа напомнит вам один раз: в Telegram и на почту, куда приходят уведомления проекта, и в колокольчик кабинета.

Реклама «Написать в Direct» и «Кому отвечает бот». Человек, пришедший по рекламе с переходом в директ, получает в диалоге источник (название объявления, картинка, ID), и бот с первого сообщения знает, что это лид с рекламы, и не спрашивает, откуда о вас узнали. Настройка «Кому отвечает бот» действует и в Instagram: в режиме «Только новым обращениям» бот не вступает к тем, с кем аккаунт переписывался в директе до подключения бота (их сообщения ждут вас в «Диалогах»), в режиме «Только лидам с рекламы» отвечает только людям с рекламы. Для Instagram режим можно выбрать отдельно от WhatsApp: строка «В Instagram» в той же карточке.

Чужие автоответчики. Бывает, что вам пишет не человек, а программа другого бизнеса: присылает карточку с кнопками вроде «Подпишитесь, и я пришлю ссылку». Такую карточку из приложения Instagram человек отправить не может, поэтому бот ей не отвечает и не отвечает на всё, что эта программа пришлёт следом за пару минут. Карточка видна в «Диалогах» с пометкой «Карточка автоответчика». Если потом с того же аккаунта напишет живой человек, бот ответит ему как обычно.

Без звёздочек. Instagram не показывает жирный текст: звёздочки из ответа бота платформа убирает сама, клиент видит чистый текст.

Отозванное и исправленное сообщение. Клиент отозвал сообщение в Instagram: в «Диалогах» на его месте остаётся пометка «сообщение удалено», и бот на этот текст больше не опирается. Клиент исправил сообщение: текст в диалоге обновляется с пометкой «изменено», и дальше бот помнит исправленный вариант. Ответ, который бот успел отправить до отзыва, остаётся у клиента, как и в WhatsApp.

Проверить ответ заранее. В тест-чате переключатель «Как увидит клиент» в положении Instagram показывает ответ бота так, как он уйдёт в директ.

Бот представляется. Meta просит раскрывать, что отвечает автоматика, там, где этого требует закон. Самое простое: одна строка в промпте, например «в первом сообщении представься помощником компании».

Кнопки в директе

Каналы → Instagram → «Кнопки в директе». Это подсказки, которые человек видит в чате с вами в приложении Instagram на телефоне (на компьютере Instagram их не показывает).

• Вопросы при первом открытии чата, до 4 штук по 80 знаков: «Сколько стоит?», «Где вы находитесь?». Видны, пока человек ещё ничего вам не написал. Нажатие уходит боту как обычный вопрос.
• Постоянное меню, до 5 пунктов по 30 знаков: всегда видно в чате. Пункт без ссылки отправляет боту свой текст, пункт со ссылкой (только https://) открывает страницу.

«Сохранить» сразу отдаёт кнопки в Instagram, а под формой видно, приняты ли они. При отключении Instagram кнопки снимаются, при новом подключении возвращаются сами.

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

Ответы на комментарии под постами и Reels настраиваются правилами: Правила и комментарии. Коротко, что умеет Instagram-правило:

• Ответ в директ по слову: написали «цена» под постом, и прайс уходит автору в директ, а под комментарием короткий публичный ответ (минимум два варианта, чтобы Instagram не счёл одинаковые ответы спамом). Если Instagram не прислал уведомление о комментарии, платформа найдёт его сама в течение 10-15 минут и ответит.
• Только подписчикам: вместо ответа в директ приходит кнопка «Получить». Нажал и подписан на ваш аккаунт: получает обещанное. Не подписан: просьба подписаться и кнопка «Я подписался», после подписки тот же текст. Работает и для слова, написанного прямо в директ. Учтите риск: правила Instagram против спама не одобряют выдачу обещанного в обмен на подписку. Многие аккаунты так делают, но после жалоб Instagram может урезать охват, поэтому включайте осознанно.
• Ответ ИИ на вопрос: бот отвечает на настоящие вопросы под постами («Как к вам записаться?»), если ответ есть в промпте, информации о компании или базе знаний. Похвалу, эмодзи и спам пропускает, выдумывать запрещено.
• Ответ не теряется: если Instagram временно не принял ответ (потолок ответов за час, сбой Meta, доступ отозван), ответ ждёт и уходит позже сам, пока Instagram его принимает (до 7 дней после комментария). В ленте срабатываний такой ответ помечен «уйдёт позже».

Если на вкладке «Комментарии» написано, что у канала нет доступа к комментариям, Instagram подключали без этой галочки: отключите его во вкладке «Каналы» и подключите снова со всеми галочками, правила сохранятся.

Если что-то не так

Сколько стоит

Instagram входит в подписку проекта, как WhatsApp. Бесплатный период проекта действует и для Instagram, один раз на аккаунт. Ответы бота списываются с баланса так же, как в других каналах: Сколько стоит сообщение. Ответ ИИ на комментарий оплачивается так же, как ответ бота.

Дальше: → Гигиена и антибан WhatsApp
Связано: Обзор каналов · Диалоги · Правила и комментарии
Не получилось? → Канал отвалился

Документация › Инструменты бота › Функции

Функции (Инструменты бота): полный гайд

Раздел «Функции» в проекте DOS AI. Путь: Проект → Функции (/projects/<id>/functions).

Подзаголовок раздела: «Инструменты, которые ИИ сам решает когда использовать».

Этот документ объясняет фичу целиком, что это, как бот ими пользуется, как их создавать и настраивать, какие бывают, все встроенные функции с параметрами, кастомные вебхуки, лимиты, безопасность, тестирование и все крайние случаи. Написан для человека, который настраивает бота, а не только для программиста, но с технической глубиной там, где она нужна.

🆕 Обновление каталога (2026-06-13). Шаблоны теперь сгруппированы по задаче: Уведомления владельцу (Telegram, WhatsApp, почта), Запись на время (Calendar + движок окошек), Ресторан: iiko (гайд), Google Таблицы, Приём оплаты (Kaspi) (как работает), Поведение бота (теги, пауза дожимов, стоп-диалог), Фото и видео, Письмо клиенту (гайд). Что ещё изменилось:

• В модалке создания есть поиск по шаблонам: напишите «оплата», «запись», «уведомление».
• У каждого шаблона на карточке видно «цену входа» (сколько полей, сколько минут, что понадобится) и ссылку 📖 Инструкция.
• У шаблонных полей человеку показывается короткая подпись, а полная инструкция для ИИ спрятана в спойлер «Инструкция для ИИ».
• Проверить функцию можно прямо в мастере (кнопка «Проверить»), не закрывая его.
• Письмо клиенту через обычную почту теперь доступно как шаблон (см. «Письмо клиенту»); Gmail остался продвинутым вариантом.
• HTTP-запрос это не шаблон, а путь «Своя интеграция по API» (для разработчика). См. Кастомные вебхуки.

Оглавление

1. Что такое функции и зачем они
2. Как бот ими пользуется (механика)
3. Страница «Функции»: весь интерфейс
4. Как создать функцию
5. Анатомия функции (из чего состоит)
6. Параметры: подробно
7. Какие функции есть
8. Своя интеграция по API
9. Поведение бота: теги, паузы, остановки
10. Тестирование, версии, лог, импорт/экспорт
11. Связь функций с промптом бота
12. Лимиты и ограничения
13. Безопасность и приватность
14. Все статусы и состояния
15. Лучшие практики и чек-лист
16. FAQ и крайние случаи
17. Глоссарий

1. Что такое функции и зачем они

Функция (инструмент) это действие, которое бот может выполнить во время диалога с клиентом. Сам по себе ИИ умеет только писать текст. Функции дают ему «руки»: записать клиента в календарь, добавить строку в Google-таблицу, выставить счёт на оплату, уведомить владельца в Telegram, поставить тег лиду и так далее.

Главная идея: вы не программируете «если клиент написал X, сделай Y». Вы просто описываете боту что умеет каждая функция и когда её вызывать, а ИИ сам решает в нужный момент диалога, какую функцию вызвать и с какими данными. Это принципиально отличается от жёстких сценариев-кнопок.

📌 Функция не создаёт лида. Карточку лида заводит статус лида, который бот ставит сам по ходу диалога: на уровне промпта, без функций. Функция «Уведомление владельцу» лишь сообщает вам о заявке; сам лид в CRM появляется из-за статуса. Для аналитики (диалоги/лиды/конверсия) функции тоже не нужны: она считается автоматически.

Пример. У стоматологии подключены две функции: «проверить свободное время» и «записать клиента». Клиент пишет «хочу на чистку завтра после обеда». Бот сам:

1. вызывает проверить свободное время на завтра,
2. получает свободные слоты,
3. предлагает клиенту «14:00 или 16:30?»,
4. когда клиент выбрал, вызывает записать клиента,
5. подтверждает: «Записала вас на завтра 14:00 ✅».

Никто не прописывал этот сценарий шагами. Бот связал функции сам, потому что у каждой было понятное описание.

Что важно понять с самого начала:

• Функция = пара «описание для ИИ (когда вызывать)» + «подключение (куда отправить данные)».
• Бот вызывает функцию, только если она включена и её описание подсказывает, что сейчас подходящий момент.
• Плохое описание = бот не вызывает функцию или вызывает не вовремя. Описание: самое важное поле.

2. Как бот ими пользуется (механика)

Простыми словами, что происходит под капотом на каждое сообщение клиента:

1. Сборка инструментов. Платформа берёт все включённые функции проекта и превращает их в «меню инструментов» для модели (формат OpenAI tools). Каждая функция = имя + описание + список параметров.
2. Решение модели. ИИ читает сообщение клиента, контекст диалога, системный промпт и это меню. Дальше он либо просто отвечает текстом, либо решает «здесь нужно вызвать функцию X с такими-то параметрами».
3. Выполнение. Если ИИ вызвал функцию, платформа выполняет реальное действие (запрос в Google Calendar, HTTP-запрос на ваш сервер, запись в таблицу и т.д.) и получает результат.
4. Возврат результата модели. Результат функции (успех/ошибка/данные) отдаётся обратно ИИ. Он смотрит на него и формулирует человеческий ответ клиенту на его основе.
5. Цепочка. За один ход бот может вызвать несколько функций подряд (например, сначала проверить слот, потом записать). Это «round-trip»: вызов → результат → следующее решение.

Где это работает. Функции одинаково работают везде, где отвечает бот:

• тест-чат в кабинете (песочница: без реальных клиентов, но ответы бота списываются с баланса проекта, как обычные),
• боевые WhatsApp (по QR, привязанное устройство), Instagram и Telegram,
• ответ бота после оплаты счёта Kaspi.

То есть если функция работает в тест-чате, она так же сработает в бою. Дожимы функций не вызывают: это только текст. Функции срабатывают на любом языке клиента: бот решает по смыслу сообщения, а не по точным словам из описания, поэтому «кейін жазамын», «I'll text you later» и «напишу позже» ставят одну и ту же паузу. Примеры в описании функции это образцы намерения; пиши их по-русски, а казахские и английские добавляй, если клиенты так пишут. Чат на главной странице сайта это наш консультант, а не ваш бот.

Что НЕ является функцией:

• База знаний (RAG). Документы и факты, которые вы загрузили в «Базу знаний», бот использует автоматически: это не вызов функции, контекст подмешивается сам. В логах вызовов вы можете встретить служебный kb_search, но настраивать его как функцию не нужно.
• Системный промпт. Это «характер и правила» бота, отдельная настройка на вкладке «Промпт». Функции и промпт работают вместе (см. раздел 11).

3. Страница «Функции»: весь интерфейс

3.1 Шапка

• Заголовок: «Функции».
• Подзаголовок: «Инструменты, которые ИИ сам решает когда использовать».
• Кнопка «Импорт»: загрузить функции из JSON (см. 10.5).
• Кнопка «+ Новая функция»: создать новую (см. раздел 4). Становится неактивной при достижении лимита 40 функций.
• Счётчик функций использовано / 40. Меняет цвет: серый → жёлтый (осталось ≤2) → красный (лимит).

3.2 Сколько функций

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

3.3 Полоса готовности (Readiness)

Сводка состояния одной строкой:

• «Все функции готовы» это всё в порядке.
• Жёлтые предупреждения с количеством: «N с ошибками», «N не упомянуты в промпте», «N не протестированы». Это подсказки, а не блокировки.
• Если есть непроверенные функции, справа стоит кнопка «Проверить по очереди»: она открывает проверку первой из них.

3.4 Фильтры и поиск

• Чипы-категории: «Все» + по типам (Calendar, Sheets, Telegram, Email, Webhook, CRM и т.д.), у каждого счётчик.
• Поиск по названию функции.
• Чекбокс «Только включённые»: спрятать выключенные.

3.5 Баннер рассинхрона с промптом

Жёлтый баннер появляется, если в системном промпте упоминается функция, которой не существует (например, вы написали в промпте «вызови book_table», а функции с таким именем нет). Баннер:

• показывает каждое недостающее имя,
• предлагает «возможно, имелась в виду ...»,
• даёт кнопку «Создать» недостающую функцию в один клик,
• ссылку «Открыть промпт бота».

3.6 Строка функции

Все функции проекта стоят одним списком, каждая функция это строка.

Свёрнутая строка отвечает на вопрос «что мой бот умеет и включено ли это»:

• значок и название по-человечески («Отложить дожимы», «Записать клиента»). У своей функции по API показывается её имя;
• одна строка пояснения, что функция делает;
• статус словом: «Работает», «Не проверена», «Ошибка», «Не настроена», «Выключена»;
• переключатель вкл/выкл и стрелка, которая раскрывает строку.

Раскрытая строка (нажмите на название или на стрелку) показывает всё остальное:

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

Строка с ошибкой или с незаполненным адресом раскрыта сразу: причина видна без нажатия.

Меню «⋯»: Попробовать в чате • Превью запроса • Дублировать • История версий • Лог вызовов • Экспорт как JSON • Восстановить предыдущую версию • переключить Dev/Бизнес режим • Удалить.

Dev-режим (переключается в меню раскрытой строки), техническая карта функции: HTTP-метод + URL, заголовки, JSON-схема параметров, готовая команда cURL с копированием, панель здоровья, таймлайн последних 5 вызовов, инлайн-форма редактирования.

3.7 Пустое состояние

Если функций нет:

• «Нет функций»,
• «Создайте первую функцию: ИИ будет сам решать когда её вызвать во время диалога»,
• три шага: «1. Создайте действие → 2. Укажите, куда отправить данные → 3. Бот сам вызовет, когда нужно»,
• кнопка «+ Новая функция».

3.8 Обновление в реальном времени

Список функций обновляется сам (realtime), без перезагрузки страницы. Если другая вкладка/сессия что-то изменила, вы увидите это сразу.

4. Как создать функцию

Нажмите «+ Новая функция». Открывается выбор пути:

Шаг 1. Выбор пути

• «Из шаблона», готовые обёртки: уведомления владельцу, запись на время, Google Таблицы, приём оплаты, поведение бота, фото и видео, письмо клиенту. Параметры уже настроены правильно, вам остаётся заполнить подключение. Рекомендуется в 90% случаев.
• «Кастомная»: свой запрос на любой сервер (вебхук). Для интеграции с вашей CRM, n8n, Zapier или собственным API.

Шаг 2. Выбор системы (для шаблона)

Показываются восемь групп: Уведомления владельцу (Telegram, WhatsApp, почта), Запись на время (Google Calendar и движок окошек), Ресторан: iiko, Google Таблицы, Приём оплаты (Kaspi), Поведение бота (теги, отложить дожимы, остановить диалог), Фото и видео, Письмо клиенту. У каждой: иконка, описание, число шаблонов. Плюс поиск по слову («оплата», «запись», «уведомление»).

Шаг 3. Выбор конкретного действия

Внутри группы, список шаблонов (например в Google Таблицах: «Узнать структуру таблицы», «Прочитать таблицу», «Найти в таблице», «Добавить строку», «Обновить запись в таблице», «Удалить строку»).

Шаг 4. Мастер настройки (ActionWizard)

Один экран с четырьмя секциями:

1) «Когда боту это вызывать»

• Название (snake_case, только для кастомных; у шаблонов подставляется). Правило: ^[a-z][a-z0-9_]*$, маленькие латинские буквы, цифры, _, начинается с буквы. Пример: create_appointment.
• Описание для AI: критическое поле, минимум 5 символов. Пишите с точки зрения бота, когда и зачем вызывать. Кнопка «Улучшить с ИИ» дорабатывает формулировку автоматически.

2) «Подключение»

• Для встроенных: специфичная настройка (ID таблицы и лист; ID календаря и рабочие часы; токен и chat_id Telegram; и т.д.). Показывается email сервисного аккаунта, которому надо дать доступ к таблице/календарю.
• Для кастомных вебхуков, URL, HTTP-метод, таймаут и сворачиваемые блоки: Авторизация, Заголовки, Параметры URL, Тело запроса, Маппинг ответа, Повторы, Пагинация (см. Своя интеграция по API).

3) «Что бот спросит у клиента»: конструктор параметров (см. раздел 6). Показывается только для кастомных вебхуков, где вы сами проектируете, какие данные бот собирает. У встроенных функций набор параметров уже задан шаблоном и менять его нельзя, поэтому отдельной секции нет: встроенную функцию достаточно включить (и при наличии, потыкать настройки в «Подключении»). Справочный список «что бот соберёт» для встроенных доступен read-only в блоке «Дополнительно».

4) «Дополнительно» (сворачиваемое): триггеры, поведение при ошибке (fallback), цепочки. Для встроенных функций здесь же: read-only список параметров, заданных шаблоном.

Кнопка «Создать функцию» (или «Сохранить» при редактировании). При редактировании есть автосохранение со статусом «Сохранение… / Сохранено / Ошибка сохранения».

5. Анатомия функции (из чего состоит)

Каждая функция хранит набор полей. Самые важные для вас: первые три.

Имя, правила и подводные камни:

• только a-z, 0-9, _, начинается с буквы;
• уникально в рамках проекта (регистронезависимо);
• нельзя использовать зарезервированные слова языков программирования (if, for, function, await и ещё ~200): система отклонит.

Тип действия (action_type) это все допустимые значения:
webhook, builtin_calendar, builtin_sheets, builtin_booking, builtin_telegram, builtin_email, builtin_whatsapp, builtin_crm, builtin_edu_crm, builtin_gmail, builtin_lead_meta, builtin_owner_payment, builtin_send_media.

5.1 Предохранитель: как запретить боту то, о чём вы его просили не делать

Описание функции читает ИИ, и это просьба. Обычно её достаточно, но у необратимых действий (сообщить о приходе денег, выставить счёт, записать на приём) цена ошибки другая: бот может решить, что шаг пора закрыть, и вызвать функцию, хотя её собственные условия не выполнены. Типичный пример: в описании функции написано «вызывать только при реальном чеке», клиент пишет «оплатил, чек позже», и бот отвечает «оплата учтена», хотя чека в диалоге нет.

Предохранитель отказывает. Вы отмечаете факт, который должен быть в диалоге, и платформа проверяет его сама, до выполнения функции. Не сходится, функция не выполняется вовсе, а боту возвращается объяснение, чего не хватает, чтобы он попросил это у клиента.

Открывается на шаге «Когда выполнять» в конструкторе функции, там же, где триггер и поведение при ошибке.

Условий можно поставить несколько, тогда должны выполниться все.

«Счёт выставлен» и «деньги пришли» это разные условия, не путайте их. Первое даёт «Сначала отработала другая функция», и оно проходит уже в момент, когда бот отправил ссылку на оплату. Второе даёт «Оплата реально прошла», и оно ждёт ответа банка. Для записи на время берите второе: между выставленным и оплаченным счётом клиент успевает сказать «я оплатил», и на этих словах бот займёт время, за которое никто не заплатил.

Что вы увидите. В раскрытой строке функции появляется отметка «Предохранитель». Каждый отказ попадает в раздел Логи проекта с причиной, поэтому «функция молчит» никогда не остаётся без объяснения.

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

6. Параметры: подробно

Параметр это данные, которые бот соберёт у клиента в разговоре и передаст в функцию. Например: имя, телефон, дата, сумма. В конструкторе каждый параметр: карточка с номером.

6.1 Поля параметра

• Тип: String (Aa) / Number (#) / Boolean (да-нет) / Array (список []) / Object (объект {}). Для массива дополнительно указывается тип элементов.
• Обязательность: переключатель *« ОБЯЗ»** / «НЕОБЯЗ». Обязательный параметр бот будет добиваться у клиента, прежде чем вызвать функцию.
• Имя (snake_case).
• Описание, что бот спросит у клиента. Пишите как живой вопрос: «На какую дату вы хотите записаться?». От этого зависит, поймёт ли ИИ, что туда подставить.
• Enum (для строк), фиксированный список допустимых значений через запятую: low, normal, high. ИИ выберет только из них.
• Перемещение (↑ ↓) и удаление (✕).

6.2 Подсказки для ИИ (делают функцию точнее)

У параметра можно задать (в шаблонах часто уже заданы):

• examples: примеры значений, помогают ИИ понять формат;
• minimum / maximum: границы для чисел;
• format: date, date-time, email;
• pattern: регулярное выражение (например дата ^\d{4}-\d{2}-\d{2}$).

6.3 Заблокированные параметры (locked): «ШАБЛОН»

У шаблонных функций часть параметров помечена бейджем «ШАБЛОН» и заблокирована: их нельзя переименовать, удалить или сменить тип. Это сделано специально, они завязаны на встроенный обработчик (например start_time у записи в календарь). Описание у некоторых можно дополнить, структуру, нет. Не заблокированные параметры шаблона (например необязательное customer_name) редактировать можно.

6.4 Пустое состояние

Если параметров нет: «Параметры, данные, которые бот соберёт у клиента. Например: имя, телефон, дата, услуга.» Кнопка «+ Параметр».

7. Какие функции есть

Готовые функции добавляются из каталога: Функции → Новая функция → Из готового шаблона. Полный список с техническими именами в справочнике функций, а как настроить каждую группу, в своей статье:

Две вещи общие для всех готовых функций:

• Поля настройки (ссылка на таблицу, ID календаря, токен) заполняете вы один раз, модель их не видит и не меняет. Параметры собирает бот у клиента в каждом вызове.
• Функции CRM и АльфаCRM в каталоге не нужны: подключили CRM на странице «Интеграции», и бот получает её инструменты сам (CRM).

8. Своя интеграция по API

Нужной готовой функции нет, а у вашего сервиса есть API (своя CRM, склад, сайт): Функции → Новая функция → Своя интеграция по API. Адрес, метод, тело, авторизация, маппинг ответа, повторы и защита адресов разобраны в отдельной статье: Своя интеграция по API. Пример на настоящем сервисе: МойСклад.

У старых функций, созданных до появления полного редактора, встречается «простой режим» (только POST и все параметры одним JSON). Новые функции создаются сразу с полным набором вкладок.

9. Поведение бота: теги, паузы, остановки

Четыре функции управляют не внешним миром, а самим разговором. Три про паузы и остановки стоят у каждого проекта с рождения и включены, у проектов с 14 сентября 2026 к ним добавлена «Помечать лида тегами». Управляются здесь же, в разделе «Функции»: выключить тумблером, поправить описание «когда вызывать» под свою нишу, удалить.

9.1 Помечать лида тегами (set_lead_tags)

• Бот добавляет теги к уже стоящим, не затирая операторские. Снять или заменить тег он может, только если включён тумблер «Разрешить боту снимать/менять теги».
• Выбирает из словаря проекта (страница «Теги», с описаниями) или создаёт новый, если включён тумблер «Разрешить боту создавать новые теги».
• Максимум 20 тегов на лида. Подробно: Теги и сегментация.

9.2 Отложить дожимы (pause_followups)

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

• ставится пауза до даты (до 09:00 по поясу проекта, если указана только дата; либо точное время), а без даты на сутки;
• счётчики дожимов сбрасываются, чтобы по истечении паузы пришло одно мягкое напоминание;
• бот в чате НЕ выключается: если клиент напишет раньше, ответит как обычно;
• пауза соблюдается, даже если раздел «Дожимы» выключен: в назначенный срок бот вернётся одним сообщением о договорённости.

9.3 Остановить диалог (stop_dialog)

Когда: клиент явно просит не писать или окончательно отказался после отработки возражений. На первое «дорого / подумаю» не вызывается: это возражение.

• бот выключается на этом диалоге до ручного включения оператором;
• причина «клиент попросил», и автовозобновление этот диалог не оживит;
• все дожимы по диалогу отменяются автоматически.

Зачем так строго: защита от назойливости и от блокировки WhatsApp за спам.

9.4 Отключить дожимы (stop_followups)

Когда: клиент просит не напоминать («не надо дожимать», «сам напишу, когда решу», «еске салмаңыз»), но вопросы задавать продолжает.

• автонапоминания по этому клиенту выключаются насовсем;
• бот остаётся включённым и отвечает как раньше;
• вернуть дожимы можно вручную в таблице дожимов.

Три способа одним взглядом: пауза = помолчи с напоминаниями до срока, отключить дожимы = напоминаний больше нет, бот отвечает, стоп-диалог = замолчи совсем.

9.5 Как вообще останавливается диалог

Бот никогда не решает остановиться сам: он дообщается с клиентом, пока его не остановят явно. Способов четыре:

1. функция «Остановить диалог» (бот вызывает её, когда клиент просит не писать);
2. галочка «Завершать диалог после выполнения этой функции» у любой функции (внизу настроек): функция успешно отработала, и бот выключается на этом чате и отменяет дожимы (удобно после записи или передачи заявки менеджеру);
3. состоявшийся звонок, если включена настройка «Выключать ИИ после состоявшегося звонка» (включена по умолчанию, справочник настроек);
4. вручную: тумблер ИИ в шапке диалога.

Рядом с галочкой «Завершать диалог» есть вторая, «Останавливать дожимы после этой функции»: она решает только судьбу напоминаний и не трогает бота. Включайте, когда после функции напоминать не о чем (заявку передали человеку, клиента записали, оплату приняли). Оставляйте выключенной для уведомлений, которые разговор не заканчивают: эскалация вопроса, пометка отказа, сигнал о жалобе.

Третья галочка, «Это заявка: создать лида и сделку в CRM», ставится у функции, которая передаёт заявку человеку (менеджеру, администратору, юристу). Сработала такая функция, значит у диалога появляется карточка лида, а если подключена CRM, то и сделка в ней. Это происходит, даже если бот оценил клиента осторожнее, чем «готов»: без галочки бывало, что заявка уже лежит в Telegram-группе менеджеров, а в CRM клиента нет. Эскалациям вопроса, пометкам отказа и уведомлениям о новом диалоге галочку не ставьте: это не заявки.

Все три галочки действуют на вызовы, которые делает сам бот по ходу разговора. Если у функции выбран автозапуск (по событию или по смене статуса лида), этот путь галочки не учитывает; в настройках такой функции стоит та же пометка.

«Передать оператору» как отдельной встроенной функции нет: это уведомление владельцу (notify_telegram и соседи) плюс галочка «Завершать диалог после выполнения», если бот после передачи должен замолчать, и галочка «Это заявка», чтобы у клиента появились карточка лида и сделка в CRM.

10. Тестирование, версии, лог, импорт/экспорт

10.1 Тест функции («Проверить»)

Кнопка «Проверить» на карточке открывает тест-модалку «Тест: <имя>»:

• кнопка «Заполнить пример» подставляет примеры;
• по каждому параметру, поле ввода (для enum, выпадающий список), с подсказкой формата;
• «Отправить тест» реально выполняет вызов (для вебхука: шлёт запрос на ваш URL);
• результат: код статуса, отформатированный JSON-ответ, длительность (мс), ошибка если была.

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

10.2 Попробовать в чате

Пункт меню «Попробовать в чате» открывает тест-чат, где можно проверить, вызовет ли бот функцию сам по описанию (а не только технически работает ли вебхук). Это проверка качества описания.

10.3 История версий

Каждое изменение функции сохраняет снимок (хранятся последние ~50 версий). Меню → «История версий» → список с датами → «Восстановить» любую (с подтверждением). Спасает, если случайно сломали настройку.

10.4 Лог вызовов (Executions)

Меню → «Лог вызовов», все реальные вызовы функции ботом: статус (успех/ошибка), время, длительность, разворачиваемые детали запроса/ответа. Первое место, куда смотреть, если «функция не сработала».

10.5 Импорт / экспорт

• Экспорт как JSON (меню карточки): выгрузить одну функцию.
• Импорт (кнопка в шапке): вставить JSON одной функции или массива, либо перетащить файл (до 1 МБ). Удобно переносить функции между проектами.

10.6 Дублировать и превью

• Дублировать: копия функции (быстро сделать похожую).
• Превью запроса: посмотреть, как будет выглядеть запрос, не отправляя его.

10.7 «Улучшить с ИИ»

Кнопка у поля описания: ИИ дорабатывает формулировку описания, чтобы бот точнее понимал, когда вызывать функцию.

11. Связь функций с промптом бота

Функции и системный промпт (вкладка Промпт) работают вместе:

• Описание функции говорит ИИ, что она делает и когда её звать. Это первично.
• Промпт задаёт общий характер, правила и может явно направлять: «когда клиент готов записаться, вызови book_appointment».
• Если в промпте упомянута функция, которой нет на странице «Функции» появится баннер рассинхрона (см. 3.5) с кнопкой создать её.
• Полоса готовности предупреждает: «N не упомянуты в промпте», это намёк, что функция есть, но бот может про неё «забыть», если в промпте нет подсказки. Для важных функций стоит и хорошее описание, и упоминание в промпте.

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

12. Лимиты и ограничения

При попытке создать 41-ю функцию кнопка заблокируется, а импорт вернёт ошибку «лимит достигнут».

13. Безопасность и приватность

• Секреты не показываются. Токены, пароли, ключи (bot_token, api_key, access_token, password, secret и т.п.) наружу не отдаются никогда: в ответах API вместо них стоит ***hidden***, а ключ авторизации (Bearer, Basic, API Key, свой заголовок) приезжает пустым, рядом с пометкой «сохранён» и последними четырьмя знаками для узнавания.
• Пустое поле ключа означает «не менять». Открыли функцию на правку и не трогали поле с ключом, значит сохранится прежний ключ. Чтобы заменить, впишите новый; чтобы убрать, выберите тип авторизации «Без авторизации». Прислать обратно скрытое значение (***hidden*** или точки) тоже безопасно: платформа поймёт, что поле не меняли, и ключ останется прежним. Если прежнего ключа нет, а поле пустое, сохранение честно откажет, а не запишет пустоту.
• Шифрование. Конфиги авторизации и встроенных функций хранятся в зашифрованном виде (AES-GCM).
• Защита от SSRF. URL вебхуков нельзя указывать на внутренние адреса (127.0.0.1, 10.x, 192.168.x, IPv6-приватные): защита от обращения бота к внутренней инфраструктуре. Проверка идёт с учётом DNS-резолва.
• Заголовки чистятся от переносов строк (защита от инъекций).
• Права доступа. Создавать/менять/удалять функции может участник проекта с ролью editor и выше; просматривать, viewer. URL и секреты не отдаются участникам без прав владельца.
• Аудит. Каждое создание/изменение пишется в журнал аудита.

14. Все статусы и состояния

Статус функции на карточке:

Предупреждения полосы готовности:

• «N с ошибками»: функции с красным статусом.
• «N не упомянуты в промпте»: есть функция, но в промпте нет наводки (бот может её не звать).
• «N не протестированы»: нажмите «Проверить».

UX-состояния страницы: загрузка (скелетоны), пусто (см. 3.7), ошибка загрузки (инлайн-сообщение, не белый экран).

15. Лучшие практики и чек-лист

Описание функции:

• Пишите от лица бота: «Записывает клиента на приём. Вызывай, когда клиент подтвердил время.»
• Укажите когда вызывать и когда НЕ вызывать.
• Не пишите формально «Функция записи»: ИИ не поймёт момент.

Параметры:

• Описание параметра = живой вопрос клиенту.
• Помечайте обязательным только то, без чего действие невозможно.
• Используйте enum для фиксированных вариантов и examples для форматов.

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

• Для Sheets/Calendar: выдайте доступ сервисному аккаунту (его email показан при настройке).
• Для вебхука: верните боту короткий понятный ответ, а не сырой JSON (настройте маппинг).
• Поставьте разумный таймаут (медленный сервер = клиент ждёт спиннер).

Перед запуском:

• ☐ Нажал «Проверить», подключение работает.
• ☐ «Попробовал в чате»: бот вызывает функцию сам по описанию.
• ☐ Функция включена.
• ☐ Если важная, упомянул её в промпте.
• ☐ Статус «Работает», полоса готовности зелёная.

Сценарии управления:

• Возражение «дорого/подумаю» → отрабатывай или pause_followups, не stop_dialog.
• «Не пишите мне» → stop_dialog.
• Готов платить → create_payment_invoice (не выдумывай сумму: уточни).

16. FAQ и крайние случаи

Бот не вызывает функцию, хотя она включена.
Причина почти всегда в описании. Откройте «Попробуй в чате» и проверьте, понимает ли ИИ момент. Улучшите описание (кнопка «Улучшить с ИИ»), при необходимости добавьте наводку в промпт.

Функция вызывается не вовремя / слишком часто.
Описание слишком широкое. Добавьте «вызывай ТОЛЬКО когда…» и «НЕ вызывай если…».

В тест-чате работает, в бою, нет.
Проверьте, что функция включена в боевом проекте, подключение настроено (не ⚠ не задано), и канал/интеграция активны. Логика ИИ одинаковая во всех 5 точках входа: расхождение обычно в настройке подключения.

Достиг лимита 40 функций.
Удалите неиспользуемые или объедините близкие. Часто несколько узких вебхуков можно заменить одним с параметром «действие».

Два клиента бронируют один слот.
Для Sheets используйте update_row с expected_current_value/expected_other_cell (запись только если слот свободен). Для Calendar: check_available_slots непосредственно перед book_appointment.

Случайно сломал настройку функции.
Меню → «История версий» → «Восстановить» нужную.

Нужно перенести функции в другой проект.
«Экспорт как JSON» в одном → «Импорт» в другом.

Где функции send_lead / escalate_to_owner / kb_search?
send_lead / escalate_to_owner это кастомные функции конкретных проектов (вебхуки или Telegram-уведомления), а не встроенные шаблоны. kb_search: служебный поиск по базе знаний, он работает автоматически, настраивать его как функцию не нужно.

17. Глоссарий

• Функция / Инструмент / Tool: действие, которое бот может выполнить (синонимы).
• action_type, тип действия: webhook (свой HTTP) или builtin_* (встроенный обработчик).
• builtin_config: настройки встроенной функции (ID таблицы, токен и т.д.), которые ИИ не видит.
• Параметр: данные, которые бот собирает у клиента и передаёт в функцию.
• locked / ШАБЛОН: заблокированный параметр шаблона, его нельзя ломать.
• enum: фиксированный список допустимых значений параметра.
• Цепочка (chain): группа связанных функций с порядком вызова.
• fallback: поведение при ошибке функции (silent / notify / retry / transfer).
• Дожим (follow-up): автоматическое напоминание клиенту; управляется pause_followups / stop_dialog.
• Сервисный аккаунт: технический Google-аккаунт DOS AI, которому вы даёте доступ к таблице/календарю.
• RAG / База знаний: автоматический поиск по вашим документам, НЕ функция.
• Где работает бот: тест-чат, WhatsApp, Instagram, Telegram и ответ после оплаты; функции работают одинаково везде. Дожимы функций не вызывают.

Простыми словами (вся статья в двух минутах)

Обычный бот умеет только разговаривать. Функции это «руки» бота: они позволяют ему делать дела, а не только отвечать словами, записать клиента в календарь, добавить строку в Google-таблицу, выставить счёт на оплату в Kaspi, скинуть тебе заявку в Telegram, отправить клиенту видео, поставить пометку на клиента. Каждая функция это «одно умение».

Самое важное и непривычное: ты не программируешь сценарий «если клиент сказал X, сделай Y». Ты просто по-человечески описываешь каждое умение: «эта функция записывает клиента, вызывай её, когда он подтвердил время», а бот сам решает, когда им воспользоваться, прямо посреди разговора. Поэтому в функциях главное поле, описание. Плохо описал, бот не поймёт, когда применять; хорошо описал, он сам всё свяжет (сначала проверит свободное время, потом запишет, потом подтвердит).

Делать функции можно двумя путями. Из шаблона это готовые умения (Google Таблицы, Календарь, Telegram, приём оплаты, отправка фото): тебе остаётся только подключить свою таблицу или номер, всё остальное уже настроено. Кастомная, если у тебя своя система (CRM, сайт), бот может «постучаться» на твой адрес и передать туда данные.

Есть и особые функции, которые управляют самим ботом: поставить напоминания на паузу («клиент сказал, напишу в четверг»), совсем остановить диалог («клиент попросил не писать»), пометить клиента тегом, выставить счёт. Их тоже бот применяет сам по смыслу разговора.

Что важно помнить на каждый день:

• Функция работает, только если она включена и у неё настроено подключение (для таблицы, дать доступ, для оплаты: подключить Kaspi).
• Всё новое проверяй в тест-чате: там видно, вызвал ли бот функцию или только написал «записал» словами.
• Функций можно сделать до 40 на проект.
• Секреты (токены, пароли) платформа прячет и шифрует, участники их не видят.
• Не получается? Загляни в «Лог вызовов» функции: там видно, что именно пошло не так.

Если в двух словах: функции превращают болтливого бота в работающего сотрудника, который не только отвечает, но и записывает, считает и принимает оплату, а ты лишь объясняешь ему словами, что и когда делать.

Документ описывает раздел «Функции» DOS AI по состоянию на август 2026. Каталог встроенных функций, источник истины: packages/@dos/admin/src/function-templates.ts. Логика выполнения: packages/@dos/ai-pipeline/src/pipeline/tool-executor.ts.

Документация › Инструменты бота › База знаний

База знаний (RAG)

Сюда грузишь факты о бизнесе (прайс, услуги, условия): бот сам подмешивает нужное в ответы и перестаёт выдумывать.

⏱ 8 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• База знаний = большие справочники бизнеса: полный прайс, каталог услуг, FAQ, условия, документы. Пара цен и адрес удобнее в поле «Информация о компании»: его бот видит всегда.
• Грузишь текст, файл (TXT/CSV/PDF/DOCX) или ссылку (URL): система сама разбивает и индексирует.
• Бот на каждое сообщение ищет подходящие куски и добавляет их в ответ (это RAG, автоматически).
• Лимит: 100 записей на проект (всего, не только активных), до 1 000 000 символов при вставке текстом, из файла и со страницы по ссылке извлекается до 500 000, файл до 4 МБ.
• Короткие факты, нужные всегда, держи в «Информации о компании»; большое и меняющееся сюда (что куда класть).

Зачем это нужно

Бот знает только то, что ты ему дал. Если прайс есть лишь «в голове» у тебя, бот начнёт выдумывать цифры. База знаний даёт ему точные факты: он ищет в них релевантное под вопрос клиента и отвечает по делу, а не фантазирует. Это разница между «кажется, около 20 тысяч» и «чистка, 18 000 ₸».

Что сюда класть

Объёмное и меняющееся: полный прайс, описания услуг, FAQ, условия, документы. Короткие факты, нужные в каждом ответе (адрес, часы, ключевые услуги), лучше в поле «Информация о компании», а поведение бота в промпт. Как разложить всё по местам: Что куда класть.

Как добавить

Вкладка проекта «База знаний» → «Добавить документ».

1. Название: понятное («Прайс услуг», «FAQ доставки»);
2. Тип, выбери источник:
3. Текст: вставь напрямую (до 1 000 000 символов);
4. Файл: TXT, CSV, PDF, DOCX (до 4 МБ, текст извлечётся сам);
5. URL, ссылка на страницу сайта (можно с глубиной сканирования: только страница / +ссылки 1-2 уровня / максимум);
6. (для URL) Автообновление, нет / еженедельно / ежемесячно;
7. «Добавить»: пойдёт загрузка → индексация → готово.

⚠️ Обработка документа стоит немного (около $0.01 за документ на индексацию, минимальное списание, 1¢), спишется с баланса. При добавлении показывается оценка токенов.

Как бот это использует

Тебе ничего вызывать не надо, это работает само:

1. Клиент пишет вопрос;
2. Бот ищет в базе знаний тремя способами сразу: по смыслу (похожие формулировки), по словам (точное совпадение: артикул, марка, название модели) и с поправкой на опечатки. Результаты объединяются, и кусок, найденный двумя способами, идёт выше;
3. Лучшие фрагменты (в сумме до 8 000 символов) добавляются в контекст ответа;
4. Бот отвечает, опираясь на них.

📌 Пример. В базе это прайс и условия. Клиент: «делаете отбеливание и сколько?». Бот находит строку про отбеливание → отвечает с точной ценой. Про услугу, которой в базе нет, он честно скажет, что уточнит.

📌 Пример на точные слова. Клиент спрашивает «есть мойка 8102?». По смыслу «8102» не значит ничего, и поиск только по смыслу такой вопрос проваливал. Совпадение по словам находит строку каталога сразу.

«Всегда под рукой»

У каждой записи есть кнопка-булавка. Включённая, она означает: этот документ едет боту в каждом сообщении, минуя поиск.

Это для короткой шпаргалки, которую бот обязан знать всегда: пять-семь ходовых цен, условия замера, главное правило доставки. Ограничение жёсткое: не больше 3 документов и 1500 символов на все закреплённые вместе. Платформа не даст закрепить сверх лимита и скажет, сколько осталось. Так и задумано: закреплённое оплачивается в каждом сообщении, ровно как текст промпта.

Всё остальное, полный каталог, характеристики, регламенты, частые вопросы, должно искаться. Тогда за него платишь только тогда, когда оно понадобилось.

Проверь, что работает

В разделе есть «Тест поиска»: вводишь вопрос клиента → видишь, какие фрагменты база вернёт боту, из какого раздела документа они взяты и как нашлись: по словам, по смыслу или с поправкой на опечатку. Это ровно тот поиск, что бот делает на каждое сообщение. Если по важному вопросу ничего не находит, переформулируй контент или добавь похожий.

Плюс прогони реальные вопросы в Тест-чате: там в «технических деталях» видно, какие источники бот подтянул.

Управление записями

• Фильтры: Все / Активные / Неактивные, поиск по названию;
• Включить/выключить запись (выключенная не участвует в поиске);
• Булавка «Всегда под рукой»: запись едет боту в каждом сообщении мимо поиска (см. выше);
• Массовые действия: включить/выключить/удалить выбранные;
• Большие документы система бьёт на фрагменты: их можно посмотреть и отредактировать.

Частые ошибки

Вопросы, которые обычно возникают

Это платно?
Да, чуть-чуть: и индексация документа, и каждый поиск стоят примерно по 1¢ ($0.01). Поиск идёт на каждое сообщение, это учитывается в расходе.

Бот читает весь документ каждый раз?
Нет. Только самые подходящие фрагменты под текущий вопрос: столько, сколько влезает в 8 000 символов контекста (обычно от 3 до 15, зависит от размера кусков).

Под капотом

• RAG (Retrieval-Augmented Generation): документы режутся на чанки, для каждого считаются векторные embeddings. На каждое сообщение клиента идёт гибридный поиск: вектора (смысл) + полнотекстовый поиск с русской морфологией (точные слова) + триграммы (опечатки), результаты объединяются рангом. В контекст попадает столько лучших чанков, сколько помещается в 8 000 символов (не больше 15). Записи со «Всегда под рукой» подмешиваются без поиска, в пределах 1500 символов.
• Лимиты: 100 записей/проект (всего), до 1 000 000 символов при вставке текстом, из файла и URL извлекается до 500 000 (MAX_EXTRACTED_LEN_KB / MAX_PAGE_SIZE), файл 4 МБ, в промпт идёт до 8 000 символов, не больше 15 чанков.
• Форматы: TXT, CSV, URL (с глубиной до 3 и автообновлением), PDF, DOCX. URL-скан: до 20 подстраниц, каждая = отдельная запись.
• Стоимость: ≈$0.01 индексация документа + ≈$0.01 за поиск (на каждое сообщение); минимальное списание за эмбеддинг, 1¢.
• Обновления списка идут в реальном времени (use-realtime-kb). RAG это не функция, а внутренний шаг пайплайна; включать/вызывать не надо.

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

База знаний это справочник твоего бизнеса для бота: цены, услуги, условия, частые вопросы. Ты загружаешь туда текст, документ или ссылку на сайт, а бот сам, на каждый вопрос клиента, достаёт оттуда нужный кусочек и отвечает точно, не выдумывая. Короткие вещи (адрес, часы работы) проще написать в поле «Информация о компании», а вот большой прайс или список услуг: сюда. Есть кнопка «Тест поиска»: вводишь вопрос и видишь, что бот найдёт, удобно проверить, что он не промахнётся.

Дальше: → Дожимы
Связано: Системный промпт · Как бот думает · Тест-чат
Не получилось? → Бот не отвечает

Документация › Инструменты бота › Медиа-библиотека

Медиа-библиотека

Бот умеет не только писать, но и показывать: отправить клиенту видео, фото работ, отзыв или прайс, в нужный момент диалога. Для этого ты заранее складываешь материалы в медиа-библиотеку.

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

За 30 секунд:

• Раздел «Медиа» проекта: твоя библиотека видео/фото/отзывов/прайсов.
• Каждому файлу даёшь ярлык (media_key), по нему бот его и отправляет.
• Бот сам решает, когда показать материал (через функцию «Отправить медиа»), если клиент сомневается или просит показать.
• Лимиты: до 60 файлов на проект, до 50 МБ каждый (для Telegram фото до 5 МБ, остальное до 20 МБ). Работает в WhatsApp, Telegram и Instagram.

Зачем это нужно

Слова не всегда убеждают. «Покажите работы», «есть видео?», «скиньте прайс»: на такие моменты у бота должны быть готовые материалы. Медиа-библиотека (раздел «Медиа», /projects/<id>/media) это склад фото, видео, отзывов и прайсов, которые бот отправляет клиенту прямо в чат в подходящий момент: в диалоге и в дожимах.

Как загрузить

1. Раздел проекта → «Медиа» → загрузи файл (нужна роль редактор+).
2. Дай название: ярлык (media_key) подставится из него сам, кириллица разрешена, поправить можно. При желании добавь подпись и описание «когда отправлять».
3. Сохрани. Готово: материал доступен боту.

Лимиты и форматы:

• до 60 материалов на проект (превысишь, «Достигнут лимит медиа на проект (60). Удали ненужное и попробуй снова.»);
• до 50 МБ на файл (больше, «Файл больше 50 МБ»). Файлы крупнее 4 МБ кабинет грузит прямо в хранилище, это занимает чуть дольше;
• если бот отвечает в Telegram, держи фото до 5 МБ, а видео и документы до 20 МБ: файл больше Telegram по ссылке не принимает, и клиент его не получит;
• форматы: изображения (JPEG/PNG/GIF/WebP/HEIC), аудио (MP3/OGG/WAV/MP4), видео (MP4/WebM/MOV), документы (PDF/DOC/DOCX/XLS/XLSX/PPT/PPTX/ZIP).
• в один диалог бот отправляет не больше 3 материалов за минуту (защита от спама и от блокировки WhatsApp).

Как бот отправляет

Бот выбирает материал по ярлыку через функцию «Отправить медиа» (send_media). Ты включаешь эту функцию и описываешь, что и когда показывать, а бот сам решает момент: клиент сомневается → показать видео-отзыв; просит прайс → отправить файл; нужно снять возражение наглядно → фото работ.

💡 Описывай ярлыки понятно. Бот выбирает материал по описанию, «когда отправлять». Чем понятнее опишешь (video_otziv, «когда клиент сомневается в качестве»), тем точнее бот будет показывать нужное. Это как с функциями: хорошее описание = верный выбор.

📌 После отправки бот ссылается на материал словами («посмотрите видео выше 👆»), а не пересказывает его. Работает и в WhatsApp, и в Telegram.

Стоит ли это денег

Отправка готового материала из библиотеки: бесплатна (не списывает баланс). Деньги тратятся только когда бот распознаёт входящее медиа от клиента (расшифровка голоса, «разглядывание» картинки): см. Сколько стоит сообщение.

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

Представь, что у бота есть папка с «продающими материалами»: видео твоих работ, фото до/после, отзывы клиентов, прайс в PDF. Ты один раз туда всё загружаешь и подписываешь, что это и когда показывать. Дальше бот сам, по ходу разговора, достаёт нужное: клиент засомневался, кинул видео-отзыв, попросил цены, отправил прайс. Это работает гораздо убедительнее, чем расписывать всё словами.

Загрузить можно до 60 файлов, каждый до 50 МБ (для Telegram лучше до 20 МБ), работает в WhatsApp, Telegram и Instagram. И приятный момент: отправлять эти материалы клиентам, бесплатно, баланс на это не тратится.

Дальше: → Дожимы
Связано: Функции · База знаний · Сколько стоит сообщение
Не получилось? → Функция не вызывается / падает

Документация › Инструменты бота › Дожимы

Дожимы (follow-up)

Клиент заинтересовался и пропал? Бот сам напомнит о себе через заданное время, и вернёт часть «потеряшек».

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

За 30 секунд:

• Дожим = автонапоминание клиенту, который замолчал.
• Настраиваешь последовательность касаний с задержками (минуты/часы/дни/недели).
• Каждое касание это либо ИИ с учётом истории диалога, либо фиксированный текст.
• Бот сам ставит дожимы на паузу, если клиент сказал «свяжусь сам», и отменяет, если просил не писать.
• Минимальная задержка, 15 минут.

Зачем это нужно

Большинство клиентов не отвечают сразу: «подумаю», «спрошу мужа», просто отвлеклись. Без напоминания половина из них теряется навсегда. Дожимы возвращают их мягким сообщением через нужное время: без твоего участия и без навязчивости. Это один из самых окупаемых инструментов.

Где это

Вкладка проекта «Автоматизации» → подвкладка «Дожимы». Нужна роль editor+.

Как настроить последовательность

Дожим это цепочка касаний. Например: через 2 часа → через 1 день → ещё через 1 день. Задержка считается от прошлого касания, и вся цепочка должна уложиться в «Максимум тишины» (по умолчанию трое суток), иначе молчащему клиенту последние касания не дойдут. А при включённом «Сбросе при ответе» они не уйдут вообще никому: ответивший клиент начинает цепочку с первого касания. Если цепочка длиннее порога, под ней появится жёлтая плашка «Шаги 4-5 не дойдут до тех, кто замолчал» с кнопкой «Поднять порог»: одно нажатие ставит порог по длине цепочки с запасом в сутки. Для каждого касания задаёшь:

💡 Совет. Первое касание делай быстрым и мягким (через 1-2 часа: «Подскажите, остались вопросы?»), дальше реже. Тип «ИИ + история» обычно работает лучше шаблона: напоминание получается живым и в контексте разговора.

📌 Пример (мотошкола). Касание 1 через 2 часа: «Остались вопросы по обучению? С радостью подскажу 🙂». Касание 2 через 1 день: напоминание про ближайший набор. Касание 3 ещё через день: предложение пробного занятия.

Кто попадает в дожимы и кто выходит

• Попадает: при включённых дожимах каждый клиент, которому бот ответил. Настройка «Авто-добавление» сужает круг: в цепочку попадут только лиды с выбранным статусом, в момент, когда статус на него сменится. Клиент, чью заявку уже передали функцией с галочкой «Останавливать дожимы», не попадает.
• Бот сам ставит на паузу: если клиент сказал «свяжусь сам в четверг», дожимы молчат до этой даты (функция пауза дожимов), но бот в чате продолжает отвечать.
• Бот сам отключает напоминания, не замолкая: клиент сказал «не надо мне напоминать, сам напишу», но вопросы задаёт: дожимы по нему выключаются насовсем, а бот в чате отвечает как раньше (функция отключить дожимы).
• Бот сам отменяет: если клиент попросил не писать или отказался, дожимы отменяются (стоп-диалог).
• Эти три функции стоят у каждого проекта с рождения и включены. Добавлять их из каталога руками больше не нужно; выключить или поправить описание можно в разделе «Функции».
• Заявка передана, дожимы закрываются, если ты так решил. У каждой функции есть галочка «Останавливать дожимы после этой функции»: включи её у функции передачи заявки (уведомление в Telegram, на почту или в WhatsApp), записи или оплаты, и после неё напоминать клиенту «вы, наверное, заняты» никто не будет. Для уведомлений, которые разговор не заканчивают (вопрос менеджеру, жалоба), оставь выключенной. Бот при этом остаётся на связи: напишет клиент, ответит. Подробно: как останавливается диалог.
• Вручную: ты можешь поставить на паузу, возобновить или отписать клиента в таблице дожимов.
• Сообщения не доходят, дожимы останавливаются сами. Если наше напоминание целых 3 дня висит на одной галочке (WhatsApp не показывает, что тебя заблокировали, но сообщение в этом случае так и не доходит), а клиент после него не писал, дожимы ему отменяются. Каждое следующее сообщение человеку, который нас заблокировал, повышает риск жалобы и блокировки твоего номера. Такие люди собраны в списке «Не доставляется» на странице дожимов (вместо слова «заблокировал» там написано «Похоже, заблокировал» или «Не доходит»: точно знать это нельзя). Кнопка «Вернуть» снова включает человека в напоминания и рассылки. Если он напишет сам, пометка снимается без твоего участия. Список появляется, только когда в нём есть люди.

Статусы подписчиков

Проверь и подсмотри, что отправится

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

Частые ошибки

Вопросы, которые обычно возникают

Дожим выключает бота?
Нет. Дожим это напоминание. Бот продолжает отвечать в чате как обычно.

Что если клиент ответит на дожим?
Отлично, диалог продолжается обычным образом, дальнейшие касания не нужны (бот видит активность).

Можно совсем без текста, чтобы ИИ сам?
Да, тип «ИИ + история диалога»: бот сам сочинит уместное напоминание по контексту.

Под капотом

• Задержки хранятся как delay_hours (дробное число), а в интерфейсе показываются человеческими единицами (минуты/часы/дни/недели) через DelayInput + formatDelayHuman. Минимум, 0.25 ч (15 минут), максимум, 720 ч (30 дней). Дробные часы пользователю не показываются.
• Время следующего касания = max(последнее сообщение клиента, дата дожима, создание) + delay_hours.
• Движок дожимов «тикает» регулярно (внешний планировщик QStash, ~каждые 5 минут).
• Статусы подписчика: active / paused / completed / cancelled / opted_out. Пауза «свяжусь сам» это snoozed_until (per-subscriber), не трогает ai_on.
• Связь с функциями: `pause_followups` ставит snooze; `stop_followups` переводит подписчика в cancelled, не трогая ai_on; `stop_dialog` выключает бота + отменяет дожимы (триггер БД). Общее правило: бот выключен в диалоге по любой причине → дожимы этого чата отменены.

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

Дожимы это вежливые напоминания тем, кто заинтересовался и пропал. Ты заранее настраиваешь: через сколько и что написать. Например, через два часа, «остались вопросы?», через день, ещё разок, ещё через день: предложение попробовать. Можно дать боту самому придумывать текст по ходу разговора: так живее. Бот умный, если клиент сказал «напишу сам в четверг», напоминания подождут до четверга, а если попросил «не пишите», бот их отменит, чтобы не злить человека. В итоге ты возвращаешь часть клиентов, которые иначе бы просто потерялись.

Дальше: → Лиды
Связано: Функции · Лиды · Диалоги

Документация › Инструменты бота › Правила и комментарии

Правила и комментарии

Правило срабатывает само, без участия модели: клиент написал слово «стоп», и бот замолкает; спросил адрес, и уходит точный ответ с картой; бот создал заявку, и вам приходит уведомление. Правило собирается из трёх частей: когда, если и то. Для Instagram отдельная вкладка «Комментарии»: ответ автору комментария в директ и публично под постом.

⏱ 7 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Автоматизации → Правила. Начните с готового набора для своей ниши («Включить набор») или нажмите «Новое правило».
• Когда: клиент пишет слово, первое сообщение, клиент прислал файл, бот создал заявку, тег добавлен, стадия изменилась, клиент оплатил и другие поводы.
• То: до трёх действий: ответить текстом, отправить файл, подсказать боту, поставить тег, перевести стадию, выключить бота, сообщить мне, дёрнуть вебхук.
• «Проверить» показывает, какое правило сработает на фразу, ещё до включения.

Из чего состоит правило

Когда (повод):

Если (условия, необязательно): канал, статус лида, тег. Правило сработает, только если диалог им подходит.

То (до трёх действий):

Частота: каждый раз, раз на диалог или раз на человека.

Как правило уживается с ботом

• Точный ответ уходит вместо ответа модели, и денег за модель на этот ход не тратится. Подсказка боту, наоборот, оставляет ответ модели, но направляет его.
• На одно событие отвечает одно правило с сообщением, первое по порядку в списке. Второе промолчит и останется в ленте с пометкой «клиенту уже ответило правило выше по списку»: два текста подряд это уже рассылка. Порядок меняют кнопки «Выше» и «Ниже» у правила.
• Бот выключен в диалоге (оператор отвечает сам): правила с сообщениями молчат, а тег, стадия и уведомление работают.
• Защита от зацикливания: не больше 5 срабатываний в час и 30 в сутки на один диалог. Правило, поставившее тег, не запускает правила «тег добавлен».
• Отказ доставки попытку не сжигает: «раз на человека» считается по успешным срабатываниям.

Внизу страницы лента срабатываний: какое правило, на какой диалог, что сделало. В отчёте владельцу строка «Правила: сработали N раз, ответили клиентам без ИИ: M».

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

Блок «Проверить»: впишите фразу клиента («а цена какая?»), отметьте, первое ли это сообщение и есть ли вложение. Платформа покажет, какое правило сработает, или скажет «Ни одно правило не сработает: бот ответит сам». Условия «Если» здесь не проверяются, они зависят от конкретного диалога.

Комментарии в Instagram

Вкладка Автоматизации → Комментарии. Самое частое правило: «написали "цена" под постом, и прайс уходит автору в директ, а под комментарием короткий публичный ответ».

• Написать автору в директ: одно сообщение на комментарий, до 1000 байт (около 500 русских букв).
• Ответить под комментарием: короткий публичный ответ, минимум два варианта: одинаковый текст под сотней комментариев Instagram считает спамом и может ограничить аккаунт. Варианты чередуются сами. Пишете «ответили в директ», добавьте «не видите, загляните в Запросы»: тому, кто на вас не подписан, Instagram кладёт сообщение в папку запросов, и человек решает, что ему ничего не пришло. В готовых правилах эта подсказка уже стоит.
• Только подписчикам Instagram (галочка у ответа в директ): вместо текста автору приходит кнопка «Получить». Нажал и подписан на ваш аккаунт: получает ваш текст. Не подписан: просьба подписаться (её можно написать своими словами) и кнопка «Я подписался»; после подписки тот же текст, а после трёх неудачных проверок разговор ведёт обычный бот. Та же галочка есть у ответа на слово в директе. Свои кнопки и фразы проверка пишет на языке вашего текста: русском, казахском или английском. Риск: правила Instagram против спама не одобряют обмен подписки на обещанное; многие так делают, но после жалоб Instagram может урезать охват аккаунта.
• Ответить ИИ на вопрос: бот сам отвечает на настоящие вопросы под постами («Как к вам записаться?»), если ответ есть в промпте, информации о компании или базе знаний. Похвалу, эмодзи и спам пропускает, выдумывать запрещено. Ответ публично под комментарием или автору в директ. Готовое правило «Вопрос в комментарии → ответ ИИ» есть в наборе, включается вами. Ставьте его ниже правил по словам: на одно событие отвечает одно правило, и слово важнее. Каждый проверенный комментарий оплачивается с баланса, как ответ бота: до 60 в час, остальные ждут следующего часа.
• Платформа держит ограничения Meta сама: не больше одного ответа на комментарий, свои потолки в час (60 публичных ответов и 200 сообщений в директ на проект).
• Комментарий не теряется. Instagram изредка не присылает уведомление о комментарии, и правило о нём не узнаёт. Поэтому платформа раз в 10 минут сама сверяет комментарии под 15 последними публикациями и отвечает тем, кого пропустила. Такой ответ приходит с задержкой до 10-15 минут, в ленте комментариев он выглядит как обычный. Комментарии в эфире так не проверяются: Instagram не отдаёт их списком.
• Ответ не теряется. Упёрлись в потолок часа, Meta временно не ответила, доступ к Instagram отозван или автоматика остановлена: ответ ждёт и уходит позже сам, пока Instagram его принимает (до 7 дней после комментария). В ленте он помечен «уйдёт позже», и второй комментарий того же человека не встанет в очередь вторым ответом.
• Справа лента «Последние комментарии»: что писали под постами и сработало ли правило.

Ответ на сторис и переход по ссылке ig.me приходят в обычный диалог, а правила на них настраиваются здесь же. Подключить Instagram: Подключить Instagram.

ℹ️ На вкладке написано, что у канала нет доступа к комментариям: Instagram подключали без галочки «комментарии». Отключите его во вкладке «Каналы» и подключите снова со всеми галочками, правила сохранятся.

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

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

Дальше: → Теги
Связано: Дожимы · Уведомления владельцу · Записи · Подключить Instagram
Не получилось? → Функция не вызывается или падает

Документация › Инструменты бота › Теги и сегментация

Теги и сегментация

Теги это ярлыки на клиентах («VIP», «опт», «недозвон»), которые бот ставит сам по ходу разговора. По ним потом удобно фильтровать лидов и понимать, кто есть кто.

⏱ 6 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Теги, свободные ярлыки на лиде (до 20 на одного): VIP, опт, Астана, недозвон.
• У проекта, созданного с 14 сентября 2026, функция «Помечать лида тегами» уже включена, а стартовый набор тегов собран из трёх ответов при создании проекта. У проектов постарше функцию нужно включить в разделе Функции: без неё теги ставит только оператор вручную.
• На странице «Теги» заводите теги с описанием, его видит и оператор, и бот (бот тегает осмысленнее).
• Бот сначала выбирает из существующих тегов, и только если ничего не подходит, создаёт новый (если это разрешено под-флагом). Новый тег бота помечается бейджем «создано ИИ».
• Бот добавляет теги, не стирая уже стоящие. Снять тег может оператор.
• В разделе «Лиды» можно фильтровать по тегам (логика «И»); на странице «Отчёты» виден весь список тегов с числом лидов за период и выгрузкой в CSV.

Шаг 1. Заведите теги (с описанием)

Откройте страницу «Теги» проекта и создайте нужные ярлыки. У каждого тега, кроме имени и цвета, есть описание: короткое пояснение, что этот тег значит («VIP = чек от 1 млн», «Недозвон = не берёт трубку 2+ раза»).

Описание важно вдвойне: его читает бот, и тегает осмысленнее, а не угадывает по одному имени. Описание можно добавить при создании или отредактировать позже (иконка ✎).

Теги бывают двух «авторов»: заведённые оператором и созданные ботом (бейдж «создано ИИ»), но в работе это один общий набор.

Шаг 2. Включите функцию «Помечать лида тегами»

Чтобы бот ставил теги сам, в проекте должна быть включена функция «Помечать лида тегами» (раздел Функции). У нового проекта она стоит с рождения, проектам, созданным до 14 сентября 2026, её добавляют из каталога. Пока она выключена, бот теги не трогает, их ставит только оператор.

У функции два переключателя. Первый, «Разрешить боту создавать новые теги»:

• включён, если подходящего тега в списке нет, бот заведёт новый (коротко, 1-3 слова) и сам добавит ему описание; тег появится на странице «Теги» с бейджем «создано ИИ»;
• выключен: бот выбирает только из тегов, которые вы уже завели; ничего нового не придумывает.

Второй, «Разрешить боту снимать/менять теги»: по умолчанию бот только добавляет теги и не трогает уже стоящие. Включи, если хочешь, чтобы он мог убрать устаревший тег (например, снять «новый», когда клиент стал «постоянным»).

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

Важно: бот добавляет теги к уже стоящим и не стирает чужие (в том числе ваши, поставленные вручную). Регистр выравнивается автоматически: «астана» от бота и «Астана» из списка станут одним тегом. Снять тег может оператор в карточке лида.

Шаг 3. Сегментация: фильтр и отчёты

В разделе «Лиды» фильтруйте список по тегам: выберите несколько, покажутся лиды, у которых есть все выбранные теги (логика «И»). Фильтр учитывается и при экспорте: выгрузите именно нужный сегмент, а в CSV будет колонка «Теги».

На странице «Отчёты» видны все теги проекта с числом лидов по каждому за выбранный период (теги с нулём тоже видны), и есть кнопка «Выгрузить CSV»: список тегов с описаниями и количеством за период.

Блок «По тегам» по умолчанию включён и в письме-отчёте владельцу. В настройках отчёта можно выбрать, какие теги в него попадут:

• Топ-N: N самых частых тегов за период (по умолчанию топ-5; число задаёте сами);
• Все: все теги, которые встречались за период, от частых к редким;
• Выбранные: только отмеченные вами теги (даже с нулём, удобно следить, что какой-то тег пока не присваивается).

💡 Зачем это на практике. Навесил ботом тег опт на оптовиков, отфильтровал, выгрузил, сделал им отдельное предложение. Или отметил недозвон, и дожимаешь именно их. Теги превращают «кучу диалогов» в управляемые группы.

Шаг 4. Теги в правилах и рассылках

Тег это ещё и переключатель для автоматики:

• Правило с поводом «тег добавлен». Бот повесил VIP: правило сообщает вам в Telegram, переводит стадию или дёргает ваш вебхук. Правило, которое само поставило тег, следующие правила «тег добавлен» не запускает, чтобы не было петли.
• Правило с условием «если тег». Один и тот же повод (например, «клиент оплатил») может вести себя по-разному для опт и розница.
• Правило с действием «поставить тег». Клиент написал слово «стоп» или прислал файл, и тег ставится без модели.
• Рассылка по тегу в Telegram и исходящие по сегменту.
• Функция «Помечать лида тегами» понимает клиента на любом языке: категорию она определяет по смыслу разговора, а не по словам.

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

Теги это стикеры, которые лепятся на клиентов. У нового проекта первые стикеры заводятся сами из твоих ответов при создании, а на странице «Теги» ты их правишь, добавляешь свои и подписываешь, что каждый значит. Функция «Помечать лида тегами» у нового проекта уже включена, и бот развешивает стикеры сам прямо во время разговора: поговорил с оптовиком, повесил «опт», клиент из Астаны, «Астана». Что именно отслеживать, ты говоришь боту в промпте обычными словами.

Бот не плодит дубли: сперва смотрит, какие стикеры уже есть, и берёт существующий. Можно разрешить ему придумывать новые (он сам и подпишет их) или запретить, тогда он клеит только из твоего списка. Чужие стикеры бот не срывает, только добавляет; снять может оператор. На одного человека до 20 стикеров.

Зачем всё это? Чтобы потом в «Лидах» одним кликом отфильтровать, например, всех оптовиков или всех, кому не дозвонились, и поработать с ними отдельно. А на «Отчётах» видно сразу весь список тегов с числами и можно выгрузить в файл. Без тегов у тебя просто свалка диалогов, с тегами: аккуратные группы.

Дальше: → Диалоги
Связано: Лиды · Дожимы · Аналитика · Функции
Не получилось? → Функция не вызывается / падает

Документация › Инструменты бота › Уведомления владельцу

Уведомления владельцу

Бот сам пишет вам, как только появился горячий лид или нужно вмешаться: в Telegram, в WhatsApp или на почту.

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

За 30 секунд:

• Это функция №1: бот ловит заявку в чате и сразу сообщает вам.
• Три способа: Telegram (мгновенно, в телефоне), WhatsApp (в личку или в рабочую группу) или Email (на почту, без настройки).
• Для Telegram нужен бот-«вестник». Если настройку ведём мы, подключаем своего, @dosaitech_bot: вам остаётся добавить его в группу. Хотите бота со своим именем, заведите его за минуту сами.
• В тексте уведомления можно подставлять данные клиента: {{name}}, {{phone}}, {{date}} и т.п. Имя и телефон бот берёт из разговора, то есть то, что клиент сам написал; не написал, подставятся имя и номер из профиля мессенджера. Поэтому письмо из тест-чата тоже приходит заполненным.
• После уведомления бот может замолчать в чате и передать клиента вам, а галочка «Это заявка» заведёт карточку лида и сделку в CRM.

Зачем это нужно

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

📌 Пример (барбершоп). Клиент пишет ночью: «запишите на завтра на 14:00». Бот предлагает время, фиксирует заявку и шлёт вам в Telegram: «Новая запись: Асан, +7 705…, завтра 14:00». Утром вы уже знаете о записи.

Способ 1. Уведомление в Telegram

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

• ☐ Бот-«вестник»: наш @dosaitech_bot или свой, созданный через @BotFather
• ☐ ID чата, куда слать (ваш личный чат или группа команды)

Шаги

1. Выберите бота

Уведомления приходят от бота, поэтому бот нужен в любом случае. Вариантов два.

Вариант А. Наш бот (по умолчанию, когда настройку ведём мы). Добавьте в вашу рабочую группу @dosaitech_bot (в Telegram он подписан «DOS AI») и пришлите нам номер группы, как его узнать, в шаге 2. Токен впишем мы, вам ничего копировать не нужно. Этот бот только приносит уведомления в вашу группу: переписку с вашими клиентами он не ведёт и не читает, для клиентов работает ваш собственный канал. Если написать ему в личные сообщения, ответит помощник DOS AI: там можно задать вопрос нам.

Вариант Б. Свой бот. Подходит, если настраиваете сами или хотите, чтобы уведомления приходили от бота с вашим названием и аватаркой. Откройте в Telegram @BotFather → команда /newbot → придумайте имя и username. BotFather пришлёт токен вида 123456789:AAExxxxxxxxxxxxxxxxxxxxxx. Скопируйте его и вставьте в поле «Токен бота» на шаге 3.

⚠️ Важно. Токен это пароль от бота, кто им владеет, тот управляет ботом. Поэтому свой мы не публикуем и вписываем сами при настройке, а вы свой никому не пересылайте. В DOS AI токен хранится зашифрованным и в интерфейсе показывается как ***hidden***.

2. Узнайте ID чата

• Личный чат: напишите боту @userinfobot, он пришлёт ваш id (число вроде 512345678).
• Группа: добавьте бота из шага 1 в группу, затем добавьте туда же @userinfobot: он покажет ID группы (число со знаком минус, например -1001234567890).

⚠️ Бот должен быть участником группы, иначе Telegram не даст ему туда написать. И номер группы меняется, если её превратить в супергруппу или добавить темы: после такого возьмите ID заново.

3. Создайте функцию

Функции → Новая функция → Из готового шаблона → Уведомления владельцу → Уведомление в Telegram.

Заполните:

• Токен бота, из шага 1 (если работаем мы, это поле уже заполнено);
• ID чата, из шага 2;
• Шаблон сообщения: текст уведомления. Кнопками-чипами вставляйте переменные: {{name}}, {{phone}}, {{summary}} и системные {{date}}, {{time}} (двойные фигурные скобки).

📌 Пример шаблона: 🔔 Новая заявка от {{name}}, тел: {{phone}}\n{{date}} {{time}}.

4. Опишите, КОГДА слать

В поле «Когда боту это вызывать» опишите повод: например «когда клиент назвал имя и телефон и согласился записаться, отправь уведомление». По этому описанию ИИ решает, в какой момент дёрнуть функцию.

Что сделать после уведомления

У любой функции, и у уведомления тоже, в настройках есть раздел «После вызова»:

• «Завершать диалог после выполнения этой функции»: после успешного уведомления бот замолкает на этом чате и передаёт клиента вам. Удобно для схемы «бот квалифицировал → дальше говорит человек».
• «Останавливать дожимы после этой функции»: напоминания этому клиенту больше не уходят, а бот продолжает отвечать.
• «Это заявка: создать лида и сделку в CRM»: ставьте у уведомления о заявке. Сработало, и у клиента появляется карточка в «Лидах» и сделка в подключённой CRM, даже если бот оценил его осторожнее. У уведомлений вроде «клиент задал вопрос не по теме» галочку не ставьте: это не заявка.

Способ 2. Уведомление в WhatsApp

Подходит, когда команда и так сидит в WhatsApp и заводить Telegram не хочется.

Функции → Новая функция → Из готового шаблона → Уведомления владельцу → Уведомление в WhatsApp. Укажите:

• Куда слать: ваш номер в международном формате (+7 705 …) либо ID рабочей группы WhatsApp вида 120363…@g.us;
• Текст сообщения с теми же переменными {{client_name}}, {{phone}}, {{channel}}.

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

Если в тексте стоит подстановка, которую ничем не заполнить (например, {{course}}, а такого параметра у функции нет), редактор под полем текста напишет красным: «Эти подстановки ничем не заполнятся и придут пустыми». То же для Telegram и почты. Исправьте имя или добавьте параметр, иначе в уведомлении будет «Курс: » без значения.

⚠️ Своему же номеру бот не пишет: если указать номер канала, платформа отклонит отправку. Это защита от петли «бот написал себе и сам себе ответил».

Способ 3. Уведомление на почту

Самый простой вариант: работает сразу, ничего создавать в сторонних сервисах не нужно.

Функции → Новая функция → Из готового шаблона → Уведомления владельцу → Уведомление на почту. Укажите:

• Email: куда слать;
• Тема и Текст письма это с теми же переменными {{name}}, {{phone}}, {{date}}.

Письмо приходит вам с адреса noreply@dosai.pro.

Проверь, что работает

Откройте функцию → кнопка «Проверить» → заполните примеры значений → бот отправит тестовое уведомление вам в Telegram, в WhatsApp или на почту. В Telegram тестовое сообщение помечается префиксом «🧪 ТЕСТ».

Частые ошибки

Вопросы, которые обычно возникают

Можно слать в группу, а не лично?
Да. Добавьте бота в группу и используйте ID группы (с минусом).

Бот будет слать на каждое сообщение клиента?
Нет, только когда выполнено условие из описания (например, собраны имя и телефон). Опишите повод точно.

Обязательно заводить своего бота?
Нет. Если проект настраиваем мы, подключаем @dosaitech_bot, и вам остаётся добавить его в группу. Свой нужен в двух случаях: вы настраиваете сами (тогда поле «Токен бота» ждёт ваш токен) или хотите, чтобы уведомления приходили от бота с вашим названием и аватаркой. Перейти с нашего на свой можно в любой момент: создали бота у @BotFather, добавили в ту же группу, заменили токен в функции.

Ваш бот сидит в нашей группе. Он видит, что мы там пишем?
Нет. У него включён режим приватности Telegram: обычные сообщения группы боту просто не приходят, он их не получает. К переписке с вашими клиентами он тоже отношения не имеет, она идёт через ваш собственный канал WhatsApp, Instagram или Telegram. Если всё равно не хотите чужого бота в рабочей группе, заведите своего, вариант Б выше.

Под капотом

• Telegram-уведомление: встроенная функция типа builtin_telegram; токен шифруется (AES-GCM), не хранится в открытом виде.
• Токен обязателен: платформа не подставляет никакого бота «по умолчанию» сама. Когда проект настраиваем мы, в это поле уходит токен @dosaitech_bot, когда вы сами, ваш токен от @BotFather.
• Тестовый чат помечает сообщение префиксом «🧪 ТЕСТ», чтобы не путать с боевым.
• «Завершать диалог» ставит conversations.ai_on=false с причиной hand-off; включить бота обратно можно кнопкой «AI» в шапке диалога.
• Email-уведомление (builtin_email) уходит через Resend с таймаутом 15 секунд; получатель: один адрес (множественные через запятую отклоняются как защита от рассылки).
• WhatsApp-уведомление (builtin_whatsapp) уходит через канал проекта: одно и то же сообщение одному получателю не чаще раза в минуту, отправка себе заблокирована, при отключённом канале функция честно отвечает «номер сейчас не подключён» вместо тихого пропуска.

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

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

Дальше: → Запись на время
Связано: Функции · Письмо клиенту
Не получилось? → Функция не срабатывает

Документация › Инструменты бота › Запись на время

Запись на время

Бот сам показывает свободное время и записывает клиента: простым способом через Google Calendar или «движком окошек» для нескольких специалистов.

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

За 30 секунд:

• Три способа записи: выберите под свой бизнес (ниже шпаргалка).
• Google Calendar: один специалист, простой график.
• Движок окошек: несколько мастеров, график в таблице, обеды/отпуска/ограничения.
• Google Таблицы, если вы уже ведёте слоты строками в таблице.
• Ресторан на кассе iiko или учебный центр в АльфаCRM: бот записывает прямо в вашу систему, отдельная функция записи не нужна (iiko, АльфаCRM).

Как выбрать способ

Способ A. Google Calendar (один специалист)

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

• ☐ Google-календарь
• ☐ Доступ для сервис-аккаунта (одна кнопка в настройках функции)

Шаги

1. Функции → Новая функция → Из готового шаблона → Запись на время → группа «Google Calendar». Здесь 5 готовых действий: проверить свободное время, записать, перенести, показать записи, отменить.
2. Сначала откройте доступ. Наверху настроек функции есть панель с адресом сервис-аккаунта и кнопкой «Копировать». В Google Календаре: нужный календарь → «Настройки и общий доступ» → «Добавить пользователей или группы» → вставьте этот адрес, выберите право «Изменять и просматривать все сведения о мероприятиях» и нажмите «Отправить». Без этого шага проверка на шаге 4 не пройдёт, боту просто некуда смотреть.
3. Укажите Календарь это ID вашего календаря: для основного его ID = ваш email в Google (например ivan@gmail.com), для отдельного календаря адрес вида ...@group.calendar.google.com (он лежит там же, в настройках календаря, раздел «Интеграция календаря»). Можно вставить ссылку из адресной строки, ID вытащится сам. ⚠️ Слово primary не подойдёт, так бот попадёт в свой технический календарь, вам не видимый, и записи «пропадут».
4. Нажмите «Проверить подключение». Зелёный ответ покажет, сколько событий бот видит, красный назовёт причину.
5. Настройте расписание работы: рабочие дни, часы, обед, длительность слота, минимальный запас до записи. Это настройки самой функции: бот будет предлагать только время внутри них.

⚠️ Важно. Расписание работы задаётся прямо в настройках функции «Проверить свободное время». Бот предлагает слоты строго в этих рамках.

📌 Пример (стоматология). Функция «Записать клиента» с длительностью слота 60 минут, рабочие дни Пн-Сб 9:00-19:00, запас 60 минут. Бот не запишет на ближайший час и не предложит воскресенье.

Если объектов несколько и они одинаковые

Бани, кабинеты, корты, столики, домики: бот не выбирает конкретный объект, он считает, СКОЛЬКО их занято на это время. Кто именно поедет в баню номер 3, решаете вы, как и сейчас.

1. Заведите один календарь на группу одинаковых объектов.
2. В функции «Проверить свободное время» поставьте «Записей на одно время» = сколько объектов в группе. Четыре бани, значит 4: пятого клиента на это время бот уже не запишет.
3. То же число продублируйте в функции «Записать клиента». Без этого она возьмёт вместимость у первой попавшейся функции проверки, и при нескольких группах числа перепутаются.

Объекты разной вместимости или цены это разные группы. У каждой свой календарь и своя пара функций «проверить» и «записать», иначе бот отправит компанию из 25 человек туда, где помещается 10.

📌 Пример (база отдыха). 4 бани, 7 юрт до 10 гостей и 2 больших юрты. Это 3 календаря и 6 функций: check_bath_slots и book_bath (вместимость 4), check_yurt_small_slots и book_yurt_small (7), check_yurt_big_slots и book_yurt_big (2). Имена функций должны отличаться, имя правится в мастере, раздел «Расширенные настройки».

💡 Свои брони, которые вы ставите руками, вносите в тот же календарь. Бот считает занятость по нему целиком и не различает, кто создал событие.

Способ B. Движок окошек (несколько специалистов)

Одна функция вместо цепочки «прочитай график → возьми занятость → посчитай сам». Сервер сам учитывает часы по дням, обеды, отпуска, ограничения дней и возраст, и отдаёт боту готовый список свободных слотов с именами специалистов.

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

• ☐ Google-таблица с графиком специалистов
• ☐ Список услуг (заполняется в конструкторе: без JSON руками)
• ☐ (если берёте занятость из CRM) подключённая АльфаCRM

Формат листа-графика

Лист должен содержать колонки: специалист, услуга (предмет), минимальный возраст, дни работы с часами, обеды, комментарии. Имена колонок по умолчанию: «Преподаватель», «Предмет», «Минимальный возраст», «Обеды», «Комментарии». Если у вас они называются иначе в настройках функции есть раздел «Колонки в листе называются иначе?».

Дни ведутся одним из двух способов, сервер определяет его сам по заголовкам:

В календарном режиме день, для которого колонки ещё нет, считается «расписание не заведено» и не показывается: бот не будет записывать в дату, которую вы не заполняли. Если весь запрошенный период за последней заполненной колонкой, функция так и скажет, вместо пустого списка, который читается как «все заняты». Держите заполненными хотя бы 2-3 недели вперёд.

В ячейках дней пишутся часы работы: 11:00-18:00, можно с перерывом 11:00-15:00 и 16:00-21:00. Пустая ячейка, в, вых или слово Отпуск означают, что в этот день специалист не работает. Маркеры в ячейке: (без ПЗ) это «в этот день новых на пробное не ставим», (день ПЗ) это «день выделен под пробные».

Какие фразы в колонке «Комментарии» сервер понимает

Пишите как удобно: понятные формы разбираются мгновенно, а необычную формулировку дочитывает ИИ (один раз, результат запоминается). Самые надёжные формы:

Одна мысль на фразу, разделяйте точкой.

💡 Условие, которое выполняет человек («по договорённости», «после согласования с мастером»), не прячет специалиста: бот покажет его время и предупредит клиента, что запись подтвердит менеджер, а бронировать сам не станет.

⚠️ Если смысл фразы непонятен даже ИИ, специалист скрывается с пометкой менеджеру. Лучше не показать того, кого можно, чем записать клиента к тому, кого нельзя. Такие случаи видно на экране «Проверка графика», и о них приходит уведомление.

Шаги

1. Функции → Новая функция → Из готового шаблона → Запись на время → Свободные окошки для записи.
2. Укажите ID Google-таблицы с графиком и нажмите проверку подключения. Затем «Найти лист автоматически»: сервер сам выберет лист с графиком и определит, как названы колонки, вам останется подтвердить.
3. Услуги заполняются в конструкторе, для каждой услуги: название (как в колонке «Предмет»), синонимы через запятую, минимальный возраст, и (если занятость из CRM) branch_id / subject_id из вашей АльфаCRM.
4. Источник занятости: «АльфаCRM (занятые уроки)» (берёт занятые уроки из CRM) или «Только график» (без CRM).
5. Параметры окна: длительность слота, за сколько дней минимум можно записаться, горизонт показа (максимум 14 дней), окно работы бизнеса, таймзона.

💡 Совет. Не вводите JSON руками: конструктор услуг и колонок соберёт его за вас. Кнопка «Редактировать как JSON» оставлена на случай тонкой правки.

Напоминание клиенту перед визитом

Записали человека, дальше он про это забывает. Платформа напомнит сама, в тот же чат, где он записывался.

Где включить: Автоматизации → Записи. Настройки одни на весь проект: сколько бы у вас ни было функций записи (баня 1, баня 2), напоминания для всех включаются одним тумблером. Там же подтверждение «вы записаны», тексты, ночное окно и список всех записей с судьбой каждого сообщения. Подробно: Подтверждение и напоминания о записи.

• Перенос записи двигает напоминания за собой, отмена снимает их.
• Отправленное напоминание видно в переписке с пометкой «Напоминание».
• В тест-чате напоминания не отправляются, это не сбой.
• Запись, которую вы занесли в календарь руками, бот не видит. Если записи ведутся в вашей CRM, её можно подключить: см. статью по ссылке выше.

Проверь, что работает

Движок окошек: откройте функцию → «Проверить график». Это главный экран самопроверки: он показывает, что сервер понял из вашей таблицы: кого видит, что вычитал из каждого комментария, кто скрыт и почему, до какой даты заполнено расписание. Если кто-то из специалистов не появляется у клиентов, ответ будет здесь.

Дальше «Проверить» → передайте услугу (и возраст, если нужен) → вернётся список свободных слотов. Для Calendar: проверьте, что слоты попадают в ваши рабочие часы.

💡 Работа за полночь. Заведение работает ночью (сауна, караоке, доставка): в функции Calendar укажите конец раньше начала, например «с 11:00 до 02:00». Бот поймёт это как «до двух часов ночи следующего дня» и будет предлагать ночные окна, а под полями появится подсказка «Работа через полночь». Круглосуточно задаётся как 00:00-23:59. Подробно: Google Календарь.

⚠️ Когда график мешает записи (лист переименовали, специалиста пришлось скрыть, колонки с датами кончились), приходит уведомление владельцу: не чаще раза в сутки, чтобы не превратиться в шум.

Частые ошибки

Вопросы, которые обычно возникают

Можно показывать запись на сегодня?
Да: поставьте «Запись минимум за» = 0.

Сколько дней вперёд показывает движок окошек?
До 14 дней (горизонт настраивается).

Под капотом

• Движок окошек: builtin_booking (find_free_slots), пересечение графика из Sheets ∩ RU-ограничений из комментариев ∩ занятости из edu-CRM. Модель не делает табличную математику: получает готовый ответ.
• Google Calendar: builtin_calendar; расписание читается из настроек функции (builtin_config): рабочие дни/часы/слот/запас/таймзона.
• Услуги хранятся в services_json, имена колонок: в columns_json; конструктор сериализует их за вас.

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

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

Дальше: → Бот выставляет счёт
Связано: Google Таблицы · Google Calendar
Не получилось? → Функция не срабатывает

Документация › Инструменты бота › Бот выставляет счёт

Бот выставляет счёт (Kaspi)

Бот сам выставляет клиенту счёт прямо в чате: клиент платит через push в Kaspi, деньги идут на вашу Kaspi-кассу.

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

За 30 секунд:

• Клиент готов платить → бот создаёт счёт → клиенту приходит push в приложение Kaspi.
• Деньги идут напрямую на вашу Kaspi-кассу.
• Сначала подключите платежи в разделе «Приём оплат» проекта.
• Бот сам спрашивает у клиента сумму и номер, не выдумывает.
• Отправив счёт, бот называет номер вслух и предлагает перевыставить, если Kaspi на другом телефоне.

Зачем это нужно

Чтобы не уводить клиента из переписки на сторонние ссылки. Договорились, бот тут же выставил счёт, клиент подтвердил оплату в Kaspi, не выходя из диалога. Меньше шагов, больше оплат.

📌 Пример (интернет-магазин). Клиент: «беру, сколько с меня?» Бот: «3 500 ₸, отправляю счёт на ваш номер». Клиенту приходит push в Kaspi, он подтверждает, заказ оплачен.

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

• ☐ Подключённые платежи: раздел «Приём оплат» проекта (мастер подключения)
• ☐ Kaspi-касса бизнеса

Шаги

1. Подключите платежи: Интеграции → Приём оплат и пройдите мастер. Без этого функция вежливо ответит клиенту, что оплата временно недоступна.
2. Функции → Новая функция → Из готового шаблона → Приём оплаты (Kaspi) → Выставить счёт на оплату.
3. (необязательно) Задайте описание по умолчанию: оно появится в Kaspi-push и чеке, если бот не передаст своё.
4. В поле «Когда боту это вызывать» опишите момент: «когда клиент согласился оплатить и назвал сумму, выстави счёт».

Что бот собирает у клиента

• Сумму в тенге (минимум 50, максимум 10 000 000);
• Номер телефона, привязанный к Kaspi (любой казахстанский формат);
• За что платит, короткая строка для чека.

Клиенту приходит push в приложение Kaspi: подтвердить нужно в течение 30 минут.

Управление в разделе «Приём оплат»

После подключения раздел «Приём оплат» показывает всё по оплатам проекта, обновляется сам, без перезагрузки страницы:

• Сводка сверху: сколько получено за месяц и всего, сколько счетов ждут оплаты, сумма возвратов.
• История счетов: кто, когда, на сколько и статус каждого счёта. Фильтр по статусу (все / ждут оплаты / оплачены / возвраты / отменены) и экспорт в CSV (для бухгалтерии).
• Выставить счёт вручную, кнопка для счёта без диалога: указываете сумму, номер клиента и описание, клиенту приходит push в Kaspi.
• Отменить неоплаченный счёт, если клиент передумал, счёт можно закрыть, чтобы он не висел.
• Вернуть оплату по оплаченному счёту можно сделать возврат: полностью или часть суммы. Деньги уходят обратно на Kaspi клиента.

Проверь, что работает

В тест-чате счёт выставляется по-настоящему: назовите боту свой номер и получите push в Kaspi (или ссылку на оплату). Сумма тестового счёта всегда 100 ₸ (у кассы в сомах 100 сом): настоящую цену бот называет словами, а тест-чат пишет её пометкой под счётом. Счёт помечен «ТЕСТ» и через 10 минут откатывается сам: оплата возвращается, неоплаченный счёт отменяется, сбор платформы за тестовую оплату не берётся. Платить не обязательно: достаточно увидеть push. Счёт появится в истории раздела «Приём оплат».

Частые ошибки

Вопросы, которые обычно возникают

Где деньги, у DOS?
Нет. Деньги идут напрямую на вашу Kaspi-кассу. DOS, только софт, который помогает выставить счёт.

Какая минимальная сумма?
50 ₸.

Под капотом

• Встроенная функция builtin_owner_payment: создаёт счёт в кассе владельца и шлёт Kaspi-push. Валидация суммы (50 … 10 000 000 ₸) и номера: до обращения к провайдеру.
• Структурированные коды ошибок (sub_merchant_not_connected, kaspi_auth_lost и т.п.) дают боту понять, как ответить клиенту.
• В тест-чате счёт настоящий, но тестовый, всегда на 100 ₸: бот называет настоящую цену и говорит, что через 10 минут оплата вернётся, а неоплаченный счёт отменится. Сказать «выставил», не вызвав функцию, бот не может ни в тесте, ни в бою: платформа сверяет слова с действиями после каждого ответа.

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

Раньше, чтобы взять оплату, нужно было кидать клиенту ссылку или реквизиты и надеяться, что он дойдёт. Теперь бот прямо в чате выставляет счёт, клиенту в Kaspi прилетает «оплатить 3 500 ₸?», он жмёт «да», и всё. Деньги: сразу на вашу кассу.

Дальше: → Письмо клиенту
Связано: Функции
Не получилось? → Функция не срабатывает

Документация › Инструменты бота › Письмо клиенту

Письмо клиенту

Бот сам пишет клиенту письмо: подтверждение, реквизиты, инструкцию или материалы. Ответ клиента приходит на вашу почту.

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

За 30 секунд:

• Бот отправляет письмо конечному клиенту от имени вашей компании.
• Тему и текст бот составляет сам по ходу разговора.
• Письмо уходит с адреса noreply@dosai.pro; если клиент ответит, придёт на ваш email.
• Работает сразу, без подключения почтового сервиса.

Зачем это нужно

Иногда клиенту нужно прислать что-то письмом: подтверждение записи, реквизиты для оплаты, договор, инструкцию. Бот делает это сам, не отвлекая вас.

📌 Пример (автошкола). Клиент записался на занятие. Бот: «отправил на вашу почту памятку, что взять с собой и адрес». Клиент получает письмо, бот продолжает диалог.

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

• ☐ Ваш email для ответов клиента

Шаги

1. Функции → Новая функция → Из готового шаблона → Письмо клиенту → Отправить письмо клиенту.
2. Укажите «Куда придёт ответ клиента»: ваш рабочий email. Если клиент нажмёт «Ответить» на письмо, оно придёт сюда. Оставите поле пустым: ответы придут на email, с которым вы зарегистрированы в DOS AI.
3. В поле «Когда боту это вызывать» опишите повод: «когда клиент попросил прислать реквизиты/памятку, отправь письмо».

Тему, текст и адрес клиента бот определяет сам по разговору: тему и текст составляет, email спрашивает у клиента, если тот не назвал.

⚠️ Важно. Письмо уходит с общего адреса noreply@dosai.pro от имени вашей компании (имя проекта в поле «От кого»). Личный почтовый ящик подключать не нужно.

Проверь, что работает

Откройте функцию → «Проверить» → передайте тестовый email, тему и текст → проверьте, что письмо пришло. Ответьте на него: ответ должен прийти на указанный вами адрес.

Частые ошибки

Вопросы, которые обычно возникают

Можно слать с моего собственного Gmail?
Есть продвинутый вариант «Отправить с Gmail (Workspace)»: он требует Google Workspace и технической настройки (domain-wide delegation). Для большинства проще обычное «Письмо клиенту».

Чем это отличается от уведомления на почту?
Уведомление, вам (владельцу). Письмо клиенту, конечному клиенту.

Под капотом

• Встроенная функция builtin_email с операцией send_customer. Отправка через Resend; from = имя проекта <noreply@dosai.pro>, reply_to: ваш email из настроек (пусто → email аккаунта владельца).
• Гарды: один валидный адрес получателя (защита от рассылки), очистка заголовков и три ограничителя подряд: одно и то же письмо на тот же адрес не чаще раза в минуту, на один адрес не больше 5 писем в час, по проекту не больше 60 писем в сутки. Живой переписке эти числа не мешают (письмо клиенту после разговора это единицы в день), а превратить бота в рассыльщик они не дают.
• Тему/текст/получателя передаёт модель; владелец задаёт только адрес для ответа.

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

Бот умеет не только писать в чат, но и отправить клиенту нормальное письмо: например, реквизиты или памятку. Письмо уходит как будто от вашей компании, а если клиент ответит, ответ придёт вам на почту. Ничего настраивать не нужно, только укажите свой email.

Связано: Функции · Уведомления владельцу
Не получилось? → Функция не срабатывает

Документация › Инструменты бота › Рассылки

Рассылки по базе контактов

Появилась акция или новость? Отправь сообщение сразу всей своей базе в Telegram, с сегментами, отложенным запуском и кнопками.

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

За 30 секунд:

• Раздел «Рассылки» в левом меню (рабочие разделы открытого проекта): массовое сообщение по своим контактам.
• Только Telegram. WhatsApp недоступен намеренно: массовая отправка грозит баном номера.
• Сегментируй по статусу лида, тегу или рекламной кампании; перед отправкой видно охват (сколько получателей).
• Можно отложить на будущее время и прикрепить кнопки (ответ/ссылка).
• Кто написал «стоп», исключается автоматически. Отправка идёт постепенно (бережно к анти-бану).

Зачем это нужно

Дожимы напоминают о себе одному клиенту по таймеру. А рассылка это когда нужно сказать всем сразу: «в субботу скидка 20%», «открылся новый филиал», «записи на январь открыты». Раньше для этого пришлось бы вручную писать каждому, теперь это одно сообщение и пара кликов.

📌 Пример. Барбершоп запускает акцию на стрижку. Владелец делает рассылку по тегу «постоянный клиент» в Telegram, 140 человек получают сообщение с кнопкой «Записаться», отправка растягивается на несколько минут, никто из отписавшихся не получает спам.

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

• ☐ Подключённый Telegram-канал (рассылки работают только по нему).
• ☐ Роль владелец или админ проекта (раздел доступен только им).
• ☐ Желательно, настроенные теги, чтобы точно выбрать, кому слать.

Шаги

1. Открой раздел «Рассылки»

В левом меню нажми «Рассылки». Создай новую это кнопка вверху.

2. Выбери, кому отправить (сегмент)

Сузь аудиторию любым из фильтров (или оставь пустым, уйдёт всей базе Telegram):

• Статус лида: например только «горячие» или «потенциальные».
• Тег: например «постоянный клиент» или «был на пробном».
• Рекламная кампания: только тем, кто пришёл по конкретной рекламной ссылке.

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

3. Напиши сообщение и (по желанию) добавь кнопки

Введи текст. Можно прикрепить до 8 кнопок:

• Кнопка-ответ: клиент жмёт, бот получает её как сообщение и продолжает диалог.
• Кнопка-ссылка: открывает URL (только http/https).

4. Отправь сейчас или запланируй

• Сейчас: рассылка уходит в очередь и начинает рассылаться постепенно.
• На потом: укажи дату и время; рассылка будет ждать в статусе «запланирована» и стартует сама в нужный момент.

Проверь, что работает

Статус рассылки меняется: черновик → запланирована → в очереди → отправляется → отправлено. В списке видно счётчики (сколько ушло). Запущенную рассылку можно отменить, пока она в очереди или ещё идёт.

Частые ошибки

Вопросы, которые обычно возникают

Почему нельзя рассылать в WhatsApp?
Массовая отправка с подключённого номера WhatsApp: самый быстрый путь к его блокировке. Поэтому рассылки ограничены Telegram на уровне системы, а не спрятаны в интерфейсе.

А если человек просил больше не писать?
Контакты, которые написали «стоп» (отписались), исключаются из любой рассылки автоматически: отправлять им повторно нельзя.

Это то же самое, что дожимы?
Нет. Дожимы: авто-напоминания одному клиенту по таймеру после его действия. Рассылка: разовое сообщение сразу многим.

Под капотом (для разработчиков и любопытных)

• Таблица project_broadcasts: scheduled_at (NULL = сейчас), buttons JSONB, статусы draft → scheduled → queued → sending → sent / failed / canceled.
• API проекта: GET (список + ?count=1 превью охвата), POST (создать, снимок сегмента в строки-получатели, статус queued), PATCH {action:"cancel"}. Гейт: owner/admin.
• Telegram-only хардлимит на слое данных: фильтр сегмента всегда добавляет .like("chat_id", "tg_%") и .eq("broadcast_opt_out", false). Поле channel сегмента: вестигиальное, WhatsApp исключён намеренно (ban-risk).
• Сегмент: lead_status (.eq), tag (.contains tags), campaign (.filter full_data->source_detail->>campaign). Один и тот же фильтр применяется и к превью-COUNT, и к материализации, не могут разойтись.
• Кнопки санитизируются как inline-кнопки бота: ≤8, label ≤64, url-кнопки только http(s).
• Отправка paced воркером drip-tick (бережно к анти-бану); он же промоутит scheduled → queued по наступлению scheduled_at.

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

Это как разослать одно объявление сразу всем своим клиентам в Telegram, но аккуратно: можно выбрать, кому именно (например только постоянным), приложить кнопку «Записаться», запустить сейчас или поставить на завтра. Тем, кто просил не беспокоить, ничего не уйдёт. В WhatsApp так нельзя: за массовую рассылку номер банят.

Дальше: → Лиды
Связано: Дожимы · Теги · Telegram
Не получилось? → Канал не работает

Документация › Инструменты бота › Исходящие диалоги

Исходящие диалоги (бот пишет первым)

Есть база заявок, но руки не доходят обзвонить? Бот сам напишет первым в WhatsApp по каждому номеру, аккуратно, по капле, с паузами и лимитами, чтобы не спалить номер.

⏱ 12 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Исходящие = бот сам инициирует диалог с человеком из заявки (пишет первым), а не ждёт входящего.
• Работает только через подключённый WhatsApp-канал (QRDOS).
• Это серый режим: WhatsApp может забанить номер за сообщения незнакомцам. Включает только владелец, под свою ответственность.
• Текст первого сообщения вы пишете сами (готовые варианты, без ИИ). Бот шлёт случайный из списка, с подстановкой имени и услуги.
• Первый запуск ведёт мастер: Сообщение (что писать) → Номера (кому) → Проверка и запуск, включая тест на своём номере одной кнопкой.
• Рассылка по списку номеров бесплатна (готовый текст, ИИ не тратится).

⚠️ Сначала прочтите про риск

Исходящие, это серый режим. Вы пишете первыми незнакомым номерам. WhatsApp считает это спам-паттерном и может заблокировать номер, а это ваш основной рабочий номер: при бане теряется вся переписка с текущими клиентами.

Все встроенные защиты (лимиты, паузы, прогрев, проверка номера, автопауза) только снижают риск, но не убирают его.

🚫 Не включайте на главном номере, если не готовы к риску бана. Лучше отдельный номер под холодную рассылку.

Перед запуском обязательно прочтите Гигиену и антибан.

Включить Исходящие может только владелец проекта, поставив галку «Понимаю риск и беру ответственность на себя».

Что нужно до старта

1. Подключённый WhatsApp-канал (QRDOS). См. Подключение WhatsApp. Без живого канала бот физически не сможет писать: лиды будут копиться в очереди, но не отправляться. В кабинете вы увидите красное предупреждение «WhatsApp-канал не подключён».
2. Роль владельца. Включение и приём ответственности доступны только владельцу.

Баланс для рассылки по списку не требуется: первое сообщение это готовый текст, ИИ не участвует, токены не тратятся.

Как устроена страница

Первый запуск: мастер. Пока кампания ни разу не запускалась, страница показывает один экран с текущим шагом: 1 Сообщение → 2 Номера → 3 Проверка и запуск. Формы прямо в шагах, ничего искать не нужно. Мастер можно пропустить ссылкой сверху; после запуска он больше не появляется.

Дальше: кабинет кампании.

• Пульт (карточка сверху): статус кампании словами и, главное, почему бот молчит прямо сейчас: «Кампания на паузе: причина», «Защитная пауза после подключения: ещё ~N мин», «Сейчас нерабочие часы», «Дневной лимит исчерпан», «Работает: в очереди N» или «Очередь пуста». Рядом полоса «Сегодня: X из Y» (сколько первых сообщений уже отправлено против действующего лимита; при прогреве написано «прогрев номера, день N»). Справа всегда красная кнопка «Стоп всё» (мгновенная пауза), на паузе вместо неё «Снять паузу». Текст про риск свёрнут в маленькую ссылку.
• Пульс кампании: четыре живые плитки (Новые / В очереди / Отправлено / Ответили). Обновляются сами; клик по плитке открывает список лидов уже с этим фильтром.
• Четыре вкладки: «Рассылка» (номера, запуск, список лидов, ответы), «Сценарий» (тексты), «Безопасность» (лимиты), «Статистика» (воронка и доставка).
• При первом ответе появится разовый баннер «Есть ответ!» с кнопкой к списку ответивших.

Шаг 1. Сценарий: что бот пишет первым

Вкладка «Сценарий». Здесь вы задаёте типы заявок и текст первого сообщения для каждого.

Тип заявки это категория обращений со своим текстом. Например, заявки на «SMM», «Таргет», «Сайт»: заведите три типа, для каждого свой текст. Если заявки однотипные, хватит одного типа «Основной».

Как заполнить:

• Текст первого сообщения (обязательно). Вы пишете готовое сообщение, бот отправит его как есть, без ИИ.
• Несколько вариантов (по желанию, до 10). Бот каждому новому человеку отправит случайный из списка. Это «ротация»: снижает риск блокировки, WhatsApp не любит, когда со всех номеров летит один и тот же текст.
• Название типа (по желанию). Только для вас. Пустое → «Основной».
• Авто-подбор типа (по желанию). Если в данных заявки есть поле с определённым значением (например, услуга = SMM), бот сам выберет нужный тип.

Подстановки

В текст можно вставить переменные:

• {{имя}}: подставится имя из заявки.
• {{услуга}}: подставится услуга.
• {{любое поле}}: любое другое поле заявки по его названию. Загрузили список с колонкой «город», пишете {{город}}; пришла заявка по API с полем filial, пишете {{filial}}.

Если в заявке нужного поля нет, кусочек аккуратно уберётся (включая предлог перед ним), сырые скобки клиенту никогда не уходят.

Развилки: разное сообщение каждому

В одинарных скобках через вертикальную черту пишутся варианты кусочка фразы, и бот выбирает один при каждой отправке:

• {Здравствуйте|Добрый день|Привет}, {{имя}}! даст три разных начала;
• Напишите{, если удобно|} иногда добавит хвост, иногда нет (пустая ветка после черты это «ничего»);
• развилки перемножаются: три начала × три середины × два конца это восемнадцать разных сообщений из одного шаблона.

Зачем: ротация готовых вариантов ограничена десятью, а людей в списке бывают сотни, и одиннадцатый получает текст, который уже уходил кому-то. Одинаковые сообщения пачкой с одного номера это то, за что WhatsApp ограничивает номера, и то, по чему человек узнаёт робота.

⚠️ Не путайте скобки: двойные {{имя}} это подстановка из заявки, одинарные {а|б} это развилка. Одинарные скобки без черты остаются в тексте как есть.

📌 Пример: «Здравствуйте, {{имя}}! Вы оставляли заявку на {{услуга}}: подскажите, актуально?» → для заявки без имени и услуги превратится в «Здравствуйте! Вы оставляли заявку: подскажите, актуально?»

Несколько сообщений подряд, как пишет человек

Человек в WhatsApp не пишет одним абзацем: сначала «Здравствуйте!», потом мысль, потом вопрос. Чтобы бот писал так же, оставьте пустую строку между абзацами:

Здравствуйте, {{имя}}!

Вы оставляли заявку на {{услуга}}. Подскажите, ещё актуально?

Клиент получит два отдельных сообщения, и перед каждым увидит «печатает…». Так же работают тексты дожимов.

• Больше трёх сообщений за раз не уходит: четвёртый абзац и дальше склеятся с третьим. Залп коротких сообщений подряд WhatsApp считает признаком автомата.
• Обычный перенос строки (без пустой строки) остаётся внутри одного сообщения.
• Превью «Так увидит клиент» сразу показывает текст отдельными пузырями.

💡 Пока вы печатаете, рядом с полем обновляется живое превью «Так увидит клиент»: ваше сообщение в виде WhatsApp-пузыря с подставленным примером имени. Видно, как текст выглядит у клиента, ещё до отправки. Кнопки-примеры («пример 1», «пример 2») вставят готовый текст, чтобы отредактировать под себя, а черновик сохраняется сам и не потеряется при переходе на другую вкладку. Проверить текст на конкретном номере из вашего списка можно кнопкой «Показать пример сообщения» в блоке «Добавить номера» (вкладка «Рассылка»). А если заданы дожимы, внизу «Сценария» появится лента «Вся цепочка глазами клиента»: первое сообщение и напоминания по порядку, как их получит человек.

Дожимы (необязательно)

Тут же можно задать напоминания тем, кто не ответил на первое сообщение. Это тоже готовый текст (с теми же подстановками, что и в первом сообщении), а не ИИ. Например: первое напоминание через 24 часа, второе через 72.

Дожимы работают только пока человек молчит. Как только он ответит, напоминания прекращаются и диалог переходит в обычный режим (подключается основной бот проекта). Подробнее про механику, Дожимы.

Автоответ на ваше первое сообщение бот за ответ человека не считает. Часто у номера стоит WhatsApp Business с приветствием или «нет на месте»: через секунду после вашего сообщения приходит шаблон вроде «Для записи напишите дату и время». Бот его сохраняет в диалоге, но не отвечает на него и не тратит деньги: настоящий человек напишет позже и получит ответ как обычно. В журнале событий это строка «Автоответ другого бизнеса: бот не отвечает».

Шаг 2. Номера: кому бот напишет

Вкладка «Рассылка», блок «Добавить номера» (у новой кампании раскрыт сразу, у работающей свёрнут в одну строку). Три способа добавить номера.

Способ 1. Вставить список (самый простой)

1. Вставьте номера в поле, по одному в строке. Можно с именем через запятую: +7 705 123 45 67, Айгерим (имя необязательно). Или нажмите «Загрузить CSV».
2. (по желанию) «Показать пример сообщения» покажет 1-2 сообщения в виде WhatsApp-пузырей, ничего не отправляя. «Проверить список» разложит базу по бейджам: всего / валидных / дублей / в стоп-листе / уже в работе / к загрузке / сколько номеров есть в WhatsApp.
3. «Загрузить в очередь (N)»: на кнопке сразу видно, сколько номеров распознано. После нажатия номера станут лидами.

После загрузки прямо на месте появится зелёная строка «✓ Загружено N» с кнопкой «Запустить сейчас»: никуда переходить не нужно. Номера станут «лидами» (список ниже на той же вкладке). Бот напишет им не все разом, а по капле: по одному, с паузами и дневным лимитом. Например, 100 номеров при лимите 20 в день разойдутся примерно за 5 дней.

⚠️ Старые базы номеров = выше риск бана. Свежие заявки безопаснее.

Способ 2. Telegram-ловец заявок (автоматически)

Если заявки с рекламы падают в Telegram-группу (таргетолог / форма / CRM), можно поставить отдельного бота в этот чат: он сам распознает заявки, вытянет номер и превратит их в лидов. Ручные списки не понадобятся.

Настройка (только владелец):

1. В @BotFather создайте нового бота, скопируйте токен. Там же /setprivacy → Disable (иначе бот не видит сообщения группы).
2. Добавьте бота в вашу группу с заявками.
3. Узнайте ID чата (например, через @getidsbot), обычно начинается с -100.
4. Впишите токен и ID чата в кабинете, «Подключить ловец».

🔧 Как это работает: сначала бот бесплатно ищет телефон в тексте (regex). Если телефона нет, сообщение игнорируется без затрат. Если телефон есть, дешёвый ИИ-классификатор решает, заявка это или болтовня, и вытягивает имя/услугу. Только этот шаг тратит токены (лимит по умолчанию 200 распознаваний в сутки, нужен положительный баланс). Телефон всегда берётся из реального сообщения, ИИ его не выдумывает.

Способ 3. API (для разработчика)

Заявки с формы сайта можно слать прямо в очередь. Нужен API-ключ проекта (создаётся в настройках проекта).

POST https://dosai.pro/api/projects/<id>/outreach/intake
Authorization: Bearer dos_sk_live_...
Content-Type: application/json

{"phone":"+77051234567","name":"Айгерим","fields":{"услуга":"SMM"}}

Шаг 3. Запуск

Есть два режима (вкладка «Безопасность», блок «Режим запуска»):

• Полу-ручной (по умолчанию): бот берёт номера в очередь только после вашей команды. Запустить можно тремя способами, все на виду: кнопка «Запустить сейчас» сразу после загрузки, оранжевая строка «N номеров готовы к запуску» вверху «Рассылки» или кнопка «Начать» у конкретного лида.
• Авто: бот сам берёт новые номера в работу в ближайшие минуты, кнопку жать не надо.

После запуска следите за пультом (он сам объяснит, что происходит), плитками «пульса», списком лидов и воронкой во вкладке «Статистика».

Безопасность и лимиты

Всё настраивается на вкладке «Безопасность»: настройки собраны в три блока. Значения по умолчанию подобраны консервативно.

Блок «Режим запуска»: полу-ручной (оператор сам жмёт «Начать», полный контроль) или авто (система сама берёт новых лидов в работу в рамках всех лимитов).

Блок «Сколько и как часто» (главные ручки анти-бана):

Блок «Автозащита» (работает сама):

Плюс защиты, которые работают всегда, без настройки:

• Пауза после подключения канала, 15 минут. Сразу после подключения WhatsApp бот не пишет ещё 15 минут (это самое опасное окно для свежего соединения).
• Проверка номера в WhatsApp. Перед отправкой бот проверяет, есть ли номер в WhatsApp. Нет → пропускает (отправка на несуществующий номер = сигнал бана).
• Не пишет в существующий диалог. Если с номером уже есть переписка, бот не влезает (это уже не холодный контакт).
• Не пишет на ваш собственный номер (тот, что подключён как канал).
• Стоп-лист. Номер, добавленный в стоп-лист, бот больше никогда не тронет.
• Не доставляется. Если первое сообщение или дожим 3 дня висит на одной галочке и человек не ответил, WhatsApp, скорее всего, нас заблокировал. Бот перестаёт писать такому человеку, заявка закрывается, а номер попадает в стоп-лист. При загрузке нового списка такие номера пропускаются сами. Увидеть их и вернуть можно кнопкой «Вернуть» в списке «Не доставляется» на вкладке «Безопасность».

🚨 Функция остановки диалога. Чтобы бот умел остановиться по просьбе клиента («не пишите мне»), в проекте должна быть включена встроенная функция остановки. На вкладке «Безопасность» видно, включена она (✓) или нет (✗).

Стоп всё. В любой момент кнопкой «Стоп всё» (красная, на пульте сверху) можно мгновенно поставить всю кампанию на паузу. Причина паузы будет написана на пульте, рядом появится кнопка «Снять паузу».

Как читать статусы лидов

Список лидов живёт внизу вкладки «Рассылка» и показывает, что с каждым номером. Есть поиск (телефон в любом формате или имя) и фильтр по статусу. Статусы отображаются цветными пилюлями (оранжевая = в работе, зелёная = успех, красная = ошибка); наведите на статус, всплывёт подсказка. Быстрый путь: клик по плитке «пульса» сразу открывает список с фильтром по этому статусу.

📌 Фильтр «Ответил» показывает не таблицу, а витрину ответов: кто ответил, что именно написал (первая реплика) и кнопка «Открыть диалог». Это главный экран результата: сюда стоит заглядывать каждое утро.

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

Во вкладке «Статистика»:

• Воронка исходящих: Отправлено → Прочитано → Ответили, с процентами от отправленных. Сразу видно, где теряются люди: не доходит текст или доходит, но не цепляет.
• Чипы «Пропущено / Ошибки / Устарело» под воронкой кликабельны: открывают список лидов с этим фильтром.
• Оценка очереди: «В очереди N лидов, при лимите X в день это примерно Y дней».
• Доставка первого сообщения: дошло ли до телефона (✓✓), прочитал ли лид, среднее и медианное время до прочтения, последние прочтения поимённо. Цифры обновляются сами, пока вкладка открыта.

Как проверить, что всё работает

Прежде чем запускать на реальной базе, прогоните тест на своём втором номере. Для этого в мастере (шаг «Проверка и запуск») есть блок «Сначала проверьте на себе»: введите номер, нажмите «Отправить тест», и статус теста будет виден тут же вживую.

Три условия честного теста:

1. Канал подключён и «на связи» (иначе тест не уйдёт, пульт это прямо скажет).
2. Свежий номер. Не тот, что подключён как канал («Пропущен: это ваш номер»), и без прошлой переписки с этим ботом («Пропущен: уже есть диалог»).
3. Терпение 5-20 минут. Бот-рассыльщик просыпается раз в 5 минут, а первые 15 минут после подключения канала действует защитная пауза. Если сейчас что-то мешает (пауза, нерабочие часы, исчерпанный лимит), блок теста напишет это прямо под статусом, это не поломка.

✅ Сообщение пришло на телефон, а ответ с него перевёл статус в «Ответил» → связка работает от начала до конца, можно запускать базу.

❌ Тишина → посмотрите на пульт (он называет причину) и на статус тестового номера: «Пропущен» (и почему), «Ошибка» или «В очереди» (ещё не прошёл паузы/лимиты).

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

Обычно бот отвечает тем, кто написал вам сам. Исходящие переворачивают это: бот сам пишет первым людям из вашей базы заявок, как будто менеджер обзванивает лиды, только в WhatsApp и автоматически.

Вы делаете три вещи, и мастер сам ведёт по ним: пишете, что сказать (готовый текст, бот его не сочиняет), даёте список, кому написать, и жмёте «Запустить». Дальше бот пишет по одному, с паузами, чтобы номер не забанили, а пульт сверху показывает, что происходит, и объясняет любую задержку.

Главное помнить: это рискованно для номера (WhatsApp не любит, когда пишут незнакомцам), поэтому не ставьте на свой главный номер и начинайте с маленькой свежей базы. И не ждите, что бот напишет мгновенно после подключения: первые 15-20 минут он специально молчит, это защита (пульт так и напишет).

🔧 Под капотом (для разработчика)

• Отправка идёт только через self-hosted WhatsApp-канал (QRDOS). На других провайдерах проект молча пропускается.
• Рассыльщик, отдельный cron-тик (раз в 5 минут). За один тик, не больше 2 сообщений на проект и не больше 6 суммарно, с паузами.
• Первое сообщение собирается без ИИ: случайный вариант из типа заявки + подстановка {{имя}}/{{услуга}}. Ноль токенов. Поэтому рассылка по списку бесплатна.
• Холодный диалог не считается «диалогом» в аналитике, пока лид не ответит (чтобы не портить конверсию). Как ответит, засчитывается один раз.
• Telegram-ловец, единственное место, где в Исходящих участвует ИИ (классификатор «заявка / не заявка»), поэтому у него отдельный дневной лимит распознаваний и нужен баланс.

Не получилось?

• Бот молчит: если сообщения не уходят.
• Канал недоступен: если WhatsApp-канал отвалился.
• Посмотрите на пульт сверху страницы: он словами называет, почему бот молчит прямо сейчас. Статус конкретного лида в списке «Рассылки» уточнит причину по номеру.

Документация › Инструменты бота › Подтверждение и напоминания о записи

Подтверждение и напоминания о записи

Клиент записался, и платформа сама пишет ему «вы записаны», а перед визитом напоминает. Неважно, где появилась запись: бот записал в календарь, записал через вашу функцию или администратор записал клиента у вас в CRM.

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

За 30 секунд:

• Где: Автоматизации → Записи. Одни настройки на весь проект.
• Записи бота приходят сами: в Google Календарь, бронь в iiko, урок в АльфаCRM, запись через свою функцию. Записи из вашей системы (CRM, сайт, сервис записи) приходят через API.
• Подтверждение уходит сразу после записи. Напоминаний до пяти: «за 1 день», «за 2 часа» и так далее, у каждого свой текст.
• Ночью не пишем: с 9:00 до 21:00 по часам проекта.
• Первыми пишем только тем, кто уже писал на ваш номер WhatsApp. Остальным можно написать со своего телефона одной кнопкой.
• Бесплатно: тексты шаблонные, ИИ не тратится.
• Страница записи: клиент сам выбирает услугу и время, вносит предоплату в Kaspi, запись встаёт в ваш календарь после оплаты.

Как включить

1. Откройте проект → Автоматизации → Записи.
2. Включите тумблер «Подтверждать и напоминать о записи».
3. Проверьте текст подтверждения и сроки напоминаний. По умолчанию одно напоминание «за 1 день».
4. Посмотрите блок «Так увидит клиент»: там готовые сообщения на примере записи «завтра в 15:00».
5. Нажмите «Сохранить».

В текстах можно использовать подстановки:

Если имени или услуги нет, лишних запятых в тексте не останется: «Здравствуйте, {{client_name}}!» превратится в «Здравствуйте!».

Откуда берутся записи

Перенос записи двигает напоминания за собой, отмена снимает их. Запись остаётся в списке с пометкой «Отменена».

Своя страница записи

Страница, где клиент записывается сам, без переписки: выбирает услугу, день и время, вносит предоплату в Kaspi, и запись встаёт в ваш Google Календарь. Ссылку можно поставить в шапку Instagram или отправлять клиентам вместо стороннего сервиса записи.

1. Откройте Автоматизации → Записи, блок «Страница записи».
2. Придумайте адрес: латиница, цифры и дефис, например massage-room. Ссылка будет dosai.pro/b/massage-room.
3. Укажите Google Календарь для записей. Если бот уже проверяет время по календарю, он подставится сам. Календарь должен быть открыт для сервисного адреса DOS AI, как и для бота.
4. Добавьте услуги: название, длительность в минутах и цену.
5. Задайте часы приёма и рабочие дни. Если конец приёма это время последней записи, а сессия может идти дольше («последняя запись в 24:00»), включите переключатель под часами.
6. Перерыв после сессии: столько минут страница оставит свободными после каждой записи.
7. Записать не раньше чем через: например 120 минут, чтобы никто не записался на через десять минут.
8. Предоплата: сумма, которую клиент вносит, чтобы запись подтвердилась. 0 значит без предоплаты.
9. Включите тумблер и нажмите «Сохранить».

Как это работает для клиента:

В календарь запись попадает только после оплаты. Пока счёт висит, время уже никто другой не займёт: двойную бронь платформа не пропускает.

Если оплата пришла, а время в календаре за эти минуты заняли вручную, вам придёт сообщение «Запись не встала в календарь», а клиент увидит, что вы с ним свяжетесь. Предоплата при этом у вас.

Для предоплаты нужна подключённая касса Kaspi (Интеграции → Приём оплат). Пока кассы нет, страница показывает свободное время и предлагает написать вам в WhatsApp. С каждой оплаты с баланса проекта списывается обычный сбор кассы.

Когда подтверждение не уходит

Подтверждение нужно, когда клиент ещё ничего от вас не слышал. Поэтому:

• записи самого бота не подтверждаем: бот уже написал «записал вас» в этом же чате;
• не шлём, если в чате только что был разговор (последние 30 минут): клиент прямо сейчас переписывается и о записи знает;
• ваша система может выключить подтверждение сама, если отправляет его своими силами.

Напоминания уходят во всех трёх случаях.

Кому мы не пишем и почему

Сообщение о записи платформа отправляет первой, без свежего сообщения от клиента. WhatsApp блокирует номера, которые пишут незнакомцам. Поэтому:

• пишем только тем, кто уже писал на ваш номер WhatsApp (в переписке с ботом или в вашем телефоне). Это проверяется в момент отправки: если клиент написал вам между записью и напоминанием, напоминание уйдёт;
• незнакомому номеру не пишем никогда. Запись видна в списке с причиной «клиент ни разу не писал на ваш номер WhatsApp» и кнопкой «Написать со своего телефона»: она откроет WhatsApp на вашем телефоне с готовым текстом, отправите вы сами;
• Instagram не участвует: там можно отвечать только в течение 24 часов после сообщения клиента, напоминание за сутки туда не пролезет;
• Telegram участвует: чат с ботом существует, только если клиент написал сам.

Ночью не пишем

Сообщения уходят с 9:00 до 21:00 по часовому поясу проекта (он задаётся на вкладке Общие настройки → Основное).

• Напоминание, которое выпало на ночь, уходит накануне в 20:30. Визит в 9:30 с напоминанием «за 2 часа» получит его вечером в 20:30.
• Подтверждение записи, созданной ночью, уходит в 9:00 утра. Если визит раньше 10:00, подтверждение не уйдёт: клиента утром встретит напоминание.

Список записей

Под настройками список: Предстоящие · Прошедшие · Отменённые, поиск по имени, телефону и услуге. У каждой записи видно, откуда она пришла, и судьба каждого сообщения:

Частые вопросы

Сколько стоит? Бесплатно. Тексты шаблонные, ИИ их не пишет, баланс не тратится.

Что если подписка закончилась? Сообщения перестают уходить и помечаются «подписка проекта закончилась».

А если WhatsApp ещё не подключён? Сообщения не уходят и сразу помечаются «WhatsApp проекта не подключён». Записи при этом сохраняются: подключите канал, и будущие напоминания пойдут как обычно.

А если клиент ответит на напоминание? Ответит боту в тот же чат, как обычно. Бот видит напоминание в переписке и понимает, о чём речь.

Я выключил тумблер, что с уже запланированными? Снимаются сразу, с причиной «подтверждение и напоминания выключены».

В тест-чате работает? Нет, в тест-чате записи не создаются и сообщения не уходят.

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

Раньше напоминать клиентам умела только запись, которую бот сделал в Google Календарь. Теперь неважно, кто записал клиента: бот, ваша функция или администратор в вашей CRM. Платформа пишет клиенту «вы записаны» и напоминает перед визитом, днём, и только тем, кто уже вам писал, чтобы номер не заблокировали. Всё, что ушло или не ушло, видно в одном списке с причинами.

Дальше: → Теги и сегментация
Связано: Запись на время · Дожимы · Публичный API
Не получилось? → напишите в поддержку

Документация › Работа с клиентами › Диалоги

Диалоги: лента, перехват, «AI на паузе»

«Диалоги» это центр, где ты видишь все переписки бота с клиентами в реальном времени и можешь в любой момент вмешаться, взять разговор на себя, поставив ИИ на паузу.

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

За 30 секунд:

• Раздел «Диалоги» (проект → chats): лента всех переписок, обновляется сама, без F5.
• У каждого диалога в шапке, переключатель «Отвечает бот»: если на нём красным написано «Бот молчит», в этом чате бот выключен.
• Начал писать клиенту вручную → ИИ автоматически встаёт на паузу (настраивается). Это перехват.
• Если пишешь, а ИИ ещё включён, увидишь подсказку «ИИ всё ещё отвечает, выключите „AI" в шапке», чтобы не отвечать вдвоём.
• Каналы WhatsApp, Telegram и Instagram видны вместе, помечены значком.

Что это и зачем

Бот общается с клиентами сам, но иногда нужно вмешаться: сложный вопрос, дорогой клиент, жалоба. Раздел «Диалоги» (route /projects/<id>/chats) показывает все переписки списком и панель открытого чата рядом. Всё обновляется в реальном времени: новые сообщения и статусы прилетают сами.

Слева, список диалогов с фильтрами, справа, переписка с клиентом и поле ввода. Сверху чата: управление ИИ и статусом.

Перехват: взять разговор на себя

Главная механика раздела. Есть два способа поставить ИИ на паузу в конкретном диалоге:

1. Просто начни писать клиенту вручную. Когда оператор отправляет сообщение из диалога, платформа (если включена настройка pause_on_operator) автоматически:

• ставит ai_on = false в этом диалоге,
• помечает причину operator_joined_chat,
• запоминает время паузы.

То есть бот замолкает, разговор ведёшь ты. Это самый естественный перехват, «вошёл и говоришь».

Отдельно про случай, когда вы начали писать в ту же секунду, что и бот. Ответ бота идёт до клиента не мгновенно: он ждёт паузу буфера, потом думает, потом длинный ответ уходит несколькими сообщениями с человеческими паузами между ними. Если вы вступили в разговор посреди этого, платформа обрывает недосланные сообщения бота, а в переписке остаётся ровно то, что клиент действительно увидел. Одно-два сообщения, уже ушедшие в WhatsApp до вашего, отменить нельзя: они у клиента на телефоне.

2. Переключатель в шапке. Переключатель «Отвечает бот»: нажал, и бот выключен или включён вручную в этом диалоге. Красная надпись «Бот молчит» = выключен.

💡 Тонкие настройки перехвата живут на вкладке Промпт → Расширенные настройки → Контроль оператора:

• pause_on_operator: ставить ли ИИ на паузу, когда оператор пишет (можно отключить, если хочешь писать «вместе» с ботом);
• ignore_first_operator_message, не паузить на первом сообщении оператора (удобно, если первое: это пометка/приветствие);
• exception_phrases: фразы-исключения, после которых пауза не ставится;
• там же: пауза после состоявшегося звонка, автовозобновление и три функции про остановки (по просьбе клиента бот замолкает, откладывает или отключает дожимы).

Защита от «двойного ответа»

Если ты в режиме оператора начал печатать, а ИИ в этом диалоге ещё включён, платформа показывает предупреждение:

«ИИ всё ещё отвечает, выключите „AI" в шапке, чтобы вести диалог самому»

Это чтобы вы с ботом не ответили клиенту одновременно. Увидел подсказку: выключи бота переключателем в шапке.

Вернуть бота

Закончил разговор: снова нажми переключатель в шапке диалога, на нём появится «Отвечает бот». Бот продолжит вести клиента дальше. По умолчанию пауза снимается только вручную: платформа не включит ИИ за тебя, чтобы не влезть в твой живой разговор.

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

Если бот замолчал сам (упёрся в потолок ответов на диалог или сработала защита от спама), та же настройка через тот же срок просто включит его обратно, и он ответит, когда клиент напишет. Первым он не пишет и тут.

Паузы по просьбе клиента, после звонка и после передачи заявки автовозобновление не снимает: там бот молчит намеренно.

Ответ с цитатой

Ответ бота привязан к сообщению клиента, как «Ответить» в WhatsApp: над первым пузырём ответа видно, на что именно бот отвечает. Так и клиенту, и тебе в ленте понятно, к какому вопросу относится ответ, особенно когда человек прислал несколько сообщений подряд.

• Одно сообщение: цитируется оно.
• Пачка сообщений: цитируется последнее из пачки (бот отвечает на всю пачку разом, а привязать ответ WhatsApp умеет к одному сообщению).
• Голосовое, фото или файл: цитируется само голосовое, фото или файл, мессенджер сам рисует превью.
• Цитата только на первом пузыре, остальные части ответа идут без неё.

В Telegram работает так же. В ленте «Диалогов» привязка видна той же цитатой, что у ответов оператора. Выключается в настройках бота: Расширенные настройки → Разделение сообщений → «Отвечать с цитатой сообщения клиента».

Отправить позже

Клиент написал в час ночи, ответ у вас готов, но будить его сообщением незачем. Нажмите на часы рядом с полем ввода, выберите время, и сообщение уйдёт само.

Есть три быстрые кнопки (через час, завтра в 9:00, в понедельник в 9:00) и обычный выбор даты со временем, если нужен другой момент. Всё, что стоит в очереди по этому диалогу, видно там же, любое можно отменить, пока оно не ушло.

Запланированное сообщение отправляется ровно так же, как обычное: тем же каналом, с той же паузой бота, и в переписке выглядит обычным сообщением оператора. Точность до пяти минут: платформа проверяет очередь каждые пять минут, поэтому «в 9:00» означает промежуток с 9:00 до 9:05.

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

Статусы и фильтры

У диалога есть статус: открыт (open), решён (resolved), закрыт (closed). В списке можно фильтровать:

• по статусу (все / открытые / решённые / закрытые),
• по каналу (все / WhatsApp / Telegram / Instagram),
• по состоянию ИИ, можно отметить сразу несколько: on (бот ведёт), off (выключен вручную), paused (на паузе), operator (перехватил оператор), done (диалог доведён до конца), pre_existing (переписка была до подключения бота),
• по тегам,
• только непрочитанные (onlyUnread),
• архив (showArchived),
• отложенные: чаты, которые вы сами отложили на потом (кнопка «Отложить чат»), со счётчиком,
• «Ждут ответа»: диалоги, где бот намеренно промолчал и ответить должен человек. Так бывает со старой перепиской после переподключения канала, со знакомым контактом и с клиентом, пришедшим не с рекламы. Рядом с фильтром стоит счётчик: видно, сколько таких накопилось.

Плюс сортировка (свежие / старые / самые длинные переписки) и сохранённые виды: набрал нужную комбинацию фильтров, сохранил её под именем и возвращаешься одним кликом.

💡 «Ждут ответа» стоит открыть прямо сейчас, если бот работает не первый день. Раньше такие чаты были помечены значком, но собрать их в одном месте было нельзя, и они копились незамеченными: это самая частая причина «клиент писал, а ему никто не ответил».

Массовые действия, например, удалить пачку диалогов, доступны через выбор нескольких чатов.

⚠️ Часть массовых действий (например, закрыть пачкой) требует роли администратор, как и одиночное действие того же типа. См. Роли и права.

Реалтайм без F5

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

Звуковые уведомления

Когда вкладка с диалогами свёрнута или неактивна, платформа подаёт тихий звуковой сигнал:

• двойной сигнал: написал новый клиент (появился новый диалог),
• короткий сигнал: новое входящее сообщение в существующем диалоге.

Ответы бота и оператора звук не издают, сигналит только реальный клиент. Между сигналами всегда пауза в несколько секунд, поэтому активная переписка не превращается в пулемёт.

Настройки живут в списке диалогов: Фильтры → «Звуковые уведомления». Можно выключить звук целиком, оставить только «новый диалог» или только «новое сообщение», а также включить звук даже при открытой вкладке. Настройки сохраняются отдельно для каждого проекта в этом браузере: шумный бот с трафиком можно приглушить, не трогая остальные.

Звонки видны в переписке

Звонок в WhatsApp это не сообщение, и сам по себе он в переписке не остался бы. Платформа ставит на него отдельную отметку прямо в ленте чата, между сообщениями, чтобы разговор не выпадал из истории:

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

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

Отдельная настройка «Отвечать на непринятые звонки» (включена у всех проектов) решает другое: писать ли клиенту, до которого не дозвонились. Если клиент позвонил и трубку никто не взял, через полторы минуты ему уходит одно сообщение: «Здравствуйте! Сейчас не можем принять ваш звонок. Напишите, пожалуйста, сюда, мы ответим». Если вы взяли трубку или в чате уже кто-то написал, сообщение не уходит. Клиенту, который перезванивает несколько раз подряд, оно приходит один раз за 2 часа. Это готовый текст: ИИ его не пишет, баланс он не тратит, в переписке он подписан «Ответ на звонок». Отметки о звонках от этой настройки не зависят, они появляются всегда.

Каналы в одной ленте

WhatsApp, Telegram и Instagram показываются вместе; канал виден по значку. У Instagram свои сроки ответа: из кабинета ответить можно 24 часа после сообщения клиента, и боту, и оператору, подробно. Диалог, начатый ответом на комментарий, до первого сообщения человека помечен «Ждём сообщения». Подробнее: Обзор каналов.

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

«Диалоги» это твоя диспетчерская. Здесь видно всё, что бот пишет клиентам, прямо вживую: ничего не надо обновлять. Если видишь, что в каком-то чате нужно вмешаться, просто начни писать клиенту сам, и бот тут же замолкает: дальше говоришь ты. Это и есть «перехват».

В шапке каждого чата есть кнопка «AI», зелёная значит бот отвечает, красная, он на паузе и ждёт тебя. Закончил разговор: включи бота обратно той же кнопкой, и он продолжит. Платформа специально не включает его сама, чтобы не влезть в твою беседу.

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

Дальше: → Лиды и их статусы
Связано: Стадии диалога · Логи событий · Роли и права · Бот не отвечает
Не получилось? → Бот не отвечает, диагностика

Документация › Работа с клиентами › Лиды

Лиды и их статусы

Заявки, которые бот собрал из переписок: кто, как связаться, насколько «горячий». Твоя воронка продаж.

⏱ 8 мин · 👤 для владельца и оператора · 🟢 live

За 30 секунд:

• Лид = потенциальный клиент с данными (имя, телефон) и статусом.
• Бот сам создаёт лида, когда клиент квалифицировался и оставил контакт, или когда сработала функция с галочкой «Это заявка».
• 7 статусов, от «Без статуса»/«Потенциальный» до «Сделка закрыта»/«Потерян».
• Можно фильтровать, искать, экспортировать в CSV, заводить лида вручную.
• Статус можно менять руками; «Сделка закрыта» и «Потерян»: финальные.

Зачем это нужно

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

Где это

Левое меню → «Лиды». Смотреть может viewer, менять, editor+.

Что такое лид

У каждого лида есть:

Статусы лида

💡 Как ставится. В основном бот сам по ходу разговора (если включена воронка продаж). Лид автоматически создаётся, когда статус становится «Квалифицированный», «Горячий» или «Резерв». Имя и телефон для этого не обязательны: если бот их уже узнал, они попадут в карточку. Ты можешь поменять статус вручную в любой момент.

📌 Пример. Клиент уточнил цены, согласился записаться, оставил телефон → бот ставит «Квалифицированный» → появляется лид. Дошёл до оплаты → «Горячий». Оплатил → ты ставишь «Сделка закрыта».

Кто создаёт лида: статус, телефон или функция «Это заявка»

Это место, где обычно путаются. Разложим по полочкам.

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

В каждом ответе бот (если включена воронка) выставляет скрытое поле, статус лида. Ты его не видишь, видит платформа. Как только бот ставит создающий статус («Квалифицированный» / «Горячий» / «Резерв»), платформа автоматически заводит карточку лида. Имя и телефон подставляются, если бот их уже узнал (по промпту он сначала их спрашивает).

То есть:

• Квалификация это момент, когда бот сам решил «это заявка» и поставил создающий статус. Это его суждение по правилам из системного промпта, а не кнопка и не функция. Откуда берётся: бот читает разговор и определения статусов из промпта, и каждый ход выбирает подходящий.
• Лид: карточка, которая появляется в результате этого статуса.

Если воронка выключена

Воронку продаж можно отключить: тогда бот не раскладывает разговор по статусам, а просто консультирует и продаёт. Раньше в этом режиме карточки лидов не появлялись вовсе, и человек, оставивший телефон, оставался только в переписке. Теперь по-другому:

Воронка выключена: карточку заводит телефон. Как только клиент назвал номер в разговоре, платформа сама создаёт лида и присылает уведомление в колокольчик. Ни статуса, ни функции для этого не нужно.

Номер самого чата в WhatsApp сигналом не считается, иначе лидом становился бы каждый написавший. Нужен именно номер, прозвучавший в переписке. Статус у такой карточки ставится «Квалифицированный», дальше меняй его руками как обычно.

Функция и создание лида

Функции (например «Уведомление в Telegram», «Запись на время», «Приём оплаты»): это действия, и сами по себе лида не создают:

• функция «Уведомление владельцу» шлёт тебе сообщение в Telegram «лови заявку», но карточку лида создаёт статус, а не она;
• можно квалифицировать клиента без единой функции: лид всё равно появится в разделе «Лиды».

Исключение одно: галочка «Это заявка: создать лида и сделку в CRM» в разделе «После вызова» у функции. Ставь её у функции, которая передаёт заявку человеку (менеджеру, администратору). Сработала такая функция, и карточка лида появляется, даже если бот оценил клиента осторожнее («Потенциальный»): статус карточки поднимается до создающего. Без галочки бывало, что заявка уже лежит в Telegram-группе менеджеров, а в «Лидах» и CRM клиента нет.

Часто статус и функция срабатывают в одном ходе (бот квалифицировал клиента и отправил тебе уведомление): отсюда и путаница. Без галочки это две независимые вещи: статус пишет карточку в CRM, функция делает действие во внешнем мире.

Нужны ли функции для аналитики?. Нет

Диалоги, лиды, конверсия, источники: аналитика считается сама, из статусов лида и факта «бот ответил». Чтобы видеть правильные цифры, не нужно настраивать ни одной функции. Функции добавляют только когда боту нужно реальное действие: уведомить, записать на время, принять оплату.

Свои статусы под твой бизнес

Сейчас платформа работает со стандартными 7 статусами лида: они покрывают путь от «Потенциальный» до «Сделка закрыта»/«Потерян» (см. справочник статусов). Возможность задать собственные статусы (кастомная воронка) временно недоступна: редактор убран из настроек, вернём в упрощённом виде. Нужны свои этапы под бизнес, напиши в поддержку: это ускорит возврат фичи, а пока логику этапов можно описать словами в системном промпте и уточнять картину тегами.

Два продукта (или направления)

Два пути:

• Один проект + теги: бот вешает на лида тег «Продукт А» / «Продукт Б», статусы общие. В аналитике увидишь разбивку по тегам. Подходит, если процесс продажи похож.
• Отдельные проекты, если у продуктов разные скрипты, каналы и логика квалификации, заведи отдельный проект на каждый (свой бот, своя воронка). Чище и не путается.

Что можно делать

• Фильтр по статусу и поиск по имени/телефону/email;
• Фильтр по источнику: каналу (WhatsApp, Telegram, Instagram) и для рекламных/кампанийных лидов по конкретному объявлению / площадке (Facebook/Instagram) / кампании / UTM, чтобы одним кликом собрать всех лидов с этого источника. Разрез появляется, когда такие лиды есть;
• Колонка «Источник» в таблице показывает не только канал, но и название объявления / кампанию / площадку: видно сразу, откуда лид, без захода в карточку;
• Колонка «Сумма» и сортировка по сумме (↓/↑) это крупные сделки наверх;
• Диапазон дат;
• Экспорт CSV (Имя, Телефон, Email, Статус, Теги, Дата): учитывает активные фильтры; для обзвона или своей таблицы;
• Завести лида вручную (кнопка создания): если клиент пришёл не через бота;
• Карточка лида (клик): полные данные, смена статуса, сумма сделки (₸/$, попадает в аналитику как выручка по объявлению/источнику, учитывает офлайн-продажи), заметки оператора, кнопки «позвонить/написать», резюме диалога и источник вплоть до объявления (превью, заголовок, площадка, ссылка, UTM) для рекламных лидов;
• Массовые действия (editor+): сменить статус, удалить, экспортировать выбранных.

Связь с дожимами

Лиды, которые «зависли» (квалифицировались, но не дошли до оплаты), кандидаты на дожимы: бот напомнит о себе сам. Настраивается авто-зачисление по статусу.

Частые ошибки

Вопросы, которые обычно возникают

Чем лид отличается от диалога?
Диалог это вся переписка. Лид: «карточка клиента» с контактом и статусом, выжимка из диалога. Не каждый диалог становится лидом.

Бот сам ставит статусы или я?
В основном бот (если включена воронка). Но ты всегда можешь переопределить вручную.

Можно выгрузить базу клиентов?
Да, «Экспорт CSV».

Под капотом

• Статусы (lead_status): none / potential / qualified / hot / converted / reserve / lost. converted и lost это терминальные.
• Авто-создание лида (post-send.ts): при включённой воронке переход в qualified/hot/reserve (или в статус проекта с creates_lead); при выключенной, телефон из ответа модели (phone или full_data.phone), номер самого чата не считается; плюс успешный вызов функции с builtin_config.creates_lead. Один лид на диалог.
• Статус ставит модель в JSON-ответе (поле lead_status) при включённой воронке; ручная смена: editor+.
• Колонки таблицы: Имя, Телефон, Статус, Дата (email/резюме/заметки, в карточке). Экспорт CSV, фильтры, диапазон дат, массовые действия.
• Карточка лида: /projects/[id]/leads/[leadId], источник (канал, utm), резюме ИИ, заметки (до 5000 символов, автосейв).

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

Лиды это список твоих потенциальных клиентов, который бот собирает сам. Пока человек просто болтает это ещё не лид. Но как только он проявил интерес и оставил телефон, бот заводит на него «карточку» и помечает, насколько он близок к покупке: просто интересуется, готов записаться или уже горячий. Ты видишь весь список, можешь кому-то перезвонить, поменять статус руками, выгрузить в табличку. Когда клиент оплатил, ставишь «Сделка закрыта», и это видно в аналитике. Это и есть твоя воронка продаж, только заполняется она сама.

Дальше: → Биллинг
Связано: Диалоги · Дожимы · Аналитика

Документация › Работа с клиентами › Стадии диалога

Стадии диалога (воронка)

Каждый диалог проходит воронку из 6 стадий, от «Приветствия» до «Завершено». Бот сам двигает клиента по ним, а ты видишь, на каком этапе кто застрял.

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

За 30 секунд:

• Воронка: Приветствие → Квалификация → Презентация → Возражения → Закрытие → Завершено.
• Бот сам определяет стадию по ходу разговора: это не ручная пометка.
• Стадия хранится у диалога; новый диалог стартует с «Приветствие».
• Дошёл до «Завершено»: бот не замолкает сам, он продолжает отвечать, пока его не остановит функция «Остановить диалог» или оператор.

Шесть стадий

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

Как стадия меняется

Стадию определяет сам бот по смыслу разговора: это часть его «мышления» (см. Как бот думает). Не нужно вручную перетаскивать клиента по этапам: модель оценивает, на каком шаге диалог, и обновляет стадию.

• Стадия хранится у диалога (поле stage).
• Новый диалог начинается со стадии «Приветствие» (greeting).
• Стадию может перевести и правило с действием «перевести стадию», например «клиент оплатил → Закрытие».
• Стадия «Завершено» это пометка для аналитики, а не выключатель: бот продолжает отвечать. Раньше он мог сам замолчать на этой стадии (в старых диалогах ещё встречается причина паузы «Воронка завершена»), это убрали: модель закрывала разговор преждевременно. Остановить диалог теперь может только явная функция или оператор (см. JSON-ответ бота).

💡 Хочешь, чтобы бот точнее переключал стадии под твой бизнес, опиши логику в системном промпте, когда считать клиента «квалифицированным», что такое «закрытие» в твоём случае.

Стадии и внешняя CRM

Если подключена внешняя CRM (Bitrix24/amoCRM), внутренние стадии можно сопоставить со стадиями сделки в твоей CRM: тогда при смене стадии у диалога сделка автоматически двигается по воронке в CRM (через сопоставление стадий, см. CRM). Стадия, переведённая правилом, двигает сделку так же. Сделка едет только вперёд: продвинутую менеджером дальше бот назад не тянет, а закрывает сделку только менеджер.

📌 Платформа использует стандартный набор из 6 стадий и 7 статусов лида: он работает «из коробки» и покрывает большинство сценариев продаж. Возможность полностью заменить набор своим (кастомная воронка) временно недоступна: редактор убран из настроек, вернём в упрощённом виде. Если твоему бизнесу нужны свои стадии, напиши в поддержку, это ускорит возврат фичи.

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

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

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

Дальше: → Аналитика
Связано: Диалоги · Лиды · Системный промпт · CRM
Не получилось? → Бот не отвечает

Документация › Работа с клиентами › Аналитика

Аналитика

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

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

За 30 секунд:

• Период: сегодня, 7, 30, 90 дней, за всё время или свои даты. По умолчанию 7 дней. Дни считаются по поясу проекта.
• Конверсия = лиды ÷ диалоги за выбранный период. Стрелки рядом с цифрами сравнивают с прошлым таким же периодом.
• Диалог это переписка, где бот реально ответил. Лид это карточка в разделе «Лиды».
• Кнопка «Скачать»: отчёт за месяц в PDF, все лиды и сводка за период в CSV. Детализация расхода по дням скачивается в Excel.

Что считается

• Диалог это переписка, где бот ответил хотя бы раз. Старые чаты, подтянувшиеся при подключении номера, и переписки, которые с начала вёл человек, в счёт не идут.
• Лид это карточка в «Лидах»: бот создаёт её сам, когда доводит клиента до статуса «Квалифицированный», «Горячий» или «Резерв» (при выключенной воронке, когда клиент назвал телефон, и когда сработала функция с галочкой «Это заявка»). Функции для подсчёта настраивать не нужно. Цифра «Лиды» на любой странице платформы значит одно и то же.
• Конверсия это доля диалогов, ставших лидами, за выбранный период. Нет диалогов, и вместо 0% стоит прочерк.