Налаштування "Телефонія"
Сторінка «Телефонія» призначена для підключення та конфігурації провайдерів IP-телефонії (Binotel, Ringostat) для обробки вхідних і вихідних дзвінків. Тут налаштовуються параметри підключення до сервісу, прив'язуються внутрішні номери провайдера до менеджерів CRM та вказується webhook-адреса для отримання даних про дзвінки в реальному часі.
Терміни
- Провайдер телефонії — сервіс або компанія, яка надає послуги IP-телефонії (наприклад, Binotel, Ringostat)
- API-ключ — унікальний код доступу до особистого кабінету провайдера для інтеграції з bims
- Webhook URL — адреса, яку необхідно вказати в кабінеті провайдера для передачі даних про дзвінки в систему
- Агент провайдера — внутрішній номер або ідентифікатор співробітника на стороні провайдера телефонії (наприклад, «101», «manager_ivan»)
- Мапінг агентів — прив'язка внутрішнього номера провайдера до конкретного менеджера в CRM
- Вхідний дзвінок — дзвінок від клієнта на номер компанії
- Вихідний дзвінок — дзвінок менеджера до клієнта з CRM
Загальний огляд
Користувач бачить список підключених інтеграцій з провайдерами телефонії. Для кожної інтеграції відображається назва провайдера, webhook URL для копіювання та дата останнього отриманого дзвінка. У верхній частині доступна кнопка «Додати інтеграцію» для користувачів з правом telephony.edit. При натисканні на іконку агентів відкривається таблиця прив'язки внутрішніх номерів провайдера до менеджерів CRM.
Основні можливості
Додавання інтеграції з провайдером
Користувач може підключити провайдера телефонії, заповнивши форму з вибором сервісу та введенням даних API. Залежно від обраного провайдера відображаються відповідні поля: для Binotel — Key та Secret, для Ringostat — API Key та Project ID. Після збереження система автоматично генерує унікальний Webhook URL для цієї інтеграції.
Копіювання Webhook URL
Після створення інтеграції система генерує унікальний Webhook URL, який необхідно вказати в особистому кабінеті провайдера телефонії. Кнопка копіювання поруч з адресою дозволяє швидко скопіювати URL в буфер обміну. Саме через цей URL провайдер надсилатиме дані про кожен дзвінок до bims.
Тестування з'єднання
Користувач може перевірити коректність введених даних натисканням іконки тестування поруч з інтеграцією. Система намагається встановити з'єднання з API провайдера та повідомляє про результат. Рекомендується виконати тест після створення інтеграції та перед прив'язкою агентів.
Синхронізація агентів
Після підключення провайдера система може автоматично отримати список внутрішніх номерів (агентів) з кабінету провайдера. Для цього в панелі агентів необхідно натиснути «Синхронізувати з провайдера». Отримані агенти відображаються в таблиці зі статусом «Не підключено» до моменту їх прив'язки до менеджерів.
Мапінг агентів на менеджерів
Для кожного агента провайдера необхідно вказати відповідного менеджера CRM через випадаючий список. Після збереження система автоматично визначатиме відповідального менеджера при вхідних дзвінках та прив'язуватиме дзвінок до його картки. Один менеджер може мати кілька ідентифікаторів (внутрішній номер, SIP, мобільний).
Активація та деактивація інтеграції
Кожну інтеграцію можна тимчасово деактивувати без видалення — система перестане обробляти вхідні webhook-запити від цього провайдера. Повторна активація відновлює обробку дзвінків. Деактивована інтеграція відображається приглушеним кольором у списку.
Сповіщення про вхідний дзвінок
При надходженні вхідного дзвінка менеджер, якому призначено відповідний внутрішній номер, отримує спливаюче сповіщення в браузері з інформацією про того, хто телефонує. У сповіщенні відображається ім'я та номер телефону клієнта (якщо він є в базі), пов'язаний лід. Натискання на іконку контакту відкриває картку клієнта або ліду.
Покрокові сценарії
Як підключити провайдера телефонії
- Відкрийте розділ Налаштування → Телефонія.
- Натисніть кнопку Додати інтеграцію.
- Оберіть Провайдера зі списку (Binotel або Ringostat).
- За бажанням введіть Назву інтеграції для зручності.
- Введіть дані API з особистого кабінету провайдера.
- Натисніть Зберегти — система згенерує унікальний Webhook URL.
- Скопіюйте Webhook URL та вставте його в налаштуваннях провайдера.
Як налаштувати прив'язку агентів
- У списку інтеграцій натисніть іконку Агенти (👥) поруч з інтеграцією.
- Натисніть Синхронізувати з провайдера для автоматичного отримання списку.
- Для кожного агента в колонці Менеджер CRM оберіть відповідного користувача.
- Прив'язка зберігається автоматично після вибору зі списку.
- Агенти зі статусом «Підключено» будуть автоматично визначатися при дзвінках.
Як перевірити з'єднання з провайдером
- У списку інтеграцій натисніть іконку Перевірити з'єднання (📶).
- Дочекайтеся результату перевірки.
- Якщо тест успішний — інтеграція готова до роботи.
- У разі помилки — перевірте правильність введених API-ключів.
Як обробляється вхідний дзвінок
- Клієнт телефонує на номер компанії.
- Провайдер надсилає дані на Webhook URL системи.
- CRM визначає менеджера за внутрішнім номером через таблицю мапінгу.
- Система шукає клієнта в базі за номером телефону або створює нового.
- Якщо у клієнта немає активного ліду — автоматично створюється новий.
- Менеджер отримує спливаюче сповіщення з карткою клієнта в браузері.
Як видалити інтеграцію
- У списку інтеграцій натисніть іконку Видалити (🗑️).
- Підтвердіть видалення у діалоговому вікні.
- Всі дані про дзвінки цієї інтеграції зберігаються в системі.
- Webhook URL стає неактивним — провайдер більше не надсилатиме дані.
Як підключити телефонію Binotel
Крок 1. Отримати дані для підключення
Перед підключенням необхідно отримати API-ключі у підтримки Binotel.
⚠️ Важливо! Пишіть з пошти, на яку зареєстровано ваш обліковий запис Binotel.
Надішліть листа на support@binotel.ua:
Тема: Отримання авторизаційних даних для REST API
Текст:
Добрий день!
Будь ласка, надайте API-ключі для інтеграції з CRM.
Дякую.
Крок 2. Підключення до bimsCRM
Після отримання ключів перейдіть до Налаштування → Телефонія та натисніть «+ Додати інтеграцію».
У панелі, що з'явилась, заповніть:
- Провайдер — оберіть «Binotel»
- Назва — введіть зручну назву інтеграції
- Binotel Key та Binotel Secret — вкажіть отримані від Binotel API-ключі
Натисніть «Зберегти».
Крок 3. Перевірка з'єднання
Знайдіть у списку вашу нову інтеграцію та натисніть іконку «Перевірити з'єднання» (📶). Якщо тест успішний — ключі введено правильно і можна переходити далі.
Крок 4. Налаштування агентів
- Натисніть іконку «Агенти» (👥) поруч з інтеграцією.
- Натисніть «Синхронізувати» — система отримає список співробітників з Binotel.
- Для кожного агента в колонці «Менеджер CRM» оберіть відповідного користувача.
Крок 5. Підключення вебхука через підтримку Binotel
Знайдіть у списку вашу інтеграцію та натисніть «Скопіювати Webhook URL».
Надішліть листа на support@binotel.ua:
Тема: Підключення веб-хука для інтеграції з CRM
Текст:
Добрий день!
Поміняйте, будь ласка, webhook для API-PUSH, api-call-completed, api-call-settings методів на:
[ВСТАВТЕ СЮДИ СКОПІЙОВАНИЙ WEBHOOK URL]
Дякую!
Після того як підтримка Binotel підтвердить налаштування — інтеграція активна. Дзвінки надходитимуть у систему та зберігатимуться в історії.
💡 Корисні поради
💡 Спочатку webhook, потім агенти — після створення інтеграції одразу скопіюйте Webhook URL та вставте його в кабінеті провайдера, а потім переходьте до налаштування агентів.
💡 Синхронізація при змінах — якщо в кабінеті провайдера були додані нові співробітники або змінені внутрішні номери, виконайте повторну синхронізацію агентів.
💡 Один менеджер — кілька номерів — якщо менеджер має кілька ідентифікаторів у провайдера (внутрішній номер і SIP), їх можна прив'язати до одного користувача CRM.
💡 Непідключені агенти — дзвінки від агентів без прив'язки зберігаються в системі, але без визначення відповідального менеджера. Рекомендується підключити всіх активних агентів.
💡 Автоматичне створення клієнтів — якщо при вхідному дзвінку номер телефону не знайдено в базі, система автоматично створює нового клієнта. Рекомендується перевіряти та доповнювати картку клієнта після дзвінка.
💡 Декілька інтеграцій — можна підключити одночасно кількох провайдерів телефонії, наприклад, Binotel для офісу та Ringostat для онлайн-відділу.