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
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.