feishu-urgent

飞书紧急通知工具

用于向已发送消息的接收者发送紧急（响铃）通知的单一工具 feishu_urgent。

概述

紧急通知（在飞书中也称为“响铃”）会向指定接收者发送强提醒推送通知。可用于升级处理需要立即关注的重要消息。

重要：发送紧急通知前，必须先发送消息。你需要获取先前已发送消息的 message_id。

紧急通知类型

类型	描述	费用
app	应用内响铃通知（弹窗 + 声音）	免费
sms	向接收者的手机发送短信推送	可能产生费用
phone	向接收者的手机拨打语音电话	可能产生费用

发送应用内紧急通知（默认）

{
  "message_id": "om_xxx",
  "user_ids": ["ou_xxx"],
  "urgent_type": "app"
}

发送短信紧急通知

{
  "message_id": "om_xxx",
  "user_ids": ["ou_xxx"],
  "urgent_type": "sms"
}

发送电话紧急通知

{
  "message_id": "om_xxx",
  "user_ids": ["ou_xxx"],
  "urgent_type": "phone"
}

多位接收者

{
  "message_id": "om_xxx",
  "user_ids": ["ou_xxx", "ou_yyy", "ou_zzz"],
  "urgent_type": "app"
}

参数

参数	必填	描述
message_id	是	要发送紧急通知的消息 ID（例如，om_xxx）。消息必须已发送。
user_ids	是	要响铃的 open_id 值列表。至少需要 1 位接收者。接收者必须是发送该消息的聊天成员。
urgent_type	否	紧急通知发送方式：app（默认）、sms 或 phone。

响应

{
  "ok": true,
  "message_id": "om_xxx",
  "urgent_type": "app",
  "invalid_user_list": []
}

• invalid_user_list：无法收到紧急通知的用户 ID 列表（例如，不在该聊天中或 ID 无效）。

配置

channels:
  feishu:
    tools:
      urgent: true  # default: true

权限

• im:message.urgent - 发送应用内紧急通知
• im:message.urgent:sms - 发送短信紧急通知（可能产生费用）
• im:message.urgent:phone - 发送电话紧急通知（可能产生费用）

注意事项

• 消息必须已存在：message_id 必须来自已发送的消息。无法为正在编辑的消息发送紧急通知。
• 接收者必须是聊天成员：user_ids 中的用户必须是发送原始消息的聊天成员。
• 配额限制：紧急通知有配额限制（尤其是 sms 和 phone）。错误 230024（“Reach the upper limit of urgent message”）表示配额已用尽。请联系租户管理员，或查看飞书管理后台 > 费用中心 > 配额。
• 无效用户 ID：如果任一 user_id 无效（未找到或不在该聊天中），将返回 HTTP 400 错误。
• 费用提醒：sms 和 phone 类型可能会产生租户费用。免费通知请使用 app（默认）。