3CX v15: Створення користувацьких шаблонів автоналаштування IP телефонів

У цій статті ми розглянемо вельми корисну технологію – шаблони IP телефонів 3CX. Шаблони автоналаштування 3CX дозволяють автоматично одноманітно налаштувати великий парк IP телефонів в організації. Однак 3CX поставляється з готовими шаблонами, налаштованими розробниками 3CX таким чином, щоб вони підходили більшості споживачів. Якщо у вашій організації є які-небудь особливі вимоги до конфігурації IP телефонів, наприклад, власна "розкладка" програмованих кнопок під дисплеєм телефону, конфігурація мелодій виклику, специфічні параметри SIP і т. п. – змінюйте стоковий шаблон під ваші потреби. Як це зробити, описано нижче.

Початок роботи

Перш за все, зробіть копію стокового шаблону 3CX. І вже з копією продовжуйте роботу.

1. В інтерфейсі управління 3CX перейдіть в розділ Settings - Templates.
2. У випадаючому списку виберіть стоковий шаблон автоналаштування IP телефону, який слід змінити (1)
3. Переконайтеся, що всередині файлу шаблону вказана саме та модель телефону, для якої буде створюватися користувальницький шаблон (2).
4. Вгорі натисніть кнопку Copy (3), введіть ім'я шаблону і натисніть OK. Це ім'я буде приєднано до імені стокового шаблону. Ви побачите повне ім'я шаблону у випадаючому списку, як показано нижче.

Внесення змін

Зверніть увагу, що для застосування змін в шаблон, необхідний перезапуск сервісу Service Management Console (MC01). Це влечен втрату з'єднань в клієнтах MyPhone/Web Client, які відповідають за статуси і індикацію присутності користувачів. Тому рекомендується налагоджувати шаблони на тестовій системі 3CX і тестовій групі IP телефонів – не в робочому оточенні. Параметри, що передаються на телефон, починаються з цього рядка в шаблоні.

Всі параметри, зазначені вище цього рядка, необхідні для роботи інтерфейсу управління 3CX, і міняти їх не слід. Помилка в цих рядках може призвести до того, що користувальницький шаблон не буде відображатися в списку в інтерфейсі управління 3CX. Параметри додаткового номера в інтерфейсі також стануть недоступні. У цьому випадку вам необхідно буде відновити останню працюючу копію вмісту файлу шаблону або повністю видалити цей додатковий номер (користувача).

Загальні рекомендації

• Уникайте дублювання однакових параметрів автоналаштування в шаблоні.
• Для уточнення параметрів звертайтеся до документації автонастройке виробника IP телефону, але не в техпідтримку 3CX.
• Ви також можете задати питання на публічному форумі 3CX.
• Якщо який-небудь параметр слід змінити з встановленого значення B в значення за умовчанням A, не просто видаляйте це параметр, а явним чином встановіть йому значення A.
• Ніколи не змінюйте визначення моделі телефону "ua="XXXXX"", задане в шаблоні. Воно використовується системою.
• Після внесення змін до шаблон, не забудьте перезапустити сервіс Service Management Console (MC01) і примусово перенастройте телефон після внесення змін.
• Якщо не переводити телефон примусово, автоматичне застосування параметрів шаблону відбувається, як правило, протягом 24 годин.

Перевірка коректності змін

Існує кілька способів переконатися в тому, що внесені вами зміни будуть коректно оброблені IP телефоном.

Якщо IP телефон в даний момент підключений до 3CX, виділіть його в інтерфейсі (розділ Phones) і натисніть кнопку +Config. Це примусово застосовує до телефону конфігурацію, зазначену в шаблоні.

Також, можна перейти на вкладку Provisioning і скопіювати URL автоналаштування. Замість {mac} вкажіть MAC адресу IP телефону. Наприклад, URL може мати вигляд http://mypbx.3cx.eu/provisioning/ads234cfsda/cfg123456787890. Вставити її в будь-який браузер, і ви отримаєте готовий XML файл настройки для конкретного IP телефону. Деякі браузери відразу відображають вміст файлу, якщо він має коректний XML формат. Щоб побачити вміст в текстовому вигляді, клікніть правою кнопкою миші і виберіть Show Source.

Застосування шаблону до IP телефону

Застосування до ненастроенному або скинутій за замовчуванням IP телефону

1. В інтерфейсі 3CX перейдіть в розділ Phones.
2. Виділіть новий телефон, який потрібно настроїти.
3. Виберіть Add/Assign Ext, в залежності від того, що вам необхідно.
4. У вкладці Phone Provisioning скопіюйте MAC адресу телефону.
5. У цій же вкладці, у випадаючому списку ваших телефонів видаліть прив'язаний телефон, натиснувши кнопку Delete праворуч.
6. Вгорі натисніть кнопку Add.
7. У випадаючому списку виберіть ваш користувальницький шаблон.
8. Вставити скопійований раніше MAC адресу телефону.
9. Двічі натисніть OK, щоб зберегти настройки користувача.
10. Перейдіть в розділ Phones, виберіть телефон і натисніть Reprovisioning.

