Composio Slack 工具集实战指南权限作用域、文件下载、V2 触发器与排障全解【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南以 Composio 仓库中的 Slack 公开支持知识文档docs/kb/source/toolkits/slack/public.md为核心系统讲解在 Composio 平台上接入 Slack 工具集时最容易踩坑的七个技术要点用户令牌权限作用域、按文件 ID 下载、assistant.search.context的版本门槛、V2 触发器、事件订阅 Webhook、短连接与重定向 URI 的区别以及企业级管理作用域。读完本文你将能正确配置 Slack 的 OAuth 认证、规避触发器失效与文件下载失败等常见问题并掌握如何借助 Webhook Triggers V2 构建稳定可靠的 Slack 消息触发链路。Slack 工具集在 Composio 中的定位在 docs/public/data/toolkits.json 中Slack 工具集slug 为slack被归类为 team chat 类别仅支持OAUTH2认证方案仓库记录的版本为20260826_00包含167 个工具与 9 个触发器。覆盖面包括消息收发、文件管理、对话管理、企业级会话操作、表情与自定义表情、远程文件引用、星标与通知等多个维度。与 Slackbot 工具集不同Slack 工具集以模拟真实 Slack 用户/机器人操作工作区为定位。正因为其工具数量庞大且涉及用户令牌与机器人令牌两套权限体系以下七个高频问题构成了接入与排障的核心。1. 用户令牌权限把权限写进user_scopes而非scopesSlack 是少数将**机器人作用域bot scopes与用户作用域user scopes**严格分离的平台。在 Composio 的 Slack 工具集中scopes字段表示bot-user scopes机器人权限如果你的场景是以真实 Slack 用户身份执行操作例如代表用户发消息、读用户的私有对话必须把权限放在认证配置凭据的user_scopes字段中对用户令牌类工具应设置credentials.user_scopes如果该用例下 Slack 应用没有对应的 bot 工具scopes字段甚至可以留空不影响使用。从源码结构看这一设计贯穿于认证配置的建模auth_configs中的credentials对象同时承载scopes与user_scopes工具执行时按令牌类型读取对应的作用域集合。仓库中的 python/examples/auth_configs.py 与 python/tests/test_auth_configs.py 展示了认证配置的构造与校验方式可作参考。实战建议在 Composio 中创建 Slack 连接时先在 Slack App 管理后台OAuth Permissions分别配置 Bot Token Scopes 与 User Token Scopes在AuthConfig中为credentials显式传入user_scopes例如[chat:write, files:read, users:read]按需裁剪若某个工具报missing_scope且该工具面向用户身份优先检查user_scopes而非scopes。2. 按文件 ID 下载 Slack 文件内容Slack 工具集提供SLACK_DOWNLOAD_SLACK_FILE用于按文件 ID 下载文件内容。其用法要点传入 Slack 文件 ID该 ID以F开头例如F123ABCDEF0工具返回可下载的文件内容以及元数据包括name文件名、mimetype媒体类型、size字节数等如果不知道文件 ID先调用SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK列出符合条件的文件从中获取 ID再传给下载工具。典型调用链SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK可按频道、用户、文件类型等条件筛选返回文件列表含id从结果中选取目标文件 IDF...SLACK_DOWNLOAD_SLACK_FILE传入该 ID得到内容与元数据。注意Slack 平台本身对文件内容有访问控制私有文件需要相应权限因此下载工具的可用性同样依赖连接令牌所拥有的files:read类作用域。3.assistant.search.context需要 Agents AI Apps 与 Business 套餐Slack 的 AI 搜索上下文工具assistant.search.context有两条硬性门槛Slack OAuth 应用必须启用Agents AI Apps功能Slack 工作区套餐必须是Business 或更高版本。如何定位阻塞点调用assistant.search.info来核验工作区能力若返回is_ai_search_enabled为false则说明工作区套餐或功能启用状态是阻塞原因。此时检查工作区套餐是否达到 Business检查该 Slack 应用是否已开启 Agents AI Apps如果工作区套餐不足即使换用客户自己的、已启用 Agents AI Apps 的 Slack OAuth 应用也仍然需要 Business 套餐——套餐是硬性前提。简单来说应用侧可替换自建 OAuth 应用工作区侧不可绕过必须 Business。4. Slack 消息触发器优先使用 V2 slug对于消息类事件Composio 提供两个 V2 触发器触发器 slug适用场景SLACK_CHANNEL_MESSAGE_RECEIVED频道消息公开频道、私有频道、多人 DMSLACK_DIRECT_MESSAGE_RECEIVED私聊 DMV2 触发器相比旧版 V1 slug如SLACK_RECEIVE_MESSAGE、SLACK_RECEIVE_DIRECT_MESSAGE的优势包括专属端点、入口级签名校验、更完善的 DM 处理、更丰富的过滤能力。旧版 V1 slug 仍然可用向后兼容但新搭建的环境建议直接使用 V2。V2 背后的机制Webhook Triggers V2仓库的更新日志 docs/content/changelog/04-27-26-webhook-triggers-v2.mdx 详细说明了 V2 的实现原理这是理解触发器稳定性的关键每个 OAuth 应用拥有专属 Webhook 端点端点按(toolkit_slug, project_id, client_id)唯一键控URL 形如https://backend.composio.dev/api/v3.1/webhook_ingress/{toolkit}/{we_xxx}/trigger_event事件只扇出到该端点上对应项目内的触发器实例入口级签名校验Composio 使用 HMAC-SHA256、Ed25519 或共享令牌等方式基于端点存储的签名密钥校验每个 V2 请求对携带时间戳签名的提供商如 Slack还会做重放保护时间戳超出允许偏差窗口的请求会被拒绝按用户授权Slack 是第一个支持按用户可见性的工具集——V2 使用应用级令牌xapp-…需authorizations:read作用域解析某事件授权的连接用户只触发该用户对应的触发器实例从而支撑私有频道与 DM 场景自动握手与清理Composio 自动应答 Slackurl_verification等提供商验证挑战回调 URL 无需自定义代码即可完成验证触发器删除时也会在提供商侧注销用户级 webhook。V2 接入流程以 Slack 为例发现必填字段GET /api/v3.1/webhook_endpoints/schema?toolkit_slugslack返回setup_fieldsSlack 需要webhook_signing_secretSigning Secret与app_tokenxapp- 应用级令牌创建端点POST /api/v3.1/webhook_endpointsBody 为{ toolkit_slug: slack, client_id: YOUR_SLACK_CLIENT_ID }该调用按toolkit_slug client_id幂等响应中的id如we_abc123与webhook_url都要保存先存储签名密钥PATCH /api/v3.1/webhook_endpoints/{id}写入data.webhook_signing_secret。⚠️ 必须在切换提供商回调 URL 之前完成否则 Slack 向 V2 URL 推送时因无密钥可用而全部返回400Slack 可能在约 36 小时失败后自动禁用端点按需添加应用级令牌SLACK_DIRECT_MESSAGE_RECEIVED始终需要app_tokenSLACK_CHANNEL_MESSAGE_RECEIVED仅在私有频道与多人 DM 时需要公开频道无需。令牌在 Slack 应用 → Basic Information → App-Level Tokens 生成作用域为authorizations:read在 Slack 应用配置回调将 Slack 应用 Event Subscriptions 的 Request URL 设置为第 2 步返回的webhook_urlComposio 会自动完成与 Slack 的验证握手创建 V2 触发器实例POST /api/v3.1/trigger_instances/SLACK_CHANNEL_MESSAGE_RECEIVED/upsertBody 传connected_account_id与trigger_config。V1 与 V2 的映射关系V1 仍受支持V1 slug仍可用V2 替代是否需要app_tokenSLACK_RECEIVE_MESSAGESLACK_CHANNEL_MESSAGE_RECEIVED仅私有频道与多人 DM 需要公开频道不需要SLACK_RECEIVE_DIRECT_MESSAGESLACK_DIRECT_MESSAGE_RECEIVED始终需要SLACK_REACTION_ADDEDSLACK_MESSAGE_REACTION_ADDED始终需要表情事件不携带频道类型按用户授权无条件执行V2 的注意事项OAuth 应用在 V2 上按项目隔离V2 将每个 OAuth 应用client_id绑定到恰好一个项目。如果当前多个 Composio 项目/组织共用同一个 Slack OAuth 应用迁移到 V2 前要么合并为单项目要么为每个项目注册独立 OAuth 应用反过来两个不同的 OAuth 应用也不能共享同一个 V2 端点——Composio 只用该端点存储的签名密钥校验请求不迁移也能继续使用 V1V1 入口 URL/api/v3/trigger_instances/{toolkit}/{project_id}/handle与所有旧 slug 均不受影响无需数据迁移。5. 触发器突然停止先检查 Slack 应用的事件订阅 Webhook URL当 Slack 触发器事件意外停止投递时首要排查项是Slack OAuth 应用 Event Subscriptions 中的webhook_url是否被改动。即使触发器实例此前一直正常工作只要 Slack 应用的事件订阅 URL 或相关设置被变更Slack 就可能停止向 Composio 投递事件。排查清单登录 Slack App 管理后台进入 Event Subscriptions核对 Request URL 是否为 Composio 提供的端点地址V1 为/handle入口V2 为/api/v3.1/webhook_ingress/...确认 URL 未被误改、未被其他服务占用检查 Slack 应用是否仍处于已启用Enabled状态、订阅事件列表是否完整若曾重新保存过设置确认 Slack 已完成 URL 验证Verification 通过。结合 V2 机制可知事件订阅 URL 与端点签名密钥必须始终与 Composio 侧保持一致任何一端变更都会导致投递断裂。6. 短连接 ≠ OAuth 重定向 URIComposio 生成的短连接/api/v3/s/...不是发送给 Slack 的redirect_uri。它的作用仅仅是把浏览器重定向到 Slack 授权页面的一个缩短链接。真正参与 OAuth 流程的是以下几项必须在两端严格一致字段含义callbackUrl/redirectUri静态回调地址必须同时在 Composio 的 authConfig 与 Slack OAuth 应用中配置一致redirectUrl每次连接per-connection的认证 URL用于把用户导向完整的认证流程短连接/api/v3/s/...仅做浏览器跳转的短链不是redirect_uri实际配置可在 authConfig 中查看。当出现Slack 授权失败 / redirect_uri 不匹配错误时优先核对 Composio 侧 authConfig 的callbackUrl/redirectUri与 Slack 应用 OAuth Permissions 中填写的 Redirect URL 是否完全一致包括协议、域名、路径与尾部斜杠。7. 定时消息的attachments不是文件上传Slack 定时消息scheduled messages中的attachments字段指的是Slack 传统意义上的次要/富文本格式附件secondary / rich-formatting attachments不是上传的文件。关键事实Slack 的chat.scheduleMessageAPI原生不支持上传文件文件必须单独上传例如通过files.upload或files.upload.v2上传完成后将文件的链接或嵌入信息放进定时消息正文消息发布时即可正常展开unfurl。因此在 Composio 中编排定时发送带文件消息时标准做法是先用文件上传类工具把文件上传到 Slack拿到permalink/url_private再在chat.scheduleMessage的消息正文中携带该链接而不是试图往attachments里塞文件。8.admin.conversations:write需要 Slack Enterprise 套餐admin.conversations:write是企业/管理员级Slack 作用域。以admin.conversations.delete为代表的会话管理 API 要求工作区必须处于Enterprise 套餐。若频道删除或管理员会话类工具不可用请按顺序确认Slack 工作区套餐是否为 Enterprise非 Enterprise 的免费/Pro/Business 套餐不提供该能力OAuth 应用中是否已勾选admin.conversations:write这一管理作用域连接令牌是否携带了该作用域参考第 1 节管理作用域同样需要进入scopes/user_scopes的正确位置。常见问题速查表症状大概率原因处理方式用户身份工具报missing_scope权限写进了 botscopes而不是user_scopes在credentials.user_scopes中补充用户作用域SLACK_DOWNLOAD_SLACK_FILE失败文件 ID 错误 / 缺少files:read先SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK获取F开头 IDassistant.search.context报错未启用 Agents AI Apps 或套餐低于 Business用assistant.search.info检查is_ai_search_enabled触发器事件突然消失Slack 应用 Event Subscriptions webhook URL 被改动核对 Request URL 与端点签名密钥OAuth 授权页 redirect_uri 报错短连接被误认为重定向 URI对齐 authConfig 的callbackUrl/redirectUri与 Slack 应用配置定时消息附件不展示attachments被当作文件上传用files.upload/files.upload.v2单独上传并嵌入正文链接频道删除工具不可用工作区非 Enterprise 套餐升级 Enterprise 并确认admin.conversations:write作用域延伸阅读docs/kb/source/toolkits/slack/public.md本文所依据的原始支持知识文档docs/content/kb/guide/toolkits-slack.mdxSlack 工具集知识库指南含更多排障条目docs/content/changelog/04-27-26-webhook-triggers-v2.mdxWebhook Triggers V2 完整变更说明与 API 参考docs/public/data/toolkits.jsonSlack 工具集的 167 个工具与 9 个触发器的官方清单python/examples/auth_configs.py认证配置含user_scopes的构造示例docs/api-overviews/auth-configs.mdx认证配置 API 概览【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Composio Slack 工具集实战指南：权限作用域、文件下载、V2 触发器与排障全解
Composio Slack 工具集实战指南权限作用域、文件下载、V2 触发器与排障全解【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio本指南以 Composio 仓库中的 Slack 公开支持知识文档docs/kb/source/toolkits/slack/public.md为核心系统讲解在 Composio 平台上接入 Slack 工具集时最容易踩坑的七个技术要点用户令牌权限作用域、按文件 ID 下载、assistant.search.context的版本门槛、V2 触发器、事件订阅 Webhook、短连接与重定向 URI 的区别以及企业级管理作用域。读完本文你将能正确配置 Slack 的 OAuth 认证、规避触发器失效与文件下载失败等常见问题并掌握如何借助 Webhook Triggers V2 构建稳定可靠的 Slack 消息触发链路。Slack 工具集在 Composio 中的定位在 docs/public/data/toolkits.json 中Slack 工具集slug 为slack被归类为 team chat 类别仅支持OAUTH2认证方案仓库记录的版本为20260826_00包含167 个工具与 9 个触发器。覆盖面包括消息收发、文件管理、对话管理、企业级会话操作、表情与自定义表情、远程文件引用、星标与通知等多个维度。与 Slackbot 工具集不同Slack 工具集以模拟真实 Slack 用户/机器人操作工作区为定位。正因为其工具数量庞大且涉及用户令牌与机器人令牌两套权限体系以下七个高频问题构成了接入与排障的核心。1. 用户令牌权限把权限写进user_scopes而非scopesSlack 是少数将**机器人作用域bot scopes与用户作用域user scopes**严格分离的平台。在 Composio 的 Slack 工具集中scopes字段表示bot-user scopes机器人权限如果你的场景是以真实 Slack 用户身份执行操作例如代表用户发消息、读用户的私有对话必须把权限放在认证配置凭据的user_scopes字段中对用户令牌类工具应设置credentials.user_scopes如果该用例下 Slack 应用没有对应的 bot 工具scopes字段甚至可以留空不影响使用。从源码结构看这一设计贯穿于认证配置的建模auth_configs中的credentials对象同时承载scopes与user_scopes工具执行时按令牌类型读取对应的作用域集合。仓库中的 python/examples/auth_configs.py 与 python/tests/test_auth_configs.py 展示了认证配置的构造与校验方式可作参考。实战建议在 Composio 中创建 Slack 连接时先在 Slack App 管理后台OAuth Permissions分别配置 Bot Token Scopes 与 User Token Scopes在AuthConfig中为credentials显式传入user_scopes例如[chat:write, files:read, users:read]按需裁剪若某个工具报missing_scope且该工具面向用户身份优先检查user_scopes而非scopes。2. 按文件 ID 下载 Slack 文件内容Slack 工具集提供SLACK_DOWNLOAD_SLACK_FILE用于按文件 ID 下载文件内容。其用法要点传入 Slack 文件 ID该 ID以F开头例如F123ABCDEF0工具返回可下载的文件内容以及元数据包括name文件名、mimetype媒体类型、size字节数等如果不知道文件 ID先调用SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK列出符合条件的文件从中获取 ID再传给下载工具。典型调用链SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK可按频道、用户、文件类型等条件筛选返回文件列表含id从结果中选取目标文件 IDF...SLACK_DOWNLOAD_SLACK_FILE传入该 ID得到内容与元数据。注意Slack 平台本身对文件内容有访问控制私有文件需要相应权限因此下载工具的可用性同样依赖连接令牌所拥有的files:read类作用域。3.assistant.search.context需要 Agents AI Apps 与 Business 套餐Slack 的 AI 搜索上下文工具assistant.search.context有两条硬性门槛Slack OAuth 应用必须启用Agents AI Apps功能Slack 工作区套餐必须是Business 或更高版本。如何定位阻塞点调用assistant.search.info来核验工作区能力若返回is_ai_search_enabled为false则说明工作区套餐或功能启用状态是阻塞原因。此时检查工作区套餐是否达到 Business检查该 Slack 应用是否已开启 Agents AI Apps如果工作区套餐不足即使换用客户自己的、已启用 Agents AI Apps 的 Slack OAuth 应用也仍然需要 Business 套餐——套餐是硬性前提。简单来说应用侧可替换自建 OAuth 应用工作区侧不可绕过必须 Business。4. Slack 消息触发器优先使用 V2 slug对于消息类事件Composio 提供两个 V2 触发器触发器 slug适用场景SLACK_CHANNEL_MESSAGE_RECEIVED频道消息公开频道、私有频道、多人 DMSLACK_DIRECT_MESSAGE_RECEIVED私聊 DMV2 触发器相比旧版 V1 slug如SLACK_RECEIVE_MESSAGE、SLACK_RECEIVE_DIRECT_MESSAGE的优势包括专属端点、入口级签名校验、更完善的 DM 处理、更丰富的过滤能力。旧版 V1 slug 仍然可用向后兼容但新搭建的环境建议直接使用 V2。V2 背后的机制Webhook Triggers V2仓库的更新日志 docs/content/changelog/04-27-26-webhook-triggers-v2.mdx 详细说明了 V2 的实现原理这是理解触发器稳定性的关键每个 OAuth 应用拥有专属 Webhook 端点端点按(toolkit_slug, project_id, client_id)唯一键控URL 形如https://backend.composio.dev/api/v3.1/webhook_ingress/{toolkit}/{we_xxx}/trigger_event事件只扇出到该端点上对应项目内的触发器实例入口级签名校验Composio 使用 HMAC-SHA256、Ed25519 或共享令牌等方式基于端点存储的签名密钥校验每个 V2 请求对携带时间戳签名的提供商如 Slack还会做重放保护时间戳超出允许偏差窗口的请求会被拒绝按用户授权Slack 是第一个支持按用户可见性的工具集——V2 使用应用级令牌xapp-…需authorizations:read作用域解析某事件授权的连接用户只触发该用户对应的触发器实例从而支撑私有频道与 DM 场景自动握手与清理Composio 自动应答 Slackurl_verification等提供商验证挑战回调 URL 无需自定义代码即可完成验证触发器删除时也会在提供商侧注销用户级 webhook。V2 接入流程以 Slack 为例发现必填字段GET /api/v3.1/webhook_endpoints/schema?toolkit_slugslack返回setup_fieldsSlack 需要webhook_signing_secretSigning Secret与app_tokenxapp- 应用级令牌创建端点POST /api/v3.1/webhook_endpointsBody 为{ toolkit_slug: slack, client_id: YOUR_SLACK_CLIENT_ID }该调用按toolkit_slug client_id幂等响应中的id如we_abc123与webhook_url都要保存先存储签名密钥PATCH /api/v3.1/webhook_endpoints/{id}写入data.webhook_signing_secret。⚠️ 必须在切换提供商回调 URL 之前完成否则 Slack 向 V2 URL 推送时因无密钥可用而全部返回400Slack 可能在约 36 小时失败后自动禁用端点按需添加应用级令牌SLACK_DIRECT_MESSAGE_RECEIVED始终需要app_tokenSLACK_CHANNEL_MESSAGE_RECEIVED仅在私有频道与多人 DM 时需要公开频道无需。令牌在 Slack 应用 → Basic Information → App-Level Tokens 生成作用域为authorizations:read在 Slack 应用配置回调将 Slack 应用 Event Subscriptions 的 Request URL 设置为第 2 步返回的webhook_urlComposio 会自动完成与 Slack 的验证握手创建 V2 触发器实例POST /api/v3.1/trigger_instances/SLACK_CHANNEL_MESSAGE_RECEIVED/upsertBody 传connected_account_id与trigger_config。V1 与 V2 的映射关系V1 仍受支持V1 slug仍可用V2 替代是否需要app_tokenSLACK_RECEIVE_MESSAGESLACK_CHANNEL_MESSAGE_RECEIVED仅私有频道与多人 DM 需要公开频道不需要SLACK_RECEIVE_DIRECT_MESSAGESLACK_DIRECT_MESSAGE_RECEIVED始终需要SLACK_REACTION_ADDEDSLACK_MESSAGE_REACTION_ADDED始终需要表情事件不携带频道类型按用户授权无条件执行V2 的注意事项OAuth 应用在 V2 上按项目隔离V2 将每个 OAuth 应用client_id绑定到恰好一个项目。如果当前多个 Composio 项目/组织共用同一个 Slack OAuth 应用迁移到 V2 前要么合并为单项目要么为每个项目注册独立 OAuth 应用反过来两个不同的 OAuth 应用也不能共享同一个 V2 端点——Composio 只用该端点存储的签名密钥校验请求不迁移也能继续使用 V1V1 入口 URL/api/v3/trigger_instances/{toolkit}/{project_id}/handle与所有旧 slug 均不受影响无需数据迁移。5. 触发器突然停止先检查 Slack 应用的事件订阅 Webhook URL当 Slack 触发器事件意外停止投递时首要排查项是Slack OAuth 应用 Event Subscriptions 中的webhook_url是否被改动。即使触发器实例此前一直正常工作只要 Slack 应用的事件订阅 URL 或相关设置被变更Slack 就可能停止向 Composio 投递事件。排查清单登录 Slack App 管理后台进入 Event Subscriptions核对 Request URL 是否为 Composio 提供的端点地址V1 为/handle入口V2 为/api/v3.1/webhook_ingress/...确认 URL 未被误改、未被其他服务占用检查 Slack 应用是否仍处于已启用Enabled状态、订阅事件列表是否完整若曾重新保存过设置确认 Slack 已完成 URL 验证Verification 通过。结合 V2 机制可知事件订阅 URL 与端点签名密钥必须始终与 Composio 侧保持一致任何一端变更都会导致投递断裂。6. 短连接 ≠ OAuth 重定向 URIComposio 生成的短连接/api/v3/s/...不是发送给 Slack 的redirect_uri。它的作用仅仅是把浏览器重定向到 Slack 授权页面的一个缩短链接。真正参与 OAuth 流程的是以下几项必须在两端严格一致字段含义callbackUrl/redirectUri静态回调地址必须同时在 Composio 的 authConfig 与 Slack OAuth 应用中配置一致redirectUrl每次连接per-connection的认证 URL用于把用户导向完整的认证流程短连接/api/v3/s/...仅做浏览器跳转的短链不是redirect_uri实际配置可在 authConfig 中查看。当出现Slack 授权失败 / redirect_uri 不匹配错误时优先核对 Composio 侧 authConfig 的callbackUrl/redirectUri与 Slack 应用 OAuth Permissions 中填写的 Redirect URL 是否完全一致包括协议、域名、路径与尾部斜杠。7. 定时消息的attachments不是文件上传Slack 定时消息scheduled messages中的attachments字段指的是Slack 传统意义上的次要/富文本格式附件secondary / rich-formatting attachments不是上传的文件。关键事实Slack 的chat.scheduleMessageAPI原生不支持上传文件文件必须单独上传例如通过files.upload或files.upload.v2上传完成后将文件的链接或嵌入信息放进定时消息正文消息发布时即可正常展开unfurl。因此在 Composio 中编排定时发送带文件消息时标准做法是先用文件上传类工具把文件上传到 Slack拿到permalink/url_private再在chat.scheduleMessage的消息正文中携带该链接而不是试图往attachments里塞文件。8.admin.conversations:write需要 Slack Enterprise 套餐admin.conversations:write是企业/管理员级Slack 作用域。以admin.conversations.delete为代表的会话管理 API 要求工作区必须处于Enterprise 套餐。若频道删除或管理员会话类工具不可用请按顺序确认Slack 工作区套餐是否为 Enterprise非 Enterprise 的免费/Pro/Business 套餐不提供该能力OAuth 应用中是否已勾选admin.conversations:write这一管理作用域连接令牌是否携带了该作用域参考第 1 节管理作用域同样需要进入scopes/user_scopes的正确位置。常见问题速查表症状大概率原因处理方式用户身份工具报missing_scope权限写进了 botscopes而不是user_scopes在credentials.user_scopes中补充用户作用域SLACK_DOWNLOAD_SLACK_FILE失败文件 ID 错误 / 缺少files:read先SLACK_LIST_FILES_WITH_FILTERS_IN_SLACK获取F开头 IDassistant.search.context报错未启用 Agents AI Apps 或套餐低于 Business用assistant.search.info检查is_ai_search_enabled触发器事件突然消失Slack 应用 Event Subscriptions webhook URL 被改动核对 Request URL 与端点签名密钥OAuth 授权页 redirect_uri 报错短连接被误认为重定向 URI对齐 authConfig 的callbackUrl/redirectUri与 Slack 应用配置定时消息附件不展示attachments被当作文件上传用files.upload/files.upload.v2单独上传并嵌入正文链接频道删除工具不可用工作区非 Enterprise 套餐升级 Enterprise 并确认admin.conversations:write作用域延伸阅读docs/kb/source/toolkits/slack/public.md本文所依据的原始支持知识文档docs/content/kb/guide/toolkits-slack.mdxSlack 工具集知识库指南含更多排障条目docs/content/changelog/04-27-26-webhook-triggers-v2.mdxWebhook Triggers V2 完整变更说明与 API 参考docs/public/data/toolkits.jsonSlack 工具集的 167 个工具与 9 个触发器的官方清单python/examples/auth_configs.py认证配置含user_scopes的构造示例docs/api-overviews/auth-configs.mdx认证配置 API 概览【免费下载链接】composioComposio powers 1000 toolkits, tool search, context management, authentication, and a sandboxed workbench to help you build AI agents that turn intent into action.项目地址: https://gitcode.com/GitHub_Trending/co/composio创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考