Документация Promolytica
Все разделы

Заявки

Чаты на сайте

переписка с посетителями

Бот в Telegram

Кнопка чата на сайте ведёт в вашего бота, а он отвечает по знаниям сайта.

  1. Откройте в Telegram диалог с @BotFather и отправьте /newbot.
  2. Он спросит название бота («How are we going to call it?») - это подпись в шапке чата, её видят посетители. Можно по-русски, например «Монитор Ком».
  3. Дальше он попросит адрес («Choose a username») - латиницей и обязательно с окончанием bot, например monikom_sale_bot. Если адрес занят, он скажет «Sorry, this username is already taken» - придумайте другой.
  4. В ответ придёт «Done! Congratulations on your new bot» и строка вида 1234567890:AAH... после слов «Use this token to access the HTTP API» - это и есть токен.
  5. Скопируйте эту строку целиком и вставьте в поле здесь. Больше ничего настраивать не нужно.
  • Токен - это ключ от бота: кто им владеет, тот и отвечает от его имени. Не пересылайте его в общих чатах. Потеряли - откройте @BotFather, отправьте /token и выберите бота; старый токен можно отозвать командой /revoke.

Если не сработало: Бот в Telegram

  • Бот подключён, но на сообщения не отвечает. Чаще всего вставлен токен другого бота или бот уже подключён к другому сервису: Telegram отдаёт сообщения только одному получателю. Отправьте @BotFather команду /revoke, выберите бота, скопируйте новый токен и вставьте его здесь - старое подключение отвалится само.
  • Токен не принимается. Скопируйте строку целиком, вместе с цифрами до двоеточия: токен выглядит как 1234567890:AAH... Лишние пробелы и перенос строки платформа уберёт сама, а вот половина строки не подойдёт.
  • Хочу поменять имя, описание или картинку бота. Это делается там же, у @BotFather: /setname - название, /setdescription - текст на пустом экране до первого сообщения, /setuserpic - аватар. Токен при этом остаётся прежним, заново подключать ничего не нужно.
  • Кнопка на сайте не появилась. Кнопка появляется после сохранения канала; если её нет, проверьте, что канал включён. Адрес бота платформа берёт из токена сама - вписывать его отдельно нужно только для варианта «Кнопка-ссылка».

Кнопка на сайте ведёт в Telegram

Кнопка чата открывает ваш бот или ваш личный аккаунт в Telegram - без токена и без ответов по знаниям сайта.

  1. Адрес бота - это его username из @BotFather со знаком @, например @monikom_sale_bot.
  2. Адрес личного аккаунта - в Telegram: «Настройки» → «Имя пользователя». Если его нет, задайте.
  3. Впишите адрес здесь. Ссылку вида t.me/... платформа соберёт сама.
  • Это не бот платформы: по знаниям сайта такая кнопка не отвечает и заявки не собирает. Нужны ответы - подключайте бота токеном.

Бот в MAX

Кнопка чата на сайте ведёт в вашего бота в MAX, а он отвечает по знаниям сайта.

  1. Бот в MAX заводится не в мессенджере, а на платформе MAX для партнёров, и только у организации, ИП или самозанятого: профиль сначала проходит верификацию через Госуслуги или банковский сервис. Физлицам и нерезидентам площадка бота не выдаёт.
  2. В левом меню откройте «Чат-боты» и нажмите «Создать». Организация и ИП могут завести 5 ботов, самозанятый - 2.
  3. Заполните карточку: логотип 500х500 px, название до 59 знаков и описание до 200. Никнейм платформа подставит сама по шаблону idИНН_bot (у самозанятых se<номер профиля>_bot), выбрать его нельзя. Нажмите «Создать».
  4. Бот уйдёт на проверку площадки: в карточке появится статус «На модерации». Она занимает до 48 часов по рабочим дням, о результате напишет бот «MAX для бизнеса» вам в личные сообщения. До её конца токена не существует, и это нормально.
  5. Когда статус сменится на «Опубликован», вернитесь в «Чат-боты», нажмите значок ⋮ на карточке бота и выберите «Настройки».
  6. В блоке «Чат-бот» найдите поле «Токен доступа» и нажмите справа от него значок копирования. Само значение показано скрытым, целиком оно попадёт в буфер обмена.
  7. Вставьте токен здесь и нажмите «Подключить бота». Дальше укажите адрес бота на вкладке «Кнопка-ссылка»: у MAX он из токена не выводится, и без него кнопка на сайте не появится.
  • Бот в MAX выдаётся не сразу: сначала площадка верифицирует профиль организации, потом проверяет самого бота - до 48 часов по рабочим дням. Сроки назначает MAX, мы на них не влияем. Токен - это ключ от бота: кто им владеет, тот и отвечает от вашего имени, не пересылайте его в общих чатах.

