Coroid имеет платформенных ботов для Slack, Discord, Telegram и SMS. Настройте их в этом разделе: Настройки → Подключения → Каналы.
Что делает каждый из них сегодня:
| Платформа | Сообщения преобразуются в запросы | Получает обновления |
|---|---|---|
| Slack | Да, через автоматизацию событий | Обновления Задач — через входящий вебхук |
| Telegram | Да, через автоматизацию событий | Нет |
| Discord | Нет | Нет |
| SMS | Нет | Нет |
Вы можете сохранить бота для Discord или SMS, но сейчас они не используются. На той же странице также есть канальные мосты, которые пока не работают. См. Мосты каналов.
Платформенные боты
Бот — это идентификатор, который Coroid использует на платформе. Установите его один раз на рабочее пространство или сервер и предоставьте ему доступ к каналам, которые он должен читать. Для Slack и Telegram необходим бот, чтобы автоматизация событий могла считывать сообщения.
Если бот Slack удалён из канала, Coroid перестаёт читать этот канал, и об этом нигде не сообщается. Если сообщения Slack перестали превращаться в запросы, проверьте, находится ли бот в канале.
Только владельцы и администраторы могут добавлять, изменять или удалять бота. Каждая платформа отправляет свои события на URL вебхука шлюза API, который Coroid указывает для каждого бота. Coroid отклоняет доставку, если она не подписана секретом бота.
Начало работы из канала
Сообщение в Slack или Telegram может стать запросом на выполнение работы. Сообщения в Discord и SMS — нет.
Сообщение превращается в запрос через автоматизацию событий. Это полезно для запросов типа «кто-нибудь, пожалуйста, исправьте…», которые иначе никогда не попадали бы в учёт работ.
Соответствующее сообщение поступает в модуль Qualification как запрос. Модуль Qualification проверяет его, ищет дубликаты и определяет, во что его превратить. Ничего не создаётся, пока запрос не пройдёт проверку. См. Способы начала работы.
Coroid не привязывает аккаунты Slack или Telegram к аккаунтам Coroid, поэтому любой человек, способный публиковать сообщения в соответствующем чате, может создать запрос. По этой причине работа из чата никогда не начинается сама по себе. Создаётся отфильтрованная Задача, которая ждёт, пока кто-то её запустит, а план ждёт утверждения.
Slack
- Настройте бота Slack в этом разделе: Платформенные боты. Для этого потребуется токен бота и секрет подписи приложения Slack.
- В вашем приложении Slack отправляйте сообщения в каналах и упоминания приложения на URL вебхука,
который указывает Coroid:
https://api.coroid.ai/api/v1/webhooks/slack/events. - Пригласите бота в каждый канал, из которого он должен считывать данные.
- Включите интеграцию с Slack в Quality Control → Настройки организации → Этап «Перед началом работы» → Источники задач. Включить такой источник могут только владельцы и администраторы, при условии подключения бота.
Включение интеграции с Slack добавляет автоматизацию, которая преобразует соответствующие сообщения в задачи. Она перечислена в Factory → Автоматизации, где можно изменить её фильтр. Отключение интеграции с Slack приостанавливает автоматизацию, но сохраняет её фильтр.
Фильтр автоматизации определяет, какие сообщения учитываются. Сначала он ищет
сообщения, содержащие это упоминание: @coroid. Фильтр также может ограничивать
автоматизацию одним каналом или сообщениями от ботов, например, уведомлениями.
Coroid обрабатывает не более 10 запросов от Slack в минуту для одного канала.
Telegram
- Добавьте бота Telegram в этом разделе: Платформенные боты. Coroid регистрирует свой вебхук в Telegram и защищает его секретом вебхука. Если поле секрета оставить пустым, Coroid сгенерирует его сам.
- Добавьте бота в группу или назначьте его администратором канала.
- Включите интеграцию с Telegram в Quality Control → Настройки организации → Этап «Перед началом работы» → Источники задач. Соответствующая автоматизация перечислена в Factory → Автоматизации, где можно изменить её фильтр.
- В чате начинайте каждую задачу с этой команды:
/coroid.
Режим конфиденциальности Telegram по умолчанию позволяет боту видеть команды, но не обычные сообщения. Фильтр также может ограничивать автоматизацию одним чатом по его ID. Бот игнорирует личные сообщения, если это не разрешено фильтром.
Любой пользователь может добавить вашего бота в другую группу и создавать там задачи. Чтобы предотвратить это, ограничьте автоматизацию вашим чатом или запретите боту присоединяться к группам с помощью этой команды BotFather: /setjoingroups.
Coroid принимает не более 10 соответствующих сообщений в минуту из одного чата. Если автоматизация привязана к одному проекту, задачи попадают именно в него.
Мосты каналов
Мост соединяет канал с сессией чат-ассистента.
Взаимодействие с ассистентом через мост недоступно. Мост не передает сообщения ассистенту, поэтому он не может инициировать или управлять выполнением работ.
Обновления в канале
Slack — единственная платформа для чата, которая получает обновления. Coroid отправляет сообщения в один Slack-канал при завершении, сбое или эскалации задачи, а также при повторной попытке или невозможности разрешить конфликт слияния. Сообщения передаются через входящий вебхук Slack, привязанный к вашей организации, а не через бота Slack. Экран настроек для подключения вебхука пока отсутствует.
Discord, Telegram и SMS не получают обновлений. Все остальные уведомления поступают в портал. Подробнее здесь: Уведомления.