build-zoom-phone-integration

Q: How do I install build-zoom-phone-integration?

Run npx skills add https://github.com/anthropics/knowledge-work-plugins --skill build-zoom-phone-integration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/build-zoom-phone-integration/ (personal) or .claude/skills/build-zoom-phone-integration/ (project).

by anthropics OfficialProductivity & Automation

Reference skill for Zoom Phone. Use after routing to a phone workflow when implementing OAuth, Phone APIs, webhooks, Smart Embed events, URI schemes, CRM or CTI dialers, or call handling automation.

Installs: 2.1K
Last 24h: —
Trending rank: —
Security: Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/anthropics/knowledge-work-plugins --skill build-zoom-phone-integration

01
Install
Run the command in your project. The CLI asks which agents to install for.
02
Describe the task
Ask your agent for something this skill covers. It loads build-zoom-phone-integration automatically when relevant.
03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

/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-event and custom notes page.
SMS engagement workflow with zoomphonesms:// and zp-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 .env keys and where to find each value.

FAQ

What does the build-zoom-phone-integration skill do?

Reference skill for Zoom Phone. Use after routing to a phone workflow when implementing OAuth, Phone APIs, webhooks, Smart Embed events, URI schemes, CRM or CTI dialers, or call handling automation.

How do I install build-zoom-phone-integration?

Run npx skills add https://github.com/anthropics/knowledge-work-plugins --skill build-zoom-phone-integration in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/build-zoom-phone-integration/ (personal) or .claude/skills/build-zoom-phone-integration/ (project).

Which AI agents can use build-zoom-phone-integration?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is build-zoom-phone-integration safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains build-zoom-phone-integration?

It is published by anthropics in anthropics/knowledge-work-plugins, and it is an official skill from the maker of the technology it covers. It has 2,086 recorded installs.