Если не сработало: Бот в MAX

  • Токена нет: поля «Токен доступа» не видно. Токен появляется только после модерации. Если в карточке бота стоит «На модерации» - ждите, проверка занимает до 48 часов по рабочим дням. Если стоит «Нужны исправления» - причина отказа написана там же, в настройках бота: поправьте данные и отправьте на проверку заново.
  • Не получается завести бота. Бота площадка выдаёт только верифицированному профилю организации, ИП или самозанятого. Верификацию через Госуслуги проходит руководитель или представитель с правом подписи, в роли сотрудника она не пройдёт; данные из ЕГРЮЛ и ЕГРИП на Госуслугах должны быть свежими. Физическим лицам и нерезидентам бот в MAX недоступен вовсе.
  • Бот подключён, но кнопки на сайте нет. У MAX адрес бота из токена не выводится, поэтому кнопку зажигает вкладка «Кнопка-ссылка»: впишите там адрес бота и сохраните. Адрес есть в профиле бота полем «Ссылка».
  • Бот подключён, но на сообщения не отвечает. Чаще всего токен обновили на платформе MAX: после нажатия значка обновления прежнее значение перестаёт работать. Скопируйте токен заново в «Настройках» бота и вставьте здесь. Вторая причина - тот же токен уже используется другим сервисом.
  • Хочу поменять название, описание или картинку бота. Только на платформе MAX для партнёров: в разделе «Чат-боты» откройте бота стрелкой и правьте раздел «Основная информация». После сохранения бот снова уходит на модерацию, и до её конца посетители видят прежний вариант. Никнейм не меняется вовсе. Токен при этом остаётся прежним, заново подключать ничего не нужно.

Кнопка на сайте ведёт в MAX

Кнопка чата открывает переписку с вашим ботом в MAX - без токена и без ответов по знаниям сайта.

  1. Адрес бота показан в его профиле в MAX полем «Ссылка», вида max.ru/idИНН_bot. Рядом с ним значки «поделиться» и QR-код.
  2. Тот же адрес виден на платформе MAX для партнёров: в разделе «Чат-боты» никнейм написан под названием бота.
  3. Впишите адрес здесь. Можно целой ссылкой из профиля, вместе со знаком @, можно одним никнеймом: платформа разберёт и приведёт к нужному виду сама.
  • Это не бот платформы: по знаниям сайта такая кнопка не отвечает и заявки не собирает. Нужны ответы - подключайте бота токеном на вкладке «Бот платформы».

Список чатов и карточка чата

Страница «Чаты» перечисляет ваших ботов: у каждого переключатель «Показан» / «Скрыт» (показывать ли кнопку на сайте) и «Удалить» с подтверждением. «Добавить чат» открывает мастер в форме диалога: название, описание бота словами, сценарий собирается сам, затем подключение Telegram (токен от @BotFather, можно пропустить).

Карточка чата на трёх вкладках. «Сценарий»: описание словами и кнопка «Собрать сценарий» (после первого раза «Изменить сценарий»), схема, которую можно дорисовать руками и сохранить, блок «У вас уже есть бот» для подключения готового. «Телеграм»: поле «Токен Telegram-бота», «Сохранить токен» и «Привязать вебхук»; после подключения строка «Бот подключён» с адресом бота. «Настройки»: название чата и переключатель «Показывать кнопку на сайте»; где и какого размера кнопка, настраивается в редакторе сайта.

Частые вопросы

  • Чем «Кнопка-ссылка» отличается от «Бота платформы»? Кнопка-ссылка открывает переписку с вашим ботом в мессенджере, разговор ведёте вы сами, платформа только ставит кнопку и передаёт боту адрес страницы. Бот платформы отвечает сам по знаниям сайта (если включён ассистент) или собирает имя и телефон по сценарию и передаёт заявку вам.
  • Нужно ли что-то публиковать после подключения? Нет: кнопка и бот подключаются настройками, сайт пересобирать не нужно. Размер и угол кнопки чата настраиваются в редакторе в разделе «Чаты».
  • Почему у MAX после подключения бота нет кнопки на сайте? У MAX адрес бота из токена не выводится: впишите адрес бота на вкладке «Кнопка-ссылка» руками.
  • Один бот может работать и на сайте, и в другом сервисе? Нет: мессенджер отдаёт сообщения только одному получателю. Второй сервис на том же токене забирает их себе, и бот на сайте молчит. Заведите второго бота или перевыпустите токен.
  • Что видит клиент, когда пишет боту платформы? При включённом ассистенте те же ответы, что в чате на сайте, с теми же ограничениями и тем же журналом «О чём спрашивают». Без ассистента бот здоровается, спрашивает имя и телефон и передаёт заявку вам.