Настройка OpenAI для работы ИИ-агентов 3CX

Введение

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

Для использования этой функции необходима редакция 3CX AI.

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

Если у вас нет учетной записи OpenAI, вам нужно создать ее. Затем настройте платежные данные и сгенерируйте API key.

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

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

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

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

  • Перейдите в Project → Limits.
  • Установите бюджет для контроля расходов.
  • В Allow or block models не включайте ничего, чтобы разрешить все модели
  • В разделе Rate limits увеличьте лимиты для указанных выше моделей по мере необходимости (крупным инсталляциям могут потребоваться более высокие лимиты во избежание непредсказуемого поведения).

Примечание о лимитах: Возможность увеличения лимитов зависит от вашего уровня использования OpenAI API и истории аккаунта.

Создание нового API-ключа

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

Шаг 2. Настройка OpenAI в 3CX

  • В Консоли администратора 3CX перейдите в Admin → Integrations → AI и нажмите кнопку OpenAI API

  • Введите OpenAI Secret Key.
  • Выберите модели для использования:
  • OpenAI Model for Real-Time Calls: gpt-realtime (рекомендуется)
  • OpenAI Model for Text: gpt-5o-mini (рекомендуется)
  • Заполните поля:
  • Company Name (Название компании)
  • Company Description (Описание компании); используется ИИ агентами для понимания контекста организации.
  • Нажмите кнопку Save.

Шаг 3. Добавление источников знаний / RAG (Bring Your Own Content)

Источники знаний позволяют агентам получать доступ к контенту компании во время звонков и чатов (политики, FAQ, правила маршрутизации, документация по продуктам). В экосистеме OpenAI это обычно реализуется через загрузку файлов, создание эмбеддингов и поиск по векторам для извлечения информации.

  • В консоли администратора перейдите в "Admin → Integrations → AI"
  • Нажмите кнопку Knowledge Sources, затем кнопку Add.

  • Задайте Name (Имя) и Description (Описание) для базы знаний.
  • Загрузите файлы (PDFs/docs/text) с информацией о вашем бизнесе, например:
  • График работы и выходные дни
  • Инструкции по маршрутизации для департаментов и отделов
  • FAQ по продуктам и ценам
  • Формулировки «чем мы занимаемся / как о нас говорить»
  • СОВЕТЫ
  • Убедитесь, что Description точно характеризует содержимое базы знаний для улучшения поиска информации.
  • Если имеются документы, охватывающие разные, несвязанные контексты (например, медицинские документы и документы по внутренней политике командировок), не помещайте их в одно хранилище; создайте отдельные хранилища знаний для каждого контекста.
  • OpenAI API не обновляет 3CX при каждом изменении; после каждого изменения нажимайте кнопку Refresh (Обновить) и дождитесь завершения процесса.

Примечание: Источники знаний создаются и оплачиваются в рамках настроенного проекта/ключа OpenAI.

