Кастомна інтеграція Mango Office з Бітрікс24: налаштування телефонії

Кастомна інтеграція телефонії Mango Office з Бітрікс24

Ви використовуєте Mango Office та Бітрікс24, але стандартний застосунок з маркетплейсу не дає потрібної гнучкості? Типова ситуація: дзвінки не прив'язуються до правильних контактів, записи приходять із півгодинною затримкою, а керівник просить налаштувати автоматичне створення лідів за єдиним сценарієм. Ми вирішуємо такі задачі через кастомний зв'язок на прямих API. За 10+ років ми інтегрували 50+ телефоній і знаємо кожне обмеження Mango. Досвід показує, що стандартні рішення покривають лише 60% потреб бізнесу — решту доводиться доопрацьовувати вручну.

Проблема посилюється, коли в компанії декілька офісів або нестандартна маршрутизація. Без кастомної інтеграції оператори витрачають до 30% часу на ручне перенаправлення дзвінків та дублювання даних. Ми гарантуємо, що після налаштування ви забудете про ці проблеми.

Чому стандартного застосунку недостатньо?

Офіційний застосунок Mango Office (встановлюється з розділу Застосунки → Маркетплейс) вирішує базові сценарії: спливаюча картка при вхідному, прив'язка дзвінка до існуючого або нового ліда. Але він не дозволяє:

• гнучко маршрутизувати ліди залежно від номера лінії;
• зіставляти внутрішні номери співробітників, якщо вони відрізняються в Mango та Бітрікс24;
• обробляти запис дзвінка, коли файл приходить через 10 хвилин після завершення;
• підтримувати декілька віртуальних АТС на одному порталі.

Це задокументована особливість Mango VPBX API.

Як працюють webhook-и Mango?

Mango надсилає події: call_start, call_answer, call_end, call_record. Ключовий нюанс — call_record приходить окремо від call_end, із затримкою до 10 хвилин. Не можна прикріпити запис синхронно; потрібна асинхронна черга. Webhook-и працюють надійно, але без правильної обробки легко втратити дзвінки.

Як маппінг співробітників запобігає втраті дзвінків?

Маппінг — це зв'язок внутрішнього номера Mango (extension) з ID користувача Бітрікс24. Без нього дзвінки від нових співробітників або при зміні номера зависають без відповідального. Ми створюємо конфігураційну таблицю, яка підвантажується при старті обробника. Якщо відповідність не знайдено, дзвінок вважається пропущеним і прив'язується до відповідального за замовчуванням — це виключає втрату лідів.

Що робити із затримкою запису дзвінка?

Це стандартна особливість API: подія call_record приходить через 1–10 хвилин після call_end. Ми реалізували чергу на Redis: при call_end зберігаємо зв'язку mango_uuid → bitrix_call_id, а при call_record завантажуємо файл за тимчасовим посиланням і викликаємо telephony.externalCall.attachRecord. Тимчасове посилання живе 24 години, тому гарантовано встигаємо.

Порівняння стандартного та кастомного підходу

Кастомна інтеграція перевершує стандарт за ключовими параметрами у 3–5 разів при роботі з нестандартними сценаріями.

Покрокова схема налаштування інтеграції

1. Реєструємо webhook-URL в особистому кабінеті Mango (АТС → Налаштування → Сповіщення).
2. Розгортаємо обробник, який приймає події та перетворює їх у REST-виклики Бітрікс24 за допомогою REST API Бітрікс24.
3. Створюємо таблицю маппінгу extension → USER_ID (приклад: 101 → 12, 102 → 8).
4. Реалізуємо чергу для відкладеного прикріплення записів: при call_end зберігаємо mango_uuid → bitrix_call_id, при call_record завантажуємо файл за тимчасовим посиланням і викликаємо telephony.externalCall.attachRecord.
5. Налаштовуємо маршрутизацію для декількох ліній.

