用途:把 Salesloft 人员解析与 cadence 注册整合为一个可审计流程,防止演示环境写入、重复人员、误改负责人以及加入未批准 cadence。
主要能力:使用读、Glob、Grep 查找人员解析、cadence 与 CRM 归属代码;仅在需要时用 WebFetch 查阅官方端点文档;在变更边界获批后再写或编辑。契约要点包括:POST /v2/people 需邮箱或电话加姓氏作为唯一查找依据;人员的 do_not_contact 和 contact_restrictions 影响可通信范围与 cadence 步骤;POST /v2/cadence_memberships 需可见的 person_id 与 cadence_id;代同事操作受团队 cadence 归属或 Personal Cadence Admin 权限限制;成员记录可变,可代表后续再注册而非不可变事件历史。
使用方式:先确认团队、人员查找、已批准 cadence、执行用户、同意状态和自有字段;只用文档化的人员筛选器搜索并显式处理零、一或多个候选;若人员不存在,先提交确切创建载荷与端点 content type 待批;重新读取人员并在存在 do_not_contact、不兼容限制或身份歧义时停止;添加新成员前检查当前与历史 cadence 成员记录;在证明 cadence 可见性和执行用户权限后仅创建一个成员;读取回成员状态并保留关联、审批与回滚证据。认证使用租户绑定的 Bearer 凭证,仅申请所需读或写作用域,变更前先证明团队与执行用户身份。
输出:团队、人员解析、同意检查、cadence 与执行用户证明、拟执行或已执行变更、写后读取状态和回滚负责人。
限制与错误处理:创建或更新人员、注册 cadence 均为实时 CRM 变更,需对目标和载荷显式批准,不得绕过同意、联系限制、同事权限或歧义匹配。多人匹配时停止并要求稳定外部标识;403 检查作用域、可见性、cadence 归属与执行用户权限;422 保留字段错误并只修正获批字段;成员待处理时不要再次提交,轮询现有记录。示例证据:team=staging; person=resolved; consent=pass; cadence=approved; action=awaiting-approval。