Чат-боты

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

Создать своего бота в Толк.Чатах может любой пользователь пространства. После создания нужно настроить бота с помощью API в своей системе (подробнее см. документацию API).

Также бота можно интегрировать с Gitlab с помощью webhooks (подробнее см. в документации). В дальнейшем список доступных сервисов для интеграции будет расширяться.

Возможности бота

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

Набор команд для бота и интеграцию со сторонними сервисами настраивает его создатель. Другие пользователи могут использовать настроенные команды, но не могут вводить свои параметры для бота.

Бот пока не может:

• создавать новые чаты или каналы,
• управлять настройками и участниками чатов/каналов,
• добавлять новых пользователей в пространство и редактировать их данные,
• сообщать данные из Чатов в сторонние системы.

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

1. Нажмите на название пространства на левой панели и перейдите на вкладку «Чат-боты».

   

2. Нажмите на кнопку «Создать».
3. В открывшемся окне укажите информацию о боте:
   • Загрузите аватар.
   • Введите название бота, не менее трех символов. Поле обязательное.
   • Введите ID бота в формате  example_bot . Например «library_bot». Перед постфиксом «_bot» должно быть не менее трех символов.
     Поле обязательное, позже его нельзя будет изменить.

   • Заполните описание.

     

4. Нажмите «Создать».

5. В открывшемся окне скопируйте API-ключ и сохраните его. После обновления страницы ключ будет скрыт.

   

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

6. Настройте команды для бота с помощью API и/или интегрируйте бота со сторонними системами. Подробнее см. в инструкции.

Удалить бота из пространства или отредактировать его данные (название, описание и аватар) может только его создатель или администратор пространства.

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

Чтобы добавить бота в групповой чат или канал:

1. На панели слева выберите чат или канал, в который нужно добавить бота.

   

2. Нажмите на название чата/канала и на открывшейся панели нажмите «Пригласить».

   

3. В открывшемся окне введите название или ID бота. Приглашать можно сразу нескольких ботов.

   

4. Нажмите на бота, затем на кнопку «Пригласить». Бот добавлен.

5. Если бот добавлен в канал, обязательно предоставьте ему права администратора, чтобы он мог отправлять сообщения. Для этого:

   1. Нажмите на профиль бота.

      

   2. Установите курсор в поле «Уровень прав» и выберите роль «Администратор комнаты».

Чтобы удалить бота из группового чата или канала:

1. Откройте нужный чат/канал и нажмите на его название.

2. Нажмите на профиль бота в блоке «Участники».

   

3. Нажмите «Удалить».

Как написать боту

• В личных сообщениях
• В групповом чате или канале

В личных сообщениях

1. Найдите бота в пространстве. Для этого нажмите на поле поиска слева.

   

2. Выберите вкладку «Чат-боты» и по названию найдите бот. Нажмите на него.

   

3. Откроется чат. Обратиться к боту можно одним из способов:
   • просто отправить любое сообщение,

   • указать конкретную команду для бота в формате «/command@username_bot».

   • упомянуть бота в сообщении. Для этого нажмите на профиль бота и выберите «Упомянуть». Либо в строке ввода сообщения напишите символ @  и введите название бота.
4. Вид ответа от бота зависит от его настроек. В ответ бот может прислать список доступных команд, инструкцию по работе с ботом или результат выполнения конкретной команды (если она была указана).

В групповом чате или канале

1. Перейдите в чат или канал, куда добавлен бот.

2. Установите курсор в строке ввода и нажмите  /  (слеш) на клавиатуре. Затем введите команду вручную в формате «/command@username_bot».

   

   Список доступных команд можно узнать у создателя бота. Чтобы посмотреть, кто создатель, нажмите на профиль бота. Имя создателя будет указано в разделе «Создатель».