Feishu Urgent Tool

Single tool feishu_urgent for sending urgent (buzz) notifications to recipients for an already-sent message.

Overview

Urgent notifications (also called "buzz" in Feishu) send a strong push notification to specified recipients. Use this to escalate important messages that require immediate attention.

Important: The message must already be sent before sending an urgent notification. You need the message_id from a previously sent message.

Urgency Types

Type	Description	Cost
`app`	In-app buzz notification (popup + sound)	Free
`sms`	SMS push to recipient's phone	May incur cost
`phone`	Voice call to recipient's phone	May incur cost

Send App Urgent (Default)

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

Send SMS Urgent

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

Send Phone Call Urgent

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

Multiple Recipients

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

Parameters

Parameter	Required	Description
`message_id`	Yes	Message ID to send urgent notification for (e.g., `om_xxx`). The message must already be sent.
`user_ids`	Yes	List of `open_id` values to buzz. Minimum 1 recipient. Recipients must be members of the chat where the message was sent.
`urgent_type`	No	Urgency delivery method: `app` (default), `sms`, or `phone`.

Response

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

invalid_user_list: List of user IDs that could not receive the urgent notification (e.g., not in the chat, or invalid ID).

Configuration

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

Permissions

im:message.urgent - Send in-app urgent notifications
im:message.urgent:sms - Send SMS urgent notifications (may incur cost)
im:message.urgent:phone - Send phone call urgent notifications (may incur cost)

Notes

Message must exist: The message_id must be from a message that has already been sent. You cannot send urgent notifications for messages being composed.
Recipients must be chat members: Users in user_ids must be members of the chat where the original message was sent.
Quota limits: Urgent notifications have quotas (especially sms and phone). Error 230024 ("Reach the upper limit of urgent message") indicates quota exhausted. Contact your tenant admin or check Feishu admin console > Cost Center > Quota.
Invalid user IDs: Returns HTTP 400 error if any user_id is invalid (not found or not in the chat).
Cost warning: sms and phone types may incur costs on the tenant. Use app (default) for free notifications.

feishu-urgent