SuperAPI AI 工具集

iblai-api-notification

办公与效率

查看项目

更新于 10-15 22:16

技能介绍

用途:通过 ibl.ai 平台 API 读取和发送组织通知,涵盖未读数、通知列表、已读/删除操作、两步式通知构建器,以及通知偏好、推送令牌、模板与 SMTP 配置管理。

主要能力:读取未读计数与带状态、渠道、排除渠道、日期、标签筛选的通知列表;标记指定通知为已读/未读、全部标记已读、批量统一状态、删除通知;两步构建器(validate_source 校验来源、preview 解析收件人返回 build_id、send 发送或定时发送);来源类型含 email、username、platform、csv、department、pathway、program、usergroup;管理平台模板(列表、详情、标签、编辑、开关、重置、发送测试渲染);管理用户通知偏好(邮件/推送开关、频率、按类型开关)与 FCM 推送设备注册/注销;组织管理员可测试 SMTP 配置。

使用方式:基础地址 https://api.iblai.app,路径前缀 /dm/api/notification/v1/,每个请求带 Authorization: Api-Token $IBLAI_API_KEY 头。路径变量 {org}=$IBLAI_ORG、{username}=$IBLAI_USERNAME、{platform_key} 通常为 $IBLAI_ORG。未连接时先运行 /iblai-api-login 以填充 IBLAI_ORG、IBLAI_USERNAME、IBLAI_API_KEY。发送前需先 preview 取得 build_id,再调用 send。

限制与注意:发送通知、发送测试邮件与测试 SMTP 均会向外部真实发送,执行前需与用户确认收件人;mark-all-as-read 与 bulk-update 语义不同;模板 toggle(组织级开关)与用户级 notification-preferences 是两回事;标记已读与偏好/模板互不相同。部分字段只读,如 is_inherited、is_enabled、source_platform、can_customize、available_context 及 *_config 对象。具体权限、错误处理与参考细节暂未在资料中完整提供。