Чат-боты

• Инструкция по созданию telegram-бота
• Создание виджета для сторонних сайтов
• Инструкция по созданию бота в мессенджере MAX

Инструкция по созданию telegram-бота

🔧 Шаг 1: Создание бота в Telegram через BotFather

1. Откройте Telegram и найдите официального бота @BotFather (с синей галочкой).
2. Нажмите «Start» или введите команду /start, чтобы начать диалог.
3. Отправьте команду /newbot.
4. Следуйте инструкциям:
   • Введите имя бота — это отображаемое имя, которое увидят пользователи.
   • Укажите уникальный username, который должен заканчиваться на bot (например, MyCompanySupportBot).
5. После успешного создания BotFather предоставит вам API-токен — длинную строку символов, например:
   
   

   123456789:ABCdefGhIJKlmNoPQRstuVWXyz123456789

Скопируйте и сохраните этот токен — он понадобится для интеграции.

---

⚙️ Шаг 2: Подключение бота к нашей платформе

1. Перейдите в раздел «Чат-боты» 

   

   
   

2. Нажмите на кнопку «Добавить чат-бота»

3. Введите название и описание для бота, чтобы вам было легче найти позже вашего бота в списке.
4. Убедитесь, что выбран тип бота «Телеграм» и нажмите «Далее»
5. Введите API-токен бота, полученный через @BotFather

6.  

   Выберите сценарий и стартовый блок, по которому будет проходить ваш бот при инициировании нового общения с ним.
7. Укажите максимальное время диалога — Когда заданное время истекает, диалог автоматически завершается и попадает в аналитику. Новые сообщения будут обрабатываться в рамках нового диалога. Для пользователя чата эта настройка ни на что не влияет.​
8. Протестируйте подключение — проверьте, возможно ли подключиться к telegram с заданными настройками. А затем добавьте чат-бота, кликнув на соответствующую кнопку.

После этого ваш Telegram-бот будет успешно интегрирован с нашей платформой, и вы сможете использовать его в сценариях взаимодействия с пользователями.​

---

🔒 Важные рекомендации по безопасности

• Не передавайте API-токен третьим лицам. Если токен станет известен посторонним, они смогут управлять вашим ботом.

• При подозрении на компрометацию токена, немедленно сгенерируйте новый токен через BotFather с помощью команды /token.

Создание виджета для сторонних сайтов

Раздел «Чат-боты» позволяет создавать и размещать ботов на сторонних сайтах или в мессенджерах.
Для работы на сайте используется тип бота «Виджет». Он встраивается в HTML-код страницы и взаимодействует с посетителями через всплывающее окно чата.

---

1. Как открыть раздел

1. Перейдите в левое меню платформы.

2. Откройте раздел «Чат-боты».

3. Нажмите кнопку «Добавить чат-бота» в правом верхнем углу.

Откроется модальное окно создания бота.

---

2. Шаг 1. Основные параметры

Заполните поля:

• Название — будет отображаться в списке чат-ботов.

• Описание — кратко опишите назначение бота, например: «Консультирует по услугам центра».

• Тип бота — выберите «Виджет» из выпадающего списка.

По умолчанию выбран тип Telegram. Для создания Telegram-бота см. отдельную инструкцию.

Нажмите «Далее», чтобы перейти к настройкам.

---

3. Шаг 2. Настройки бота

На этом шаге задаются параметры работы бота.

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

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

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

После заполнения нажмите «Добавить чат-бота и сгенерировать код».

---

4. Получение и размещение кода

После сохранения система автоматически сгенерирует HTML-код для вставки виджета на сайт.

Как вставить код:

1. Скопируйте код, нажав «Копировать код».

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

3. Сохраните изменения на сайте.

---

5. Проверка работы и взаимодействие с пользователем

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

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

---

6. Редактирование и удаление чат-бота

• Чтобы изменить настройки, нажмите иконку шестерёнки ⚙️ в списке чат-ботов.
  Откроется модальное окно настроек.
  

  

• Здесь можно:

  • изменить название, описание, сценарий или имя бота;

  • сгенерировать новый код вставки;

  • удалить бота с помощью кнопки «Удалить чат-бота».

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

---

7. Список чат-ботов

В списке отображаются все созданные чат-боты проекта.
Для каждого указываются:

• Название и тип (Telegram или Виджет);

• Статус подключения;

• Сценарий, с которым связан бот.

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

---

8. Пример использования

Виджет-бот можно разместить:

• на главной странице сайта компании — для консультаций посетителей;

• на странице обратной связи — для записи на приём или оформления заявки;

• в интернет-магазине — для помощи при выборе товара.

Инструкция по созданию бота в мессенджере MAX

Шаг 1: Получение API-токена для MAX-бота

API-токен можно получить в личном кабинете профиля организации на сайте MAX для бизнеса. Подробная инструкция по получению API-токена на официальном сайте.

---

Шаг 2: Подключение бота к нашей платформе

1. Перейдите в раздел «Чат-боты» 

   

   
   

2. Нажмите на кнопку «Добавить чат-бота»

3. Введите название и описание для бота, чтобы вам было легче найти позже вашего бота в списке.

   

4. В выпадающем списке в поле «Тип бота» выберите «MAX», затем нажмите на кнопку «Далее».
   

   

   
   
5. Введите API-токен бота, полученный с помощью профиля организации на сайте MAX для бизнеса.

   

   
   

   
   

6. Выберите сценарий и стартовый блок, по которому будет проходить ваш бот при инициировании нового общения с ним.
7. Укажите максимальное время диалога — Когда заданное время истекает, диалог автоматически завершается и попадает в аналитику. Новые сообщения будут обрабатываться в рамках нового диалога. Для пользователя чата эта настройка ни на что не влияет.​
8. Добавьте чат-бота, кликнув на соответствующую кнопку.

После этого ваш MAX-бот будет успешно интегрирован с нашей платформой, и вы сможете использовать его в сценариях взаимодействия с пользователями.​