Код для сайта

Вставьте перед закрывающим тегом </body> на всех страницах.

Скопировать Скачать файл Проверить установку

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

Домены сайта

Внешний вид чата

Меняйте цвета — превью справа обновляется сразу. На сайт попадёт после «Сохранить».

Контакты в чате

Бот копирует их дословно, поэтому опечатка = письмо в пустоту.

Реквизиты оператора данных

Это вы как оператор персональных данных. Реквизиты подставляются в текст согласия — по п.3 ч.4 ст.9 152-ФЗ документ обязан называть, кто именно обрабатывает данные. Без них согласие ничтожно, и память о посетителях не включится.

Куда направлять отзыв согласия — берётся из поля «Почта» выше.

Операторы: Telegram, MAX, ВКонтакте

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

1. В Telegram напишите @BotFather → /newbot → скопируйте токен.
2. Там же: Bot Settings → Group Privacy → Turn off — без этого бот не увидит ответы оператора в группе.
3. Создайте группу для заявок, включите в её настройках Темы, добавьте бота и сделайте его администратором.
4. Впишите токен и id группы ниже, нажмите «Проверить».

1. На платформе MAX: Чат-боты → Перейти → Расширенные настройки — создайте бота и скопируйте токен.
2. Создайте чат для заявок и добавьте туда бота. Сам бот создать чат не может — это ограничение MAX, а не наше.
3. Впишите токен и id чата ниже, нажмите «Проверить».
4. Веток на посетителя в MAX нет, поэтому каждое сообщение помечено тегом вида #abcd1234. Отвечайте Reply на сообщение посетителя, а если ответить через Reply нельзя — начните ответ с этого тега.

1. В сообществе: Управление → Работа с API → создайте ключ доступа с правом Сообщения.
2. Там же Long Poll API → «Включено», в «Типах событий» отметьте Входящее сообщение. Без этого ответы оператора не вернутся посетителю.
3. Беседа: добавьте сообщество в беседу и впишите её адрес (2000000000 + номер беседы). Личка: впишите id оператора — но он сам должен сначала написать сообществу, иначе ВКонтакте запретит писать ему первым.
4. Веток на посетителя во ВКонтакте нет: отвечайте Reply, запасной способ — начать ответ с тега #abcd1234.

⚠️ У бота в @BotFather выключите Group Privacy (Bot Settings → Group Privacy → Turn off), иначе он не увидит ответы оператора в группе.

Сигнал о брошенном контакте

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

Маршрутизация заявок

Кому из операторов уходит диалог. Без правил заявка идёт всем — так работает сейчас. Правило только сужает этот список: если ни одно не подошло, заявку по-прежнему получат все, а не никто.

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

Проверка агента

Спросите так, как спросит посетитель. Отвечает тот же код, что на сайте — с вашими правилами, знаниями и моделью. Диалог никуда не пишется и оператору в Telegram не уходит.

Диалоги и заявки

За выбранный период. «Позвали человека без ответа» — главный сигнал: посетитель просил оператора, а оператор не ответил.

Память о посетителях

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

Кто приходил

Товары и обмен с 1С

Бот собирает корзину прямо в чате, а ваша 1С забирает её и создаёт документ. Каждая позиция должна быть привязана к номенклатуре — иначе документ создастся с дырами, и мы его не поставим в очередь вовсе.

Ключ для базы 1С

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

Позиции сайта

Очередь документов

Инбокс оператора

Отвечайте посетителям прямо здесь — ответ уйдёт в чат на сайте и продублируется в вашу группу Telegram. После вашего ответа бот по этому диалогу молчит.

Инструкция

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

1. Список сайтов

Первый экран после входа. Один кабинет ведёт несколько сайтов: у каждого свой агент, свои знания, свой оператор и своя переписка.

Новый сайт — заводит агента. Нужны название и адрес; остальное настраивается на вкладках ниже.

Статус «в работе» / «черновик» — черновик не отвечает посетителям. Пока агент в черновике, код на сайте будет молчать.

2. Настройки

