Перейти к основному содержимому

Создание и настройка чат-ботов

Loop поддерживает создание чат-ботов для автоматизации задач, отправки уведомлений и интеграции с внешними сервисами. Существует несколько способов создания ботов в зависимости от задач и требований.

Учетные записи ботов​

Бот-аккаунты — это специальные учётные записи, управляемые через API, которые позволяют автоматизировать взаимодействие с пользователями в каналах.

Создание бота​

  1. Перейдите в Системную консоль > Интеграции > Учетные записи ботов.
  2. Убедитесь, что параметр Включить создание учетной записи бота установлен в значение Да.
  3. Перейдите в Главное меню > Интеграции > Учетные записи ботов.
  4. Нажмите Добавить учетную запись бота.
  5. Заполните поля:
    • Имя пользователя — уникальное имя бота
    • Значок бота — аватар (необязательно)
    • Отображаемое имя — имя, которое увидят пользователи
    • Описание — назначение бота
    • Роль и дополнительные права post:all / post:channels — если бот должен писать в каналы, где он не состоит
  6. Нажмите Создать аккаунт бота.

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

Права бота​

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

  • post:all — позволяет боту публиковать сообщения во всех каналах Loop, включая личные сообщения.
  • post:channels — позволяет боту публиковать сообщения во все публичные каналы.

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

Входящие вебхуки (Incoming Webhooks)​

Входящие вебхуки позволяют внешним сервисам отправлять сообщения в каналы Loop по HTTP-запросу. Это простейший способ создать бота для уведомлений.

Создание входящего вебхука​

  1. Перейдите в Главное меню > Интеграции > Входящие вебхуки.
  2. Нажмите Добавить входящий Webhook.
  3. Выберите канал, в который бот будет отправлять сообщения.
  4. Укажите Заголовок и описание вебхука.
  5. Нажмите Сохранить.

После создания вы получите URL вебхука. Для отправки сообщения выполните POST-запрос:

curl -X POST -H 'Content-Type: application/json' \
  -d '{"text": "Привет от бота!"}' \
  https://your-loop-url/hooks/xxx-generatedkey-xxx

Исходящие вебхуки (Outgoing Webhooks)​

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

Создание исходящего вебхука​

  1. Перейдите в Главное меню > Интеграции > Исходящие вебхуки.
  2. Нажмите Добавить исходящий Webhook.
  3. Укажите Канал и/или Ключевые слова для срабатывания.
  4. Укажите URL обратного вызова — адрес вашего сервиса.
  5. Нажмите Сохранить.

Пользовательские slash-команды​

Slash-команды позволяют пользователям вызывать бота, набрав /команда в поле ввода сообщения. При вызове Loop отправляет запрос на указанный URL, и бот возвращает ответ.

Создание slash-команды​

  1. Перейдите в Главное меню > Интеграции > Быстрые команды.
  2. Нажмите Добавить быструю команду.
  3. Заполните поля:
    • Ключевое слово — текст после /
    • URL запроса — адрес вашего сервиса
    • Метод запроса — GET или POST
  4. Нажмите Сохранить.

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

Плагины​

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

Управление плагинами осуществляется через Системную консоль > Плагины.

Администрирование ботов​

Управление доступом​

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

  • Управление входящими вебхуками — право на создание, редактирование и удаление входящих вебхуков.
  • Управление исходящими вебхуками — право на создание, редактирование и удаление исходящих вебхуков.
  • Управление быстрыми командами — право на создание, редактирование и удаление пользовательских slash-команд.

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

Отключение бота​

Откройте Главное меню > Интеграции > Учетные записи ботов и нажмите Отключить у нужного бота. Включить его снова — Включить.