Документація Можливості Швидке налаштування Розмежування прав доступу АРІ Контакти Зовнішні лінії Налаштування SIP-клієнта Автоматичний обдзвін Call-tracking Чати Внутрішні телефони Пропущені та Заплановані Віртуальні номери Кол - центри Конференції Дзвінки зараз Журнал Готові скрипти для ifAPI Профіль Користувачі

В АТС вже є кілька готових API, які можна використовувати.

Готові АРІ

• src.php
• dst.php
• callexisted.php
• talkexisted.php

src.php

   API перевіряє номер ініціатора дзвінка(від кого), якщо номер збігається з зазначеним або підпадає під шаблон у параметрах API, виконуватиметься гілка ifAPI. У всіх інших випадках IfAPI-ELSE.
   Шаблон може мати значення декількох номерів в одному виразі, використовуйте додаткові символи для вказівки діапазону номерів.

• X - будь-яка цифра
• Z - будь-яка цифра в діапазоні 1-9
• N - будь-яка цифра в діапазоні 2-9
•  .  - (крапка) будь-що, що залишилось

https://api.example.com/ifapi/src.php?[number1]&[number2]&[number3]...

• https://api.example.com/ifapi/src.php - Вкажіть URL з розташуванням API. Зазвичай це доменне ім'я сервера IP-телефонії.
• ? - Початок переліку параметрів запиту.
• [number] - Внутрішній номер або шаблон декількох номерів.
• & - Роздільник параметрів.

У прикладі зображено API, якщо джерелом дзвінка буде внутрішній номер 103, буде дозволено виклик з лінії 2345678. У всіх інших випадках дзвінок буде завершений.

У прикладі зображено API, якщо джерелом дзвінка є будь-який внутрішній номер від 100-199(1XX), буде дозволений виклик з лінії 2345678. У всіх інших випадках дзвінок буде завершений.

У прикладі зображено API, якщо джерелом дзвінка є будь-який внутрішній номер від 1000-3999, починається нова умова в яких усім номерам (із 1000-3999) крім 1800-1899, 2800-2899, 3800-3899, буде дозволено виклик з лінії 2345678. У всіх інших випадках дзвінок буде завершений.

dst.php

   API перевіряє номер телефону призначення(до кого), якщо номер збігається з зазначеним або підпадає під шаблон у параметрах API, виконуватиметься гілка IfAPI. У всіх інших випадках IfAPI-ELSE.
   Шаблон може мати значення декількох номерів в одному виразі, використовуйте додаткові символи для вказівки діапазону номерів.

• X - будь-яка цифра
• Z - будь-яка цифра в діапазоні 1-9
• N - будь-яка цифра в діапазоні 2-9
•  .  - (крапка) будь-що, що залишилось

https://api.example.com/ifapi/dst.php?[number1]&[number2]&[number3]...

• https://api.example.com/ifapi/dst.php - Вкажіть URL з розташуванням API. Зазвичай це доменне ім'я сервера IP-телефонії.
• ? - Початок переліку параметрів запиту.
• [number] - Внутрішній номер або шаблон декількох номерів.
• & - Роздільник параметрів.

У прикладі зображено API, якщо номер призначення MTC(050, 066, 095, 099) то виклик буде ініційований з лінії 0661234567. Якщо номер призначення LIFE(063, 073, 093) то виклик буде ініційований з лінії 0631234567. Ці дзвінки будуть обмежені за часом з 08:30-20:30. В усіх інших випадків дзвінок буде завершений.

callexisted.php

   API перевіряє чи був вхідний дзвінок із зовнішнього номера за певний проміжок часу на внутрішній номер чи групу (Дзвінком вважатиметься будь-який виклик на оператора чи групу, навіть якщо на нього не відповіли). Якщо умова буде виконана, виконуватиметься гілка ifAPI. У всіх інших випадках IfAPI-ELSE.

https://api.example.com/ifapi/callexisted.php?period=[minutes]&internal=[number1],[number2],[number3]...&grp=[group1],[group2]...

• https://api.example.com/ifapi/callexisted.php - Вкажіть URL з розташуванням API. Зазвичай це доменне ім'я сервера IP-телефонії.
• ? - Початок переліку параметрів запиту.
• & - Роздільник параметрів.
• period=[minutes] - приймає в параметр ціле число, що позначає кількість хвилин, за які нещодавно був здійснений виклик.
• internal=[number] - Внутрішній номер. Якщо більше одного, перерахуйте їх через кому.
• grp=[group] - Унікальна назва групи. Якщо груп більше однієї, перерахуйте їх через кому.
Якщо в назві групи є символ пропуску, замініть його на "%20" або "+".

У прикладі зображено API "callexisted.php". Першою умовою він перевіряє, чи був за останні 60 хвилин дзвінок на номер 101, 102, 103, 104 або на будь-який із номерів, що перебуває в групі "sales depart". Якщо так, то буде здійснено дзвінок на номери 101-104 та групу "sales depart". Якщо ні, то буде виконуватися перевірка іншої умови, чи був дзвінок на номери 301, 302 або групу "service depart". Якщо обидві умови не були виконані, абонент буде направлений на інший віртуальний номер.

talkexisted.php

   API перевіряє чи була вже розмова з номером або групою за певний проміжок часу. Якщо умова буде виконана, виконуватиметься гілка ifAPI. У всіх інших випадках IfAPI-ELSE.

https://api.example.com/ifapi/talkexisted.php?period=[minutes]&internal=[number1],[number2],[number3]...&grp=[group1],[group2]...

• https://api.example.com/ifapi/talkexisted.php - Вкажіть URL з розташуванням API. Зазвичай це доменне ім'я сервера IP-телефонії.
• ? - Початок переліку параметрів запиту.
• & - Роздільник параметрів.
• period=[minutes] - приймає в параметр ціле число, що позначає кількість останніх хвилин, за які була здійснена розмова.
• internal=[number] - Внутрішній номер. Якщо більше одного, перерахуйте їх через кому.
• grp=[group] - Унікальна назва групи. Якщо груп більше однієї, перерахуйте їх через кому.
Якщо в назві групи є символ пропуску, замініть його на "%20" або "+".

У прикладі зображено API "talkexisted.php". Першою умовою він перевіряє, чи була за останні 60 хвилин розмова з будь-яким номером із 101-104 або з номером що перебуває в групі "sales depart". Якщо так, то буде здійснено липкий дзвінок до останнього з операторів з яким вже була розмова. Якщо ні, то буде виконуватися перевірка іншої умови, чи була розмова з 301, 302 або групу "service depart". Якщо обидві умови не були виконані, абонент буде направлений на інший віртуальний номер.