Інтеграція з Phonet

Phonet — сервіс IP-телефонії (віртуальна АТС). Підключений до Skynum, він перетворює виклики на робочі сценарії ERP: менеджер бачить дані клієнта ще під час гудків, розмови збираються в журнал разом із записами, невзяті виклики стають завданнями передзвонити, а набрати клієнта можна одним кліком по номеру.

Як працює телефонія у Skynum

Ця сторінка — інструкція підключення Phonet. Можливості самої телефонії — журнал, картка дзвінка, робота з пропущеними, аналітика — описані в розділі Телефонія.

Порядок підключення: забрати дані API в кабінеті Phonet, створити інтеграцію і зіставити співробітників у Skynum, повернутися в кабінет і роздати Webhook URL полям подій.

Що потрібно підготувати

• Робочий кабінет Phonet із номером, який приймає виклики.
• Внутрішні номери співробітників, заведені в Phonet.
• Доступ до розділу Налаштування → Інтеграції кабінету — там лежать дані API і поля вебхуків.

API сервер і ключ у Phonet

1. Увійдіть у кабінет Phonet.
2. Відкрийте Налаштування → Інтеграції і натисніть плитку інша CRM.
3. На сторінці Інтеграція з іншою CRM системою праворуч розташований блок Дані для авторизації по API.
4. Скопіюйте звідти API сервер і API ключ — обидва значення вводяться у Skynum: домен у поле Хост, ключ у поле Токен.

Сторінку не закривайте: після створення інтеграції сюди треба буде повернутися з Webhook URL.

Зберігайте ключ у таємниці

API ключ відкриває програмний доступ до вашої телефонії — йому не місце в листуваннях і на скриншотах.

Що зробити в Skynum

1. Відкрийте Налаштування → Інтеграції → Телефонія.
2. Натисніть Додати інтеграцію.
3. Виберіть Phonet.
4. Дайте підключенню зрозумілу Назву інтеграції.
5. Увімкніть Інтеграція активна.
6. У поле Хост введіть домен з API сервер — вигляду компанія.phonet.com.ua, без https://.
7. У поле Токен вставте API ключ.
8. Поле Філія, юридична особа заповнюйте, коли номер належить конкретній філії; порожнє — телефонія спільна для компанії.
9. Натисніть Перевірити підключення.
10. Після успішної перевірки збережіть форму.

Внизу збереженої інтеграції з'являється адреса Webhook URL (вставте у кабінет телефонії) — скопіюйте її повністю: у кабінеті Phonet вона розкладається по всіх полях подій і в поле інформації про клієнта. Інша адреса не знадобиться.

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

Коли підключень телефонії декілька, позначка За замовчуванням вирішує, через яке з них піде дзвінок в один клік.

Співробітники телефонії

Зіставлення людей відповідає на питання, чий це виклик, — без нього дзвінки лишаються знеособленими:

1. Відкрийте вкладку API мапінг усередині інтеграції.
2. У секції Співробітники телефонії призначте кожному користувачу його внутрішні номери; порожній довідник наповніть кнопкою Завантажити з Phonet.
3. Збережіть мапінг.

Список Внутрішні номери видно й у кабінеті Phonet — праворуч на сторінці інтеграції, зручно звіряти. Співробітнику дозволено кілька номерів; вихідний виклик стартує з першого його номера в довіднику Phonet.

Що зробити в Phonet

Усе відбувається на вже знайомій сторінці Інтеграція з іншою CRM системою (Налаштування → Інтеграції → інша CRM).

Вебхуки подій дзвінків

Події — канал реального часу: саме вони запалюють картку виклику в момент дзвінка. Розкладіть Webhook URL зі Skynum по всіх полях подій:

1. У поле Передача повної інформації про дзвінок.
2. У секції Події користувача — поля Початок виклику, Відповіли на дзвінок, Завершили дзвінок.
3. У секції Події групи — поля Поставлений в чергу і Завершили дзвінок.
4. Натисніть Зберегти.

Події групи обов'язкові

Вхідний виклик у Phonet проходить через групу або відділ, тож Skynum дізнається про нього саме з Подій групи. Самих лише Подій користувача недостатньо — вхідні залишаться без картки виклику і без завдань за невзятими.

Кнопка + Додати під полями розрахована на кілька адрес одночасно — Skynum достатньо одного рядка. Поле Передавати UTM мітки по дзвінкам лишається порожнім.

Розумна маршрутизація на відповідального менеджера

Постійного клієнта Phonet з'єднує спершу з його відповідальним менеджером — а вже потім, за потреби, з групою. Логіка вибору описана в статті Розумна маршрутизація.

Окремого сценарію дзвінка для цього не існує — все на сторінці інтеграції:

1. Вставте Webhook URL у поле Отримати інформацію про клієнта.
2. У блоці Запитувати відповідального позначте З картки CRM.
3. Натисніть Зберегти.

Перед з'єднанням Phonet звертається до Skynum за відповідальним менеджером номера і веде виклик спершу на його внутрішній номер. Для невідомого номера чи клієнта без відповідального виклик рухається своїм звичайним маршрутом групи — додаткові кроки не потрібні.

Приємний бонус: разом із маршрутом Skynum віддає ім'я клієнта, і співробітник бачить його на екрані SIP-застосунку під час виклику.

Відповідь Phonet тримає в кеші кілька хвилин, тому щойно призначений відповідальний менеджер почне отримувати виклики свого клієнта з невеликою затримкою.

Дзвінок в один клік

Налаштувань з боку Phonet не вимагає: достатньо мапінгу співробітників. Менеджер клікає номер, першим дзвонить його внутрішній номер, після відповіді АТС набирає клієнта. Подробиці: Дзвінок в один клік.

Перевірка після підключення

1. Наберіть номер компанії з власного мобільного — на екрані Skynum має спалахнути картка виклику.
2. Поговоріть і покладіть слухавку: розмова із записом і менеджером має лягти в Телефонія → Журнал дзвінків.
3. Зателефонуйте ще раз і не відповідайте — має народитися завдання передзвонити (при активному перемикачі).
4. Клікніть телефон у будь-якій картці, виберіть Дзвінок — вихідний виклик має пройти через менеджера до клієнта.

Типові проблеми

Дзвінки з'являються в журналі із запізненням, картки виклику немає

Звірте на сторінці інтеграції в кабінеті Phonet, що адреса зі Skynum стоїть у всіх полях подій: Передача повної інформації про дзвінок, три поля Подій користувача і два поля Подій групи. Втрачені події не фатальні — журнал Phonet регулярно синхронізується, і розмова із записом дожене журнал Skynum трохи згодом.

Вихідні виклики видно, а вхідні не показують картку

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

Розмова записана без співробітника

На вкладці API мапінг користувачу не призначені номери, з яких він реально відповідає. Довідник оновлюється кнопкою Завантажити з Phonet; самі номери зручно звірити зі списком Внутрішні номери в кабінеті.

Виклик минає відповідального менеджера

Перевірте поле Отримати інформацію про клієнта і позначку З картки CRM у блоці Запитувати відповідального, а також лінію менеджера в API мапінг. Після зміни відповідального зачекайте кілька хвилин — діє кеш Phonet.

Перевірка підключення не проходить

У полі Хост має стояти голий домен з API сервер (компанія.phonet.com.ua — без https:// і слешів), у полі Токен — API ключ із блоку Дані для авторизації по API. Скопіюйте значення заново і простежте, щоб не потрапили пробіли.