Кейс: страховий брокер з трьома офісами

Компанія мала три офіси в різних містах, кожен з окремим номером Mango. Потрібно було: дзвінок на московський номер створюється у московського менеджера, на краснодарський — у краснодарського. Рішення: три окремих webhook-URL, кожен обробник передає LINE_NUMBER при створенні дзвінка в Бітрікс24. При переведенні дзвінка між офісами (подія call_transfer) оновлюється відповідальний в активному дзвінку. Результат: час на обробку скоротився на 40%, а повторні дзвінки зменшилися на 25%.

Деталі реалізації маппінгу та черги

Конфігурація маппінгу

Таблиця відповідності зберігається в конфігурації обробника. Приклад:

Якщо алгоритм не знаходить відповідності, дзвінок вважається пропущеним і прив'язується до відповідального за замовчуванням.

Черга для записів дзвінків

При отриманні call_end зберігаємо в Redis пару {mango_uuid → bitrix_call_id}. Через 1–10 хвилин приходить call_record; по mango_uuid витягуємо bitrix_call_id, завантажуємо запис з тимчасового посилання (живе 24 години) і завантажуємо в Бітрікс24 через telephony.externalCall.attachRecord. Якщо не встигнути — файл стає недоступним.

Що входить в проект

• Аудит поточної АТС та CRM;
• Розробка архітектури інтеграції;
• Налаштування webhook-ів та REST API;
• Маппінг співробітників;
• Реалізація черги записів;
• Тестування на реальних дзвінках;
• Документація та навчання.

Терміни та вартість

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

Переваги та економіка

Кастомна інтеграція скорочує час обробки дзвінків на 30–40% та усуває ручне перенаправлення лідів. Інвестиція окупається за 2–3 місяці. Наш досвід підтверджує: сертифіковані розробники гарантують стабільну роботу навіть при високих навантаженнях. Замовте налаштування телефонії Mango Office з Бітрікс24 під ключ — отримайте консультацію вже сьогодні.

Висновок

Зв'яжіться з нами для консультації: розкажемо, які можливості Mango Office ви не використовуєте, та запропонуємо оптимальний план інтеграції.

Налаштування телефонії під ключ: від SIP до CRM

SIP-транк не реєструється — перша проблема при підключенні телефонії до Бітрікс24. Клієнт надсилає дані від провайдера, вбиваєш у розділ «Телефонія → Налаштування телефонії → SIP-конектор», а статус висить «Очікування реєстрації». Порти 5060/5061 для SIP та діапазон 10000–20000 для RTP закриті на фаєрволі — класика. Або кодек G.729 не підтримується, а G.711 жере смугу по 87 кбіт/с на лінію. На 20 одночасних розмов — рахуйте самі. Ми підключаємо та налаштовуємо телефонію так, щоб дзвінки не губилися, маршрутизація працювала за логікою бізнесу, а CRM отримувала дані автоматично.

Протокол SIP (Session Initiation Protocol) — стандарт для голосового зв'язку через інтернет. Наші фахівці мають 5+ років досвіду інтеграції з Бітрікс24. Гарантія на налаштовані рішення — 1 рік. Зв'яжіться з нами для безкоштовного аудиту поточної інфраструктури — часто знаходимо сліпі зони: пропущені без завдань, менеджери зі статусом «На лінії» і нулем дзвінків, IVR-гілки, в які ніхто не потрапляє.

Як уникнути збоїв при SIP-реєстрації?

SIP-реєстрація та підключення: як уникнути зривів?

Неправильний NAT, закриті порти або несумісні кодеки — 90% збоїв. Перевіряємо підтримку кодеків на стороні оператора, налаштовуємо keepalive та резервні SIP-сервери. Після налаштування реєстрація тримається місяцями.

Контракт з оператором вже є, міняти номери — не варіант. Підключаємо до Бітрікс24 через SIP-конектор. Для стабільної роботи потрібен канал: мінімум 100 кбіт/с на лінію для G.729, 87 кбіт/с для G.711a.

