Инструкция — Боты — Аквариум. Без воды

1. Доступ

Оформите доступ к модулю «Боты» (после оплаты или как владелец продукта).
Войдите в личный кабинет.
Откройте «Боты» → кабинет ботов.

2. Что подготовить до настройки

Аккаунт Telegram (личный или рабочий).
Доступ к сайту, куда нужно вставить код (для Заявщика) — правка HTML или через разработчика.
Список форм на сайте и их CSS-селекторы (например #form-order), если формы уже есть.

3. Token бота и chat id — куда вводить и где взять

Token бота Telegram

В Telegram откройте @BotFather.
Команда /newbot (или /mybots → ваш бот → API Token).
Скопируйте строку вида 123456789:AAH... целиком, без пробелов.
В кабинете ботов → «Настройка» → поле «Token бота Telegram» → «Сохранить token».

Бот отвечает от вашего имени. Сервисного бота Аквариума для диалогов с клиентами нет.

Chat id для заявок (куда слать лиды)

Напишите своему боту любое сообщение (например /start), чтобы появился диалог.
Узнайте свой числовой id: откройте @userinfobot или @getidsbot в Telegram — пришлют Id.
Вставьте число в поле «Chat id для заявок» → «Сохранить тексты».
Нажмите «Тест в ЛС» — в этот чат должно прийти тестовое сообщение.

В поле нужен личный chat id или id группы, куда добавлен бот. Id канала (@channel) сюда не подходит.

4. Квалификатор лидов

Диалог в Telegram: вопросы → баллы → «горячий» лид в chat id.

Вкладка «Мои боты» → в каталоге «Квалификатор лидов» → «Создать».
«Настроить».
Заполните: название, название бизнеса, приветствие.
Блок «Вопросы квалификатора» — правьте тексты и баллы при необходимости.
Порог «горячий» (score) — число; при достижении уходит сообщение менеджеру.
Token → «Сохранить token». Chat id → «Сохранить тексты».
«Тест в ЛС» → «Запустить».
Откройте ссылку бота t.me/... (появится после сохранения token) → напишите /start и пройдите вопросы.

5. Заявщик с сайта

Заявки с форм вашего сайта → сообщение в Telegram (и при желании таблица в кабинете).

«Мои боты» → «Заявщик с сайта» → «Создать» → «Настроить».
Название, название бизнеса, заголовок формы.
Блок «Сайт и формы»:
- Домен — ваш сайт без https:// (например shop.ru).
- URL страницы → «Найти формы» — или добавьте формы вручную: название (метка в Telegram) + CSS-селектор (#form-id).
Token и chat id — как в разделе 3 → «Сохранить» → «Тест в ЛС» → «Запустить».
Скопируйте блок «Код на сайт для приёма заявок с ваших форм».
Вставьте код на сайт перед закрывающим тегом </body> на страницах с этими формами.
Опубликуйте страницу, обновите её с очисткой кэша (Ctrl+F5), отправьте тестовую заявку.

Дополнительно в настройках может быть код для отдельной формы-виджета — если на странице нет своей формы, а нужна готовая «Оставить заявку».

6. Лиды и хранение данных

По умолчанию

Лид уходит в ваш Telegram (chat id).
Копия строки появляется во вкладке «Лиды» кабинета (на сервере Аквариума).

Режим без хранения лидов у Аквариума

В «Настройка» снимите галочку «Хранить лиды в кабинете Аквариума» и сохраните тексты. Тогда:

заявка / «горячий» лид уходит только в ваш Telegram;
таблица «Лиды» для этого бота не наполняется контактными данными.

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

8. Webhook лида и Макс

В «Настройка» можно указать HTTPS URL — на него уйдёт POST при каждой заявке (квалификатор, заявщик, эскалация справки). При сбое — до 3 попыток.

Формат тела

{
  "event": "bots.lead",
  "version": 1,
  "occurred_at": "2026-07-21T17:00:00.000Z",
  "instance_id": 12,
  "sku": "qualify",
  "bot_title": "Квалификатор",
  "lead": {
    "id": 45,
    "name": "Ирина",
    "contact": "+7999…",
    "score": 82,
    "source": "telegram_bot",
    "status": "hot",
    "answers": [ { "question_id": "need", "question": "…", "answer": "…", "score": 30 } ],
    "handoff_ok": true,
    "hot": true
  }
}

Заголовок X-Aquarium-Event: bots.lead. Ответьте HTTP 2xx.

Макс

В «Настройка» выберите Куда слать заявки → Макс.
Token: access_token бота из «MAX для бизнеса» (не BotFather).
Нужен ваш личный user_id в Макс — как chat id ЛС в Telegram. Id бота и id канала не подходят (заявки не в канал).
Напишите своему боту MAX любое сообщение с телефона → в кабинете «Узнать мой id» → «Сохранить» → «Тест доставки».

Заявка приходит в личный диалог с ботом в Макс, по тому же принципу, что и в Telegram.

CRM: Битрикс24 и amoCRM

В «Настройка» → CRM: выберите Битрикс24 или amoCRM. Заявка уйдёт в CRM параллельно с мессенджером (и опциональным webhook).

Битрикс24: Разработчикам → входящий webhook → права CRM → вставьте URL вида https://ваш.bitrix24.ru/rest/1/xxxxx/. Создаётся лид (crm.lead.add): имя, телефон/email, комментарий с ответами.
amoCRM: поддомен (company из company.amocrm.ru) + access token интеграции. Создаётся сделка с контактом; ответы — в заметке.

«Тест доставки» создаёт тестовый лид в CRM, если коннектор заполнен.

9. Чеклист «бот работает»

«Сохранить token» без ошибки.
«Тест доставки» — сообщение в Telegram и/или Макс; при webhook — 2xx на URL.
«Запустить» — статус active.
Квалификатор: диалог /start до конца; при высоком score — пинг менеджеру.
Заявщик: код на сайте; submit формы → сообщение с меткой формы.

Вопросы по доступу: help@aquarium-waterfree.ru.

Справка по продуктам

«Мои боты» → «Справка по продуктам» → «Создать» → «Настроить».
Приветствие и блок «База Q&A»: по умолчанию подставлены вопросы и ответы с FAQ страниц продуктов сайта. Можно править, добавлять ключевые слова (через запятую).
Token и chat id (как в разделе 3) → «Сохранить» → «Тест в ЛС» → «Запустить».
В Telegram боту: /start, затем вопрос из базы — должен прийти ответ.
Вопрос вне базы — вам в Telegram уйдёт эскалация с текстом вопроса.

Если тот же token уже используется квалификатором, активным в опросе останется один бот (последний обновлённый). Для параллельной работы удобнее отдельный бот в BotFather.