mcpField
B
build-zoom-phone-integration

build-zoom-phone-integration

github.com/anthropics開発33.6k2.1k 回インストール1 日前に更新
リポジトリ

build-zoom-phone-integration について

API、Webhook、Smart Embed、URI起動を使った Zoom Phone 連携の開発者向けリファレンススキルです。連携のライフサイクル、イベントや通話記録の処理、移行、安全対策を扱います。

主な機能

  1. 01API・Webhook・埋め込み連携のガイダンス
  2. 02クリック発信とSMSのURIパターン
  3. 03リアルタイムイベントの取得
  4. 04通話記録の関連付けと移行
  5. 05セキュリティとOAuth設定のガイダンス

活用シーン

  1. 01CRMへのソフトフォンパネル追加
  2. 02連絡先レコードからの発信
  3. 03Webhook駆動の運用ボード構築
  4. 04通話分析の新しい記録形式への移行

インストール

コマンドをコピーしてターミナルで実行します。

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

インストール後、Claude Code で/build-zoom-phone-integrationを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

RUNBOOK.md
concepts/
architecture-and-lifecycle.md
examples/
phone-api-service-pattern.md
smart-embed-postmessage-bridge.md
references/
call-handling-patterns.md
crm-sample-validation.md
deprecations-and-migrations.md
environment-variables.md
forum-top-questions.md
smart-embed-event-contract.md
source-map.md
scenarios/
high-level-scenarios.md
troubleshooting/
common-issues.md

詳細

/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 と webhook を使用してください（references/deprecations-and-migrations.md）。
  • 外部 UI からクリック発信／SMS 起動が必要な場合は、URI スキーム（zoomphonecall://、zoomphonesms://）を使用してください。
  • Zoom Phone と Contact Center を組み合わせる場合は、../contact-center/SKILL.md と連携してください。

クイックリンク

まずはこちらをご覧ください：

  1. concepts/architecture-and-lifecycle.md
  2. scenarios/high-level-scenarios.md
  3. references/deprecations-and-migrations.md
  4. references/forum-top-questions.md
  5. references/smart-embed-event-contract.md
  6. references/call-handling-patterns.md
  7. references/environment-variables.md
  8. references/crm-sample-validation.md
  9. troubleshooting/common-issues.md
  10. RUNBOOK.md
  11. examples/smart-embed-postmessage-bridge.md
  12. examples/phone-api-service-pattern.md
  13. references/source-map.md

一般的なライフサイクルパターン

  1. アカウントの前提条件を整えます（Zoom Phone ライセンス、管理者による設定、SMS の利用準備）。
  2. Marketplace で OAuth アプリとスコープを作成します。
  3. 連携方法を選択します：
  • Smart Embed（iframe + postMessage）
  • REST + webhook
  • URI 起動（callto、tel、zoomphonecall、zoomphonesms）
  1. リアルタイムイベントを取得します（Smart Embed イベント、webhook、またはその両方）。
  2. 通話識別子を保存し、レコードを関連付けます（call_id、call_history_uuid、call_element_id）。
  3. 移行に安全なデータマッピング（v1 -> v2 -> v3）を適用し、名称が変更されたフィールドに対応します。
  4. セキュリティを強化します（オリジンの検証、webhook 署名の検証、最小権限のスコープ）。

主なシナリオ

  • Smart Embed と連絡先の検索／照合コールバックを使用した CRM ソフトフォンペイン。
  • zp-make-call を使って、アカウント／連絡先テーブルからクリック発信。
  • zp-save-log-event とカスタムのメモページを使用した通話結果の記録ワークフロー。
  • zoomphonesms:// と zp-sms-log-event を使用した SMS 対応ワークフロー。
  • phone.* webhook イベントを利用したリアルタイム運用ボード。
  • レガシーな通話ログから通話履歴／通話要素への通話分析の移行。
  • ユーザー、自動受付、通話キューの通話処理設定に関する管理者向け自動化。

詳細は scenarios/high-level-scenarios.md をご覧ください。

連携先

環境変数

コメント

Markdown 対応