Настройка канала Slack

Подключите своего Bot в Memoh к Slack: он сможет получать личные сообщения, работать в каналах и тредах, читать вложения, отправлять файлы и отвечать в потоковом режиме.

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

• Рабочее пространство Slack, в которое вы можете устанавливать приложения, и доступ к консоли Slack API.
• Bot в Memoh; каналы настраиваются на его вкладке Platforms.

Шаги

1. В консоли Slack создайте приложение

1. Откройте консоль Slack API и создайте новое приложение.
2. Выберите рабочее пространство, куда хотите установить Bot.

TIP

Не закрывайте страницу настроек приложения — шаги со 2-го по 5-й выполняются именно там.

2. В консоли Slack включите Socket Mode

Адаптер Slack в Memoh работает через Socket Mode, поэтому помимо токена Bot понадобится ещё и app-level токен.

1. В разделе Basic Information включите Socket Mode.
2. Создайте App-Level Token со scope connections:write.
3. Скопируйте сгенерированный токен. Он начинается с xapp-.

3. В консоли Slack добавьте scope для токена Bot

В разделе OAuth & Permissions добавьте scope токена Bot, которые нужны адаптеру Slack:

• app_mentions:read — получать упоминания Bot в каналах
• channels:history — читать сообщения в публичных каналах
• groups:history — читать сообщения в приватных каналах
• im:history — читать личные сообщения
• mpim:history — читать групповые личные сообщения
• chat:write — отправлять ответы и сообщения в тредах
• files:read — читать загруженные файлы и изображения
• files:write — отправлять исходящие файлы
• reactions:write — ставить и убирать реакции

Если хотите, чтобы названия бесед Slack и метаданные отображались в Memoh полнее, добавьте также рекомендуемые scope:

• channels:read
• groups:read
• im:read
• mpim:read

4. В консоли Slack подпишитесь на события Bot

В разделе Event Subscriptions включите события Bot и добавьте входящие типы событий, которые обрабатывает адаптер Slack:

• app_mention
• message.channels
• message.groups
• message.im
• message.mpim

5. В консоли Slack установите приложение в рабочее пространство

1. В разделе OAuth & Permissions нажмите Install to Workspace.
2. Просмотрите экран запроса прав и авторизуйте приложение.
3. Скопируйте Bot User OAuth Token. Он начинается с xoxb-.

6. В Memoh добавьте канал Slack

1. Откройте страницу нужного Bot и перейдите на вкладку Platforms.
2. Нажмите Add Channel и выберите Slack.
3. Заполните поля:
   • Bot Token: ваш токен xoxb-...
   • App-Level Token: ваш токен xapp-...
4. Нажмите Save and Enable.

7. В Slack добавьте Bot в беседы

После включения канала приложение Slack ещё нужно добавить в те беседы, где оно должно работать:

• Личные сообщения: откройте DM с приложением и отправьте сообщение.
• Публичные каналы: пригласите Bot в канал.
• Приватные каналы: после установки пригласите Bot явно.

Учётные данные

Поле	Описание
Bot Token	Bot User OAuth Token (xoxb-...), скопированный после установки приложения в рабочее пространство.
App-Level Token	Токен Socket Mode (xapp-...), созданный со scope connections:write.

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

Проверка

Пригласите Bot в канал и отправьте ему /help через @-упоминание — или отправьте /help в личной переписке с приложением. Если Bot ответил списком команд, канал работает.

Групповые чаты

Каналы Slack поддерживаются. Пригласите Bot в публичный или приватный канал и общайтесь с ним через @-упоминания. Ответы могут продолжаться в тредах; Slack — единственный канал, поддерживающий треды.

Отключение и смена учётных данных

Отключить или удалить этот канал можно в любой момент на вкладке Platforms нужного Bot. Чтобы сменить учётные данные, обновите поля Bot Token и App-Level Token и сохраните.

Частые вопросы

Зачем Slack два токена?

Адаптер Slack в Memoh работает через Socket Mode: помимо токена Bot xoxb-... нужен ещё app-level токен xapp-..., и оба должны принадлежать одному приложению Slack и одному рабочему пространству.

Bot отправляет сообщения, но не читает загруженные изображения и файлы

Проверьте, что включён scope files:read.

Bot подключается, но не получает входящих сообщений

Перепроверьте события Bot в разделе Event Subscriptions и соответствующие scope вида history.