核心用法
本技能通过 Maton 网关代理访问 Slack API，提供托管式 OAuth 认证方案。用户无需自行维护 OAuth 令牌，仅需在 Maton 平台完成一次授权，即可通过统一的 API Key 调用全部 Slack 功能。
主要能力覆盖四大场景：
- 消息操作：发送、更新、删除消息，支持线程回复、富文本块(Block Kit)、表情反应
- 频道管理：列出公开/私有频道、获取成员列表、读取历史消息和线程回复
- 用户相关：查询用户信息、列表团队成员、开启私聊会话
- 搜索与文件：全文搜索消息历史、上传文件到频道
技术接入方式为标准 HTTP REST，支持 cURL、Python、JavaScript 等任意语言。请求路径遵循 https://gateway.maton.ai/slack/api/{method} 格式，认证头统一使用 Authorization: Bearer {MATON_API_KEY}。
连接管理
通过独立的控制面板 ctrl.maton.ai 管理多工作区连接：创建连接会返回 OAuth 授权 URL，用户完成 Slack 授权后连接状态变为 ACTIVE。支持多连接并存，通过 Maton-Connection 头部指定目标工作区。
---
显著优点
1. 零维护 OAuth：令牌生命周期、刷新、加密存储全部由 Maton 托管，用户侧仅需保管单一 API Key
2. 完整 API 覆盖：支持 Slack 核心方法（chat.postMessage、conversations.、users.、search.messages 等），满足绝大多数自动化需求
3. 多租户友好：一个 API Key 可挂载多个 Slack 工作区连接，适合 MSP 或跨团队场景
4. 标准协议：保持 Slack 原生 API 的请求/响应格式，官方文档完全适用，迁移成本极低
5. 线程与富文本：原生支持 thread_ts 参数实现线程对话，支持 Block Kit JSON 构建交互式消息
---
潜在局限与风险
| 维度 | 说明 |
|------|------|
| **速率限制** | 10 req/sec 每账户上限，高频场景需本地队列缓冲 |
| **网络依赖** | 必须能访问 Maton 网关（gateway.maton.ai），内网隔离环境需评估 |
| **权限粒度** | 继承 Slack OAuth 的权限范围，无法突破工作区管理员设定的边界 |
| **数据驻留** | 消息内容流经 Maton 网关，对合规敏感行业需确认数据处理协议 |
| **连接失效** | Slack 用户撤销授权或工作区停用会导致连接失效，需监控状态并支持重授权流程 |
---
适合人群
- 开发者/运维工程师：构建 CI/CD 通知、告警机器人、自动化工作流
- 团队管理员：批量管理频道成员、导出历史记录、审计消息
- 集成服务商：为客户快速搭建 Slack 互通能力，避免重复 OAuth 开发
---
常规风险提示
- 消息不可恢复：chat.delete 为硬删除，无回收站机制
- 隐私合规：users.list、search.messages 可能触及 GDPR 等法规，需确保授权范围内使用
- Token 保管：MATON_API_KEY 泄露将导致全部挂载的 Slack 连接被滥用，建议配合密钥管理服务