Типові завдання:

• Міські номери від будь-якого оператора — зберігаються при переході на Б24
• Номери 8-800 для вхідних — маршрутизація через CRM
• Багатоканальні номери з розподілом по відділах через IVR
• Аналогові лінії через VoIP-шлюзи Grandstream або Linksys

Де зазвичай стопориться:

• Порти SIP/RTP закриті на рівні провайдера або роутера
• NAT не проброшується коректно — одностороння чутність
• Різні кодеки на стороні АТС та Бітрікса — немає звуку взагалі

Ми вирішуємо ці проблеми за 1–3 дні, а не тижнями.

Покрокова інструкція підключення через SIP-транк:

1. Перевіряємо відкритість портів SIP (5060/5061) та RTP (10000–20000) на фаєрволі.
2. Узгоджуємо кодеки: G.711 або G.729 — тестуємо обидва варіанти.
3. Налаштовуємо SIP-конектор в адмінці Бітрікс24: логін, пароль, домен/IP провайдера.
4. Вмикаємо keepalive (період 30–60 секунд) для стабільної реєстрації.
5. Перевіряємо двосторонню чутність тестовим дзвінком.
6. Налаштовуємо резервний SIP-сервер на випадок збою основного.

Хмарна АТС чи SIP-транк: що вибрати?

Хмарна ВАТС не потребує заліза — підключається за 1–2 дні. SIP-транк зберігає ваші номери та дозволяє гібридну схему з on-premise АТС. Хмарна АТС налаштовується в 2-3 рази швидше і економить до 40% бюджету порівняно з утриманням власної інфраструктури. Порівняйте провайдерів за реальними кейсами.

Як порівняти провайдерів?

Навіщо потрібен запис дзвінків і як його налаштувати?

Усі вхідні та вихідні записуються автоматично. Зберігання — хмара Бітрікс24 (обмеження за тарифом) або власний сервер через модуль voximplant. Кожен запис прив'язаний до картки в CRM: контакт, угода, лід. Прослуховування — з таймлайну угоди.

Інструменти контролю:

• Повідомлення про запис — обов'язково за 152-ФЗ, налаштовується в IVR
• AI-транскрибація — розпізнавання мови через вбудований модуль CoPilot або зовнішній сервіс. Переводить дзвінок у текст, можна шукати за ключовими словами
• Аналіз тональності — система позначає дзвінки з негативом. Не заміна прослуховуванню, але фільтрує 90% рутини
• Вибірковий запис — тільки вхідні, тільки конкретні відділи
• Автоматичний контроль тривалості — дзвінки коротші 15 секунд майже завжди означають проблему: скинули, не додзвонилися, менеджер не підняв

Керівник бачить зведені звіти: кількість дзвінків по менеджерах, середня тривалість, пропущені без передзвону. Останній пункт — найболючіший: пропущений дзвінок без завдання на передзвін = втрачений клієнт.

Типові помилки в маршрутизації

Маршрутизація — найкрихкіша частина. Налаштували «по черзі», а менеджер залогінився і пішов обідати — дзвінок висить 40 секунд і скидається. Або IVR з п'ятьма рівнями вкладеності — клієнт кидає трубку на третьому. Ми використовуємо робочі сценарії розподілу:

• По відповідальному з CRM — номер знайдено в базі, дзвінок летить напряму менеджеру
• По черзі — рівномірне навантаження між операторами зі статусом «На лінії»
• По відділах через IVR — голосове меню, максимум два рівні. Більше — втрата дзвінків
• За часом — робочий/неробочий час, вихідні
• По регіону — визначення за кодом номера, розподіл на локальних менеджерів

При вхідному дзвінку система виконує: Номер знайдено в CRM:

