
Zoom Phone Integration
OfficialFreeSeamlessly integrate Zoom Phone into your applications.
Free · Opens the source repo
What Zoom Phone Integration does
The Zoom Phone Integration skill provides comprehensive guidance for developers looking to incorporate Zoom Phone functionalities into their applications. This skill serves as a reference for implementing various integration methods, including API calls, webhooks, Smart Embed events, and URI-launch workflows. It is designed to streamline the process of connecting your applications with Zoom Phone services, ensuring that you can leverage the full capabilities of the platform effectively.
This skill includes detailed implementation guidance, helping you navigate the complexities of OAuth setups, phone APIs, and call handling automation. It outlines the necessary prerequisites, such as obtaining a Zoom Phone license and setting up the required OAuth applications. Furthermore, it offers insights into choosing the right integration surface, whether it be through Smart Embed for embedded softphone behavior or REST APIs for more extensive call management functionalities.
Developers and designers can utilize this skill to create a variety of use cases, from CRM softphone implementations to click-to-call functionalities. The provided examples and scenarios illustrate how to effectively capture real-time events and manage call records, ensuring a smooth user experience. By following the structured guidance, you can also ensure that your integration adheres to security best practices, such as origin validation and webhook signature validation.
Whether you are building a new application or enhancing an existing one, the Zoom Phone Integration skill equips you with the knowledge and resources necessary to create robust and efficient phone integration solutions.
When to use it
Use this skill when you need to implement Zoom Phone functionalities in your applications, such as call handling, CRM integration, or automated workflows.
When not to use it
This skill may not be suitable for users looking for basic Zoom Phone usage without any integration or for those not familiar with API and webhooks.
What you can build with it
CRM Softphone Integration
Implement a softphone pane in your CRM using Smart Embed to enable direct calling features.
Click-to-Dial Functionality
Enable click-to-call from your application by utilizing URI schemes like `zoomphonecall://`.
Real-Time Call Analytics
Capture and analyze call events in real-time using webhook events to enhance operational insights.
How to install Zoom Phone Integration
View source1. Install with the skills CLI
npx skills add anthropics/knowledge-work-plugins/phone --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by anthropics/build-zoom-phone-integration
Background reference for Zoom Phone integrations across API, webhook, Smart Embed, and URI-launch workflows.
Implementation guidance for Zoom Phone integrations across API, webhook/event, Smart Embed, and URI-launch workflows.
Official docs:
- https://developers.zoom.us/docs/phone/
- CRM sample reference: https://github.com/zoom/CRM-Sample
Routing Guardrail
- If the user needs embedded softphone behavior in a web app, use Smart Embed (examples/smart-embed-postmessage-bridge.md).
- If the user needs call records, analytics, or automation, use Phone REST API and webhooks (references/deprecations-and-migrations.md).
- If the user needs click-to-dial/SMS launch from external UI, use URI schemes (
zoomphonecall://,zoomphonesms://). - If the user mixes Zoom Phone and Contact Center, chain with ../contact-center/SKILL.md.
Quick Links
Start here:
- concepts/architecture-and-lifecycle.md
- scenarios/high-level-scenarios.md
- references/deprecations-and-migrations.md
- references/forum-top-questions.md
- references/smart-embed-event-contract.md
- references/call-handling-patterns.md
- references/environment-variables.md
- references/crm-sample-validation.md
- troubleshooting/common-issues.md
- RUNBOOK.md
- examples/smart-embed-postmessage-bridge.md
- examples/phone-api-service-pattern.md
- references/source-map.md
Common Lifecycle Pattern
- Provision account prerequisites (Zoom Phone license, admin setup, SMS readiness).
- Create OAuth app and scopes in Marketplace.
- Choose integration surface:
- Smart Embed (iframe + postMessage)
- REST + webhooks
- URI launch (
callto,tel,zoomphonecall,zoomphonesms)
- Capture real-time events (Smart Embed events and/or webhooks).
- Persist call identifiers and correlate records (
call_id,call_history_uuid,call_element_id). - Apply migration-safe data mapping (v1 -> v2 -> v3) and handle renamed fields.
- Harden security (origin validation, webhook signature validation, least-privilege scopes).
High-Level Scenarios
- CRM softphone pane using Smart Embed + contact search/match callbacks.
- Click-to-call from account/contact table via
zp-make-call. - Call disposition workflow using
zp-save-log-eventand custom notes page. - SMS engagement workflow with
zoomphonesms://andzp-sms-log-event. - Real-time operational board driven by
phone.*webhook events. - Call analytics migration from legacy call logs to call history/call elements.
- Admin automation for user/auto-receptionist/call-queue call-handling settings.
See scenarios/high-level-scenarios.md for details.
Chaining
- OAuth setup/token lifecycle: ../oauth/SKILL.md
- Phone and account resources via REST: ../rest-api/SKILL.md
- Event delivery and signature validation: ../webhooks/SKILL.md
- Contact Center blended journey: ../contact-center/SKILL.md
Environment Variables
- See references/environment-variables.md for standardized
.envkeys and where to find each value.
Frequently asked questions about Zoom Phone Integration
Similar skills
WinMD API Search
Easily find and explore Windows desktop APIs.
WebMCPify
Transform any web app into an agent-ready platform.
Phoenix Tracing
Instrument LLM applications with OpenInference tracing.
Foundry Hosted Agent CopilotKit
Guidance for developing agentic web apps on Azure.
Power Automate Foundation
Connect AI agents to Power Automate seamlessly.
Power Automate Flow Builder
Efficiently build and deploy Power Automate flows programmatically.