Застосування до налаштованому і підключеному IP телефону

1. В інтерфейсі управління 3CX перейдіть в розділ Extensions, клацніть за номером (користувачу), для якого необхідно застосувати шаблон, і перейдіть на вкладку Phone Provisioning.
2. У випадаючому списку з вашими телефонами, виберіть IP телефон, до якого потрібно застосувати спеціальний шаблон.
3. Скопіюйте MAC адресу телефону.
4. Видаліть прив'язаний телефон, натиснувши кнопку Delete праворуч.
5. Вгорі натисніть кнопку Add.
6. У випадаючому списку виберіть ваш користувальницький шаблон.
7. Вставити скопійований раніше MAC адресу телефону.
8. Двічі натисніть OK, щоб зберегти настройки користувача.
9. Перейдіть в розділ Phones, виберіть телефон і натисніть Reprovisioning.

Особливості шаблонів

Залежно від змін, внесених в шаблони, можливо буде потрібно повний скидання IP телефону перед автоналаштуванням користувальницьким шаблоном.

Шаблони Yealink

На відміну від інших виробників, Yealink для автонастройки використовує 2 конфігураційних файлів. З-за цього в шаблоні присутні два розділу

• Перший розділ model) і відповідає іменам файлів виду y0000000000xx.cfg. Тут xx – ідентифікатор конкретної моделі, визначений Yealink. Міняти його не можна. У даній статті ці файли називаються y-files.
• Другий розділ Для того, щоб користувальницький шаблон Yealink працював коректно, перед застосуванням шаблону необхідно виконати ручне редагування:
  • Ім'я шаблону змінює назву відповідної моделі телефону Yealink. Тому це нова назва має бути зазначено вище розділу для відповідної моделі (правий скріншот). Зверніть увагу, щоб назва моделі відповідало коректному індексу xx в y-file (наприклад, y-file T19P має індекс 53, і міняти його не можна!).
  
  • Імена y0000000000xx.cfg повинні бути унікальні в відрізняються користувацьких шаблонів. Найпростіше добитися цього – виділити вміст файлу і скопіювати його в текстовий редактор. Потім, використовуючи функцію Replace All, знайти тест y0000000000 і замінити його на y1000000000 для першого шаблону, y2000000000 для другого шаблону і т. д.
  

  Універсальні шаблони

  Настійно не рекомендується явно вказувати в шаблоні такі параметри як номери портів, IP-адреса або FQDN сервера 3CX, облікові дані користувача і т. п. Якщо шаблон не містить такої жорстко заданої інформації, його можна назвати універсальним (переноситься). Він може бути перенесений на іншу інсталяцію системи 3CX. Це дуже корисно для інтеграторів, які модифікують шаблони для вирішення специфічних задач користувачів. Універсальні шаблони повинні бути розміщені в папці C:\ProgramData\3CX\Instance1\Data\Http\Interface\provisioning\XXXXXXXXXX\CustomTemplates\phones При оновленні системи, файли в цьому каталозі зберігаються (резервуються, а потім відновлюються). Не використовуйте ім'я файлу шаблону збігається з ім'ям стокового шаблону. Стокові шаблони перезаписуються при кожному оновленні 3CX. Таким чином, ваші користувальницькі шаблони будуть перезаписані без попередження. Якщо шлях CustomTemplate\phones відсутня, створіть ці папки (дотримуючи регістр символів) і перезапустити сервіс MC01.

  Підтримка користувацьких шаблонів компанією 3CX

  3CX поставляє стокові шаблони для всіх підтримуваних IP телефонів, а також для деяких застарілих IP телефонів. Шаблони для старих телефонів дозволяють автоматично коректно налаштувати і забезпечити багато сучасні функції 3CX. Однак модифікація стічних шаблонів позбавляє вас офіційної підтримки 3CX, як описано тут. Якщо у вас виникли проблеми з конкретним IP-телефоном, перед відкриттям заявки слід скинути його налаштування за замовчуванням і налаштувати стоковим шаблоном. Після цього повторіть дії, що викликали проблему, а тільки після цього відкривайте заявку в техпідтримці 3CX. Іншими словами, 3CX не надає ніякої додаткової підтримки з користувальницьким шаблонах, за винятком даного керівництва. Крім того, якщо ви створили користувальницький шаблон, необхідно постійно відстежувати оновлення відповідного стокового шаблону. Оскільки стічні шаблони відповідають прошивка IP телефонів, застарілий користувальницький шаблон може привести до некоректної роботи IP телефону з оновленою прошивкою.