Документація
Можливості
Базовий функціонал:
  • внутрішні, вхідні та вихідні дзвінки;
  • перемикання дзвінків;
  • перехоплення дзвінків;
  • запис дзвінків;
  • блокування номерів (чорний список);
  • голосова пошта. Запис розмови надсилається на e-mail;
  • переведення дзвінка у разі недоступності, зайнятості або завжди;
  • повідомлення про пропущені дзвінки на e-mail.
Розширені можливості:
  • діалплани:
    • голосове меню будь-якої глибини;
    • перевірка часу, у тому числі державних свят або перенесення;
    • груповий внутрішній дзвінок;
    • вихідний виклик:
    • вибір мови;
    • маркування дзвінка, буде збережено в лог дзвінків;
    • персональний менеджер (прив'язка контакту до співробітника);
    • голосова пошта;
    • одночасний дзвінок на внутрішній номер та налаштований номер для перемікання дзвінків;
    • автоматичний зворотний дзвінок у вказаний період, у т.ч. з урахуванням державних свят/переносів.
  • липкість дзвінка (дзвінок буде спершу спрямований на того з ким раніше спілкувався клієнт);
  • виклик номера через веб;
  • білінг вихідних дзвінків;
  • заплановані/відкладені (закріплені за співробітником) дзвінки у певний час.
  • текстові повідомлення/чати у сумісних SIP-клієнтах
  • надсилання та прийом SMS між SIP-клієнтами та сумісними GSM-шлюзами
Контакт центр:
  • підтримка української, російської та англійської мов;
  • стратегії дзвінків: дзвонити всім, дзвонити тому хто найдовше не відповідав, хто найменше відповів, випадково;
  • налаштування SLA;
  • можливість автоматично встановлювати оператора на паузу у разі не прийняття дзвінка;
  • налаштовані користувачем паузи;
  • Онлайн стан Контакт Ценру (Дашбоард):
    • моніторинг поточних станів КЦ;
    • підсвічування проблемних показників червоним світлом;
    • порівняння поточних показників із попередніми періодами;
  • постановка/зняття операторів з пауз;
  • статистика КЦ у вигляді діаграм та таблиць;
  • статистика роботи операторів у вигляді діаграм та таблиць;
  • підслуховування та нашіптування. Супервізор може слухати операторів, Оператори можуть запитати підслуховування/допомогу своєї розмови
  • пріоритет операторів
Чати:
  • автоматична постановка та зняття операторів КЦ на паузу під час роботи в чаті;
  • відображення черги чатів у дашбоарді КЦ;
  • сповіщеня про нові повідомлення операторам чату;
  • прив'язка чату до контакту;
  • підтримка ViberBot;
  • підтримка TelegramBot;
Контакти:
  • ведення списку контактів;
  • відповідність контакту одному або декільком зовнішнім номерам;
  • прив'язка контакту до співробітника;
  • просте збереження номера телефону з лога дзвінків у новий або існуючий контакт;
  • користувацькі (настроювані) поля контакту. Підтримуються типи: текст, дата, e-mail, ціле число, список та файл;
  • імпорт та експорт;
Логи дзвінків:
  • збережені в логах дзвінків дані:
    • час дзвінка
    • хто дзвонив
    • кому дзвонив
    • напрямок дзвінка
    • статус дзвінка (відповіли, не відповіли, зайнятий і т.д.)
    • тривалість дзвінка
    • час розмови
    • оцінка аудіо-якості дзвінка з можливістю переглянути деталі (втрати, джитер та затримку)
    • використовувані кодеки
    • яка зі сторін завершила дзвінок
    • колцентр
    • час перебування в голосовому меню до потрапляння в чергу КЦ
    • час очікування у черзі колцентру
    • маркування дзвінка
    • запис розмови
    • вартість
  • відображення пропущених вхідних дзвінків з якими пізніше не було здійснено розмову;
  • можливість відображати всі зовнішні телефонні номери у повному форматі (e.164);
  • підрахунок мінімуму, максимуму, середнього та всього для вибраних записів;
  • вивантаження логів у форматі xml (в електронні таблиці типу Exel);
Cтатистика:
  • подобова статистика у вигляді діаграм та таблиць
    • внутрішніх телефонів
    • операторів колцентів
    • зовнішніх ліній
  • вартість дзвінків за сьогодні та місяць для зовнішніх ліній;
  • настроювані періоди тривалості розмов для накопичення детальної статистики;
  • звіт про втрачені дзвінки, відображає кількість спроб, кількість зворотних дзвінків, можливо запланувати зворотний дзвінок.
Безпека:
  • підтримка шифрування TLS та SRTP;
  • списки доступу IP-адреси або мережі IPv4 та IPv6;
  • паролі телефонів не зберігаються в АТС, тільки хеш паролів;
  • аналіз складності пароля. Попередження про слабкі паролі;
  • генератор надійних паролів;
  • ліміт максимальної кількості одночасних вихідних з'єднань;
  • добовий ліміт вихідних хвилин;
  • добовий ліміт вартості дзвінків;
Системні:
  • інтернет протоколи IPv4 та IPv6;
  • IP-телефонія протоколу SIP. Транспорт: TLS, TCP, UDP;
  • оцінка аудіо-якості дзвінка (використовується протокол RTCP);
  • аудіо кодеки: ulaw, alaw, gsm, ilbc;
  • відео кодеки: h261, h263, h263p, h264, h265, mpeg4, vp8, vp9;
  • онлайн-статуси зовнішніх ліній та внутрішніх телефонів, включаючи статус шифрування;;
  • онлайн стан поточних дзвінків;;
  • повідомлення про зміни статусу реєстрації зовнішньої лінії на e-mail адміністраторам;
  • повідомлення про зміну статусу реєстрації телефону на e-mail користувачеві;
  • підтримка GSM шлюзів GoIP (SMS, Balance та GSM-level);
  • можлива оренда SIM-порту в GSM-шлюзі.
Швидке налаштування

⠀Налаштування внутрішніх телефонів

⠀Для налаштування внутрішніх телефонів натисніть на кнопку " телефони "

У правому нижньому куті натисніть додати.

Заповніть форму, що відкрилася:

  • Номер телефону номер внутрішнього телефону. Номер має бути унікальним у Вашій АТС;
  • Ідентифікатор символьне ім'я абонента. Це ім'я відображатиметься на екранах телефонів, на які надходитиме дзвінок даного абонента. Якщо Ваші телефони підтримують кирилицю (UTF-8), можна використовувати кирилітичні символи, якщо Ви не впевнені в підтримці кирилиці на всіх телефонних апаратах Вашої АТС краще використовувати латинські літери та цифри. Наприклад, можна вказати: "Охорона", "Ivan Ivanovich", Secretaty.
  • Пароль вкажіть пароль, який використовуватиме телефон при підключенні до хмарної АТС. Оскільки хмарна АТС відкрита у глобальному Інтернеті, вкрай бажано вибирати надійні паролі. АТС спочатку генерує надійний пароль, щоб його подивитись наведіть стрілкою мишки на поле введення пароля. Пароль не зберігається на стороні АТС, тому надалі його не можна буде подивитися - лише змінити..

Додатково для внутрішнього телефону можна налаштувати інші необов'язкові параметри, для цього натисніть на Детально:

  • Переадресація номер, на який будуть переводиться дзвінки. Причини для перемикання дзвінка слід вибрати в наступному полі Коли.
  • Коли коли робити перемикання дзвінка на номер вказаних у полі Forward number:
    • завжди завжди;
    • зайнятий коли телефон зайнятий (по ньому розмовляють);
    • не відповідає не підняли трубку;
    • недоступний телефон недоступний, наприклад, проблеми з Інтернетом.
    • разом одночасний виклик на внутрішній і номер переадресації.
  • E-mail email для отримання голосової пошти та повідомлень про пропущені дзвінки;
  • Голосова пошта увімкнути або вимкнути голосову пошту на email;
  • Повідомлення увімкнути або вимкнути повідомлення про пропущені дзвінки та проблеми з реєстрацією телефону на email;
  • Дозволи список IP-адрес або IP-мереж, з яких дозволено реєстрацію телефону. Якщо у вас постійна зовнішня IP-адреса - обов'язково вкажіть її в цьому полі.

Натисніть кнопку зберегти під цією формою, щоб зберегти налаштування нового телефону.

Налаштування sip-телефону можна переглянути, натиснувши значок "" праворуч відповідної строчки.

Після правильного налаштування sip-телефону в стовпці наживо повинно відобразиться Вільний. Це означає, що телефон підключився до АТС та готовий до роботи.



Налаштування зовнішніх ліній

Для налаштування зовнішніх ліній натисніть кнопку " лінії "

У правому нижньому куті натисніть додати.

Заповніть форму, що відкрилася:

  • Назва лінії ім'я зовнішньої лінії (транка). Повинно бути унікальним для Вашої АТС. Можна використовувати лише латинські маленькі літери та цифри.
  • SIP домен ім'я SIP-сервера. Повідомляється Оператором IP-телефонії.
  • Username ім'я для підключення до sip-сервера оператора IP-телефонії. Повідомляється Оператором IP-телефонії.
  • Пароль пароль. Повідомляється Оператором IP-телефонії.
  • Вхідні дзвінки на який внутрішній номер надсилати вхідні дзвінки з цієї лінії.
  • Номер номер зовнішньої лінії у форматі e.164. Наприклад, +380441234567. Неправильна вказівка зовнішнього номера телефону може призвести до помилок перетворення зовнішніх номерів у повний формат із плюсом.

Натисніть кнопку зберегти під цією формою, щоб зберегти налаштування для нової зовнішньої лінії..

Якщо Ви все налаштували правильно, то АТС спробує зареєструвати нову зовнішню лінію на сервері оператора IP-телефонії. У разі успішної реєстрації в колонці наживо статус з'явиться Зареєстрований або Досяжний.

Розмежування прав доступу


привілеїРолі/Права
adminsupervisoragent
налаштування АТС редагування ні ні
управління користувачами все ні ні
списки дат все,
крім глобальних
перегляд перегляд
АТС: Контакти все все перегляд всіх,
створення нових,
редагування де manager=own phone
АТС: Контакти:
створення/налаштування полів
все ні ні
АТС: Контакти: історія дзвінків все все все,
але прослуховувати лише свої дзвінки
АТС: Контакти: імпорт/експорт все все ні
АТС: Зовнішні лінії (external) все перегляд,
в т.ч. статистики/діаграм
ні
АТС: Внутрішні телефони (internal) все перегляд,
в т.ч. статистики/діаграм
перегляд,
тільки онлайн статуси
АТС: Діалплани (virtual) все ні ні
АТС: КЦ (Call Centers) все перегляд статистики/діаграм ні
АТС: КЦ дашбоард все все перегляд
персональні паузи та налаштування
АТС: КЦ підслуховування та нашіптування ні усі розмови в КЦ просити Супервізора для своїх розмов
АТС: Активні дзвінки (online calls) перегляд та скидання дзвінка перегляд ні
АТС: логи дзвінків (logs) все все тільки свої дзвінки
АТС: пропущені дзвінки (missed) все все ні
АТС: заплановані дзвінки (scheduled) все все ні
АТС: Наради (meetings) перегляд, mute, Kick перегляд ні


АРІ

Налаштування webhook

API url: https://voip.mik.ua/api.php?set-webhook

Приклад запиту:

{ "url":"https://my.example.com", "events":[ "call", "internal" ], "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
url URL адреса для отримання повідомлень про події. Обов'язкове поле. підтримується тільки https
events Про які події повідомляти. Обов'язкове поле. call сповіщення про виклики
internal сповіщення про зміну статусу телефонів
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Отримання webhook

API url: https://voip.mik.ua/api.php?get-webhook

Приклад запиту:

{ "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "webhooks":[ {"url":"https://www1.example.com", "active":true, "events"=["call"]}, {"url":"https://www2.example.com", "active":false, "events"=["call","internal"]} ], "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
webhooks.url URL адреса для отримання повідомлень про події
webhooks.active признак працездатности. false в разі неможливості виконати запит URL або отримання будь якої HTTP-помилки. true or false
webhooks.events на які події підписано webhook call сповіщення про виклики
internal сповіщення про зміну статусу телефонів
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Видалення webhook

API url: https://voip.mik.ua/api.php?del-webhook

Приклад запиту:

{ "url":"https://my.example.com", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
url URL адреса webhook для видалення. Обов'язкове поле.
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "url":"https://my.example.com", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
url URL адреса webhook яка видаляється.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Повідомлення статусу внутрішнього телефону (internal)

Приклад повідомлення:

{ "event": "internal", "phonenumber": "1001", "status": "Idle", "call": { "uniqueid": "1613123141.17", "src": "+380441234567", "dst": "1001" }, "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
event Тип повідомлення. Обов'язкове поле. завжди internal
phonenumber Номер внутрішнього телефону. Обов'язкове поле. цифры
status Текущий статус телефону. Обов'язкове поле. Idle, InUse, Busy, Unavailable, Ringing, InUse&Ringing, Hold, InUse&Hold, Ring.
call Поточний дзвінок.
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь.

На будь яке повідомлення необхідно надати відповідь - підпис (pbx+timestamp+hash), інакше webhook буде вважатись не працюючим.

{ "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }
Повідомлення виклику (call)

Приклад повідомлення:

{ "event": "call", "uniqueid": "1613123141.17", "src": "+380441234567", "dst": "1001", "status": "Hold", "direction": "INCOMING", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
event Тип повідомлення. Обов'язкове поле. завжди call
uniqueid Унікальний ідентифікатор виклику. Обов'язкове поле. timestamp у форматі float
src Номер телефону викликаючого абонента. Обов'язкове поле.
dst Номер телефону, що викликається. Обов'язкове поле.
status Текущий статус каналу виклику. Обов'язкове поле. Up, Busy, Hold, Down, Ring, Completed.
direction Напрямок виклику. Обов'язкове поле. UNCLEAR, INTERNAL, INCOMING, OUTGOING, TRANSIT.
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь.

На будь яке повідомлення необхідно надати відповідь - підпис (pbx+timestamp+hash), інакше webhook буде вважатись не працюючим.

{ "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }
Повідомлення-перевірка працездатності webhook (ping)

Приклад повідомлення:

{ "event": "ping", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
event Тип повідомлення. Обов'язкове поле. завжди ping
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь.

На будь яке повідомлення необхідно надати відповідь - підпис (pbx+timestamp+hash), інакше webhook буде вважатись не працюючим.

{ "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }
Відомості про стан телефону

API url: https://voip.mik.ua/api.php?get-internal

Приклад запиту:

{ "phonenumber": "1001", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
phonenumber Номер внутрішнього телефону. Обов'язкове поле.
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "phonenumber": "1001", "phonestatus": "Idle", "callerid": "Богдан Миколайович", "deviceaddr": "IPV4/TLS/192.168.1.1/38608", "forwardnumber": "+380501234567", "forward": [ "always", "busy", "noanswer", "unavailable", "together" ], "email": "user@example.com", "voicemail": true, "announce": true, "trunk": "gsm1", "useragent": "Cisco/SPA514G-7.6.2f", "ACL": [ "10.1.1.1", "192.168.1.0/24", "2001:db8::/32" ], "call": { "uniqueid": "1613123141.17", "src": "+380441234567", "dst": "1001" }, "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
phonenumber Номер внутрішнього телефону. цифры
phonestatus Текущий статус телефону. Idle, InUse, Busy, Unavailable, Ringing, InUse&Ringing, Hold, InUse&Hold, Ring.
callerid Ідентифікатор абонента, що буде відображатися при виклику від цього телефону
deviceaddr Інформація про останнє мережеве підключення: Версія інтернет протоколу, тип підключення, IP-адреса, порт. IPV6/TLS/2001:db8::1/37578
IPV4/TCP/10.1.1.1/37364
IPV6/UDP/2001:db8::1/37578
forwardnumber Номер для переадресації викликів.
forward В яких випадках робити переадресацію викликів. Якщо обрано "together", виклик буде одночасно направлено на цей телефон та на номер для переадресації. always, busy, noanswer, unavailable, together
email Адреса електронної пошти для голосової пошти та повідомлень.
voicemail Увімкнення Голосової пошту. Відправка на email. true, false
announce Надсилання повідомлень про пропущені дзвінки та статус реєстрації телефону на електронну пошту true, false
trunk Бажана зовнішня лінія для вихідних дзвінків. Бажана лінія буде обрана якщо є кілька зовняшніх лінії з однаковим шаблоном зовняшньго номеру.
useragent Строка useragent отримана при останньої реєстрації
ACL IP-адреси з яких дозволена реєстрація телефону
call Поточний дзвінок за наявності.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відомості про дзвінок

API url: https://voip.mik.ua/api.php?get-call

Приклад запиту:

{ "uniqueid": "1613123141.17", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
1613123141.17 Унікальний ідентифікатор виклику. Обов'язкове поле.
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "uniqueid": "1613123141.17", "src": "+380441234567", "dst": "1001", "callstatus": "Completed", "direction": "INCOMING", "disposition": "ANSWERED", "start": "2021-02-15 17:18:51+02", "answer": "2021-02-15 17:18:53+02", "end": "2021-02-15 17:19:20+02", "duration": 29, "billsec": 26, "talksec": 26, "waitsec": 1, "priorsec": 2, "callcenter": "support", "cost": 3.23, "currency": "UAH", "missed": true, "record": true, "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
uniqueid Унікальний ідентифікатор виклику. timestamp у форматі float
src Номер телефону викликаючого абонента.
dst Номер телефону, що викликається.
callstatus Текущий статус каналу виклику. Up, Busy, Hold, Down, Ring, Completed.
direction Напрямок виклику. UNCLEAR, INTERNAL, INCOMING, OUTGOING, TRANSIT.
disposition Підсумковий стан виклику. NO ANSWER, FAILED, BUSY, ANSWERED, CONGESTION, BLACKLIST, LIMIT, VOICEMAIL, SMS.
start Початок виклику. 2021-02-15 17:18:51+02
answer Час відповіді на дзвінок. 2021-02-15 17:18:51+02
end Час завршення виклику. 2021-02-15 17:18:51+02
duration Тривалість дзвінка в секундах.
billsec Тривалість оплатного часу дзвінка в секундах.
talksec Час розмови в секундах.
waitsec Час очікування в черзі колцентру, в секундах.
priosec Час до надходження дзвінка в чергу колцентру, в секундах.
callcenter Назва Кол-Центру
cost розрахункова вартість виклику
currency код валюти для cost USD, UAH, EUR
missed признак пропущеного дзвінка true, false
record наявність запису розмови. true, false
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Отримання запису розмови

API url: https://voip.mik.ua/api.php?get-record

Приклад запиту:

{ "uniqueid": "1613123141.17", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
uniqueid Унікальний ідентифікатор виклику. Обов'язкове поле. timestamp у форматі float
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

бінарний аудіофайл у форматі ogg


Створення виклику

API url: https://voip.mik.ua/api.php?dial

Приклад запиту:

{ "phonenumber": "1001", "dial": "+380501234567" "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
phonenumber Номер внутрішнього телефону. Обов'язкове поле.
dial Номер абонента який треба набрати з phonenumber. Обов'язкове поле. тільки цифри, можливо з ведучим "+":
+380441234567
1234567
00380441234567
0441234567
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "uniqueid": "1613123141.17", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
uniqueid Унікальний ідентифікатор виклику. timestamp у форматі float
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Отримання Контакту

API url: https://voip.mik.ua/api.php?get-contact

Приклад запиту:

{ "contactid": 4383, "phonenumber": "0501234567", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Обов'язкове треба зазначити contactid або phonenumber. Параметри:

Назва Опис Допустимі значення
contactid Пошук Контакту за уникальним ідентифікатор контакту. число
phonenumber Пошук Контакту за номером телефону. тільки цифри, можливо з ведучим "+":
+380441234567
1234567
00380441234567
0441234567
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "contactid": 3792, "name": "Іван Іванович", "phonenumbers": ["+380441234567","00380441234567","0441234567"], "personalmanager": 1002, "custom": {"e-mail":"user@example.com", "фірма":"Рога та Копита"}, "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
contactid Унікальний ідентифікатор контакту. Обов'язкове поле. число
name І'мя контакту. Обов'язкове поле. UTF-8 текстова строка до 32 символів
phonenumbers Телефоні номери контакту. Обов'язкове поле.
personalmanager Внутрішній номер телефону призначеного менеджера.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Створення або оновлення Контакту

API url: https://voip.mik.ua/api.php?set-contact

Приклад запиту:

{ "contactid": 4383, "phonenumber": "0501234567", "name": "Іван Іванович", "personalmanager": 1002, "phonenumbers": ["0501234567","5555555"], "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Обов'язкове треба зазначити contactid або phonenumber. Параметри:

Назва Опис Допустимі значення
contactid Оновити Контакт за уникальним ідентифікатором. число
phonenumber Додати номер телефону до контакту або оновити контакт з таким номером телефону тільки цифри, можливо з ведучим "+":
+380441234567
1234567
00380441234567
0441234567
name І'мя контакту. Обов'язкове поле у разі створення нового контакту. UTF-8 текстова строка до 32 символів
personalmanager Внутрішній номер телефону призначеного менеджера.
phonenumbers Список телефонних номерів контакту. Відсутні в цьому списку номери будуть видалені з Контакту тільки цифри, можливо з ведучим "+":
+380441234567
1234567
00380441234567
0441234567
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "contactid": 3792, "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
contactid Унікальний ідентифікатор контакту. Обов'язкове поле. число
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Видалення Контакту

API url: https://voip.mik.ua/api.php?del-contact

Приклад запиту:

{ "contactid": 4383, "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
contactid Видалити Контакт за уникальним ідентифікатором. Обов'язкове поле. число
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Відповідь:

{ "status": 0, "status_message": "success", "actionid": "id-1", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx Назва АТС для запиту. Обов'язкове поле коли status=0.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Команда віртуального діалплану IfAPI

При виконанні команди IfAPI здійснюється запит вказаної в команді URL з наступним інформуванням методом POST (приклад):

{ "event": "ifapi", "uniqueid": "1613123141.17", "src": "+380441234567", "dst": "1001", "status": "Hold", "start": "2021-02-15 17:18:51+02", "answer": "2021-02-15 17:18:53+02", "direction": "INCOMING", "pbx": "mypbxname", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
event Тип повідомлення. Обов'язкове поле. завжди ifapi
uniqueid Унікальний ідентифікатор виклику. Обов'язкове поле. timestamp у форматі float
src Номер телефону викликаючого абонента. Обов'язкове поле.
dst Номер телефону, що викликається. Обов'язкове поле.
status Текущий статус каналу виклику. Обов'язкове поле. Up, Busy, Hold, Down, Ring, Completed.
start Початок виклику. 2021-02-15 17:18:51+02
answer Час відповіді на дзвінок. 2021-02-15 17:18:51+02
direction Напрямок виклику. Обов'язкове поле. UNCLEAR, INTERNAL, INCOMING, OUTGOING, TRANSIT.
pbx Назва АТС для запиту. Обов'язкове поле.
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

У разі відповіді true або 1 - команда IfAPI виконує основну гілку команд, при будь якої іншої відповіді або помилки виконується гілка "ELSE"

true
Створення або налаштування АТС

API url Створення АТС: https://voip.mik.ua/api.php?create-pbx

API url Зміни налаштувань АТС: https://voip.mik.ua/api.php?set-pbx

Приклад запиту:

{ "name": "newpbx", "max_internal": 10, "records_quota": "10G", "actionid": "id-1", "pbx": "GLOBAL", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри:

Назва Опис Допустимі значення
name назва АТС. Обов'язкове поле. текстова строка до 10 символів. Може містити виключно літери латинського алфавіту a-z та цифри 0-9.
description Опис АТС. UTF-8 текстова строка
max_internal Максимальна кількість внутрішніх телефонів. За замовчуванням 100. число
max_virtual Максимальна кількість віртуальних номерів (діалпланів). За замовчуванням 100. число
max_external Максимальна кількість зовнішніх ліній. За замовчуванням 10. число
max_callcenters Максимальна кількість КолЦентрів. За замовчуванням 5. число
store_log_days Скільки днів буде зберігатися журнал викликів. За замовчуванням 90. число
records_quota Максимальний об'єм пам'яті для зберігання записів розмов. 0 запис заборонена. Можливо вказувати об'єм в M - мегабайтах або G гігабайтах. За замовчуванням запис заборонено. строка або число. Наприклад: 100, 500M, 10G.
language Мова АТС за замовчуванням. Може бути змінена в віртуальному діалплане. За замовчуванням Українська. Двобуквений код мови: uk - Українська, en - English, ru - руська
limit_out_connections Максимальна кількість дозволених вихідних одночасних з'єднань. За замовчуванням 10. число
limit_out_daily_duration Максимальна тривалість в хвилинах вихідних викликів протягом доби. За замовчуванням 180. число
limit_daily_cost Максимальна вартість вихідних викликів протягом доби. За замовчуванням 1000. число
currency Валюта для розрахунку вартості викликів. За замовчуванням UAH. UAH, USD або EUR
limit_action Дія в разі перевищення limit_out_connections, limit_out_daily_duration або limit_daily_cost. За замовчуванням 3. число від 1 до 3. 1 - повідомити на admin email, 2 - скидати вихідні виклики, 3 - заборонити вихідні виклики.
active АТС активна (true) чи відключена (false). За замовчуванням true. true або false
actionid ідентифікатор запиту, буде повернуто у відповіді текстова строка до 32 символів
pbx Обов'язкове поле. GLOBAL
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле.
hash md5(pbx:timestamp:apikey). Обов'язкове поле. строка 32 символа. Глобальний ключ API Key.

Відповідь:

{ "status": 0, "status_message": "success", "name": "newpbx", "apikey": "sjk6c0b121ce90e7c38328d875c4ee54", "actionid": "id-1", "pbx": "GLOBAL", "timestamp": 1613125191.2345, "hash": "afe6c0b121ce90e7c38328d875c4e272" }

Параметри відповіді:

Назва Опис Можливі значення
status Код відповіді. 0 - успіх, все інше помилка. Обов'язкове поле. 0 або додатне ціле число
status_message Опис коду відповіді. Обов'язкове поле.
name Назва створеної АТС
apikey API-key створеної АТС. Може використовуватися для подальшого налаштування АТС.
actionid Ідентифікатор запиту, якій було передано в запиті. текстова строка до 32 символів
pbx GLOBAL
timestamp Поточний час у форматі UNIX-TIMESTAMP. Обов'язкове поле коли status=0.
hash md5(pbx:timestamp:apikey). Обов'язкове поле коли status=0. строка 32 символа. API Key можна подивитися в налаштуванні АТС.

Контакти
MyPBX | Контакти ⠀⠀
⠀додати⠀ ⠀імпорт⠀ ⠀експорт⠀
 
Ім`я телефони особистий менеджер
Александрова Анастасия Дмитриевна 5131234,⠀+380991234567
Денисов Никита Максимович 0442341234
Кудрявцев Максим Егорович 4991234,⠀0671234567
Кузнецова Алёна Даниловна 5961234,⠀0931234567
Петрова Валерия Фёдоровна +380501234567,⠀2341234
 

⠀⠀У розділі " контакти " є можливість створити загальну базу абонентів, вона буде відображена таблицею в яку можно імпортувати та з якої можливо єкспортувати дані. Таблиця контактів не обмежується стандартними стовпцями Ім'я і номер, Ви можете додавати власні стовпчики з бажанними аргументами. В роботі з контактами доступний пошук, редагування записів, передивляйтесь і прослуховуйте їх журнали дзвінків.

⠀1.1 Створення контакту - щоб додати новий контакт натисніть ⠀додати⠀ буде відкрито налаштування нового контакту.

 

Новий Контакт

Ім`я:

Буде використовувати як підпис на екрані телефону при викликах. Має бути унікальним.

Менеджер

 

Особистий менеджер.

Телефони:

Один номер телефону на строку.

⠀відмінити⠀ ⠀зберегти⠀
 
  1. Name / Ім’я — Назва контакту, буде відображена на дісплеї телефону під час виклику. Може мати літери маленького і великого регістру, латиниця або кирилиця і числове значення. Створити два контакти з однаковим ім'ям неможливо.
  2. Personal manager / Персональний менеджер — У даному полі надається можливість закріплення особистого менеджера(оператора) за контактом. Ця можливість буде недоступна якщо не створений хоча б один внутрішній номер.
  3. Phones / Телефони — Номер телефону, перерахуйте усі номери контакту, кожний номер повинен починатися з нового рядка. Один номер телефону повинен належати одному контакту.
    Chats / Чати — Це поле з'явиться після створення автоматичного чату і стане можливим в нього додавати контакти. .

⠀⠀Після закінчення редагування користувача натисніть ⠀зберегти⠀. Новий контакт з‘явиться у таблиці. Якщо численність користувачів зросла Ви можете скористатися пошуком, вікно “Search” / “Пошук” над таблицею.

⠀1.2 При необхідності редагування контакту натисніть "edit " навпроти рядка необхідного контакту. З'явиться вікно редагування, по закінченню з котрим необхідно натиснути ⠀зберегти⠀ щоб зміни втупили в силу.

⠀1.3 Створення додаткових стовпців надає можливість мати більше аргументів для нових та вже створених контактів. Натисніть "Налаштування записів контактів ", у відкритій таблиці "Власні поля контактів" натисніть ⠀додати⠀, далі для розширеного налаштування натисніть “Show expert options” / “ Докладно (для експертів) ”.

  1. Name / Назва — Назва колонки.
  2. Type / Тип — В полях стовпця буде один із типів даних:
    • DATE — календарний день, місяць і рік.
    • EMAIL — поштова адреса.
    • FILE — дозволяє завантажити вказаний документ котрий зберігається на сервері. (документи не експортуються)
    • INTEGER — ціле числове значення.
    • SELECT — вибір аргументу із контекстного меню. Щоб створити меню, перелічуйте їх в полі (Default)/(За замовчуванням) з допомогою переходу на іншу строку.
    • TEXT — любий набір тексту без переходу на іншу строку.
    • TEXTBOX - різний набір тексту із можливістю переходу на іншу строку.
  3. Priority / Пріоритет — Пріоритет місця знаходження стовпця. Стовпець з меншим пріоритетом буде з ліва, а стовпець з більшим пріоритетом зправа.
  4. Placeholder / Заповнювач — Поле зразка. У поле буде доданий прозорий текст із можливим зразком его значенням.
  5. Help / Підказка — сюди додаються коментар, цей коментар буде відображений трохи нижче поля вводу інформації, у цьому коментарі можуть бути нагадування для чого саме це поле або що в ньому повинне бути.
  6. Default / За замовчуванням — Заповнивши це поле інформацією, ця інформація буде автоматично додаватися у стовпчик, поки Ви явно не вкажете інші данні. Або якщо у полі “type” / “Тип” стоїть “SELECT” то кожна строчка стає пунктом меню.
  7. Show / Відображати — Якщо вибрано “no” / “ні” стовпець можна приховати. Якщо вибрано “yes” / “Так” стовпець буде відображений у таблиці.
  8. Mandatory / Обов`язкове — Виберіть, чи буде це поле обов'язковим для заповнювання.
  9. Expert / Експерт — Виберіть, чи буде ця опція у відділі розширені.

⠀1.4 Ви можете експортувати усю базу даних контактів, для цього потрібно натиснути кнопку ⠀експорт⠀. Відкриється вікно у якому буде пропонувати зберегти файл у форматі (.xml)

⠀1.5 Ви можете імпортувати існуючу таблицю контактів, для цього натисніть ⠀імпорт⠀. У поле “CSV file:” можна завантажити тільки файли з розширенням .csv для цього буде необхідно експортований документ з розширенням .xml конвертувати у документ з розширенням .csv. Для коректного імпортування потрібно щоб мінімальним числом контактів було не менше десяти.

⠀⠀Вкажіть місце розташування .csv документа. Після его завантаження натисніть ⠀крок 1⠀”.

  1. На першому кроці Вас запитають, Чи присутні на зображенні у першому рядку іменування стовпців. Якщо так натискайте “yes” / “так” якщо ні то “no” / “ні”
  2. На другому кроці необхідно підключати до імен стовпців відповідну категорію стовпця.
  3. На третьому кроці почнеться імпортування контактів.

Зовнішні лінії

⠀⠀2.1 Щоб створити зовнішній номер натисніть кнопку ⠀додати⠀ знизу з’явиться меню створення, натисніть кнопку “Show expert options” / “ Докладно (для експертів) ” для більш детальної конфігурації.

  1. Trunk name / Назва лінії — Будьте уважні при вказанні назви, після збереження можливості редагувати назву вже не буде. Можна використати лише літери латинського алфавіту і цифри.
  2. SIP domain / SIP домен — DNS ім’я або IP-адреса сервера із запущений сервісом котрий надає послуги VoIP.
  3. Transport — Оберіть протокол який буде використаний для передачі голосових даних.
  4. AuthName, Username, Password/Пароль — Поле інформації виданої Вам постачальником зв’язку. Якщо вказати ці поля не вірно, у таблиці " лінії "

    у першому стовпчику “Наживо статус” навпроти створеної лінії буде написано "Відхилено".
  5. Incoming call to/Вхідні дзвінки — У поле вкажіть внутрішній номер (створення внутрішнього розглядається у розділі 3.1), номер Кол-центру (створення Call-centr розглядається у розділі 6.1) або номер діал-плану (створення Dial-plans розглядається у розділі 5.1) якщо вибрати “DISABLE” дзвінок на номер буде відхилений.
  6. Number/Номер - Поле номеру лінії. Обов’язково заповняти у формі E.164 (+380ххххххххх)
  7. Billing/Розрахунок вартості — можна використати вже створений тариф “Kiev Fixed”
  8. E.164 — перетворює номер 4961234 у форму +380444961234
  9. Outgoing call/Вихідні дзвінки — у параметрах потрібно вказати на які номера зможуть дзвонити користувачі.
    • аny — Дозволяє внутрішнім номерам дзвінки на будь-які номера.
    • disable — Забороняє внутрішнім номерам дзвінки на будь-які номера.
    • patterns — Дозволяє внутрішнім номерам дзвінки на вказані у полі “Outgoing patterns/ Вихідні шаблони” номери.
  10. Outgoing patterns/Вихідні шаблони - Синтаксис:
    • X - будь-яка цифра
    • Z - будь-яка цифра в діапазоні 1-9
    • N - будь-яка цифра в діапазоні 2-9
    • . - (крапка) будь-що, що залишилось
    • [Номер] | [Кількість перших цифр для видалення] | [Які цифри потрібно додати на місце видаленої або просто додати якщо вони не видалялись]

⠀Після вдалої з’еднання у таблиці “Зовнішні лінії” у стовпчику “Статус” / “Status” буде відображений статус "Зареєстрований".

⠀2.2 Також є система моніторингу " Table" звідки можна дізнатися скільки було вхідних і вихідних викликів, тривалість і оплатний час. Можете продивлятися статистику як у виді “Таблиця” так і у “Діаграма”.

Налаштування SIP-клієнта (Linphone).

⠀Крім стаціонарних телефонів, Ви можете використовувати програмні телефони. Ми рекомендуємо використовувати linphone. Це безкоштовне кросплатформне програмне забезпечення для операційних систем Windows, Linux, MacOS, а також смартфонів на базі Android та IOS.

⠀Ви можете безкоштовно завантажити linphone на офіційному сайті «linphone.org», для смартфонів знайти програму в «google play» та «itunes».

⠀Під час першого запуску застосунку, погодьтесь з ліцензійною угодою, тільки після підтвердження стане доступним налаштування телефону. Оберіть «use sip account».

⠀Після того, як адміністратор створив внутрішній телефон, його налаштування будуть відображені в головному меню розділу «Внутрішні телефони», також якщо вказали поле E-mail на вказану пошту, будуть надіслані конфігураційні дані.

⠀Username - Складається з назви Вашої PBX та унікальний внутрішній номер телефону розділені нижнім прочерком. (Якщо номер використовується іншим пристроєм, при спробі зареєструватися, вони почнуть конкурувати за підключення до PBX і обидва пристрої не працюватимуть повноцінно)

⠀Password - Не використовуйте слабкі паролі, паролі не зберігаються на сервері.

⠀Domain — Ім'я сервера, що поставляє послугу ATC.

⠀Display name - не обов'язкове поле, буде відображено навпроти номера в головному меню linphone. Може служити коментарем до номера, це зручно коли використовуються декілька номерів.

⠀Transport — Виберіть TLS, ми рекомендуємо використовувати шифрування.

⠀Після введення всіх параметрів натисніть "Login". Підтвердженням правильного налаштування стане статус телефону "connected", у головному меню linphone.

⠀Ввімкніть сповіщеня роботи linphone в фоновому вікні та автоматичний запуск застосунку при старті пристрою. В меню налаштувань, у розділі «advanced» перемикніть повзунок на опції «background mode» і «Start at boot time» в активний стан.

⠀Багато програм на смартфонах переходять в режим енергозбереження і частково відключають свій функціонал. Для повноцінної роботи linphone рекомендується вимкнути це обмеження. Для відключення зайдіть у меню «settings», у розділі «advanced» виберіть меню «battery optimization settings». Далі необхідно вказати смартфону контроль фонової активності Linphone. Вкажіть: без жодних обмежень.

⠀Щоб додати linphone в автозапуск, зайдіть у меню «settings», у розділі «advanced» виберіть меню «power manager setting». В меню автозапуску посуньте повзунок в активний стан. Кожного разу при старті смартфона linphone буде завантажуватися самостійно.

⠀Надайте дозволи тимчасових сповіщень. Зайдіть у меню «settings», у розділі «advanced», виберіть меню «Android app settings». В меню інформації про програму Linphone, обов'язково налаштуйте «Сповіщення» - Показувати сповіщення, Дозвольте сповіщення на екрані блокування, Дозвольте відтворення звуку і Дозвольте світлову індикацію.

⠀Ще в меню інформації про програму Linphone, вкажіть «Інші дозволи» - Показувати на екрані блокування, спливаючі вікна.

⠀В меню інформації про програму Linphone, налаштуйте «Обмеження трафіку» - Вкажіть із яких мереж може працювати linphone. Бажано ввімкнути Wi-Fi і мобільну мережу, linphone не потребує великого об'єму мережевого трафіку.

⠀Pекомендуємо включити SRTP. У налаштуваннях програми зайдіть у розділ «Call». Знайдіть поле «Media encryption» і виберіть зі спливаючого меню значення SRTP. А також можете перетягнути повзунок в активний стан навпроти поля "Media encryption mandatory" тим самим вказавши щоб медіа шифрування було обов'язковим.

Внутрішні телефони

⠀⠀У розділі " телефони " створіть внутрішні номери для операторів, обмежте IP-адреси з яких можна реєстуватися на АТС та мажливість шифрування. Налаштовуйте голосову пошту та інші повідомлення на e-mail, вкажіть випадки переадресації з цього номеру на інші .

⠀3.1 Щоб створити новий внутрішній номер натисніть кнопку ⠀додати⠀ у відкритому вікні натисніть "Show expert options" / "Докладно (для експертів)" для більш детальної конфігурації.

  1. Phone Number / Номер телефону — Унікальний номер.
  2. Caller Id / Ідентифікатор — Поле може мати довільний текст. це може бути Ім'я володаря номеру, або будь-яка інша інформація.
  3. Password / Пароль — поле генерується автоматично чи можна завдати його самостійно.
  4. Forward number / Переадресація — Вкажіть номер, на який буде виконано переадресацію. Нижче у полі "When" вкажіть випадок переадресації
  5. When / Коли — Переадресація буде відбуватися у випадках...
    • always / завжди — Виклик негайно буде переадресований на вказаний.
    • busy / зайнято — Переадресація у той час коли абонент уже розмовляє, ігнорує або у стані "Не турбувати"
    • noanswer / не відповідає — Переадресація при тривалому очікуванні.
    • unvaliable / недоступний — Переадресація коли телефон вимкнутий або не під'єднаний до мережі
    • together / разом — Дзвінок на номер телефону і на номер переадресації одночасно.
  6. E-mail — На вказану пошту будуть відправлені голосові повідомлення і повідомлення якщо трапилась несправність.
  7. Voicemail / Голосова пошта — Якщо вибраний пункт меню “yes” / “так” голосові повідомлення будуть приходити на вказану у полі “E-mail” адрессу.
  8. Announces /Повідомлення — Надсилання повідомлень про пропущені дзвінки та статус реєстрації.
  9. Permit / Дозволи — Дозволити підключення телефону лише з вказаних IP-адрес.
  10. Encryption / Шифрування — Якщо Вибрано “yes” / “Так” тоді необхідно налаштовувати телефон внутрішнього номера на роботу з SRTP для шифрування інформації при передачі її у відкритих мережах і TLS який забаспечує захист від перехвату та модіфікації службового повідомлення SIP. Поле “yes” / “Так” говорить про то що TLS+RSTP повінен бути примусово і телефон з невірно налаштованими параметрами не буде зареєстрований. Якщо “no” / “Ні”, зашифроване з’єднання бажане але не обов’язкове.
  11. Бажана лінія / Preferred trunk — Вкажіть з випадаючого меню ім'я транка який буде використовуватися внутрішнім телефоном для виконання дзвінків. Якщо виставлено значення "DEFAULT", дзвінок буде ініційований з менш навантаженої лінії.

⠀Після створення внутрішнього телефону з’явиться інформація котра необхідна для налаштування кінцевої точки. Запам’ятовувати її не обов’язково, натисніть " Налаштування телефону" Ви побачите ідентичну інформацію, але вже без пароля, его потрібно створювати по-новому.

⠀Після вдалої підключення у таблиці " телефони " у стовпчику "Status" / "Наживо" буде відображений статус Idle / Вільний .

⠀3.2 Також є можливість слідкувати за кожним номером окремо, загальна кількість викликів, число відповідей, тривалість розмови. Натисніть "Chart ".

Пропущені та Заплановані

⠀" пропущені ", missed calls — запис з’явиться якщо ніхто із внутрішніх номерів не відповів.

    пропущені виклики
    1. Кол Центр / Call Center — назва кол-центру який не відповів
    2. Контакт / contact — номер та ім'я контакту(якщо створений) якому не відповіли.
    3. Вперше / first — дзвінок що був пропущений вперше.
    4. Останній / last — дзвінок що був пропущений востаннє.
    5. Всього / total — загальне число пропущених дзвінків.
    зворотні виклики
    1. Внутрішній / internal — номер та ініціали внутрішнього номера, від імені якого буде зроблений зворотній віклик.
    2. Вперше / first — час першого невдалого зворотного дзвінка.
    3. Останній / last — час останнього невдалого зворотного дзвінка
    4. Всього / total — загальна кількість невдалих зворотніх дзвінків.
    5. Внутрішній / status — SCHEDULED: дзвінок запланований. NO ANSWER: на зворотній запланований дзвінок ніхто не відповів.

⠀якщо співробітник або клієнт врешті зможуть почати розмову, то по кінцю бесіди запис про пропущений виклик самостійно видалиться. Щоб запланувати виклик з пропущеним номером, натисніть "Запланувати дзвінок ".

Далі піде мова про налаштування запланованого дзвінка.

4.2 Для налаштування запланованого дзвінка у меню " заплановані " натисніть ⠀додати⠀, (Запланувати новий дзвінок).

  1. Телефон — номер телефону з котрим заплановано телефонна бесіда.
  2. Дата — вкажіть дату коли відбудеться дзвінок.
  3. Час — вкажіть час коли відбудеться дзвінок.
  4. Від — вкажіть з яким саме співробітником буде дзвінок, виділити можна декілька.
  5. Повторів — скільки загалом дзвінків буде якщо попередні були пропущені.
  6. Затримка — з яким періодом часу будуть наступні дзвінки якщо попередні були пропущені.
  7. Автовидалення — Чи видаляти запланований дзвінок якщо він був зроблений раніше запланованого.
Віртуальні номери

    Створення віртуальних номерів (Dial-plan) дозволяє автоматизувати обробку викликів. Діал-план покроково описує роботу із дзвінками або зверненню до чату. Усі можливості будуть перелічені далі. Щоб створити Dial-plan перейдіть у розділ " віртуальні " і натисніть ⠀додати⠀.

   
  1. Номер телефону — унікальний числовий номер.
  2. Опис — коментарі або нагадування.
  3. тип — телефон, чат або шаблон.
  • Телефон — обравши цей тип, ви можете вказати дії для дзвінків, що надходять на цей номер діал-плану. Після створення, номер діал-плану з'явиться у налаштуваннях “Зовнішні лінії“ під час створення або редагування зовнішніх ліній.
  • Чат — для створення чат-бота. Після створення, можна обрати в налаштуваннях “Чати”
  • Шаблон — у цьому випадку, поле номер телефону може приймати додаткові символи, які відповідають за групу цифр. Символ ( . ) крапка наприкінці шаблону позначає довільну кількість будь-яких цифри від нуля до дев'яти. Літера X - позначатиме одну цифру значенням від нуля до дев'яти. Літера Z - будь-яка цифра в діапазоні від одного до дев'яти і символ N - будь-яка цифра в діапазоні від двох до дев'яти.
  •   Наприклад: необхідно вказати групу номерів (+380501060000 — +380501069999)

      Рішення: +38050106. або +38050106XXXX

        Після створення віртуального номера натисніть "редагувати діалплан ". З’явиться діал-план віртуального номера. Додайте команду і збережіть параметр натиснувши "Save ". Щоб створювати додаткову команду натисніть "Додати нову команду після цієї ", усі команди діал-плану виконуються по черзі, тому її потрібно вірно розташувати в черзі, якщо потрібно редагувати послідовність виконання натисніть "Up " або "Down ". Щоб редагувати команду натисніть "Edit ".


    Команди діал-плану.

      AssociatedCC

       Виберіть із списку існуючий Кол Центр. В результаті виконання команди виклик буде відмічено в журналі як викликів до кол-центру, навіть якщо абонент не зв'язувався з кол-центрами. Якщо команд цього типу в діал-плані кілька в журнал буде записана остання виконана команда.


      Callback

       Створення запланованого дзвінку із внутрішнього номера до абонента.

      Опція Опис
      Час З якої по яку годину ви плануєте зробити виклик.
      Святкові дні Виберіть “Ні” якщо Ви не хочете турбувати абонента запланованим дзвінком у святковий день.
      Робочі дні в суботу або в неділю Виберіть “Ні” якщо Ви не хочете турбувати абонента запланованим дзвінком у вихідний день.
      Від Номера внутрішніх абонентів від якого пролунає дзвінок абоненту.
      Затримка Початкова затримка, скільки потрібно часу до дзвінка після створення запланованого виклику.
      Випадкова затримка У вказаному числі випадково буде вибрано значення, воно стане числом хвилин до виклику (складеться з полем “Затримка”).
      Спроб Максимально число Спроба зв'язати до абонента.
      Очікування Період в хвилинах між повторними дзвінками.

      CallCenter

       Виберіть у меню кол-центр який ви хочете додати до діалплану. Якщо у абонента виконається команда, на вказаний вами Кол-центр відбудеться виклик.


      Comment

       Додайте інформацію для нагадування. Інформація у цьому полі ні на що не впливає і ніде не буде відображена, окрім списку команд.


      Conference

       Створіть або виберіть із вже створених конференцію, якщо під час дзвінка виконається команда "Conferenc", абонент буде направлений до наради.


      DisplayName

       Абонант проходячи через цю команду, буде відображений у оператора під ім'ям вказаним в полі.


      EndCall

       Зазначте один із типів завершення виклику.

      Опція Опис
      Повісити слухавку Телефонна розмова буде завершена.
      Зайняте Абонент буде чути короткі гудки.
      Затор Абонент інформується про перевантаження лінії.

      ExternalDial

       (команду використовують для шаблону) Виконання команди дозволяє внутрішньому телефону конкретно вказати яку зовнішню лінію використовувати для здійснення дзвінка. Якщо вибрано значення параметра “INTERNAL SETTINGS” для кожного окремого внутрішнього телефону буде використовуватися лінія, яку вказує параметр "Бажана лінія" в налаштуваннях облікового запису телефону.


      ifAPI

      ⠀⠀Дозволяє обрати гілку діалплану на основі зовнішнього http-запиту. При здійсненні запиту POST методом передається інформація про виклик яка включає унікальний ідентифікатор, номер абонента та номер призначення , початок розмови, стан та її напрямок. Якщо у відповіді на цей запит буде true або 1 виконується основна гілка “ifAPI”, при будь якої іншої відповіді або помилки виконується гілка “ifAPI-ELSE”.

      ⠀⠀В АТС вже є декілька скриптів котрими Ви можете скористатися.

      src.php - Необхідний у випадку якщо потрібно зробити виключні дії для окремих внутрішніх номерів. Пиймає за параметр номери внутрішнього номеру телефону, до якого повинен застосуватися шаблон, або вираз декількох внутрішніх номерів. У випадку співпадання шаблону буде виконуватися гілка ifAPI-TRUE. Приклад:

      [https://voip.mik.ua/ifapi/src.php] - мережеве росташування скрипта та його назва

      [?] - після цого вкажить параметри номерів

      [&] - перелічуйте номери для шаблонів через амперсант

      [X] - на місці символа Х може знаходитись будь-яка одна цифра від нуля до девяти.

      [.] - (крапка), скільки завгодно чисел, з будь-яким значенням від нуля до девяти

      Потрібно зробити виключення для номерів 101, 104, 105, 108, 131.

      https://voip.mik.ua/ifapi/src.php?101&104&105&108&131

      співпадання номеру - 100-199.

      https://voip.mik.ua/ifapi/src.php?1XX

      співпадання номеру - усі номери котрі починаються з цифри '4' і мають будь який розмір і значення цифр після неї.

      https://voip.mik.ua/ifapi/src.php?4.

      співпадання номеру - усі номери.

      https://voip-dev2.mik.ua/ifapi/src.php?X.

      dst.php - Приймає за параметр номери зовнішнього номеру телефону, до якого повинен застосуватися шаблон, або вираз декількох зовнішніх номерів. у випадку співпадання шаблону буде виконуватися гілка ifAPI-TRUE. Приклад:

      [https://voip.mik.ua/ifapi/dst.php] - мережеве росташування скрипта та його назва

      [?] - після цого вкажить параметри номерів

      [&] - перелічуйте номери для шаблонів через амперсант

      [X] - на місці символа Х може знаходитись будь-яка одна цифра від нуля до девяти.

      [.] - (крапка), скільки завгодно чисел, з будь-яким значенням від нуля до девяти

      співпадання номеру - 0501060421.

      https://voip.mik.ua/ifapi/dst.php?0501060421

      співпадання номеру - 0501060000-0501069999

      https://voip.mik.ua/ifapi/dst.php?050106XXXX

      співпадання номеру - усі номери Vodafone.

      https://voip.mik.ua/ifapi/dst.php?050.&066.&095.&099.


      IfTime

         Створення гілки діал-плану яка буде виконуватися у випадку якщо абонент зателефонував у час вказаний у “ifTime”.

      Опція Опис
      Час from Період з якого по який час виконувати команди ifTime.
      День вкажіть дні неділі що будуть потрапляти до команд ifTime.
      Святкові дні Якщо встановити параметр “Так” святкові дні будуть потрапляти до команд ifTime. Параметр ігнорувати, не бере до уваги умову.
      Робочі дні в суботу або неділю Якщо встановити параметр “Так”, в вихідні дні будуть потрапляти до команд ifTime. Параметр ігнорувати, не бере до уваги умову.

         Якщо абонент зателефонував за межами вказаного часу буде виконаний блок “ifTime-ELSE”.


      InternalDial

         Команда робить виклик на внутрішній номер.

      Опція Опис
      Очікування Час очікування з’єднання з оператором. По закінченню часу звернення піде на наступну команду.
      Липкість Буде спроба зателефонувати останньому внутрішньому номеру з котрим була розмова (внутрішній номер лише в межах вказаний у параметрах InternalDial).
      Разом дзвінок буде направлено усім вказаним внутрішнім номерам та на телефон переадресації.

      IVR

         Ця команда надає можливість створення голосового меню. Потрібно щоб попередньо створений файл (назва файлу повинна бути латинськими літерами) у форматі .wav або .mp3 був завантажений в поле “Аудіо”. Від абонента буде очікуватися цифрова відповідь. Перелічте можливі відповіді через кому у полі “Відповіді”. Якщо поставити галочку навпроти поля “Донабор внутрішнього номера” абонент може набрати номер внутрішнього телефону під час голосового меню і його буде направлено на вказаного внутрішнього номера.


      IVR-text

       Теж саме що і IVR але замість аудіо файлу потрібно написати текст який буде відтворений.


      Language

       Встановлення мови для користувача діалплану. Усі подальші системні повідомлення будуть на вказаній мові.


      Mark

         Додає позначку. Побачити позначки можливо у розділі “Журнал”. Позначки заносяться під час роботи абонента з діал-планом, якщо абонент покроково переходив по цим командам.

      Опція Опис
      Mark Виберіть існуючу позначку або виберить "НОВА" и вкажіть назву в полі "Назва"
      Назва Вкажіть ім’я нової позначки (якщо вона нова, вона буде створена).
      Опис Коментарій до позначки.

      NotifyMissed

      ⠀Команда приймає за параметр одну електронну адресу. Після виконання команди "NotifyMissed", якщо дзвінок з оператором не відбувься, на вказаний e-mail буде надіслане повідомлення про пропущений виклик. Інформування про пущений виклик відбувається лише один раз, тобто усі наступні (номер з якого телефонували) повторні дзвінки до операторів або Колл-центру (на який вже телефонували), на які не було відповіді будуть замовчуватися.


      OutgoingDial

      Команда виконує дзвінок з вказаної лінії на вказаний зовнішній номер.


      PersonalManager

       При виконанні цієї команди в діал-плані, абонента буде направлено до закріпленого за ним персонального менеджера.

      Опція Опис
      Очікування Вкажіть максимальне число секунд яке розраховане на відповідь персонального менеджера.
      Примусово Якщо цей параметр вимкнений після закінчення часу “Очікування” наступні кроки діал-плану не виконуються. Якщо цей параметр включений, номер після закінчення часу “Очікування” буде використовувати переадресацію і голосову пошту (переадресацію і голосову пошту потрібно налаштовувати у розділі “Телефони”).

      PlayAudioFile

       В поле додається аудіо файл (назва файлу повинна бути латинськими літерами), який моє розширення .wav або .mp3. Цей запис буде програватися для абонента (абонент не може його пропустити до його завершення).


      Speak

       В поле задається текстове повідомлення (на разі можливе на трьох мовах). Під час виконання команди для абонента буде вимовлено написаний текст.


      Virtual

       Команда відправляє абонента на інший діалплан


      Voicemail

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

    Кол - центри

    ⠀⠀Створення Кол-центру надає можливість: Відображення стану операторів (зайнятий, вільний, пауза). Розподіл дзвінків всередині групи по завантаженню операторів і по порядку. Запис розмов, підслуховування і нашіптування. Контроль якості роботи операторів. Планування розкладу робочих змін операторів.

    6.1 Щоб створи Кол-центр натисніть ⠀додати⠀.

    1. Назва / Name — Унікальне ім’я, після створення змінити не можливо. Може складатися із літер латинського алфавіту.
    2. Опис / Description — Поле для опису, нагадування.
    3. Оператори / Agents — Виберіть декілька операторів використовуючи Ctrl+ЛКМ.
    4. Довжина черги / Max length — Максимальна кількість клієнтів котрі чекають у черзі до зв’язку з оператором. Не встановлюйте це значення більше за можливу кількість одночасних з’єднань зовнішніх ліній.
    5. Стратегія / Strategy виберіть як будуть розподілені вхідні дзвінки між операторами.
      • ringall — Дзвонити всім доступним операторам.
      • leastrecent — Розподіляє дзвінки між операторами на тих хто менш зайнятий.
      • Fewestcalls — Спочатку виклик піде на оператора з найменшим числом відповідей.
      • random — Дзвонити випадковому оператору.
      • rrmemory — Дзвонити випадковому оператору але розподіляє дзвінки між операторами на тих хто менш зайнятий.
    6. Максимальне очікування / Absolute timeout — Максимальний час очікування в черзі до оператора.
    7. Очікування / Timeout — Час після котрого для клієнта буде вибраний інший оператор.
    8. Очікування повтору / Retry Timeout — період між з’єднанням з наступним оператором.
    9. Час після дзвінка / Wrap uptime — Скільки часу потребується після вдалого дзвінка щоб рахувати оператора вільним і він міг знову приймати дзвінки.
    10. Підключення до порожнього / Join empty — Якщо немає зареєстрованих операторів у мережі, дзвінок до кол-центру буде відхилено.
    11. Видалити з порожнього / Leave when empty — Якщо у мережі не залишилось зареєстрованих операторів, то усі клієнти котрі чекали у черзі будуть видалені, та можуть бути обробленими подальшим діал-планом.
    12. Сповіщати очікування / Report holdtime — Дає голосове повідомлення оператору про те, скільки клієнт очікував.
    13. Оголошення першому абоненту / Announce to first user — Оголошує першому клієнту номер в черзі.
    14. Оголошення очікування / Announce holdtime — інформує середній час очікуванні в черзі.
    15. Оголошувати позицію / Announce position
      • Так — клієнта будуть сповіщати про его позицію у черзі.
      • Ні — ніякого сповіщення не буде.
      • Ліміт — потрібно вказувати діапазон позицій які будуть оголошуватись у полі “Ліміт оголошення позиції” усі поза чергою не будуть інформовані.
      • Більше — оголошення позиції до вказаної у полі “Ліміт оголошення позиції” і усім хто буде з вищим номером позиції будуть сповіщення про те що вони в черзі з числом вище вказаного у полі “Ліміт оголошення позиції”.
    16. Ліміт оголошення позиції / Announce position limit — ліміт позицій для режиму оголошення ( Приклад 1: якщо у полі “Оголошувати позицію” стоїть “Ліміт” а в полі “Ліміт оголошення позиції” стоїть значення “5” то лише перши п’ять абонентів будуть проінформовані о своїй позиції у черзі. Приклад 2: якщо у полі “Оголошувати позицію” стоїть “Більше” а в полі “Ліміт оголошення позиції” стоїть значення “5” усіх абонентів чий початковий номер буде більше п’яти будуть інформовані про те що, перед ними у черзі що найменше п’ять абонентів ).
    17. Тільки покращення позиції / Announce position only up — Повідомляє тільки у тому разі якщо позиція покращилась.
    18. Частота оголошень / Announce frequency — через який період часу буде оголошено абоненту його позиція у черзі. Першого абонента в черзі завжди буде оголошувати один раз у 40 секунд.
    19. Мін. частота оголошень / Min. announce frequency - через який період часу буде оголошено абоненту його позиція у черзі, після покращення позиції.
    20. Частота періодичних оголошень / Periodic announce frequency — через який період часу абонента будуть інформувати про те що усі оператори зайняті.
    21. Рівень обслуговування 1 / Service Level 1 - Абонент вважається обслугованим вчасно, якщо на дзвінок відповіли протягом вказаних в цьому параметрі секунд.
    22. SLA 1 — Відсотковий параметр мінімально необхідного рівня обслуговування.
    23. Рівень обслуговування 2 / Service Level 2 - Абонент вважається обслугованим вчасно, якщо на дзвінок відповіли протягом вказаних в цьому параметрі секунд.
    24. SLA 2 — Відсотковий параметр мінімально необхідного рівня обслуговування.
    25. Користувачі / Users - У списку ви побачите користувачів наявної PBX. Вибравши одного або декілька із списку, користувач незалежно від налаштувань в розділі "Управління користувачами" отримує можливість переглядати і прослуховувати, всі дзвінки у журналі які надходили у налаштований кол-центр. Також будуть відображені записи дзвінків які під час виклику проходили через команду діл-плану "AssociatedCC" налаштованого кол-центру.
    26. Автопауза / Autopause — Надає можливість у випадку відсутності відповіді оператора автоматично поставити його телефон на паузу.
    27. Затримка автопаузи / Autopause delay — Цей час проти якого автопауза не застосовується. Відлік часу починається з моменту закінчення розмови цим оператором.
    28. Пауза 0 / Pause 0 — Системна пауза, вона повинна бути, її можливо перейменувати.
    29. Пауза 0 буде використовуватися в якості автопаузи.

    30. Нові паузи / New pause status — Можна додати одну чи декілька пауз які можна включати вручну.

      На приклад: Якщо автопауза увімкнена та у полі “Затримка автопаузи” стоїть значення “60”, тоді відлік часу почнеться відразу від кінця останнього вдалого дзвінка і лише через 60 секунд буде рахуватися відсутнім.

    ⠀Після створення кол-центру потрібно вказати за котрою зовнішньою лінією він закріплений (див. Розділ 2.1) або додати его в віртуальні (див. Розділ 5.3).

    ⠀Якщо натиснути "chart " навпроти певного кол-центу, буде відкрита діаграма у котрій буде підсумкова інформація об усіх викликах до усіх операторів. Число відповідей на дзвінок, втра чених дзвінків, параметр мінімально необхідного рівня обслуговування, час котрий був затрачений клієнтом у інтерактивному голосовому меню, час очікування в черзі, мінімальну середню і максимальну довжину бесіди.

    6.2 Також можливе редагування кожного оператора у кол-центрі, натисніть "edit " навпроти необхідного оператора.

    • Пауза / Pause — Можна вказати автопаузу, якщо ви знаєте що оператора не буде певний період за телефоном.
    • Пріоритет / Priority — поки є оператори з меншим пріоритетом, операторів з вищим пріоритетом турбуватися не будуть.
    • Видалити / Delete — натисніть галочку “Так” та “Зберегти” щоб підтвердити видалення. Буде видалений оператор і уся зібрана інформація цього оператора.

    ⠀Щоб подивитися усю зібрану інформацію про кожного оператора, натисніть "chart " навпроти необхідного оператора. В таблиці зображено число відповідей на дзвінок, втрачених дзвінків, параметр мінімально необхідного рівня обслуговування, мінімальну середню і максимальну довжину бесіди.

    ⠀6.3 Щоб подивитися детальну інформацію, натисніть дашборд певного кол-центру. Побачите три таблиці, перша описує загальний стан кол-центру, у другій статистика по кожному оператору роздільно, третя онлайн показники абонентів.

    Перша таблиця:

    • Період — період часу за котре відбувались події.
    • Відповіли — кількість дзвінків на котрі відповіли.
    • Втрачено — кількість дзвінків на котрі не відповіли.
    • Всього — загальна кількість дзвінків.
    • ср.доКЦ — середній час витрачений абонентом до зв’язку з кол-центром (може бути череда дій із dial-plans)
    • ср.очік — середній часу очікування у черзі до зв’язку з оператором.
    • ср.розм — середній часу розмови з оператором.
    • Завантаження черги — у шкалі зображено рівень завантаження кол-центру абонентами. Якщо світло блакитного кольору це максимальний показник за увесь час. Якщо блакитного це середній показник за увесь час.
    • Рівень обслуговування — кількість дзвінків які були обслуговані завчасно, стосовно рівня обслуговування оди і два.
    • Оператори — підсумок операторів по стану їх телефонів.

    ⠀Ви можете створити власний статистичний рядок, для цього натисніть ⠀додати⠀"Додати статистику". Якщо вибрати “За аналогічний день тижня” буде відображена підсумкова інформація цього дня усіх попередніх неділь. Якщо вибрати “Попередні 7 днів” буде відображена інформація лише останніх 7 днів котра буде резюмуватися кожен день. Або вкажіть власноруч “Користувацький період” з якої дати по яку.

    ⠀Можливо змінити відображення таблиць. Натисніть “Змінити зовнішній вигляд лічильників”. У таблиці буде відсотковий вигляд або абсолютний показник плюс відсотковий.

    Друга таблиця:

    • Статус - Cтан у якому знаходиться телефон оператора (Не під’єднаний, Дзвін, Готов, Пауза, Зайнято).
    • Останній виклик — Скільки часу пройшло від останнього влучного виклику конкретному оператору або “now” зараз розмовляє.
    • Відповідей — Число відповідей на дзвінок, за сьогодні і за у весь час.
    • Втрачено — Число втрачених дзвінків, за сьогодні і за у весь час.
    • Дзвоник — Усереднений показник часу скільки абонент чекав зв’язку з оператором.
    • Розмов — Усереднений показник скільки часу триває розмова з оператором.
    • SL1, SL2 — Параметр мінімально необхідного рівня обслуговування.
    • Оператор — ім’я та номер оператора.
    • Співрозмовник — номер телефону и ім’я абонента якщо він є списку контактів.
    • Управління — У цьому стовпчику можливе включення або вимкнення паузи. Щоб увімкнути паузу натисніть навпроти необхідного оператора на кнопку “змінити паузу”. Якщо ж видалити паузу натисніть “unPause”. Якщо у Вас є права supervisor з налаштованим номером телефону, то під час розмови у цьому ж полі з’явиться кнопки "Listen " і "Whisper ". “Listen” дає змогу прослуховувати розмову абонента і оператора так щоб вони не чули Вас. “Whisper” дає змогу підслуховувати бесіду і розмовляти з оператором так щоб абонент Вас не чув.

    Третя таблиця:

    • Позиція — Номер в черзі.
    • Початок — Час початку з’єднання
    • Тривалість — Загальний час від початку взаємодії абонента з діал-планом до повного закінчення зв’язку.
    • Очікування — Час котре витратив абонент до зв’язку з оператором.
    • Розмова — Час витрачений на розмову з оператором.
    • Абонент — Номер та ім’я абонента якщо про нього є інформація у розділі контакти. А також назва зовнішньої лінії через яку дзвонить абонент.
    • Оператор — у момент виклику буде список усіх доступних операторів, у час розмови номер і ім’я оператора.
    Чати і Конференції

    ⠀7.1 В цьому розділі буде налаштований чат для автоматичної письменної відповіді абонентам. Щоб створити чат перейдіть у розділ " Чати " і натисніть ⠀додати⠀.

    1. Name / Назва — Назва чат боту, може складатися із цифр і літер латиниці та кирилиці
    2. Welcome / Привітання — зміст цього поля буде відображений у абонента котрий тільки що під’єднався до чату.
    3. Call Centr / Кол Центр — на усіх операторів вказаного кол-центра будуть приходити сповіщення о нових повідомленнях у чаті.
    4. Pause / Пауза — Вкажіть на яку паузу переключати оператора коли він розмовляє у чаті.
    5. New pause / Нова пауза — Створення нової паузи.
    6. ViberBot — у поле потрібно вставити token, його можна скопіювати із приватного кабінета.
    7. TelegramBot — у поле потрібно вставити token, його можна скопіювати із приватного кабінета.
    8. Startup Robot / Початковий Робот — вкажіть створений діал-план, про його створення мова піде далі.

    7.2 Щоб створити шаблонний чат для бота, перейдіть у розділ "віртуальні" та натисніть ⠀додати⠀.

    1. Номер телефону — унікальний числовий номер.
    2. Опис — коментарі або нагадування.
    3. тип — "чат" для створення шаблонних діалогових меню чат-бота.

    7.3 Після створення діалплану, натисніть "редагувати діалплан " для створення шаблона діалогу.

    1. Comment — зміст цього поля не буде відображено у чаті, поле для нагадування.
    2. IfTime — створення умови. В поле вказується:
      • час — Проміжок часу підпадаючого під умову “ifTime”.
      • день — Виділіть усі дні неділі підпадаючи під умову “ifTime”.
      • Святкові дні — Вкажіть “ні” щоб святкові дні не підпадали під умову “ifTime” Робочі дні в суботу або в неділю — Вкажіть “так” щоб святкові дні не підпадали під умову “ifTime”. Можна створювати власний список святкових днів у розділі “datelist”.

      ⠀Після створення “ifTime” буде додатково створений “ifTime-ELSE” і “ifTIme-ENDIF”. Якщо абонент напише у час котрий підпадає у вказаному часі у полі “IfTime” буде виконано наступні вами створена задача. Щоб створи наступну задачу необхідно натиснути "Додати нову команду після цієї " навпроти поля “ifTime”.

      ⠀ifTime-ELSE — Якщо абонент почав чат за межами вказаного часу в полі “ifTime”, буде виконуватися задача із поля “IfTime-ELSE”. Щоб створи наступну задачу необхідно натиснути "Додати нову команду після цієї " навпроти поля “ifTime-ELSE”.

      ⠀ifTIme-ENDIF — закінчення умови в нього можна додати прощальне повідомлення.

    3. SendMessage — зміст повідомлення може бути відправлений в чат.
    4. SendRequest — поле із запитом і очікуванні відповіді від абонента.
      • Запит — В цьому полі краще вказати що шукати, після цього поля буде очікуватися відповідь від абонента.
      • Відповідь (1, 2, 3 ...) - Записуються як регулярні вирази. Напишіть зразок відповіді від абонента у скісних рисках, Приклад: /зразок відповіді/. Якщо передбачається декілька варіантів однієї відповіді, перелічуйте їх через вертикальну риску, Приклад: /зразок відповіді 1 | зразок відповіді 2/. Якщо у відповіді передбачається невідоме змінне число літер або чисел. Приклад:
      • /зразок ві[а-яА-Я]*ді 1 | зразок відповіді [0-9]*/.

      • Повторів — Це поле буде відображено клієнту у випадку невірного відповіді на запит.
      • Повторний запит — скільки разів буде відображено поле “Повторів” у випадку невірної відповіді на запит.
     
     

    ⠀Щоб створити нараду, додайте в діал-план команду "Conference". Команда "Conference" приймає параметр баженої назви, під цією назвою надалі буде відображена конференція у розділі " Наради ".

    ⠀Керувати нарадою може користувачь тільки з правами "Admin". Адміністратор PBX здатний видаляти абонентів з наради або обмежити можливість учаснику конференції розмовляти.

    ⠀Щоб обмежити можливість учаснику конференції розмовляти натисніть " Mute " на впроти необхідного абонента.

    ⠀Щоб повернути можливість участника розмовляти натисніть " unMute ".

    ⠀Щоб видалити із конференції абонента натисніть " Kick ". Але майте на увазі що, ця дія не припинить його виклик, абонент покине конференцію але виконання команд діал-плану продовжиться з останнього місця.

    Дзвінки зараз та Журнал

    8.1 У розділі " дзвінки зараз" можна зібрати інформацію:

    • Початок — Дата і час початку дзвінка.
    • Тривалість — Загальна тривалість дзвінка.
    • Хто телефонує — номер телефону та ім’я абонента чи оператора.
    • До кого — У полі може бути номер абонента чи оператора, номер діалплану.
    • Статус — Утримання якщо абонент чекає відповіді. З’єднано якщо абонент відповідає на голосові меню або розмовляє з оператором.
    • Напрямок — Показує звідки пролунав дзвінок, вхідний або вихідний.
    • Кол-центр — Назва кол-центру котрому направлений дзвінок.

    8.2 У розділі "журнал" можна зібрати інформацію:

      У дашборді який відображений як "стисло" відображені:

    • НС (Напрямок та статус)
      • OUTGOING ANSWERED — від АТС вийшов дзвінок на котрий відповіли.
      • INCOMING ANSWERED — до АТС прийшов дзвінок на котрий відповіли.
      • OUTGOING BUSY — від АТС вийшов дзвінок на котрий не відповіли.
      • INCOMING NO ANSWER — до АТС прийшов дзвінок на котрий не відповіли.
    • Час — година і дата початку дзвінка. Також можливо вказати період відображення.
    • Від кого — ініціатор дзвінка. Можна користатися пошуком.
    • До кого — викликаємий абонент. Можна користатися пошуком.
    • Тривалість — тривалість розмови. Скористайтесь пошуком, вкажіть мінімальний час розмови і максимальний.
    • Запис — Дає змогу прослухати записану розмову.
    •  

      У дашборді який відображений як "докладно" додається поля:

    • Платні — час від цілої виклику котрий буде оплачуватися.
    • Розмова — час затрачений на бесіду.
    • Завершено — ким саме був закінчений дзвінок.
    • Вартість — сума грошей.
    • Якість — підсумок усієї розмови.
    • Позначки — також зберігається інформація о позначках діалплану.
    •  

      У дашборді який відображений як "Кол-Центр" додається поля:

    • Кол-Центр — Назва кол-центру до котрого надійшов дзвінок.
    • доКЦ — скільки часу витратив абонент до початку дзвінка у кол-центр.
    • Очікував — Час затрачений абонентом на очікування відповіді від кол-центру.
    • статусКЦ
      • COMPLETEAGENT — Оператор закінчив розмову поклавши трубку.
      • COMPLETECALLER — Абонент закінчив розмову поклавши трубку.
      • BLINDTRANSFER — У час розмови було виконано переведення на іншого оператора, без оповіщення третьої сторони
      • ABANDON — Абонент котрий стояв у черзі до кол-центру поклав трубку.
      • TRANSFER — У час розмови було виконано переведення на іншого оператора, з оповіщення третьої сторони
      • RINGNOANSWER — оператор не відповів на дзвінок на вхідний виклик.
    • Позиція — на котрій позиції абонент встав в чергу.

    ⠀Виберіть "мін" підсумок: буде додані поля у яких буде зібрана інформація про мінімальній час дзвінку, мінімальний час очікування до кол кол-центру і мінімальний час відповіді від кол-центру.

    ⠀Виберіть "макс" підсумок: буде відображено максимальний час тривалості дзвінка, максимальний час очікування до кол-центру і максимальний час відповіді від кол-центру.

    ⠀Виберіть "у середньому" підсумок: буде відображено середній час тривалості дзвінка, середній час очікування до кол-центру і середній час очікування у черзі до відповіді від кол-центру.

    ⠀Виберіть "сумарно" підсумок: буде інформація тривалості усіх дзвінків разом, загальний час затрачений на очікування до кол-центру і загальний час очікування у черзі.

    ⠀Також є можливість зберегти весь журнал дзвінків, перейдіть у необхідний розділ журналу і натисніть ⠀Export to XML⠀ журнал дзвінків буде завантажено і збережено локально у форматі .xml.