Шаг 4. Создание и настройка ИИ-агентов

  • Перейдите в раздел "Admin → Integrations → AI” и нажмите кнопку Add Agent

  • Выберите тип агента:
  • Секретарь: Корпоративный ИИ агент для базовой обработки и маршрутизацию вызовов
  • Персональный ассистент: Настроен для обработки вызовов конкретного пользователя (например, руководителя)

  • На вкладке Agent Info:
  • Определите Общие настройки (General Settings) для ИИ агента:
  • Extension – назначьте уникальный добавочный номер для ИИ агента
  • Персональный ассистент для (только PA) – пользователь, которого представляет ассистент
  • Department Membership – выберите отдел(ы), к которому принадлежит ИИ агент
  • First Name и Last Name – озвучиваемое и отображаемое имя ИИ агента
  • Присвоенные DID номер(а) – прямые входящие номера, ведущие на ИИ агента
  • Настройте параметры голоса и вызовов для ИИ агента:
  • Voice Style – выберите предпочтительный вариант голоса
  • Call Recording – выберите, какие вызовы записывать: Off – Вызовы не записываются, All – Записывается каждый вызов, External Only – Записываются только вызовы с внешними абонентами
  • Maximum Call Duration – укажите максимальную длительность (в минутах) для всех вызовов, обрабатываемых этим Агентом.
  • Agent Talk Link – показывает уникальную ссылку для звонков с сайта (Click-to-Talk); если оставить поле пустым, ссылка для этого агента будет отключена.
  • На вкладке Agent Type:
  • Установите Knowledge Sources – выберите, к каким источникам знаний агент имеет доступ
  • Установите Introduction Language – язык приветствия по умолчанию
  • Также можно включить опцию Allow Language Switching (Разрешить переключение языка).
  • Установите Welcome Message – первое сообщение, которое произносится звонящему.
  • На вкладке Agent Instructions - предварительно настроены инструкции по поведению ИИ; однако, если требуется, кнопка Customize Prompt позволяет настроить тон, границы политики и правила «можно/нельзя» (“do/don’t”).
  • На вкладке Block Spam Calls: 
  • Защита от спама (Spam Protection) включена по умолчанию
  • Можно настроить What Counts as Spam, чтобы определить, что считается спамом или мошенничеством, и какое действие предпринять:
  • End Call – немедленно завершает вызов при обнаружении спама.
  • Transfer To – переводит вызов назначенному пользователю или менеджеру. Это нужно для дальнейшего реагирования.
  • Send Screening Message and Disconnect – отправляет предварительное сообщение (скрининг) и автоматически передает инцидент менеджеру с кратким резюме звонка, а затем завершает соединение.
  • На вкладке Call Routing (только Секретарь (Receptionist)):

  • Добавьте правила маршрутизации (Routing Behaviour), чтобы ИИ агент мог интеллектуально маршрутизировать вызовы и чаты на разные направления на основе описания.
  • Например, если звонящий говорит: «Я получаю ошибку 404», ИИ агент может классифицировать это как звонок в поддержку и перевести на направление с описанием вроде «В случае ошибок HTTP переводить сюда».
  • Можно создать несколько записей маршрутизации, но избегайте чрезмерного перекрытия для обеспечения точной маршрутизации.
  • Если включена опция Allow Extension Routing by Name, ИИ агент позволяет звонящим запрашивать перевод по имени; например, «Пожалуйста, соедините меня с Георгием».
  • При включенном Режиме конфиденциальности (Confidentiality Mode):
  • Это предотвращает раскрытие ИИ конфиденциальной информации, такой как фамилии и сведения о сотрудниках
  • Имейте в виду, что если объединить это с Allow Extension Routing by Name, ИИ агент не сможет, например, спросить: «У нас два Георгия: Георгий Такеи и Георгий Вашингтон, с кем вы хотите соединиться?», а вместо этого спросит у звонящего полное имя требуемого адресата.
  • На вкладке Call Screening:
  • Опция Disable Call Screening for Known Contacts смягчает процесс скрининга для известных, доверенных контактов, сохраненных в телефонной книге.
  • Можно включить чекбокс Busy Check Before Call Transfer, чтобы убедиться, что добавочный номер назначения доступен перед переводом вызова.
  • На вкладке Options:
  • Caller Response Actions направлена на два конкретных типа проблемных абонентов:
  • Враждебные или оскорбительные абоненты.
  • Неконтактные абоненты, препятствующие разговору.
  • Можно настроить соответствующие действия для автоматического управления этими ситуациями.

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

  • Аудиокодек: Поддерживается только PCMU.
  • Настройки сети / сетевого экрана
  • Убедитесь, что Firewall Checker проходит проверку без ошибок.
  • Убедитесь, что разрешен исходящий трафик на:
  • TCP 443 (HTTPS)
  • UDP 3478 (STUN/TURN)
  • Примечание о моделях ИИ:
  • OpenAI постоянно обновляет свои модели, и по мере появления новых улучшенных версий, старые версии устаревают. Информация в этом документе будет время от времени обновляться для поддержания актуальности рекомендуемых опций. Необходимо убедиться, что учетная запись OpenAI настроена так, чтобы разрешить использование более новых моделей в 3CX.
  • В новых релизах 3CX настроенные модели будут автоматически обновляться до более современных эквивалентов.

Версия документа

Последнее обновление документа 26 мая 2026

https://www.3cx.ru/docs/ai-agent-configuration/