iiuniversitet.ruЦентр обучения нейросетямОткрыть каталог

Интеграция с Zoom Phone

Справочник по интеграциям Zoom Phone: API, вебхуки, встроенный софтфон Smart Embed, CRM-дозвонщики и обработка звонков.

СкиллAnthropic (партнёр: Zoom)ClaudeMITНужен терминалПроверка не требуется
Скачать на русскомОригинал на английском (архив)Источник ↗
Что делает
Справочник по интеграциям Zoom Phone: API, вебхуки, встроенный софтфон Smart Embed, CRM-дозвонщики и обработка звонков.
Когда брать
Когда нужно встроить телефонию Zoom в CRM или веб-приложение, получать данные о звонках или автоматизировать их обработку.
Когда не брать
Если задача относится к контакт-центру Zoom (для этого есть contact-center) или не связана с телефонией.
Пример запроса
Встрой в нашу CRM софтфон Zoom Phone, чтобы звонить клиентам по клику и сохранять итог звонка.
Нужно подключить
терминал

Входит в плагин zoom-plugin. В Cowork и Claude Code можно поставить плагин целиком.

Как включить

  1. Скачайте архив и распакуйте его.
  2. Положите папку build-zoom-phone-integration в ~/.claude/skills/.
  3. Откройте Claude Code и опишите задачу своими словами: Claude подхватит скилл по описанию.

Текст

---
name: build-zoom-phone-integration
description: "Справочный скилл по Zoom Phone. Используй после выбора телефонного процесса при реализации OAuth, API Phone, вебхуков, событий Smart Embed, схем URI, CRM- и CTI-дозвонщиков и автоматизации обработки звонков."
triggers:
  - "zoom phone"
  - "phone smart embed"
  - "zoom phone api"
  - "zoom phone webhook"
  - "call history"
  - "call handling"
  - "zoomphonecall"
  - "zoomphonesms"
  - "phone crm integration"
  - "call element"
---

/build-zoom-phone-integration

Справочный материал по интеграциям Zoom Phone: сценарии с API, вебхуками, Smart Embed и запуском через URI.

Рекомендации по реализации интеграций Zoom Phone: сценарии с API, вебхуками и событиями, Smart Embed и запуском через URI.

Официальная документация:

Ограничитель маршрутизации

  • Если пользователю нужен встроенный софтфон в веб-приложении, используй Smart Embed ([examples/smart-embed-postmessage-bridge.md](examples/smart-embed-postmessage-bridge.md)).
  • Если пользователю нужны записи звонков, аналитика или автоматизация, используй REST API Phone и вебхуки ([references/deprecations-and-migrations.md](references/deprecations-and-migrations.md)).
  • Если пользователю нужен запуск звонка или SMS по клику из внешнего интерфейса, используй схемы URI (zoomphonecall://, zoomphonesms://).
  • Если пользователь смешивает Zoom Phone и Contact Center, соединяй с [../contact-center/SKILL.md](../contact-center/SKILL.md).

Быстрые ссылки

Начни здесь:

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

Типовой жизненный цикл

  1. Подготовь предварительные условия аккаунта (лицензия Zoom Phone, настройки администратора, готовность SMS).
  2. Создай OAuth-приложение и области доступа (scopes) в Marketplace.
  3. Выбери поверхность интеграции:
  4. Smart Embed (iframe + postMessage)
  5. REST + вебхуки
  6. запуск через URI (callto, tel, zoomphonecall, zoomphonesms)
  7. Фиксируй события в реальном времени (события Smart Embed и/или вебхуки).
  8. Сохраняй идентификаторы звонков и сопоставляй записи (call_id, call_history_uuid, call_element_id).
  9. Применяй сопоставление данных, безопасное при миграции (v1 -> v2 -> v3), и учитывай переименованные поля.
  10. Усиль безопасность (проверка источника, проверка подписи вебхуков, области доступа по принципу наименьших привилегий).

Сценарии верхнего уровня

  • Панель софтфона в CRM на базе Smart Embed с обратными вызовами поиска и сопоставления контактов.
  • Звонок по клику из таблицы клиентов и контактов через zp-make-call.
  • Процесс фиксации итога звонка через zp-save-log-event и собственную страницу заметок.
  • Процесс работы с SMS через zoomphonesms:// и zp-sms-log-event.
  • Операционная панель в реальном времени на событиях вебхуков phone.*.
  • Миграция аналитики звонков со старых журналов звонков на историю звонков и элементы звонков (call history / call elements).
  • Автоматизация администрирования настроек обработки звонков для пользователей, автосекретарей и очередей звонков.

Подробности — в [scenarios/high-level-scenarios.md](scenarios/high-level-scenarios.md).

Связки с другими скиллами

  • Настройка OAuth и жизненный цикл токенов: [../oauth/SKILL.md](../oauth/SKILL.md)
  • Ресурсы Phone и аккаунта через REST: [../rest-api/SKILL.md](../rest-api/SKILL.md)
  • Доставка событий и проверка подписи: [../webhooks/SKILL.md](../webhooks/SKILL.md)
  • Сквозной путь клиента через Phone и Contact Center: [../contact-center/SKILL.md](../contact-center/SKILL.md)

Переменные окружения

  • Стандартные ключи .env и то, где найти каждое значение, — в [references/environment-variables.md](references/environment-variables.md).

Перевод: iiuniversitet. Оригинал: https://github.com/anthropics/knowledge-work-plugins/tree/main/partner-built/zoom-plugin/skills/phone, лицензия MIT. Изменения: перевод на русский язык.

Оригинал на английском 
---
name: build-zoom-phone-integration
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."
triggers:
  - "zoom phone"
  - "phone smart embed"
  - "zoom phone api"
  - "zoom phone webhook"
  - "call history"
  - "call handling"
  - "zoomphonecall"
  - "zoomphonesms"
  - "phone crm integration"
  - "call element"
---

# /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](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](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](../contact-center/SKILL.md).

## Quick Links

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

## Common Lifecycle Pattern

1. Provision account prerequisites (Zoom Phone license, admin setup, SMS readiness).
2. Create OAuth app and scopes in Marketplace.
3. Choose integration surface:
- Smart Embed (iframe + postMessage)
- REST + webhooks
- URI launch (`callto`, `tel`, `zoomphonecall`, `zoomphonesms`)
4. Capture real-time events (Smart Embed events and/or webhooks).
5. Persist call identifiers and correlate records (`call_id`, `call_history_uuid`, `call_element_id`).
6. Apply migration-safe data mapping (v1 -> v2 -> v3) and handle renamed fields.
7. 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](scenarios/high-level-scenarios.md) for details.

## Chaining

- OAuth setup/token lifecycle: [../oauth/SKILL.md](../oauth/SKILL.md)
- Phone and account resources via REST: [../rest-api/SKILL.md](../rest-api/SKILL.md)
- Event delivery and signature validation: [../webhooks/SKILL.md](../webhooks/SKILL.md)
- Contact Center blended journey: [../contact-center/SKILL.md](../contact-center/SKILL.md)

## Environment Variables

- See [references/environment-variables.md](references/environment-variables.md) for standardized `.env` keys and where to find each value.

Источник: anthropics/knowledge-work-plugins / zoom-plugin / build-zoom-phone-integration ↗. Ссылка проверена 2026-10-10.

Похожие