回调设置

概述

EngageLab OTP 支持回调机制，您可以在关键事件发生时，将相关数据自动推送到您的业务系统，实现自动化运营、异常监控和业务闭环。

配置回调地址后，系统会在以下场景下主动推送事件数据至您的接口：

• 消息生命周期状态变更
• 余额不足、验证率过低等业务告警
• 上行消息接收
• 账号登录、模板变更、API 调用等系统级事件通知

更多回调事件的详细配置说明，请参见 回调配置。

回调配置流程

1. 在【配置管理】-【回调设置】页面，点击“立即配置”或“配置回调地址”，进行EngageLab OTP 服务的回调配置。

2. 填写以下信息

   • 回调描述：自定义设置回调的描述信息，便于区分不同回调用途。
   • 回调地址：必须为公网可访问的 HTTPS 地址。
   • 用户名：回调安全校验机制，选填，建议配置。
   • Authorization：如您的接口需要鉴权，可选择配置此字段。

3. 选择需订阅的回调事件类型，点击右侧消息状态和消息响应可以查看对应示例。

4. 保存后，系统会自动推送选中事件的数据到您的回调地址。 。

回调列表

• 回调地址状态：回调地址下方的标识用于显示该地址当前是否已启用。您可以通过右侧筛选按钮，快速切换展示正常或异常状态的回调地址。
• 事件统计：展示该回调地址已接收的各类事件数量。将鼠标悬停在统计数上，可查看具体的事件标识列表。
• 刷新：点击“刷新”按钮，系统会立即对回调地址发起一次连通性测试，在界面上更新该回调地址的实时状态。
• 删除：点击“删除”按钮，可移除当前回调地址。删除后，该地址将不再接收任何事件通知。

配置事件

点击“配置事件”，进行EngageLab OTP 服务的余额告警配置。 该页面用于自定义各类事件的触发条件。您可以设置超时未验证、验证率过低、余额不足等事件的阈值。

注意：在进行此操作之前，需要先配置回调地址。

设置告警阈值

• 超时未验证：设置用户在多长时间内未完成验证时（如：5 分钟），系统将判定为超时未验证，并触发事件。
• 验证率过低：设置最低可接受的验证率百分比（如：70%）。当实际验证率低于该阈值时，系统会触发“验证率过低”事件。
• 余额不足：输入告警触发阈值（如：$10），当账户余额低于设定阈值时，Bot会自动发送提醒。 注意：单位是美金，且只支持输入正整数。

告警接收方式

• 选择您希望接收告警的渠道：

  • Telegram：

    • 点击 “Telegram” 复选框：

    • 在弹出的窗口中，点击 “START BOT” 按钮完成绑定：

    • 绑定完成后，显示的结果如下：

    • 如果需要修改接收的Telegram账号，也可以点击 “重新获取” 按钮重新设置：

  • Email：

    • 输入接收告警的 Email 地址，最多支持设置5个，中间用英文逗号(,)分隔。

保存设置

• 确保所有配置已完成后，点击页面底部的 “确定” 按钮。
• 系统会提示您设置成功。