Інтеграція Бітрікс24 з 3CX

Уявіть: компанія використовує 3CX і Бітрікс24, але дзвінки не фіксуються в CRM. Менеджери витрачають час на ручне введення даних, губляться ліди, складно відстежити якість обслуговування. Це типова ситуація, коли потрібна безшовна інтеграція телефонії. Ми вирішуємо такі завдання — синхронізуємо дзвінки, записи та автоматично створюємо картки в CRM. У цій статті розберемо технічні деталі двох офіційних способів інтеграції та розповімо про підводні камені, з якими зіткнулися на практиці. Наша команда — сертифіковані спеціалісти з 10+ річним досвідом у Бітрікс24 і 3CX, ми виконали понад 50 інтеграцій телефонії. За рахунок автоматизації ви економите до 20 робочих годин на місяць на кожного менеджера — це дає значну економію до 20 000 грн на місяць на одного співробітника.

3CX — комерційна IP-АТС з продуманим веб-інтерфейсом і власною екосистемою клієнтських додатків. На відміну від Asterisk, 3CX надає структурований API для інтеграцій — що спрощує завдання, але й накладає обмеження на архітектурні рішення.

Як налаштувати Custom CRM Integration в 3CX для Бітрікс24?

1. У консолі 3CX Management Console перейдіть у CRM Integration → Custom CRM.
2. Вкажіть URL для події "Call Answered":

   https://ваш_портал.bitrix24.ru/rest/КЛЮЧ/telephony.externalcall.register/
   

   Параметри передаються в тілі POST:

   {
     "USER_PHONE_INNER": "%Ext%",
     "PHONE_NUMBER": "%CallerNumber%",
     "CALL_START_DATE": "%CallStarted%",
     "CRM_CREATE": "Y",
     "TYPE": "%Direction%"
   }
   

3. Вкажіть URL для події "Call Ended":

   https://ваш_портал.bitrix24.ru/rest/КЛЮЧ/telephony.externalcall.finish/
   

   Параметри:

   {
     "CALL_ID": "%call_id_saved%",
     "DURATION": "%TalkDuration%",
     "STATUS_CODE": "200"
   }
   

4. Збережіть налаштування.

Проблема: Custom CRM Integration в 3CX не надає механізму збереження стану — не можна зберегти CALL_ID з відповіді Бітрікс24 і передати при завершенні. Це ключове обмеження: для повноцінної інтеграції зі збереженням CALL_ID потрібен проміжний сервер. Офіційна документація 3CX підтверджує, що такий підхід є рекомендованим.

Чому потрібен проміжний сервер для передачі CALL_ID?

Архітектура з проміжним обробником вирішує проблему:

3CX → webhook → PHP/Node.js обробник
                     ↓
              Бітрікс24 REST API → отримуємо CALL_ID
                     ↓
              Зберігаємо CALL_ID в Redis/БД з ключем = UNIQUEID дзвінка
                     ↓
3CX → webhook завершення → обробник
                     ↓
              Дістаємо CALL_ID з Redis
                     ↓
              telephony.externalcall.finish
                     ↓
              Прикріплюємо запис

Це додає компонент інфраструктури, але дає повний контроль над інтеграцією. Ми використовуємо такий підхід у всіх проектах — він у 2 рази надійніший, ніж стандартна інтеграція без збереження CALL_ID. Таке рішення окупається за 3-6 місяців за рахунок виключення ручного введення.

Запис дзвінків: як передати в Бітрікс24

3CX зберігає записи в директорії сервера або в хмарному сховищі (залежить від версії та налаштувань). Доступ до файлів через 3CX Recording Storage API або безпосередньо до файлової системи. Для передачі в Бітрікс24 — скрипт після завершення дзвінка звертається до 3CX API, отримує посилання на запис і завантажує його через telephony.externalCall.attachRecord. Документація 3CX описує цей метод детально.

3CX повертає посилання на запис через API дзвінків:

GET /api/recordings?callId={callId}

Авторизація через JWT-токен (3CX версії 18+): Authorization: Bearer <token>.

3CX SBC і проблема NAT: що перевірити

3CX часто розгортається з SBC (Session Border Controller) для NAT-traversal. При інтеграції з Бітрікс24 через SIP-транк потрібно переконатися, що зовнішній IP SBC прописаний у налаштуваннях SIP-транка Бітрікс24. Інакше — одностороннє аудіо при дзвінках від Бітрікс24 до 3CX. Це часта помилка, яку ми виявляємо на етапі аудиту. Отримайте консультацію щодо вашої інфраструктури — напишіть нам, ми перевіримо конфігурацію.

Порівняння методів інтеграції

Типові помилки та їх рішення

Кейс нашого клієнта: розподілена команда, 3CX у хмарі

IT-компанія з офісами у двох містах використовувала 3CX Hosted (хмарна версія). Вимога: коли клієнт телефонує на московський номер і потрапляє до пітерського менеджера, у Бітрікс24 дзвінок має створюватися у пітерського менеджера з прив'язкою до московського вхідного номера.

3CX Custom CRM Integration не підтримує маппінг внутрішніх номерів на користувачів Бітрікс24. Вирішили через проміжний обробник з таблицею відповідностей: внутрішній номер 3CX → ID користувача Бітрікс24. При реєстрації дзвінка обробник дивиться в таблицю та підставляє USER_ID потрібного користувача. Термін налаштування: 7 робочих днів. Клієнт отримав повністю автоматизовану телефонію з коректною маршрутизацією.

Що входить у нашу роботу з інтеграції

• Аудит поточної конфігурації 3CX та Бітрікс24.
• Проектування архітектури (проміжний сервер, маппінг, запис).
• Налаштування Custom CRM Integration або CFD під ваші завдання.
• Розробка проміжного обробника (PHP/Node.js) зі збереженням CALL_ID.
• Інтеграція запису дзвінків: API 3CX → завантаження в Бітрікс24.
• Траблшутінг NAT/SBC, SIP-транків.
• Тестування та навчання користувачів.
• Гарантійна підтримка 30 днів.

Ми маємо 10+ років досвіду, виконали 50+ проектів з інтеграції телефонії, працюємо на ринку з 2014 року. Вартість типового проекту — від $1500 до $3000 залежно від складності. Оцінимо ваш проект за 1-2 дні. Зв'яжіться з нами — підберемо оптимальне рішення під вашу інфраструктуру.

Налаштування телефонії під ключ: від 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-гілки, в які ніхто не потрапляє. Зв'яжіться з нами для консультації — ми запропонуємо оптимальне рішення під ваш бюджет та бізнес-процеси.