Slack

Slack API integration with managed OAuth. Отправка сообщений, управление каналами, поиск диалогов и взаимодействие с рабочими пространствами Slack.

Используйте этот инструмент, когда нужно публиковать сообщения, получать список каналов, информацию о пользователях или автоматизировать рабочие процессы в Slack. Для работы с другими сторонними сервисами рекомендуется использовать API Gateway.

Slack

Доступ к Slack API с управляемой OAuth-аутентификацией. Позволяет отправлять сообщения, управлять каналами, получать список пользователей и автоматизировать рабочие процессы.

Быстрый старт

# Отправка сообщения в канал
python <<'EOF'
import urllib.request, os, json
data = json.dumps({'channel': 'C0123456789', 'text': 'Hello from Maton!'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/slack/api/chat.postMessage', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/slack/{method}

Шлюз проксирует запросы к slack.com и автоматически подставляет OAuth-токен.

Аутентификация

Все запросы требуют API-ключ Maton в заголовке Authorization:

Authorization: Bearer $MATON_API_KEY

Переменная окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

• Зайдите или создайте аккаунт на maton.ai
• Перейдите в раздел настроек
• Скопируйте ваш API-ключ

Управление подключениями

Управляйте OAuth-подключениями Slack через:

https://ctrl.maton.ai

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=slack&status=ACTIVE')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Создание подключения

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'app': 'slack'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Обработка ошибок

• 400 — отсутствует подключение Slack
• 401 — неверный или отсутствующий API-ключ
• 429 — превышен лимит запросов
• 4xx/5xx — ошибка со стороны Slack API

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

Проблемы с API-ключом

echo $MATON_API_KEY

Проверьте корректность ключа, запросив список подключений.

Неверное имя приложения

Убедитесь, что URL начинается с slack:

• Корректно: https://gateway.maton.ai/slack/api/chat.postMessage
• Некорректно: https://gateway.maton.ai/api/chat.postMessage

Ресурсы

• Обзор Slack API
• Отправка сообщений
• Обновление сообщений
• Удаление сообщений
• Список каналов
• История каналов
• Ответы в тредах
• Список пользователей
• Информация о пользователе
• Поиск сообщений
• Block Kit

---