build-zoom-phone-integration
Zoom Phone の参照スキルです。OAuth、Phone API、Webhook、Smart Embed イベント、URI スキーム、CRM または CTI ダイヤラー、通話処理の自動化を実装する際に、電話ワークフローへのルーティング後に使用します。
description の原文を見る
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.
SKILL.md 本文
/build-zoom-phone-integration
Zoom Phone インテグレーションに関する背景参考資料です。API、ウェブフック、Smart Embed、URI起動ワークフロー全体をカバーします。
Zoom Phone インテグレーション実装ガイダンスです。API、ウェブフック/イベント、Smart Embed、URI起動ワークフロー全体に対応しています。
公式ドキュメント:
ルーティングガイドライン
- ウェブアプリで組み込みソフトフォン動作が必要な場合は、Smart Embed を使用してください (
examples/smart-embed-postmessage-bridge.md)。 - 通話記録、分析、または自動化が必要な場合は、Phone REST API とウェブフックを使用してください (
references/deprecations-and-migrations.md)。 - 外部 UI からのクリック‐ツー‐ダイヤル/SMS 起動が必要な場合は、URI スキーム (
zoomphonecall://,zoomphonesms://) を使用してください。 - Zoom Phone とコンタクトセンターを組み合わせる場合は、
../contact-center/SKILL.mdと連携させてください。
クイックリンク
ここから開始してください:
concepts/architecture-and-lifecycle.mdscenarios/high-level-scenarios.mdreferences/deprecations-and-migrations.mdreferences/forum-top-questions.mdreferences/smart-embed-event-contract.mdreferences/call-handling-patterns.mdreferences/environment-variables.mdreferences/crm-sample-validation.mdtroubleshooting/common-issues.mdRUNBOOK.mdexamples/smart-embed-postmessage-bridge.mdexamples/phone-api-service-pattern.mdreferences/source-map.md
一般的なライフサイクルパターン
- アカウント前提条件をプロビジョニングします (Zoom Phone ライセンス、管理者セットアップ、SMS 対応)。
- Marketplace で OAuth アプリとスコープを作成します。
- インテグレーション方法を選択します:
- Smart Embed (iframe + postMessage)
- REST + ウェブフック
- URI 起動 (
callto,tel,zoomphonecall,zoomphonesms)
- リアルタイムイベントをキャプチャします (Smart Embed イベントおよび/またはウェブフック)。
- 通話識別子を保存し、レコードを相関させます (
call_id,call_history_uuid,call_element_id)。 - マイグレーション対応データマッピング (v1 → v2 → v3) を適用し、名前が変更されたフィールドを処理します。
- セキュリティを強化します (オリジン検証、ウェブフック署名検証、最小権限スコープ)。
高レベルシナリオ
- Smart Embed + 連絡先検索/一致コールバックを使用した CRM ソフトフォンペイン。
zp-make-call経由でアカウント/連絡先テーブルからのクリック‐ツー‐コール。zp-save-log-eventとカスタムノートページを使用した通話処理フロー。zoomphonesms://とzp-sms-log-eventを使用した SMS エンゲージメントワークフロー。phone.*ウェブフックイベント駆動のリアルタイム運用ダッシュボード。- レガシー通話ログから通話履歴/通話要素への通話分析マイグレーション。
- ユーザー/自動受付員/通話キューの通話処理設定に関する管理自動化。
詳細は 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を参照してください。
ライセンス: Apache-2.0(寛容ライセンスのため全文を引用しています) · 原本リポジトリ
詳細情報
- 作者
- anthropics
- ライセンス
- Apache-2.0
- 最終更新
- 2026/5/8
Source: https://github.com/anthropics/knowledge-work-plugins / ライセンス: Apache-2.0
関連スキル
doubt-driven-development
重要な判断はすべて、本番環境への展開前に新しい視点から対抗的レビューを実施します。速度より正確性が重要な場合、不慣れなコードを扱う場合、本番環境・セキュリティに関わるロジック・取り消し不可の操作など影響度が高い場合、または後でバグを修正するよりも今検証する方が効率的な場合に活用してください。
apprun-skills
TypeScriptを使用したAppRunアプリケーションのMVU設計に関する総合的なガイダンスが得られます。コンポーネントパターン、イベントハンドリング、状態管理（非同期ジェネレータを含む）、パラメータと保護機能を備えたルーティング・ナビゲーション、vistestを使用したテストに対応しています。AppRunコンポーネントの設計・レビュー、ルートの配線、状態フローの管理、AppRunテストの作成時に活用してください。
desloppify
コードベースのヘルスチェックと技術負債の追跡ツールです。コード品質、技術負債、デッドコード、大規模ファイル、ゴッドクラス、重複関数、コードスメル、命名規則の問題、インポートサイクル、結合度の問題についてユーザーが質問した場合に使用してください。また、ヘルススコアの確認、次の改善項目の提案、クリーンアップ計画の作成をリクエストされた際にも対応します。29言語に対応しています。
debugging-and-error-recovery
テストが失敗したり、ビルドが壊れたり、動作が期待と異なったり、予期しないエラーが発生したりした場合に、体系的な根本原因デバッグをガイドします。推測ではなく、根本原因を見つけて修正するための体系的なアプローチが必要な場合に使用してください。
test-driven-development
テスト駆動開発により実装を進めます。ロジックの実装、バグの修正、動作の変更など、あらゆる場面で活用できます。コードが正常に動作することを証明する必要がある場合、バグ報告を受けた場合、既存機能を修正する予定がある場合に使用してください。
incremental-implementation
変更を段階的に実施します。複数のファイルに影響する機能や変更を実装する場合に使用してください。大量のコードを一度に書こうとしている場合や、タスクが一度では完結できないほど大きい場合に活用します。