База знань Uspacy
Усі матеріалиТелефонія

Інтеграції з телефоніями АТС (PBX, Asterisk чи FreePBX)

Інтеграції з телефоніями АТС (PBX, Asterisk чи FreePBX)

Тут ми розкажемо як підключити програмну АТС телефонію на базі PBX, Asterisk чи FreePBX до CRM і працювати з дзвінками прямо у Просторі

Здійснюйте вхідні та приймайте вихідні дзвінки всередині вашої CRM, підключивши відомі платформи для впровадження програмних АТС (PBX, Asterisk чи FreePBX).

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

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

AD_4nXd_IIA7JnYyc3uiy1Ok1As1pybTMFRBnXS9hOUVjTEGmzpr0pEHggdOMYsKVCaqkoTD3BKCaeh3BLq0-NEeIy_SJw6yb801W5_KWQWWV2nncAg2r35KC6l6QlbZVdzaHSL-ix40Dw

Отже, для успішної роботи програмної АТС телефонії на базі PBX, Asterisk чи FreePBX потрібно виконати стартові налаштування як на стороні самої платформи, так і на стороні Uspacy.

☝🏻Крім того, перш ніж переходити до покрокових налаштувань сервісу телефонії та Uspacy, потрібно виконати декілька підготовчих дій.

Але про все по черзі ⬇️

Підготовчі дії

Спершу потрібно встановити для вашого Простору безкоштовний застосунок тієї платформи для впровадження програмних АТС (PBX, Asterisk чи FreePBX) із яким ви працюєте.

Для цього перейдіть у розділі Крамниця. Та натисніть на кнопку Отримати.

AD_4nXdqTjARlH39SnPTqGjwfhjjDC3oxejD9fidNlQtNkbV5YrSxb4xbL2kqtP3FoWD8OU91ZxecqYqg_Hzt6wSaKV6tOUU8Cm_J4zYRg6Zsr5ARebhKJUGfd4oMJ0YfSLqTBbcsakfzQ

Коли застосунок, буде встановлений, стануть доступними дані для інтеграції, які потрібні для використання на стороні платформи PBX, Asterisk чи FreePBX. Тому відкрийте його налаштування.

AD_4nXdOLS19jTZ0SLNQEP3NDLOdWKWjvDsRJSwiNruZnfhCgfVglx01XkZ6E1mCmxZRNbcCQtgERz-VPmxXymUwHJQOMVg6gm_fsNLZ0Csba8wOJqCBxJd9XZZvZc8gtib0A5KCYWRj

Тут вам буде потрібне поле: Uspacy вебхук. Його потрібно використати під час налаштування інтеграції на стороні платформи PBX, Asterisk чи FreePBX. Тому скопіюйте його значення.

AD_4nXdGEt9D98b9JUMp-2G0-BEaqunzmgxLtK599e3U6CES50AN3UUPkLuSp-6LbH8ow01giWHDT76Kwyq5LB_cYPs1GmHo59h8WIWTZ_85iYURdqmYi3bR7Oiua8VRSe6-2reIvm00Zw

Дії на стороні платформ PBX, Asterisk чи FreePBX

Uspacy отримує дані про дзвінки з телефонії. Тому необхідно налаштувати передачу цієї інформації до інтеграції.

Запити про події дзвінка мають бути в такому вигляді:

Метод: POST

Формат: JSON

У таблиці нижче можете ознайомитися з описом параметрів.

ПараметрТипОбов'язковоОпис
actionstringтак«call» – запит з інформацією по дзвінку;«route» – запит на отримання інформації про відповідального оператора за номер та базову сутність.
routestringтак, якщо action - routeномер телефону клієнта
callobjectтак, якщо action - callоб'єкт з детальною інформацією по дзвінку.
call.idstringтакунікальний ідентифікатор дзвінка, який генерується на стороні телефонії
call.directionstringтакнапрям дзвінка: outgoing – вихідний; incoming – вхідний.
call.fromstringтакномер, з якого телефонують
call.tostringтакномер, на який телефонують
call.statestringтакстатус дзвінка: started – початок; pending – режим очікування; answered – підняття слухавки; canceled – скасування дзвінка менеджером; busy – скасування дзвінка клієнтом; completed – завершення дзвінка; transferred – переведення дзвінка на інший номер.
call.durationintegerнітривалість дзвінка в секундах, потрібно передавати тільки після завершення дзвінка
call.audio_urlstringніпосилання на аудіозапис дзвінка в телефонії, потрібно передавати тільки після завершення дзвінка.

Структура тіла запиту може бути така (як приклад подія початку дзвінка):

Приклади сценаріїв роботи інтеграції

1. Вихідний дзвінок

1.1 Ініціалізація дзвінка:

Якщо ви додали в налаштуваннях інтеграції в поле Посилання для ініціалізації дзвінка посилання, то коли в картці CRM натиснути на номер телефону, то з інтеграції за цим посиланням у телефонію буде відправлено наступний запит:

1.2 Подія початку дзвінка:

Після початку дзвінка, на посилання яке ми даємо в налаштуваннях інтеграції в полі Uspacy вебхук, телефонія має надіслати наступний запит:

1.3 Подія завершення дзвінка:

2. Вхідний дзвінок

2.1 Подія початку дзвінка:

2.2 Подія перенаправлення дзвінка на іншого оператора:

2.3 Подія відповіді оператором на дзвінок:

2.4 Подія завершення дзвінка:

3. Подія отримання інформації про номер:

У відповідь ви отримаєте наступне:

Дії на стороні Uspacy

Після додаткових налаштувань застосунку для інтеграції із платформами для впровадження програмних АТС (PBX, Asterisk чи FreePBX) можна буде без перешкод телефонувати клієнтам або приймати дзвінки від них.

Робота з телефонією

☎️ Після цього можна починати працювати з телефонією прямо в Uspacy – завжди будьте на зв’язку зі своїми поточними та потенційними клієнтами.

AD_4nXfoVB2a7LPLp0llJC1AYCDRTyO2KC5o1S42arxci0JlwQc_6DfCYeLZLAB5-FoVZfmXsmpY5mnshQaoiGq-tQwskZWsLJtyW0oLrsgiJTJCrsuplPAeScYU0oJoGn9VhDbp_M-_gw

☎️ Усі дзвінки (вхідні, вихідні та пропущені) будуть збережені в історії та знаходитимуться на сторінці Журнал дзвінків.

🌟 Він доступний лише на комерційних тарифах.

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

AD_4nXftDU5cLU_8H9YeTSnUyxqahxSyY3zdS44SB0NpWKD5cfR1rV9j8PscKIiI4oMjo4p1XetWysnTUQSIqdTBOt7E2npvk2EzvcD-abzx88LU4PjVl_tafVqKcLnsDVh4gauob995bg

🙌🏻 Зверніть увагу, що записи розмов зазвичай додаються із затримкою у 10-15 хвилин. А якщо дзвінок був довгий, то затримка може бути ще трошки більшою.

А записи розмов будуть також міститися в картці CRM, у правій її частині, під фільтром активностей, там де відображена історія взаємодії з елементом.

Створено: 26 березня 2025 р. / Оновлено: 13 лютого 2026 р.