用途:为 Instantly 已记录的事件类型构建接收端,不假设未公开的签名或重试契约,并记录假设、证据、审批状态与回滚责任人,便于他人复现。
主要能力:事件包含 workspace、campaign、timestamp、event_type 及可选的 lead/email/reply 内容;自定义标签可能作为 event_type 出现。API 支持列表、创建、补丁、删除、测试、恢复、事件类型发现与投递事件可观测性。
使用方式:用 Read、Glob、Grep 检查代码与配置;WebFetch 仅用于 Instantly 一方文档与包元数据;仅在明确要求且目标文件已知时用 Write/Edit,且不得写入凭据、线索数据、邮件内容或未受限环境输出。认证使用 API v2 密钥,以 Authorization: Bearer <key> 请求 https://api.instantly.ai/api/v2,仅授予端点所需最小作用域,密钥从服务端密钥管理器注入,不得打印、持久化、提交或放入 URL。步骤:获取实时事件类型列表并只选所需事件;审查 HTTPS 目标、数据分级、保留与接收方责任人;按文档字段与最小权限创建 Webhook;校验模式、工作区身份、时间戳边界、负载大小与事件可选字段;用接收方自有稳定指纹去重并异步处理;仅在明确变更审批下使用测试、投递事件聚合与恢复。
限制与审批边界:未经责任人明确批准,不得创建、轮换、泄露或撤销密钥,邀请或移除成员,跨工作区委派,连接发信账户,创建或激活活动,导入或删除线索,更改抑制或保留策略,注册、补丁、恢复或删除 Webhook,调整套餐或付费容量,传输诊断信息或执行其他生产变更。诊断默认只读。错误处理:401 停止并核实密钥存在、有效且未被撤销;403 停止并对照所需作用域,不默认扩大为 all:all;429 协调工作区预算、遵守端点覆盖并限制重试;模式或租户不匹配时失败关闭,保留脱敏证据,不重试变更。输出应包含工作区安全作用域、检查的文件与契约、API v2 路由与所需作用域、证据、校验结果、脱敏字段、剩余风险、责任人、审批状态与回滚或下一步。