Configuring OpenAI for 3CX AI Agents

Введение

В этом руководстве объясняется, как интегрировать OpenAI с ИИ-агентами 3CX для сценариев интеллектуального секретаря и обработки вызовов.

Эта функция требует редакции 3CX AI.

Настройка учетной записи OpenAI

При отсутствии учетной записи OpenAI выполните вход или создайте новую на странице входа OpenAI.

Создание проекта и настройка биллинга

  • Войдите на страницу OpenAI Login.
  • Создайте новый проект (Project) и задайте ему понятное имя.
  • Перейдите в "Settings → Billing" и завершите настройку биллинга.
  • Убедитесь в наличии достаточного баланса для ожидаемого использования.

Примечание: для правильной работы требуется платная учетная запись OpenAI; пробные учетные записи имеют ограничения и могут вызывать непредсказуемые проблемы/ошибки. Соответственно, учетные записи OpenAI с минимальным платежом в 100 долларов США обычно сразу повышаются до уровня Tier 3.

Настройка доступа к моделям и лимитов

  • Перейдите в "Project → Limits".
  • Set a budget to control your spending.
  • Under Allow or block models, keep the list empty to allow all models
  • Under Rate limits, increase limits for the models above as needed (larger installations may require higher limits to avoid unpredictable behavior).
  • Установите бюджет для контроля расходов.
  • В разделе Allow or block models оставьте список пустым, чтобы разрешить все модели
  • В разделе Rate limits при необходимости увеличьте лимиты для указанных выше моделей (для крупных установок могут потребоваться более высокие лимиты во избежание непредсказуемого поведения).

Примечание о Rate Limits: возможность повышения лимитов зависит от уровня использования OpenAI API (tier) и истории учетной записи.

Создание нового API Key

  • Перейдите в "Dashboard → API Keys".
  • Нажмите Create a New Secret Key.
  • Введите понятное имя и установите разрешения на All.
  • Скопируйте ключ и сохраните его в надежном месте.

Настройка OpenAI в 3CX

В консоли администратора 3CX перейдите в Admin > Integrations > AI. Нажмите Realtime API и выберите OpenAI в раскрывающемся списке AI Provider.

  • Введите следующие параметры:
  • API Key: вставьте API Key, созданный в панели управления OpenAI.
  • AI Realtime Model: выберите модель реального времени OpenAI, рекомендованную для установленной версии 3CX.
  • AI Text Model: выберите текстовую модель OpenAI, рекомендованную для установленной версии 3CX.
  • Заполните:
  • Company Name
  • Company Description; это используется ИИ-агентами для понимания контекста организации.
  • Нажмите кнопку Save.

Настройка ИИ-агентов и источников знаний

Для получения подробной информации по настройке ИИ-агентов см. основное руководство “Настройка OpenAI для работы ИИ-агентов 3CX”.

Технические примечания

  • Аудиокодек: PCMU
  • Если учетная запись OpenAI ограничивает доступ к моделям, разрешите gpt-realtime-whisper и модели, выбранные для Realtime и Text в настройках Realtime API.
  • Убедитесь, что проверка 3CX Firewall Checker проходит успешно.
  • Разрешите исходящий трафик на:
  • TCP 443 – используется для передачи сигналов OpenAI Realtime API и настройки сессии.
  • UDP 3478 – используется для медиа-соединения WebRTC.
  • 3CX устанавливает подключение OpenAI Realtime в три этапа:
  • Создает секрет клиента реального времени (client secret) через https://api.openai.com/v1/realtime/client_secrets.
  • Создает вызов или сессию реального времени через https://api.openai.com/v1/realtime/calls.
  • Устанавливает медиа-соединение WebRTC с использованием SDP, которым обмениваются во время настройки сессии.

Модели ИИ

OpenAI регулярно обновляет модели и может прекращать поддержку старых версий. В свою очередь, 3CX обновляет рекомендованные модели при изменении поддерживаемых версий. Следовательно, убедитесь, что проект OpenAI имеет доступ к моделям, необходимым для установленной версии 3CX.

Дополнительная информация

Версия документа
Последнее обновление документа 20 августа 2026
https://www.3cx.ru/docs/ai-agent-configuration-openai/