Пользовательский шаблон IP-телефона в 3CX: пример Yealink

Как создать и использовать пользовательский шаблон IP-телефона в 3CX (пример Yealink)

В системе 3CX предусмотрена гибкая возможность настраивать параметры IP-телефонов с помощью собственных шаблонов. Это особенно полезно, когда требуется уникальная конфигурация для телефона (например, изменение яркости дисплея, кнопок, поведения подсветки и других параметров), которая не входит в стандартные настройки производителя.

API отлично подходит для автоматизации, однако для быстрой и простой настройки надёжным решением остаются пользовательские шаблоны телефонов.

В этом материале мы покажем пошаговый пример создания кастомного шаблона для телефонов Yealink, который сохраняется при обновлении системы и может использоваться для автоматической настройки множества устройств.

📌 Что такое пользовательский шаблон телефона

Пользовательский шаблон — это копия стандартного XML-шаблона автонастройки, которую вы можете изменить под свои задачи. В отличие от стандартных шаблонов, кастомная копия не будет перезаписана при обновлениях 3CX.

Рекомендуется создать копию стандартного шаблона и использовать её при настройке телефона.
Руководство создания пользовательских шаблонов было обновлено, чтобы упростить начало работы.

📍 Пример задачи: настройка подсветки экранов телефонов Yealink

В качестве примера рассмотрим ситуацию, когда нужно изменить уровень подсветки дисплея IP-телефона Yealink T48S, однако указанные настройки будут применяться ко всем моделям телефонов, включённым в данный шаблон:

• phone_setting.active_backlight_level — уровень подсветки, когда телефон активен;
• phone_setting.inactive_backlight_level — уровень подсветки в режиме ожидания. 

📌 Шаг 1: создание кастомного шаблона

Чтобы начать работу, в веб-консоли 3CX перейдите в меню:

• «Admin → Advanced → Templates»;
• Выберите нужный базовый шаблон для вашей модели телефона;
• Сделайте копию шаблона по инструкции "Как создать и использовать пользовательские шаблоны IP‑телефонов в 3CX" и назовите её, например, yealinkT4x_backlight.

Это создаст отдельный шаблон, который не будет изменяться системой при обновлениях, что важно для стабильности кастомных параметров.

📌 Шаг 2: внесение изменений в шаблон

• Откройте консоль администратора и в разделе Templates выберите созданный шаблон yealinkT4x_backlight.ph.xml из выпадающего списка;
• Затем с помощью CTRL+F найдите phone_setting.inactive_backlight_level и укажите 0 для отключения подсветки дисплея в режиме ожидания и установите нужное значение уровня подсветки для активного режима телефона в параметре phone_setting.active_backlight_level, например 3
• Сохраните изменения кнопкой Save.

📌 Шаг 3: назначение пользовательского шаблона телефону

Чтобы применить кастомный шаблон к конкретному телефону:

• Перейдите в Admin Console → Users;
• Выберите пользователя и нажмите «Edit»;
• На вкладке «IP Phone» нажмите «Configure a Phone»;
• В поле «Phone Model» выберите созданный кастомный шаблон;
• Введите MAC-адрес телефона в соответствующее поле и продолжите настройку кнопкой Next;
• В окне Configure your Phone выберите корректный тип подключения для IP-телефона;
• После этого нажмите Add Phone, а затем Close в появившемся окне IP Phone Added;
• Далее перезагрузите IP-телефон. Наиболее надёжный способ — выполнить сброс устройства к заводским настройкам. После перезагрузки телефон автоматически выполнит настройку и применит новые параметры.

🔧 Практические советы

• Не перезаписывайте имена файлов стандартных шаблонов — это может привести к потерям конфигураций при обновлениях системы.
• Всегда тестируйте изменения на одном телефоне, прежде чем масштабировать на всю сеть.
• Если шаблон перестаёт работать после обновления 3CX, обновите кастомную копию или пересоздайте её.

📌 Когда это полезно

Кастомные шаблоны особенно полезны, когда необходимо:

• Изменить стандартные параметры дисплея, подсветки и логотипов;
• Настроить набор кнопок и функциональность под требования компании;
• Автоматизировать конфигурацию большого парка IP-телефонов при вводе в эксплуатацию.

📢 Итог

Настройка пользовательских шаблонов IP-телефонов в 3CX — это эффективный способ адаптировать систему под уникальные требования бизнеса. С помощью кастомных шаблонов вы получаете стабильный, расширяемый механизм автонастройки, который не будет потерян после обновлений платформы.