Кто такой ваш помощник и что он знает. Правила общения задают манеру, знания — факты, которыми он отвечает.

Имя помощника — как он представляется посетителю.

Правила общения — характер и границы: о чём говорить, о чём нет, когда звать оператора.

Факты: услуги, цены, контакты — короткая справка о компании. Она уходит в каждый ответ, поэтому объём ограничен.

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

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

Часы работы коллег и Только будни — когда бот предлагает позвать оператора. Вне этих часов он честно скажет, что коллеги offline, и предложит оставить контакты.

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

Перенести в другой кабинет — увозит сайт со всеми настройками, знаниями, каналами и перепиской. Действие необратимо и рвёт доступ прежним операторам: они перестанут видеть эту переписку.

Пустые «Правила общения» и «Факты» — бот отвечает общими словами и не знает ни ваших услуг, ни цен.

3. Установка на сайт

Одна строка кода, которую нужно вставить на сайт перед закрывающим тегом </body> — на всех страницах, где нужен чат.

Скопировать — берёт строку в буфер обмена.

Скачать файл — та же строка файлом, чтобы переслать верстальщику.

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

Домены сайта — адреса, где чату разрешено работать. Защита от переноса вашего кода на посторонний сайт.

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

4. Внешний вид

Как чат выглядит на сайте и что умеет посетитель.

Цвет шапки чата и Цвет кнопки, когда чат свёрнут — подгоняются под ваш бренд. Цвет текста считается сам, чтобы надпись осталась читаемой; если контраст выходит слабым, кабинет предупредит.

Сбросить — возвращает цвета к вашему основному.

Картинка в круге — что нарисовано внутри круга чата: и на свёрнутой кнопке в углу сайта, и в шапке открытого окна. Готовых наборов два: цветные занимают круг целиком, белые силуэты ложатся на ваш цвет кнопки — вид остаётся таким же, как сейчас, меняется только форма. Либо загрузите свою — PNG, JPEG, WEBP или SVG до 2 МБ; мы уменьшим её до 256 точек и перезапишем заново, поэтому лишние данные из файла (например, координаты съёмки) на сайт не попадут. Тарифы «Проф» и «Корпоративный».

Форма свёрнутой кнопки — круг (как было), скруглённый квадрат или квадрат. Меняется только кнопка в углу сайта: кружок в шапке чата остаётся круглым. Тарифы «Проф» и «Корпоративный».

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

Показывать кнопку вложения — скрепка: посетитель сможет прислать фото или документ.

Голосовой помощник — кружок микрофона: посетитель говорит, а не печатает. Тариф «Проф».

Вместо значка — микрофон занимает место аватара в шапке, чтобы не было двух кружков.

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

Чем озвучивать ответы и Диктор — наш голос или голос браузера посетителя. Прослушать даёт образец выбранного диктора.

Разделы для голосового перехода — что человек говорит и куда его вести, по строке на раздел («услуги = /uslugi/»). Кнопка Заполнить обходит сайт и предлагает список; вычитайте его и сохраните.

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

5. Контакты

Две разные вещи: что бот говорит посетителю и кто по закону отвечает за его персональные данные.

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

Ссылка на политику обработки данных — стоит под галочкой согласия в форме контактов. Ведёт на вашу страницу политики.

Организация или ФИО предпринимателя, ИНН, Адрес — реквизиты оператора персональных данных. Оператор — вы: данные собираются на вашем сайте и в ваших интересах, мы лишь обрабатываем их по вашему поручению. Из этих реквизитов складывается текст согласия.

Реквизиты не заполнены — текст согласия неполон по 152-ФЗ, и память о посетителях включить нельзя.

6. Оператор

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

Токен бота — вашего бота вы заводите сами у @BotFather в Telegram. Токен виден только вам, мы показываем лишь факт, что он задан.

ID группы — группа, куда падают диалоги. У супергруппы идентификатор начинается со -100: без минуса Telegram ответит «чат не найден».

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

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

