Обзор

Что такое бот

Бот в Пачке — сервисный участник пространства, на котором строятся интеграции. У него есть имя, аватар и никнейм, он состоит в чатах, пишет сообщения и получает события, но действует от своего имени, а не от имени кого-то из сотрудников. Через ботов работают уведомления из внешних сервисов, чат-боты с командами, кнопки и формы, превью ссылок и автоматизации, которые действуют от имени сотрудника.

Бот и сотрудник

Бот взаимодействует с пространством как участник с ролью «Сотрудник»: видит открытые каналы вместе с их тредами. В закрытые каналы и беседы его добавляют участником, а в отдельный тред — и без родительского чата. Где бот бывает, кто может его добавить и написать ему — в разделе Доступы к чатам и сообщениям. Как бот отвечает в личных сообщениях, беседах и тредах и откликается на упоминание по нику — в разделе Общение с ботом.

Своими правами бот ограничен: он не видит чужие личные переписки и не может действовать как конкретный сотрудник. Когда автоматизации нужны права самого сотрудника, например чтобы собрать сводку по его чатам, завести задачу от его имени или связать его аккаунт в другом сервисе с Пачкой, сотрудник авторизует бота: один раз соглашается на экране согласия, и дальше бот работает от его имени. Подробнее — в разделе Авторизация от имени сотрудника.

С чего начать

Выберите строку по задаче, которую решает интеграция:

AI-агент в Пачке — тоже бот: его зовут по нику в треде, и он отвечает туда же. Что нужно именно агенту — в разделе AI-агенты. Боты с открытым кодом, на которых можно посмотреть устройство целиком, — в разделе Готовые примеры.

Где бот находится в интерфейсе

Боты пространства собраны в разделе Интеграции > Боты на двух вкладках:

• Обзор — витрина: публичные боты и опубликованные боты с авторизацией. Её видят сотрудники, администраторы и мульти-гости.
• Управление — боты, которых вы можете редактировать. Вкладка и кнопка Создать бота в шапке раздела есть у тех, кому разрешено создавать интеграции.

На вкладке Управление собраны боты, которых вы можете редактировать: созданные вами и те, чьи настройки открывают вам доступ. Для каждого видны создатель, число сотрудников, авторизовавших бота, дата создания и когда бот последний раз обращался к API или к нему приходил входящий вебхук. Нажатие на строку открывает карточку бота, а в меню бота есть ещё его профиль и удаление.

У каждого бота есть карточка с пятью вкладками, по одной на возможность:

Бот создаётся только с названием и ником, а каждую возможность включают на своей вкладке, когда она понадобится. Подробнее — в разделе Создание бота.

Подмена имени и аватара отправителя

Метод POSTНовое сообщение поддерживает поля display_name и display_avatar_url, позволяющие указать произвольное имя и аватар отправителя для конкретного сообщения. Бейдж Бот при этом сохраняется, а при открытии профиля отправителя сотрудник увидит оригинальное имя и аватар бота.

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