# Webhook Management

配置接收 Webhook 事件的团队回调地址

 - [POST /webhook/config](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookconfigpost.md): 新增或替换团队的 Webhook 配置。 - **前置条件**：`callbackUrl` 必须是 1 到 1024 个字符的 HTTPS 地址，带主机名，不含用户信息与片段，端口合法。它解析到的每个地址都必须是公网可路由的；localhost、内网、链路本地、CGNAT、云元数据、协议保留、文档示例与 6to4 等范围会被拒绝。实际建连时会再校验一次，因此某个域名若之后解析到内网范围，只会导致该
 - [POST cloud_phone.power_on](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudphonepoweron.md): 在开机得到最终结果后发送。 只有当操作完成回调成功且本地同步已提交时，`success` 才为 `true`。开机计费失败，或异步代理检测失败并完成失败收尾时，都报告开机失败，且不会另外产生关机事件。安装预设应用等已推迟的后置任务不改变该结果。 若开机过程被关机操作打断，本次尝试不产生开机事件；随后真正关机成功时仍会产生独立的 `cloud_phone.power_off`。
 - [POST cloud_phone.power_off](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudphonepoweroff.md): 在关机成功时发送。关机失败不会产生该事件，因此这里的 `result.success` 恒为 `true`。 `data.reason` 记录关机原因。
 - [POST cloud_phone.restart](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudphonerestart.md): 在重启得到最终结果后发送。只有当操作完成回调成功且本地同步已提交时，`success` 才为 `true`。
 - [POST cloud_phone.reset](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudphonereset.md): 在重置得到最终结果后发送。只有当操作完成回调成功且本地同步已提交时，`success` 才为 `true`。
 - [POST cloud_phone.new_machine](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudphonenewmachine.md): 在一键新机操作得到最终结果后发送。只有当操作完成回调成功且本地同步已提交时，`success` 才为 `true`。
 - [POST cloud_browser.start](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudbrowserstart.md): 在云浏览器开启得到最终结果后发送。
 - [POST cloud_browser.stop](https://guide.morelogin.com/zh/api-reference/shared-resources/open-api/webhook-management/webhookcloudbrowserstop.md): 云浏览器每次关闭尝试都会发送，无论成功与否。进入关闭失败状态本身就是该次尝试的失败结果；随后的人工重试或强制释放属于新操作，会产生新的 `eventId`。 事件按关闭操作去重，因此同一次尝试不会产生两个事件，两次尝试也不会被合并。内部归档失败只影响 `result`，绝不覆盖关闭流程开始时固化的 `reason`。
