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

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

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

Бот-аккаунты​

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

Создание бот-аккаунта​

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

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

Настройка разрешений бот-аккаунта​

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

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

Настройка выполняется в Системной консоли > Управление пользователями > Пользователи, выбрав бот-аккаунт из списка.

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

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

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

  1. Перейдите в Главное меню > Интеграции > Входящие вебхуки.
  2. Нажмите Добавить входящий вебхук.
  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. Нажмите Добавить исходящий вебхук.
  3. Укажите канал и/или ключевые слова для срабатывания.
  4. Укажите URL обратного вызова (Callback URL) — адрес вашего сервиса.
  5. Нажмите Сохранить.

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

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

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

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

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

Плагины​

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

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

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

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

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

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

По умолчанию эти права доступны Системным Администраторам. При необходимости права могут быть расширены на Администраторов команд или всех участников.

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

Для отключения бот-аккаунта перейдите в Системную консоль > Управление пользователями > Пользователи, найдите бот-аккаунт и выберите Деактивировать.