Сигнал о брошенном контакте — человек начал вводить телефон и ушёл: оператору придёт уведомление. Номер уходит только если посетитель дал согласие.

Добавить оператора — второй и последующие операторы, тариф «КОРП». Заявка приходит каждому.

У бота включён Group Privacy — он не увидит ответы операторов в группе. Выключается у @BotFather, после чего бота нужно добавить в группу заново.

7. Проверка

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

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

Диалог из проверки не попадает в переписку и не будит оператора.

8. Диалоги

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

Обновить — пересчитывает за выбранный период.

Позвали человека, а оператор не ответил — главный рабочий сигнал: посетитель просил живого человека и не дождался.

Клик по диалогу открывает переписку целиком.

9. Посетители

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

Помнить посетителей — включает память. Имя используется сразу, остальное — только после согласия человека.

Срок хранения — сколько дней помним. По истечении записи удаляются.

Текст согласия — кабинет складывает его из ваших реквизитов по 152-ФЗ. Скопировать переносит текст, чтобы разместить у себя.

Только вернувшиеся — фильтр списка.

Без заполненных реквизитов на вкладке «Контакты» согласие неполно, а память не включится.

10. Товары и 1С

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

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

Что создавать в 1С — «Заказ клиента» или «Счёт на оплату». В счёте 1С не хранит перечень позиций: если нужны строки товаров, выбирайте заказ.

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

Только несопоставленные — показывает позиции, которые 1С не сможет опознать. Такая строка блокирует документ: лучше пустой список, чем заказ с дырой. Рядом со списком всегда стоит счёт «всего N · без привязки M», а кнопка Показать все позиции снимает фильтр: пустой экран при включённом фильтре значит «непривязанных нет», а не «каталог пуст».

Как посетитель кладёт товар в корзину — словами в чате. Бот добавляет позицию, только когда его явно попросили: «добавьте сервер в корзину», «беру два таких». Вопрос о цене («сколько стоит сервер») заказом не считается — иначе корзина набивалась бы от простого интереса.

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

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

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

Очередь документов — что уже ушло в 1С и что ждёт. Обновить перечитывает состояние.

Инициатива всегда на стороне 1С: она сама опрашивает нас. Пока в 1С не установлено расширение и не задан ключ, очередь просто копится.

11. Инбокс оператора

Ответы посетителям прямо из кабинета, без Telegram.

Обновить список — подтягивает свежие диалоги. Список обновляется и сам, пока вкладка открыта.

Только ждут ответа — оставляет тех, кому ещё не ответили.

Ответ отсюда виден посетителю и дублируется в Telegram, чтобы коллега не написал второй раз. Набранный текст не пропадает при обновлении.

12. Оплата

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

Где начать — строка тарифа над списком сайтов, кнопка Оплатить.

Реквизиты плательщика — заполняются один раз, из них печатается счёт. Пока они пусты, кнопка «Выставить счёт» не появится: счёт без плательщика бухгалтерия вернёт.

ИНН: 10 цифр у организации — тогда нужен и КПП; 12 у ИП — КПП оставьте пустым. Мы проверяем контрольную цифру, поэтому опечатка отклоняется сразу, а не всплывает у вашего бухгалтера.

Тариф для счёта — выбираете, за что платите. Тариф кабинета от этого выбора не меняется: права переключатся, когда оплата будет отмечена. Так выбор КОРП в счёте не открывает КОРП до денег.

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

Расчёт показывает, из чего сложилась сумма. Считает сервер, браузер арифметику не повторяет — поэтому в PDF попадает ровно та же сумма, что вы видите на экране.

Выставить счёт — создаёт счёт и PDF для банка. Номер сквозной по году: у вашей бухгалтерии не будет дыр в нумерации.

Выставленные счета — список со статусом и ссылкой на PDF. Статус меняется на «оплачен» после того, как мы увидим деньги на расчётном счету; тогда же продлевается подписка и переключается тариф.

Оплата счёта означает принятие условий договора-оферты — п. 3 ст. 438 ГК РФ. Бумажный договор подписывать не нужно.