高级设置

添加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 字段