Интеграция с Slack

Добавьте вашего агента в рабочие пространства Slack для доступа всей команды.

Обзор

Интеграция с Slack обеспечивает:

• Поддержку слеш-команд (/ask)
• Диалоги в личных сообщениях
• Упоминания в каналах
• Доступность на уровне всего рабочего пространства

Предварительные требования

• Права администратора рабочего пространства Slack или разрешение на установку приложений
• Учётная запись Cuneiform Chat с активным агентом

Шаги настройки

1. Начало настройки интеграции

1. Перейдите в Integrations в боковой панели
2. Откройте карточку Slack
3. Нажмите Add to Slack

2. Авторизация приложения

1. Выберите рабочее пространство для установки
2. Просмотрите разрешения
3. Нажмите Allow

3. Проверка установки

1. Откройте Slack
2. Попробуйте слеш-команду: /ask Hello
3. Убедитесь, что вы получили ответ

Использование бота

Слеш-команды

Используйте команду /ask в любом канале:

/ask What is our refund policy?

Ответ появляется в канале (или как эфемерное сообщение, в зависимости от настроек).

Личные сообщения

Напишите боту напрямую для приватного общения:

1. Найдите приложение на боковой панели Slack
2. Откройте личное сообщение
3. Общайтесь в свободной форме

Упоминания в каналах

Упомяните бота в каналах, чтобы задать вопрос:

@YourBot What are the shipping options?

Возможности

Доступ на уровне рабочего пространства

После установки бот доступен всем участникам рабочего пространства.

Ответы в тредах

Ответы могут публиковаться в тредах для поддержания порядка в каналах.

Расширенное форматирование

Ответы поддерживают форматирование Slack:

• Жирный и курсивный текст
• Ссылки
• Блоки кода
• Списки

Параметры конфигурации

Настройки ответов

Ограничения по каналам

Можно ограничить бота определёнными каналами для целевого использования.

Поддержка нескольких рабочих пространств

Вы можете установить одного агента в несколько рабочих пространств Slack:

1. Каждое рабочее пространство требует отдельной авторизации
2. Все рабочие пространства используют одного и того же агента и контент
3. Диалоги отслеживаются отдельно для каждого рабочего пространства

Устранение неполадок

Команда не найдена

Если /ask не работает:

1. Убедитесь, что приложение установлено в вашем рабочем пространстве
2. Проверьте, что у приложения есть необходимые разрешения
3. Попробуйте переустановить интеграцию

Нет ответа

Если бот не отвечает:

1. Убедитесь, что ваш агент настроен и работает (протестируйте в Playground)
2. Проверьте, что интеграция со Slack подключена
3. Убедитесь, что бот имеет доступ к каналу

Проблемы с разрешениями

Slack-приложение запрашивает следующие OAuth-разрешения (настроены заранее — вы предоставляете их все, когда нажимаете Allow при установке):

• commands — для слеш-команд
• chat:write — для отправки сообщений
• chat:write.customize — отправка сообщений с пользовательским именем/иконкой
• app_mentions:read — для упоминаний через @
• im:history — чтение истории личных сообщений для контекста
• channels:history — чтение истории публичных каналов для контекста
• channels:read — получение списка публичных каналов
• groups:history — чтение истории приватных каналов для контекста
• mpim:history — чтение истории групповых DM для контекста
• users:read — разрешение имён пользователей

Безопасность

• Токены OAuth зашифрованы
• Нет доступа к сообщениям, кроме явных команд и упоминаний
• Данные рабочего пространства остаются конфиденциальными

Отключение

Чтобы удалить интеграцию со Slack:

1. Из Cuneiform Chat:

   • Integrations (боковая панель) → Slack → Disconnect

2. Из Slack:

   • Перейдите в настройки рабочего пространства
   • Apps → Найдите приложение → Remove

Оба шага обеспечивают полное удаление.