build-zoom-phone-integration
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.
下記のコマンドをコピーしてターミナル(Mac/Linux)または PowerShell(Windows)に貼り付けてください。 ダウンロード → 解凍 → 配置まで全自動。
mkdir -p ~/.claude/skills && cd ~/.claude/skills && curl -L -o build-zoom-phone-integration.zip https://jpskill.com/download/22696.zip && unzip -o build-zoom-phone-integration.zip && rm build-zoom-phone-integration.zip
$d = "$env:USERPROFILE\.claude\skills"; ni -Force -ItemType Directory $d | Out-Null; iwr https://jpskill.com/download/22696.zip -OutFile "$d\build-zoom-phone-integration.zip"; Expand-Archive "$d\build-zoom-phone-integration.zip" -DestinationPath $d -Force; ri "$d\build-zoom-phone-integration.zip"
完了後、Claude Code を再起動 → 普通に「動画プロンプト作って」のように話しかけるだけで自動発動します。
💾 手動でダウンロードしたい(コマンドが難しい人向け)
- 1. 下の青いボタンを押して
build-zoom-phone-integration.zipをダウンロード - 2. ZIPファイルをダブルクリックで解凍 →
build-zoom-phone-integrationフォルダができる - 3. そのフォルダを
C:\Users\あなたの名前\.claude\skills\(Win)または~/.claude/skills/(Mac)へ移動 - 4. Claude Code を再起動
⚠️ ダウンロード・利用は自己責任でお願いします。当サイトは内容・動作・安全性について責任を負いません。
🎯 このSkillでできること
下記の説明文を読むと、このSkillがあなたに何をしてくれるかが分かります。Claudeにこの分野の依頼をすると、自動で発動します。
📦 インストール方法 (3ステップ)
- 1. 上の「ダウンロード」ボタンを押して .skill ファイルを取得
- 2. ファイル名の拡張子を .skill から .zip に変えて展開(macは自動展開可)
- 3. 展開してできたフォルダを、ホームフォルダの
.claude/skills/に置く- · macOS / Linux:
~/.claude/skills/ - · Windows:
%USERPROFILE%\.claude\skills\
- · macOS / Linux:
Claude Code を再起動すれば完了。「このSkillを使って…」と話しかけなくても、関連する依頼で自動的に呼び出されます。
詳しい使い方ガイドを見る →- 最終更新
- 2026-05-18
- 取得日時
- 2026-05-18
- 同梱ファイル
- 8
📖 Skill本文(日本語訳)
※ 原文(英語/中国語)を Gemini で日本語化したものです。Claude 自身は原文を読みます。誤訳がある場合は原文をご確認ください。
/build-zoom-phone-integration
API、Webhook、Smart Embed、およびURI起動ワークフローを横断するZoom Phone連携に関する背景情報です。
API、Webhook/イベント、Smart Embed、およびURI起動ワークフローを横断するZoom Phone連携の実装ガイダンスです。
公式ドキュメント:
ルーティングのガードレール
- ユーザーがWebアプリに組み込みのソフトフォン動作を必要とする場合、Smart Embedを使用します(examples/smart-embed-postmessage-bridge.md)。
- ユーザーが通話記録、分析、または自動化を必要とする場合、Phone REST APIとWebhooksを使用します(references/deprecations-and-migrations.md)。
- ユーザーが外部UIからのクリック・トゥ・ダイヤル/SMS起動を必要とする場合、URIスキーム(
zoomphonecall://、zoomphonesms://)を使用します。 - ユーザーがZoom PhoneとContact Centerを併用する場合、../contact-center/SKILL.mdと連携させます。
クイックリンク
ここから始めます:
- 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
共通のライフサイクルパターン
- アカウントの前提条件をプロビジョニングします(Zoom Phoneライセンス、管理者設定、SMS準備)。
- MarketplaceでOAuthアプリとスコープを作成します。
- 連携インターフェースを選択します:
- Smart Embed (iframe + postMessage)
- REST + webhooks
- URI起動 (
callto,tel,zoomphonecall,zoomphonesms)
- リアルタイムイベントをキャプチャします(Smart Embedイベントおよび/またはWebhooks)。
- 通話識別子を永続化し、レコードを関連付けます(
call_id、call_history_uuid、call_element_id)。 - 移行に安全なデータマッピング(v1 -> v2 -> v3)を適用し、名前変更されたフィールドを処理します。
- セキュリティを強化します(オリジン検証、Webhook署名検証、最小権限スコープ)。
高レベルのシナリオ
- Smart Embed + コンタクト検索/マッチコールバックを使用したCRMソフトフォンペイン。
zp-make-callを介したアカウント/コンタクトテーブルからのクリック・トゥ・コール。zp-save-log-eventとカスタムノートページを使用した通話処理ワークフロー。zoomphonesms://とzp-sms-log-eventを使用したSMSエンゲージメントワークフロー。phone.*Webhookイベントによって駆動されるリアルタイム運用ボード。- レガシー通話ログから通話履歴/通話要素への通話分析移行。
- ユーザー/自動受付/コールキューの通話処理設定のための管理者自動化。
詳細はscenarios/high-level-scenarios.mdをご覧ください。
チェーン
- OAuthセットアップ/トークンライフサイクル: ../oauth/SKILL.md
- RESTを介した電話およびアカウントリソース: ../rest-api/SKILL.md
- イベント配信と署名検証: ../webhooks/SKILL.md
- コンタクトセンターのブレンドジャーニー: ../contact-center/SKILL.md
環境変数
- 標準化された
.envキーと各値の検索場所については、references/environment-variables.mdをご覧ください。
📜 原文 SKILL.md(Claudeが読む英語/中国語)を展開
/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.
同梱ファイル
※ ZIPに含まれるファイル一覧。`SKILL.md` 本体に加え、参考資料・サンプル・スクリプトが入っている場合があります。
- 📄 SKILL.md (4,280 bytes)
- 📎 references/call-handling-patterns.md (961 bytes)
- 📎 references/crm-sample-validation.md (1,416 bytes)
- 📎 references/deprecations-and-migrations.md (1,192 bytes)
- 📎 references/environment-variables.md (1,363 bytes)
- 📎 references/forum-top-questions.md (3,793 bytes)
- 📎 references/smart-embed-event-contract.md (1,025 bytes)
- 📎 references/source-map.md (888 bytes)