feishu-urgent

Feishu 緊急通知ツール

送信済みメッセージの宛先に緊急通知（バズ通知）を送る単一のツール feishu_urgent です。

概要

緊急通知（Feishu では「バズ」とも呼ばれます）は、指定した宛先に強いプッシュ通知を送信します。すぐに対応が必要な重要なメッセージをエスカレーションする際に使用します。

重要：緊急通知を送信する前に、メッセージを送信済みである必要があります。以前に送信したメッセージの message_id が必要です。

緊急通知の種類

種類	説明	費用
app	アプリ内バズ通知（ポップアップ＋サウンド）	無料
sms	宛先の電話に SMS を送信	費用が発生する場合があります
phone	宛先の電話に音声通話を発信	費用が発生する場合があります

アプリ内緊急通知を送信（デフォルト）

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

SMS 緊急通知を送信

{
  "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 - SMS 緊急通知を送信する（費用が発生する場合があります）
• im:message.urgent:phone - 電話による緊急通知を送信する（費用が発生する場合があります）

注意事項

• メッセージが存在している必要があります：message_id は送信済みメッセージのものである必要があります。作成中のメッセージに緊急通知を送ることはできません。
• 宛先はチャットのメンバーである必要があります：user_ids に指定するユーザーは、元のメッセージを送信したチャットのメンバーである必要があります。
• 割り当て上限：緊急通知には割り当て上限があります（特に sms と phone）。エラー 230024（「緊急メッセージの上限に達しました」）は、割り当てを使い切ったことを示します。テナント管理者に問い合わせるか、Feishu 管理コンソールの［Cost Center］>［Quota］を確認してください。
• 無効なユーザー ID：user_id が無効（見つからない、またはチャットに参加していない）な場合、HTTP 400 エラーが返されます。
• 費用に関する注意：sms と phone の種類は、テナントに費用が発生する場合があります。無料で通知するには、デフォルトの app を使用してください。