用途:为 Zoom Phone 集成提供背景参考与实现指引,覆盖 API、webhook/事件、Smart Embed 和 URI 启动四类工作流。资料给出官方文档 https://developers.zoom.us/docs/phone/ 及 CRM 示例 https://github.com/zoom/CRM-Sample。
路由建议:需要 Web 应用内嵌软电话行为时用 Smart Embed(examples/smart-embed-postmessage-bridge.md);需要通话记录、分析或自动化时用 Phone REST API 与 webhook(references/deprecations-and-migrations.md);需要从外部 UI 点击拨号/发短信时用 URI 方案 zoomphonecall:// 与 zoomphonesms://;Zoom Phone 与 Contact Center 混用时可链到 ../contact-center/SKILL.md。
生命周期:配置前置条件(Zoom Phone 许可、管理员设置、SMS 就绪)→ 在 Marketplace 创建 OAuth 应用与 scope → 选择集成面(Smart Embed iframe+postMessage、REST+webhook、URI 启动)→ 捕获实时事件 → 持久化并关联 call_id、call_history_uuid、call_element_id → 做 v1→v2→v3 迁移安全的数据映射并处理字段改名 → 加固安全(origin 校验、webhook 签名校验、最小权限 scope)。
场景:CRM 软电话面板结合 Smart Embed 与联系人搜索/匹配回调;账户或联系人表格通过 zp-make-call 点击外呼;用 zp-save-log-event 与自定义备注页做通话处置;用 zoomphonesms:// 与 zp-sms-log-event 做短信互动;基于 phone.* webhook 事件的实时运营看板;旧通话日志向 call history/call elements 的迁移;用户、自动接线员、呼叫队列的通话处理设置管理。
配套技能:OAuth 设置与令牌生命周期 ../oauth/SKILL.md;REST 资源 ../rest-api/SKILL.md;事件投递与签名校验 ../webhooks/SKILL.md;Contact Center ../contact-center/SKILL.md。环境变量键与取值来源见 references/environment-variables.md。其他实现细节与常见问题见 troubleshooting/common-issues.md、RUNBOOK.md 和 references/source-map.md;本资料未提供具体计费、价格等信息。