一句话答案
在目标飞书群添加自定义机器人，启用合适的安全策略并取得 Webhook；将 Webhook 和签名密钥通过受控方式配置到讯蜂飞书通道，保存后发送脱敏测试消息，确认来源、目标群和发送状态均正确。
开始前需要准备什么？
- 一个由团队合法管理、成员范围明确的飞书群。
- 在该群添加或管理自定义机器人的权限。
- 已经在讯蜂中完成合法接入的 SIM 卡或授权邮箱。
- 一条不会包含真实验证码、密码、Token 或业务敏感数据的测试内容。
建议为验证消息建立专用群或明确的业务群，不要默认发送到成员范围过大的公共群。群成员应与实际业务职责一致。
飞书群转发的配置步骤
- 选择目标群：确认谁需要接收消息，谁可以管理机器人。
- 添加自定义机器人：按照飞书开放平台的自定义机器人说明，在目标群创建机器人。
- 设置安全策略：根据飞书当前提供的选项设置签名校验、关键词或来源限制，生产环境优先启用签名校验。
- 保存 Webhook：Webhook 等同于通道凭据，不应出现在截图、公开文档、前端代码或 Git 仓库。
- 配置讯蜂通道：进入讯蜂对应的飞书通道配置，将 Webhook 与安全参数通过受控方式写入。
- 绑定来源与去向：选择哪些 SIM、邮箱或业务来源应该进入这个飞书群。
- 发送脱敏测试：验证机器人是否成功发消息，并检查来源标识、目标群和状态。
SIM / 授权邮箱讯蜂识别消息来源和归属
飞书目标群机器人按规则将消息送达团队
Webhook 为什么必须作为密钥管理？
任何获得有效 Webhook 的人都可能尝试向对应机器人发送消息。因此它不能写入公开网页、客户端 JavaScript、代码仓库或普通操作手册，也不应通过官网表单提交。
- 生产 Webhook 和签名密钥只放在服务器私有配置中。
- 限制能够查看或修改配置的人员。
- 成员或职责变化时，及时检查群成员和机器人权限。
- 怀疑泄露时立即在飞书侧重置或删除机器人，并更新讯蜂配置。
- 测试截图应遮盖 Webhook、签名密钥、真实验证码和业务账号信息。
飞书平台能力和界面可能调整。创建机器人及安全选项应以飞书开放平台自定义机器人官方说明为准。
怎样确认配置真正可用？
一次合格测试至少检查以下五项，而不是只看群里“出现了一条消息”：
- 测试内容不含真实验证码和敏感凭据。
- 消息进入预期飞书群，没有送往错误群组。
- 消息显示的来源名称能够识别对应号码、邮箱或业务。
- 讯蜂侧能够得到明确的成功或失败结果。
- 关闭或更新机器人后，团队知道如何恢复通道。
常见故障与排查顺序
| 现象 | 优先检查 | 处理方向 |
|---|---|---|
| 机器人完全不发消息 | Webhook 是否有效、机器人是否仍在目标群 | 重新复制并受控更新配置 |
| 返回签名相关错误 | 签名密钥、时间戳和服务器时间 | 核对密钥并同步服务器时间 |
| 测试成功，业务消息不发送 | 来源是否绑定到该目标通道 | 检查讯蜂来源与路由规则 |
| 消息进入错误群 | Webhook 与通道名称映射 | 立即暂停规则并重新核对 |
| 偶发发送失败 | 飞书返回状态、频率限制和网络状态 | 记录失败时间并按返回信息排查 |
常见问题
为什么建议优先用飞书演示？
飞书群消息结果直观，适合演示“来源接入—平台归集—团队送达”的完整路径，并且后续可以扩展机器人和业务流程。
Webhook 可以直接发给实施人员吗？
只应通过双方确认的受控渠道交付，不要放入公开文档、普通群聊、演示申请表或 Git 仓库。
能否把所有验证码都发到一个群？
技术上可以配置统一去向，但不建议忽略权限。应根据业务、账号敏感程度和人员职责拆分目标群。
飞书通道失败会改变原始验证码吗？
不会。通道失败影响的是转发送达，原始验证码仍由业务平台发送到对应 SIM 卡或邮箱。
外部参考：飞书开放平台：在群组中添加自定义机器人。产品通道范围见讯蜂转发通道。