Справочник по Zoom Contact Center

Текст

---
name: build-zoom-contact-center-app
description: "Справочный скилл по Zoom Contact Center. Используй после выбора рабочего процесса Contact Center при реализации интеграций для приложений, веба или нативных платформ; контекста и состояния обращений (engagement); кампаний; обратных звонков; а также при поиске причин расхождения версий."
triggers:
  - "contact center sdk"
  - "zoom contact center"
  - "zcc"
  - "engagement context"
  - "engagement status"
  - "campaign sdk"
  - "scheduled callback"
  - "getengagementcontext"
  - "onengagementstatuschange"
  - "zoom contact center app"
---

/build-zoom-contact-center-app

Фоновый справочник по интеграциям Zoom Contact Center для приложений, веба и нативных мобильных платформ.

Руководство по реализации Zoom Contact Center для:

• Приложений Contact Center в клиенте Zoom (путь через Zoom Apps SDK)
• Встраиваемых веб-каналов (чат/видео/кампании)
• Нативных мобильных SDK (Android/iOS)

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

• https://developers.zoom.us/docs/contact-center/
• https://developers.zoom.us/docs/contact-center/web/sdk-reference/
• https://marketplacefront.zoom.us/sdk/contact/android/index.html
• https://marketplacefront.zoom.us/sdk/contact/ios/index.html

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

• Если пользователь создаёт приложение внутри настольного клиента Zoom Contact Center, оставайся на пути Zoom Apps SDK и используй этот скилл вместе с zoom-apps-sdk.
• Если пользователь встраивает виджеты чата и видео на сайт, переходи к [web/SKILL.md](web/SKILL.md).
• Если пользователь интегрирует нативные бинарные файлы SDK для Android или iOS, переходи к [android/SKILL.md](android/SKILL.md) или [ios/SKILL.md](ios/SKILL.md).
• Если пользователю нужны API управления звонками или очередями Contact Center, подключи [../rest-api/SKILL.md](../rest-api/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/forum-top-questions.md](references/forum-top-questions.md)
4. [references/versioning-and-compatibility.md](references/versioning-and-compatibility.md)
5. [references/samples-validation.md](references/samples-validation.md)
6. [references/environment-variables.md](references/environment-variables.md)
7. [troubleshooting/common-drift-and-breaks.md](troubleshooting/common-drift-and-breaks.md)
8. [RUNBOOK.md](RUNBOOK.md)

Скиллы по платформам:

• [android/SKILL.md](android/SKILL.md)
• [ios/SKILL.md](ios/SKILL.md)
• [web/SKILL.md](web/SKILL.md)

Структура документации

contact-center/
├── SKILL.md
├── RUNBOOK.md
├── concepts/
│   └── architecture-and-lifecycle.md
├── scenarios/
│   └── high-level-scenarios.md
├── references/
│   ├── versioning-and-compatibility.md
│   ├── samples-validation.md
│   └── environment-variables.md
├── troubleshooting/
│   └── common-drift-and-breaks.md
├── android/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/android-reference-map.md
│   └── troubleshooting/common-issues.md
├── ios/
│   ├── SKILL.md
│   ├── concepts/sdk-lifecycle.md
│   ├── examples/service-patterns.md
│   ├── references/ios-reference-map.md
│   └── troubleshooting/common-issues.md
└── web/
    ├── SKILL.md
    ├── concepts/lifecycle-and-events.md
    ├── examples/app-context-and-state.md
    ├── references/web-reference-map.md
    └── troubleshooting/common-issues.md

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

1. Рано инициализируй контекст платформы.
2. Построй элемент канала (entryId для чата/видео/ZVA, apiKey для сценариев запланированного обратного звонка и кампаний).
3. Получи экземпляр сервиса или клиента.
4. Зарегистрируй слушатели и делегаты до взаимодействия пользователя.
5. Запусти сценарий (fetchUI, startVideo или путь открытия/показа веб-SDK).
6. Обрабатывай смены состояния обращения (start, hold, resume, end) и переключение контекста.
7. Заверши сценарий и освободи ресурсы (endChat/endVideo, logout/logoff, деинициализация или освобождение).

Основные сценарии

• Приложение в боковой панели агента, которое хранит заметки по каждому engagementId и переживает переключение контекста.
• Кампании чата и видео в браузере, запускаемые из веб-тегов.
• Нативное мобильное клиентское приложение для чата, видео и запланированного обратного звонка.
• Выбор канала по кампании (чат, ZVA, видео, запланированный обратный звонок).
• Сценарий повторного подключения к оборванным видеообращениям на мобильных.
• Софтфон Smart Embed для CRM с контрактами событий через postMessage.

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

Цепочки

• Авторизация и идентификация приложения в клиенте: [../zoom-apps-sdk/SKILL.md](../zoom-apps-sdk/SKILL.md) и [../oauth/SKILL.md](../oauth/SKILL.md)
• Рабочие процессы Contact Center через REST: [../rest-api/SKILL.md](../rest-api/SKILL.md)
• Cobrowse в голосовых и чат-каналах веба: [../cobrowse-sdk/SKILL.md](../cobrowse-sdk/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/contact-center, лицензия MIT. Изменения: перевод на русский язык.