• Маршрутизація на відповідального менеджера
• Спливаюча картка: ім'я, компанія, відкриті угоди, історія звернень
• Якщо менеджер не відповідає за 15 секунд — переадресація на колегу, потім на керівника

Номер не знайдено:

• Автоматично створюється лід в CRM (налаштування Телефонія → CRM-інтеграція → Створювати лід при невідомому номері)
• Дзвінок розподіляється по черзі
• Вся інформація фіксується для подальшої обробки

Інтеграція з CRM: як автоматизувати роботу?

Спливаюча картка при вхідному дзвінку показує:

• Ім'я, компанія, посада
• Поточні угоди зі статусами
• Останні 5 звернень — дзвінки, листи, чати
• Коментарі по клієнту
• Кнопки: «Створити угоду», «Поставити завдання», «Перевести дзвінок»

Автоматизація через бізнес-процеси налаштовується в розділі «CRM → Роботи та тригери»:

• Пропущений дзвінок → лід + завдання на передзвін відповідальному
• Завершення розмови → запис активності в таймлайн угоди
• Пропущений без передзвону протягом 30 хвилин → повідомлення керівнику
• Вхідний від клієнта з простроченою угодою → ескалація

Аналітика доступна в розділі «Телефонія → Баланс та статистика» та звітах CRM:

• Кількість дзвінків по менеджерах, відділах, напрямках
• Середня тривалість та час очікування на лінії
• Відсоток пропущених з трендом за тиждень
• Конверсія дзвінків в угоди — найважливіша метрика для комерційного відділу

Callback, автообдзвін та голосове меню: як збільшити конверсію?

Віджет «Передзвоніть мені» на сайті — одне поле (телефон), нічого зайвого. Система додзвонюється менеджеру, потім клієнту. Кожен запит — автоматичний лід в CRM. Антиспам: обмеження запитів з одного номера. A/B-тестування розташування — віджет справа внизу конвертує краще, ніж зліва, але залежить від дизайну. Callback знижує втрату дзвінків до 30% порівняно з ручним набором.

Автообдзвін:

• Обдзвін по сегменту з CRM — менеджер підключається після відповіді клієнта
• Роботизований обдзвін з голосовим повідомленням — підтвердження замовлень, нагадування про запис
• IVR-сценарії: «натисніть 1 для підтвердження»
• Розклад з урахуванням часових поясів — модуль перевіряє регіон за кодом номера

Побудова голосового меню:

• Привітальне повідомлення — назва компанії, повідомлення про запис
• Вибір відділу через DTMF — максимум 4–5 пунктів
• Черга очікування з музикою та позицією в черзі
• Неробочий час — голосова пошта або інформаційне повідомлення

Запис професійним диктором — має сенс для привітання та основного меню. Глибше — синтез мови, простіше оновлювати.

Що входить у налаштування телефонії?

Deliverables після завершення проекту:

• Налаштована SIP-реєстрація (хмарна АТС або SIP-транк під ключ)
• Працююча маршрутизація дзвінків (по CRM, черги, IVR)
• Запис дзвінків зі зберіганням у хмарі або на сервері
• Інтеграція з CRM: спливаючі картки, автостворення лідів, бізнес-процеси
• Віджет зворотного дзвінка на сайті
• Голосове меню (IVR) із записом диктора або синтезом
• Документація по налаштуваннях та навчання співробітників (2 сесії)
• Технічна підтримка протягом місяця після запуску

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

Терміни налаштування

Вартість розраховується індивідуально залежно від обсягу робіт. Ми оцінимо ваш проект за 1 день. Починаємо з безкоштовного аудиту поточної інфраструктури — часто знаходимо сліпі зони: пропущені без завдань, менеджери зі статусом «На лінії» і нулем дзвінків, IVR-гілки, в які ніхто не потрапляє. Зв'яжіться з нами для консультації — ми запропонуємо оптимальне рішення під ваш бюджет та бізнес-процеси.