飞书群营销消息卡片

解决的问题

在飞书 / Lark 群里做一次营销推送，看起来只是「发条消息」，实际要处理的事情不少：机器人 Webhook 怎么配、签名怎么算、msg_type 和内容结构怎么对应、卡片 JSON 为什么渲染不出来、批量发送会不会触发限流。这个技能把这些细节收敛成一套可审查的消息构造流程，让发送动作不再是散落的 curl 命令。

技能如何工作

• 两种集成方式：轻量场景用 FEISHU_WEBHOOK_URL（可选 FEISHU_WEBHOOK_SECRET）走 Custom Bot Webhook；需要跨群发送、上传图片、@ 指定用户、接收事件时，改用 App Bot API 的 FEISHU_APP_ID + FEISHU_APP_SECRET，并先换取 tenant_access_token。
• 四类消息体：纯文本适合快速通知；富文本 post 支持加粗、链接、@ 和多语言（zhcn / enus）；交互式卡片可组合 header 配色、Markdown 段落、分割线、图片、多列布局和按钮；App Bot API 还能上传图片拿 image_key。
• 签名校验：配置了 secret 的 Webhook，需要用时间戳拼接密钥做 HMAC-SHA256 再 Base64，技能会生成带 timestamp 和 sign 的完整请求体。
• 发送前预览：技能会先交付分析、方案、草稿和完整的 JSON payload，展示目标群、内容和影响范围，等你明确确认后才执行发送，并回传响应码核验结果。
• 排错参考：内置 Webhook 响应码对照表（如 19002 签名失败、19021 触发限流），覆盖卡片 JSON 校验、token 过期、bot 被移出群等常见问题。

适用边界

• 仅限用户明确授权的群组和材料；信息不足时先标记缺口，不猜内容填补事实、数字或人名。
• 所有联网检索和接口调用都需先说明目标与用途，取得同意后再执行；凭据不回显、不记录、不转发。
• 营销输出只做合规方案、草稿和测试建议，不承诺流量或成交，不刷量、不群发骚扰、不设计绕过平台规则的做法。
• 卡片内容建议控制在约 30KB 以内，长报告改用外链；批量发送需自行加间隔，Webhook 限速 100 条/分钟。