knowledge-work-plugins 之 Zoom Phone 文档来源图谱官方文档爬取、页面清单与技能内页映射实战指南【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本文是一份围绕 Zoom Phone 集成技能目录内source-map.md即文档来源图谱展开的实战指南。它记录了这一技能中全部参考资料的真实出处——从 Zoom Phone 官方开发者文档站点抓取得到的页面清单、抓取配置以及官方页面 → 技能内页的完整映射关系。读完本文你将掌握如何在 partner-built/zoom-plugin/skills/phone 目录中快速定位 OAuth 配置、Smart Embed 事件、呼叫处理 API、API/Webhook 迁移时间线等关键资料并直接获得可落地的环境变量清单、事件契约与迁移安全编码范式。什么是文档来源图谱source-map.md 的定位在 partner-built/zoom-plugin/skills/phone/references/source-map.md 这份文件中记录了三类核心信息爬取来源技能内参考资料源自 Zoom Phone 官方开发者文档站点developers.zoom.us/docs/phone/区域即由官方文档爬取而来而非社区二手资料抓取配置使用深度10、并发10的抓取参数并显式排除了 Android 相关内容保证资料聚焦于 Web 与通用平台场景映射关系将 12 个被处理的官方页面映射到技能目录内 5 类内部文档形成官方主题 → 技能内页的可检索索引。这张图的价值在于当开发者遇到这个 API 是干什么的官方文档改版后我的代码该往哪里查等问题时无需回到官方站点重新漫游直接通过映射表即可命中技能目录中经过提炼、整理且附带工程实践的对应文档。官方页面清单12 个处理过的文档页面source-map 记录了从官方站点抓取并处理过的 12 个页面它们是技能内页内容的事实依据。结合页面命名与映射关系各页面主题可以归纳如下官方页面文件名主题由命名与映射推断start.md接入 Zoom Phone 的起步指引对应应用创建与 OAuth 基础流程create-app.md在 Marketplace 创建应用first-app.md首个应用的上手流程integrate-with-zoom-phone.md与 Zoom Phone 进行集成的整体路径call-handling.md呼叫处理call handling管理 API 主题call-data.md通话数据call data相关能力outbound-call.md外呼outbound call能力outbound-sms.md外发短信outbound SMS能力smart-embed.mdSmart Embed 嵌入方案smart-embed-guide.mdSmart Embed 使用指南migrate.mdAPI 迁移主题webhook-migrate.mdWebhook 迁移主题可以看到官方页面的覆盖维度非常完整应用创建与授权、嵌入式软电话Smart Embed、呼叫数据与呼叫处理、外呼与短信、迁移——这正是 Zoom Phone 集成的全部主干场景。页面到技能内页的映射总览source-map 给出了 5 条核心映射是理解整个技能目录组织结构的关键官方主题映射到的技能内页应用创建 OAuthSKILL.md、environment-variables.mdSmart Embed 生命周期 / 事件smart-embed-postmessage-bridge.md、smart-embed-event-contract.md呼叫处理管理 APIcall-handling-patterns.mdAPI / Webhook 迁移时间线deprecations-and-migrations.mdCRM 示例校验crm-sample-validation.md下面逐条展开映射背后的工程细节。映射详解一应用创建与 OAuthstart.md、create-app.md、first-app.md、integrate-with-zoom-phone.md四个页面共同回答如何创建应用并完成授权。技能目录将其收敛为两份文档SKILL.md 定义了整个技能的行为框架build-zoom-phone-integration触发词覆盖zoom phone、zoom phone api、call history、call handling等并给出路由护栏Routing Guardrail——需要嵌入式软电话用 Smart Embed需要通话记录/分析/自动化用 REST API 与 Webhook需要从外部 UI 发起点击拨号/短信用 URI schemezoomphonecall://、zoomphonesms://environment-variables.md 给出标准化的.env键位可直接作为项目配置模板变量是否必需用途取值来源ZOOM_CLIENT_ID是OAuth 应用身份Phone API 使用Zoom Marketplace → General OAuth app → App CredentialsZOOM_CLIENT_SECRET是OAuth 令牌交换Zoom Marketplace → General OAuth app → App CredentialsZOOM_REDIRECT_URI是用户 OAuthOAuth 回调地址Zoom Marketplace → OAuth redirect/allow listZOOM_ACCOUNT_ID可选S2S 模式账户级服务集成Zoom Marketplace → Server-to-Server OAuth app credentialsZOOM_WEBHOOK_SECRET/WEBHOOK_SECRET_TOKEN推荐Webhook 签名校验Zoom Marketplace → Features → Event Subscriptions → Secret TokenZOOM_PHONE_SMART_EMBED_URL可选Smart Embed iframe URL 覆盖Zoom Phone Smart Embed 文档applications.zoom.us路径ZOOM_PHONE_SMART_EMBED_ORIGIN推荐允许的 postMessage 来源固定为https://applications.zoom.us该文档还补充了常见运行时键NEXTAUTH_URL、NEXTAUTH_SECRET、PORT、NODE_ENV并给出三条纪律OAuth 密钥仅存服务端Smart Embed 的批准域名在 Marketplace 应用设置中配置而非.env修改 scope 后需重新授权应用。OAuth 令牌生命周期的完整细节可继续链式查阅 oauth/SKILL.md。映射详解二Smart Embed 生命周期与事件smart-embed.md与smart-embed-guide.md两个页面被映射到两份深度文档。Smart Embed 是基于window.postMessage的嵌入式软电话方案可靠性的关键在于初始化顺序与 origin 校验。smart-embed-event-contract.md 记录了完整事件契约初始化与命令消息zp-init-config、zp-make-call、zp-input-sms、zp-contact-search-response、zp-contact-match-response核心事件类型zp-call-ringing-event、zp-call-connected-event、zp-call-ended-event、zp-call-log-completed-event、zp-call-recording-completed-event、zp-call-voicemail-received-event、zp-ai-call-summary-event、zp-sms-log-event、zp-save-log-event、zp-contact-search-event、zp-contact-match-event、zp-notes-save-event字段级可靠性要点callId在生命周期早期即出现callLogId出现在完成类事件中event.id可用于去重/幂等payload 中可能出现额外标志如enableAutoLog相关行为字段安全与韧性必须校验event.origin https://applications.zoom.us对新出现的可选字段保持宽松解析未知事件类型应记入结构化日志而非直接抛错。smart-embed-postmessage-bridge.md 则给出了可直接复用的桥接代码const ZOOM_ORIGIN https://applications.zoom.us; const iframe document.querySelector(#zoom-embeddable-phone-iframe); function initSmartEmbed(config) { iframe?.contentWindow?.postMessage({ type: zp-init-config, data: config, }, ZOOM_ORIGIN); } function makeCall(number, callerId) { iframe?.contentWindow?.postMessage({ type: zp-make-call, data: { number, callerId, autoDial: true }, }, ZOOM_ORIGIN); } window.addEventListener(message, (event) { if (event.origin ! ZOOM_ORIGIN) return; const payload event.data; if (!payload?.type) return; switch (payload.type) { case zp-call-ringing-event: case zp-call-connected-event: case zp-call-ended-event: case zp-call-log-completed-event: handlePhoneEvent(payload); break; default: break; } });操作要点只有在 iframe 就绪回调之后才能调用 API持久化event.id若存在用于幂等事件分发器需对新增事件类型保持容忍。整个链路在 concepts/architecture-and-lifecycle.md 中有清晰的架构图描述用户/坐席 UI → Smart Embed Iframeapplications.zoom.us→ CRM Web App事件桥 UI 状态→ 后端 API 层OAuth 令牌仅存服务端→ Zoom Phone REST API 与 Webhook 端点。映射详解三呼叫处理管理 APIcall-handling.md被映射到 call-handling-patterns.md用于管理员对用户、自动话务员auto receptionist和呼叫队列call queue的呼叫处理设置进行自动化管理。端点族POST /phone/extension/{extensionId}/call_handling/settings/{settingType}PATCH /phone/extension/{extensionId}/call_handling/settings/{settingType}GET /phone/extension/{extensionId}/call_handling/settings支持的扩展目标用户Users、自动话务员Auto receptionists、呼叫队列Call queues。常见子设置subsettingcustom_hours、holiday、call_handling、call_forwarding面向用户。推荐的实施模式先用GET读取当前设置快照按子设置构建小粒度的、类型化的 PATCH 载荷分别独立更新营业时间/非营业时间/节假日路由对外部电话号码校验 E.164 格式保存旧设置以便回滚。漂移监控点Drift watchpoints枚举/动作值可能演进路由字段名在官方文档不同章节与旧实现之间不一致应保留服务端校验器在 API 调用前拒绝格式错误的呼叫处理载荷。映射详解四API 与 Webhook 迁移时间线migrate.md与webhook-migrate.md被映射到 deprecations-and-migrations.md这是规划数据管线改造时最关键的文档。从官方文档提取的废弃时间线旧版 Call Logs APIv1完全废弃2026 年 4 月旧版 Call Log Webhookv1完全废弃2026 年 5 月旧版数组字段废弃call_log数组于2026 年 11 月、call_path数组于2026 年 11 月。API 迁移映射GET /phone/call_logs→GET /phone/call_historyGET /phone/call_logs/{callLogId}→GET /phone/call_history/{call_history_uuid}GET /phone/call_history_detail/{callHistoryId}→GET /phone/call_element/{call_element_id}Webhook 迁移映射phone.call_log_deleted→phone.call_history_deleted→phone.call_element_deletedphone.callee_call_log_completed→phone.callee_call_history_completed→phone.callee_call_element_completedphone.caller_call_log_completed→phone.caller_call_history_completed→phone.caller_call_element_completed兼容性策略统一存储字段为call_id、call_history_uuid、call_element_id在过渡窗口期为新旧字段名增加适配层所有新功能与 schema 优先采用 v3 命名。与之配套的迁移安全编码范式见 phone-api-service-pattern.mdexport async function getCallHistory(accessToken, from, to) { const qs new URLSearchParams({ from, to }).toString(); const res await fetch(https://api.zoom.us/v2/phone/call_history?${qs}, { headers: { Authorization: Bearer ${accessToken} }, }); if (!res.ok) throw new Error(call_history failed: ${res.status}); const data await res.json(); // Normalize v2/v3 style for downstream code. return (data.call_history || data.call_logs || []).map((row) ({ callHistoryUuid: row.call_history_uuid || row.id, callId: row.call_id, raw: row, })); } export async function getCallElement(accessToken, callElementId) { const res await fetch(https://api.zoom.us/v2/phone/call_element/${callElementId}, { headers: { Authorization: Bearer ${accessToken} }, }); if (!res.ok) throw new Error(call_element failed: ${res.status}); return res.json(); }该模式的目标是将 OAuth 令牌使用隔离在服务端代码中支持当前的 call history / call element 模型在迁移期间兼容旧 payload 字段。操作要点是当命中回退字段call_logs、call_path时显式记录日志迁移完成后移除回退路径。映射详解五CRM 示例校验官方文档中关于 CRM 集成示例的内容被映射到 crm-sample-validation.md。该文档用于对 CRM 集成示例进行校验配合 SKILL.md 中提及的 CRM 示例参考一起使用确保 CRM 软电话面板、联系人搜索/匹配回调等集成实现符合官方示例的行为预期。如何在实际集成中使用这张图source-map 的最终价值体现在与技能目录其他文档配合使用时。建议的阅读与使用路径与 SKILL.md 的 Quick Links 一致concepts/architecture-and-lifecycle.md —— 先建立整体架构与生命周期认知scenarios/high-level-scenarios.md —— 8 个高层场景CRM 软电话、表格点击拨号、SMS 跟进自动化、通话处置与备注管线、实时主管看板、通话历史现代化、呼叫处理管理自动化、Phone Contact Center 混合旅程references/deprecations-and-migrations.md —— 迁移时间线references/forum-top-questions.md —— 社区高频问题references/smart-embed-event-contract.md 与 examples/smart-embed-postmessage-bridge.md —— Smart Embed 事件与桥接references/call-handling-patterns.md —— 呼叫处理管理 APIreferences/environment-variables.md ——.env配置references/crm-sample-validation.md 与 troubleshooting/common-issues.md —— 校验与排障RUNBOOK.md —— 快速预检清单。其中通用生命周期模式Common Lifecycle Pattern可概括为准备账户前置条件Phone 许可、管理员配置、SMS 就绪→ 在 Marketplace 创建 OAuth 应用并配置 scopes → 选择集成面Smart Embed / REST Webhook / URI 启动→ 捕获实时事件 → 持久化并关联通话标识call_id、call_history_uuid、call_element_id→ 应用迁移安全的数据映射v1 → v2 → v3→ 加固安全origin 校验、Webhook 签名校验、最小权限 scopes。上线前的 5 分钟预检清单RUNBOOK.md 提供了深度调试前的快速预检框架结合 source-map 的主题映射可以高效定位问题产品前置Zoom Phone 许可已分配、管理员可访问 Phone 设置、如需 SMS 则 10DLC/SMS 配置完成应用与 OAuth应用类型为 General OAuth用户/管理员流程、Redirect URI 与白名单精确且最新、必需的 Phone scopes 已添加、scope 变更后已重新安装/授权集成面Smart Embed 的 iframe/脚本已加载且批准域名已配置API/Webhook 的 access token 有效且端点可达URI 启动使用受支持的 scheme 且客户端已登录事件/数据关联持久化call_id实时事件、call_history_uuid与call_element_id事后查询、保留重复事件投递的幂等逻辑迁移姿态不在旧版 v1 call logs 上构建新功能、Webhook 消费者已准备好call_element事件名与字段、存在旧/新 payload 形状的字段映射适配器安全控制Smart EmbedpostMessage强制可信 origin、Webhook 签名用 Secret Token 校验、OAuth 密钥仅存服务端。快速决策树同样值得收藏iframe 可见但无事件 → 初始化顺序缺失或 origin 过滤错误OAuth 正常但 API 返回 401/403 → scope 不匹配或授权过期端点/事件升级后数据管线中断 → 缺少 v2/v3 字段映射点击 URI 无响应 → 平台/客户端状态不受支持或 scheme 错误。结语source-map 看似只是一张索引表实则是整个 Zoom Phone 技能目录的知识寻址层它把官方文档的 12 个页面、抓取配置与 5 类主题映射固化在仓库中让后续的 Agent 与开发者都能以最低成本定位到 SKILL.md、environment-variables.md、smart-embed-event-contract.md、call-handling-patterns.md 与 deprecations-and-migrations.md 等实战文档。在动手实现 Zoom Phone 集成之前先读懂这张图能让你的排查路径与官方文档演进保持一致。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 knowledge-work-plugins 之 Zoom Phone 文档来源图谱：官方文档爬取、页面清单与技能内页映射实战指南
knowledge-work-plugins 之 Zoom Phone 文档来源图谱官方文档爬取、页面清单与技能内页映射实战指南【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins本文是一份围绕 Zoom Phone 集成技能目录内source-map.md即文档来源图谱展开的实战指南。它记录了这一技能中全部参考资料的真实出处——从 Zoom Phone 官方开发者文档站点抓取得到的页面清单、抓取配置以及官方页面 → 技能内页的完整映射关系。读完本文你将掌握如何在 partner-built/zoom-plugin/skills/phone 目录中快速定位 OAuth 配置、Smart Embed 事件、呼叫处理 API、API/Webhook 迁移时间线等关键资料并直接获得可落地的环境变量清单、事件契约与迁移安全编码范式。什么是文档来源图谱source-map.md 的定位在 partner-built/zoom-plugin/skills/phone/references/source-map.md 这份文件中记录了三类核心信息爬取来源技能内参考资料源自 Zoom Phone 官方开发者文档站点developers.zoom.us/docs/phone/区域即由官方文档爬取而来而非社区二手资料抓取配置使用深度10、并发10的抓取参数并显式排除了 Android 相关内容保证资料聚焦于 Web 与通用平台场景映射关系将 12 个被处理的官方页面映射到技能目录内 5 类内部文档形成官方主题 → 技能内页的可检索索引。这张图的价值在于当开发者遇到这个 API 是干什么的官方文档改版后我的代码该往哪里查等问题时无需回到官方站点重新漫游直接通过映射表即可命中技能目录中经过提炼、整理且附带工程实践的对应文档。官方页面清单12 个处理过的文档页面source-map 记录了从官方站点抓取并处理过的 12 个页面它们是技能内页内容的事实依据。结合页面命名与映射关系各页面主题可以归纳如下官方页面文件名主题由命名与映射推断start.md接入 Zoom Phone 的起步指引对应应用创建与 OAuth 基础流程create-app.md在 Marketplace 创建应用first-app.md首个应用的上手流程integrate-with-zoom-phone.md与 Zoom Phone 进行集成的整体路径call-handling.md呼叫处理call handling管理 API 主题call-data.md通话数据call data相关能力outbound-call.md外呼outbound call能力outbound-sms.md外发短信outbound SMS能力smart-embed.mdSmart Embed 嵌入方案smart-embed-guide.mdSmart Embed 使用指南migrate.mdAPI 迁移主题webhook-migrate.mdWebhook 迁移主题可以看到官方页面的覆盖维度非常完整应用创建与授权、嵌入式软电话Smart Embed、呼叫数据与呼叫处理、外呼与短信、迁移——这正是 Zoom Phone 集成的全部主干场景。页面到技能内页的映射总览source-map 给出了 5 条核心映射是理解整个技能目录组织结构的关键官方主题映射到的技能内页应用创建 OAuthSKILL.md、environment-variables.mdSmart Embed 生命周期 / 事件smart-embed-postmessage-bridge.md、smart-embed-event-contract.md呼叫处理管理 APIcall-handling-patterns.mdAPI / Webhook 迁移时间线deprecations-and-migrations.mdCRM 示例校验crm-sample-validation.md下面逐条展开映射背后的工程细节。映射详解一应用创建与 OAuthstart.md、create-app.md、first-app.md、integrate-with-zoom-phone.md四个页面共同回答如何创建应用并完成授权。技能目录将其收敛为两份文档SKILL.md 定义了整个技能的行为框架build-zoom-phone-integration触发词覆盖zoom phone、zoom phone api、call history、call handling等并给出路由护栏Routing Guardrail——需要嵌入式软电话用 Smart Embed需要通话记录/分析/自动化用 REST API 与 Webhook需要从外部 UI 发起点击拨号/短信用 URI schemezoomphonecall://、zoomphonesms://environment-variables.md 给出标准化的.env键位可直接作为项目配置模板变量是否必需用途取值来源ZOOM_CLIENT_ID是OAuth 应用身份Phone API 使用Zoom Marketplace → General OAuth app → App CredentialsZOOM_CLIENT_SECRET是OAuth 令牌交换Zoom Marketplace → General OAuth app → App CredentialsZOOM_REDIRECT_URI是用户 OAuthOAuth 回调地址Zoom Marketplace → OAuth redirect/allow listZOOM_ACCOUNT_ID可选S2S 模式账户级服务集成Zoom Marketplace → Server-to-Server OAuth app credentialsZOOM_WEBHOOK_SECRET/WEBHOOK_SECRET_TOKEN推荐Webhook 签名校验Zoom Marketplace → Features → Event Subscriptions → Secret TokenZOOM_PHONE_SMART_EMBED_URL可选Smart Embed iframe URL 覆盖Zoom Phone Smart Embed 文档applications.zoom.us路径ZOOM_PHONE_SMART_EMBED_ORIGIN推荐允许的 postMessage 来源固定为https://applications.zoom.us该文档还补充了常见运行时键NEXTAUTH_URL、NEXTAUTH_SECRET、PORT、NODE_ENV并给出三条纪律OAuth 密钥仅存服务端Smart Embed 的批准域名在 Marketplace 应用设置中配置而非.env修改 scope 后需重新授权应用。OAuth 令牌生命周期的完整细节可继续链式查阅 oauth/SKILL.md。映射详解二Smart Embed 生命周期与事件smart-embed.md与smart-embed-guide.md两个页面被映射到两份深度文档。Smart Embed 是基于window.postMessage的嵌入式软电话方案可靠性的关键在于初始化顺序与 origin 校验。smart-embed-event-contract.md 记录了完整事件契约初始化与命令消息zp-init-config、zp-make-call、zp-input-sms、zp-contact-search-response、zp-contact-match-response核心事件类型zp-call-ringing-event、zp-call-connected-event、zp-call-ended-event、zp-call-log-completed-event、zp-call-recording-completed-event、zp-call-voicemail-received-event、zp-ai-call-summary-event、zp-sms-log-event、zp-save-log-event、zp-contact-search-event、zp-contact-match-event、zp-notes-save-event字段级可靠性要点callId在生命周期早期即出现callLogId出现在完成类事件中event.id可用于去重/幂等payload 中可能出现额外标志如enableAutoLog相关行为字段安全与韧性必须校验event.origin https://applications.zoom.us对新出现的可选字段保持宽松解析未知事件类型应记入结构化日志而非直接抛错。smart-embed-postmessage-bridge.md 则给出了可直接复用的桥接代码const ZOOM_ORIGIN https://applications.zoom.us; const iframe document.querySelector(#zoom-embeddable-phone-iframe); function initSmartEmbed(config) { iframe?.contentWindow?.postMessage({ type: zp-init-config, data: config, }, ZOOM_ORIGIN); } function makeCall(number, callerId) { iframe?.contentWindow?.postMessage({ type: zp-make-call, data: { number, callerId, autoDial: true }, }, ZOOM_ORIGIN); } window.addEventListener(message, (event) { if (event.origin ! ZOOM_ORIGIN) return; const payload event.data; if (!payload?.type) return; switch (payload.type) { case zp-call-ringing-event: case zp-call-connected-event: case zp-call-ended-event: case zp-call-log-completed-event: handlePhoneEvent(payload); break; default: break; } });操作要点只有在 iframe 就绪回调之后才能调用 API持久化event.id若存在用于幂等事件分发器需对新增事件类型保持容忍。整个链路在 concepts/architecture-and-lifecycle.md 中有清晰的架构图描述用户/坐席 UI → Smart Embed Iframeapplications.zoom.us→ CRM Web App事件桥 UI 状态→ 后端 API 层OAuth 令牌仅存服务端→ Zoom Phone REST API 与 Webhook 端点。映射详解三呼叫处理管理 APIcall-handling.md被映射到 call-handling-patterns.md用于管理员对用户、自动话务员auto receptionist和呼叫队列call queue的呼叫处理设置进行自动化管理。端点族POST /phone/extension/{extensionId}/call_handling/settings/{settingType}PATCH /phone/extension/{extensionId}/call_handling/settings/{settingType}GET /phone/extension/{extensionId}/call_handling/settings支持的扩展目标用户Users、自动话务员Auto receptionists、呼叫队列Call queues。常见子设置subsettingcustom_hours、holiday、call_handling、call_forwarding面向用户。推荐的实施模式先用GET读取当前设置快照按子设置构建小粒度的、类型化的 PATCH 载荷分别独立更新营业时间/非营业时间/节假日路由对外部电话号码校验 E.164 格式保存旧设置以便回滚。漂移监控点Drift watchpoints枚举/动作值可能演进路由字段名在官方文档不同章节与旧实现之间不一致应保留服务端校验器在 API 调用前拒绝格式错误的呼叫处理载荷。映射详解四API 与 Webhook 迁移时间线migrate.md与webhook-migrate.md被映射到 deprecations-and-migrations.md这是规划数据管线改造时最关键的文档。从官方文档提取的废弃时间线旧版 Call Logs APIv1完全废弃2026 年 4 月旧版 Call Log Webhookv1完全废弃2026 年 5 月旧版数组字段废弃call_log数组于2026 年 11 月、call_path数组于2026 年 11 月。API 迁移映射GET /phone/call_logs→GET /phone/call_historyGET /phone/call_logs/{callLogId}→GET /phone/call_history/{call_history_uuid}GET /phone/call_history_detail/{callHistoryId}→GET /phone/call_element/{call_element_id}Webhook 迁移映射phone.call_log_deleted→phone.call_history_deleted→phone.call_element_deletedphone.callee_call_log_completed→phone.callee_call_history_completed→phone.callee_call_element_completedphone.caller_call_log_completed→phone.caller_call_history_completed→phone.caller_call_element_completed兼容性策略统一存储字段为call_id、call_history_uuid、call_element_id在过渡窗口期为新旧字段名增加适配层所有新功能与 schema 优先采用 v3 命名。与之配套的迁移安全编码范式见 phone-api-service-pattern.mdexport async function getCallHistory(accessToken, from, to) { const qs new URLSearchParams({ from, to }).toString(); const res await fetch(https://api.zoom.us/v2/phone/call_history?${qs}, { headers: { Authorization: Bearer ${accessToken} }, }); if (!res.ok) throw new Error(call_history failed: ${res.status}); const data await res.json(); // Normalize v2/v3 style for downstream code. return (data.call_history || data.call_logs || []).map((row) ({ callHistoryUuid: row.call_history_uuid || row.id, callId: row.call_id, raw: row, })); } export async function getCallElement(accessToken, callElementId) { const res await fetch(https://api.zoom.us/v2/phone/call_element/${callElementId}, { headers: { Authorization: Bearer ${accessToken} }, }); if (!res.ok) throw new Error(call_element failed: ${res.status}); return res.json(); }该模式的目标是将 OAuth 令牌使用隔离在服务端代码中支持当前的 call history / call element 模型在迁移期间兼容旧 payload 字段。操作要点是当命中回退字段call_logs、call_path时显式记录日志迁移完成后移除回退路径。映射详解五CRM 示例校验官方文档中关于 CRM 集成示例的内容被映射到 crm-sample-validation.md。该文档用于对 CRM 集成示例进行校验配合 SKILL.md 中提及的 CRM 示例参考一起使用确保 CRM 软电话面板、联系人搜索/匹配回调等集成实现符合官方示例的行为预期。如何在实际集成中使用这张图source-map 的最终价值体现在与技能目录其他文档配合使用时。建议的阅读与使用路径与 SKILL.md 的 Quick Links 一致concepts/architecture-and-lifecycle.md —— 先建立整体架构与生命周期认知scenarios/high-level-scenarios.md —— 8 个高层场景CRM 软电话、表格点击拨号、SMS 跟进自动化、通话处置与备注管线、实时主管看板、通话历史现代化、呼叫处理管理自动化、Phone Contact Center 混合旅程references/deprecations-and-migrations.md —— 迁移时间线references/forum-top-questions.md —— 社区高频问题references/smart-embed-event-contract.md 与 examples/smart-embed-postmessage-bridge.md —— Smart Embed 事件与桥接references/call-handling-patterns.md —— 呼叫处理管理 APIreferences/environment-variables.md ——.env配置references/crm-sample-validation.md 与 troubleshooting/common-issues.md —— 校验与排障RUNBOOK.md —— 快速预检清单。其中通用生命周期模式Common Lifecycle Pattern可概括为准备账户前置条件Phone 许可、管理员配置、SMS 就绪→ 在 Marketplace 创建 OAuth 应用并配置 scopes → 选择集成面Smart Embed / REST Webhook / URI 启动→ 捕获实时事件 → 持久化并关联通话标识call_id、call_history_uuid、call_element_id→ 应用迁移安全的数据映射v1 → v2 → v3→ 加固安全origin 校验、Webhook 签名校验、最小权限 scopes。上线前的 5 分钟预检清单RUNBOOK.md 提供了深度调试前的快速预检框架结合 source-map 的主题映射可以高效定位问题产品前置Zoom Phone 许可已分配、管理员可访问 Phone 设置、如需 SMS 则 10DLC/SMS 配置完成应用与 OAuth应用类型为 General OAuth用户/管理员流程、Redirect URI 与白名单精确且最新、必需的 Phone scopes 已添加、scope 变更后已重新安装/授权集成面Smart Embed 的 iframe/脚本已加载且批准域名已配置API/Webhook 的 access token 有效且端点可达URI 启动使用受支持的 scheme 且客户端已登录事件/数据关联持久化call_id实时事件、call_history_uuid与call_element_id事后查询、保留重复事件投递的幂等逻辑迁移姿态不在旧版 v1 call logs 上构建新功能、Webhook 消费者已准备好call_element事件名与字段、存在旧/新 payload 形状的字段映射适配器安全控制Smart EmbedpostMessage强制可信 origin、Webhook 签名用 Secret Token 校验、OAuth 密钥仅存服务端。快速决策树同样值得收藏iframe 可见但无事件 → 初始化顺序缺失或 origin 过滤错误OAuth 正常但 API 返回 401/403 → scope 不匹配或授权过期端点/事件升级后数据管线中断 → 缺少 v2/v3 字段映射点击 URI 无响应 → 平台/客户端状态不受支持或 scheme 错误。结语source-map 看似只是一张索引表实则是整个 Zoom Phone 技能目录的知识寻址层它把官方文档的 12 个页面、抓取配置与 5 类主题映射固化在仓库中让后续的 Agent 与开发者都能以最低成本定位到 SKILL.md、environment-variables.md、smart-embed-event-contract.md、call-handling-patterns.md 与 deprecations-and-migrations.md 等实战文档。在动手实现 Zoom Phone 集成之前先读懂这张图能让你的排查路径与官方文档演进保持一致。【免费下载链接】knowledge-work-pluginsOpen source repository of plugins primarily intended for knowledge workers to use in Claude Cowork项目地址: https://gitcode.com/GitHub_Trending/kn/knowledge-work-plugins创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考