高級設定

添加IP白名單

白名單用於指定該appKey可接受的推送請求IP地址。 alt text

回調管理

如果企業的業務系統需要獲取「消息狀態」信息，則需要在此配置一個回調地址。消息狀態：發送一條消息後，該消息的發送、送達、已讀等狀態。

進入【高級設置】-【回調管理】頁面，可以進行回調配置，點擊“配置回調”。

alt text

填寫回調描述和回調地址。
勾選回調事件，在所選事件發生後，將信息推送到您設定的回調地址上。
點擊右側消息狀態和消息響應可以查看對應示例。

頻控管理

頻控設置功能支持設置單個設備單日接收推送上限，防止推送過於頻繁騷擾用戶，也支持設置用戶可接收推送的時間段，防止深夜推送滋擾用戶。同時，為了方便企業開發和運營人員根據各類業務場景區分運營，支持區分是否系統類型消息不進行限制。

推送頻率

點擊“啟用”按鈕，並填寫單設備下發推送條數限制，可設置每個用戶每小時/每天/每周最多允許被下發 N 條消息，超過限制直接丟棄。

alt text

可推送時間段

點擊“啟用”按鈕，並選擇可接受推送時間段。不在指定時間段範圍，消息直接丟棄。

alt text

告警設置

推送告警功能用於在推送任務異常（如任務堆積）時，通過郵件或簡訊等方式及時通知開發者，幫助快速發現並處理潛在風險。

功能入口與權限

入口位置

控制台 → 高級設置 → 告警設置

告警指標說明

大目標推送任務堆積

指標含義 當前時間仍未處理完成的大目標推送任務數量

已完成的任務不計入堆積數
大目標定義 單個推送任務的註冊 ID 數 ≥ 系統為當前 AppKey 配置的閾值 （該閾值由系統自動獲取，不同 AppKey 可能不同）

告警規則說明

1. 告警閾值

表示允許的最大任務堆積數
支持用戶自定義
最小值：5
當實時堆積數 ≥ 告警閾值 時，觸發告警判斷

2. 告警頻率

統計週期：每天 00:00:00 – 23:59:59
告警觸發邏輯：
1. 當堆積數首次達到或超過閾值時，立即發送告警
2. 之後系統每 5 分鐘檢測一次
3. 若仍滿足告警條件，則繼續發送告警通知

3. 恢復告警規則

當任務堆積數 降低至告警閾值的 50%系統將自動發送一條恢復告警通知，用於提示當前異常狀態已緩解

基礎設置說明

1. 告警時間

用於限制告警生效的時間範圍。

選項	說明
任何時間	告警在任意時間段內生效
自定義時間	僅在指定時間段內生效，若告警發生在該時間段之外，將被直接丟棄

2. 告警方式

支持以下告警方式（可多選）：

📧 郵件
📱 簡訊
🤖 釘釘機器人
🤖 企業微信機器人
🤖 Telegram 機器人

告警方式	接收信息
郵件	郵箱地址列表
簡訊	手機號列表
釘釘機器人	Webhook 地址
企業微信機器人	Webhook 地址
Telegram 機器人	Bot Token + Chat ID

若選擇多種告警方式，需分別完成各方式的接收信息配置

說明：

使用 EngageLab 內部統一賬號發送
不要求：
- 郵箱地址已註冊 EngageLab 賬號
- 手機號已註冊 EngageLab 賬號

使用說明與注意事項

告警開關開啟後，即表示接受該指標的告警
若未配置告警方式或接收列表，即使開啟告警也不會發送通知
自定義告警時間之外發生的告警將被直接丟棄，不會補發
恢復告警僅在發生過異常告警後才會觸發

FAQ：如何獲取 Telegram 機器人的 Bot Token 和 Chat ID？

在使用 Telegram 機器人告警 前，需要獲取以下兩項信息：

Bot Token：用於標識並授權你的機器人
Chat ID：用於指定告警消息發送的對象（個人或群聊）

一、如何獲取 Bot Token？

在 Telegram 中搜索並打開 @BotFather
發送 /start
發送 /newbot，按提示創建機器人
設置機器人名稱和用戶名（用戶名需以 bot 結尾）
創建成功後，BotFather 會返回一串 Bot Token

示例：

123456789:AAxxxxxxxxxxxxxxxx

              
              123456789:AAxxxxxxxxxxxxxxxx

此代碼塊在浮窗中顯示

⚠️ 請妥善保管 Bot Token，洩露可能導致機器人被他人控制。

二、如何獲取 Chat ID？

方法一：使用工具機器人（推薦）

在 Telegram 中搜索 @userinfobot 或 @get_id_bot
向該機器人發送任意消息
在返回信息中查看 Chat ID

個人 Chat ID 通常為正整數
群聊 Chat ID 通常為負整數（如 -100xxxxxxxxxx）

方法二：通過群聊獲取（適用於群告警）

將你的 Telegram 機器人添加到目標群聊

在群聊中發送一條消息或輸入：

/start@你的機器人用戶名

              
              /start@你的機器人用戶名

此代碼塊在浮窗中顯示

使用以下地址訪問（將 <BOT_TOKEN> 替換為你的 Token）：
https://api.telegram.org/bot<BOT_TOKEN>/getUpdates
```
              
              https://api.telegram.org/bot<BOT_TOKEN>/getUpdates

            
```
此代碼塊在浮窗中顯示
在返回結果中查看 chat.id 字段