Обзор
Что такое бот
Бот в Пачке — это посредник между вашим сервисом и мессенджером, действующий от своего имени. Он может отправлять и получать сообщения, реагировать на команды пользователей, открывать интерактивные формы и использовать другие методы, предоставляемые API.
Сообщение от бота в Пачке
Бот имеет доступ не ко всем методам API. Например, добавление участников в пространство и экспорт сообщений доступны только с персональным токеном. Подробнее о токенах в разделе Авторизация.
Бот позволяет работать с вебхуками, кнопками и формами в Пачке. Подробнее в разделах Входящие вебхуки, Исходящие вебхуки, Кнопки в сообщениях, Формы и Разворачивание ссылок.
Типы ботов
Тип выбирается при создании и не меняется. Подробнее о создании — в разделе Создание и настройка.
- Для одного чата — подойдёт для отправки уведомлений из других сервисов. В одном чате можно собрать всех получателей и обсуждать уведомления в тредах.
- Для нескольких чатов — подойдёт, если вы хотите создать личное взаимодействие бота с каждым участником вашей компании или разными группами участников.
- Unfurl бот (только администраторам) — подойдёт для получения событий об отправке ссылок во всех чатах вашего пространства и возможности создавать их предпросмотр.
Ограничение «для одного чата» распространяется только на каналы и беседы — бот по-прежнему может участвовать в тредах и личных сообщениях. Бот любого типа может быть настроен как публичный.
Доступность бота
Бот взаимодействует с пространством как участник с ролью «Сотрудник»: видит открытые каналы, а в закрытые каналы, треды и личные сообщения его нужно подключать отдельно. Дополнительно бота можно сделать публичным — тогда любой участник пространства сможет начать с ним диалог и упоминать через @никнейм.
Бот получает исходящие вебхуки только из тех чатов и тредов, в которых он состоит. Глобальные события (например, изменение участников пространства) приходят без добавления в чат.
Подробнее — в разделе Доступы к чатам и сообщениям.
Подмена имени и аватара отправителя
Сообщение от бота с подменой имени и аватара
Метод POSTНовое сообщение поддерживает поля display_name и display_avatar_url, позволяющие указать произвольное имя и аватар отправителя для конкретного сообщения. Бейдж Бот при этом сохраняется, а при открытии профиля отправителя пользователь увидит оригинальное имя и аватар бота.
Это полезно для миграции сообщений из другого сервиса: бот отправляет сообщения от своего имени, но каждое сообщение отображается с именем и аватаром реального автора из исходной системы.
Поля display_name и display_avatar_url доступны только при использовании токена бота. Метод PUTРедактирование сообщения также поддерживает эти поля.