Настройка интеграции с Bitrix24
Last updated
Last updated
Виды приложения для интеграции с MikoPBX:
«бесплатное» - можно установить без наличия подписки на маркетплейс.
«подписка» - когда у Вас есть подписка на маркетплейс.
Функционал всех вариантов установки идентичен.
Наше приложение в маркетплейс Bitrix 24.
Выполните установку модуля «MikoPBX»:
Перейдите в раздел «Телефония» - «Настройки телефонии» - «Пользователи телефонии»:
Назначьте сотрудникам внутренние номера:
Назначенные внутренние номера должны существовать в MikoPBX!
Перейдите в раздел «Телефония» - «Настройки телефонии» - «Общие настройки»:
В поле «Номер для исходящего звонка по умолчанию» - укажите приложение «Интеграция с MIKOPBX» (следует выполнить после аутентификации модуля со стороны MikoPBX)
С АТС MikoPBX обязательно должны быть доступны:
Ваш портал Bitrix24 по порту 443
Сайт oauth.bitrix.info по порту 443
Пример проверки подключения из консоли:
Перейдите в меню «Модули» → «Управление модулями»
Установите модуль «Интеграция с CRM Bitrix24», перейдите в интерфейс модуля.
Заполните поле «Адрес портала Bitrix24», без указания протокола https, используя пример:
Сохраните настройки и включите модуль.
Выполните подключение к порталу:
Если на портал была установлена «Бесплатная» версия модуля и портал находится в РФ, то модуль будет работать только если выбран регион «Весь остальной мир» Для сотрудников следует указать телефонные номера. Именно по ним происходит сопоставление сотрудника из интерфейса MikoPBX с сотрудником из Битрикс 24.
На вкладке «Основные настройки»:
«Создавать в CRM сущности, связанные со звонком (Лид / сделка / контакт)» - если отключить эту опцию, то карточка звонка будет открываться, а Лид / Сделка созданы не будут.
«Для каких звонков создавать лид» - можно ограничить создание лида, к примеру только для входящих.
«Использовать перехват на ответственного» - при поступлении входящего звонка будет выполнен запрос в bitrix, если найден ответственный, то вызов сразу будет направлен на него.
«Длительность попытки звонка на ответственного» - как долго пытаться дозвониться до ответственного сотрудника.
На вкладке «Прочее» следует настроить:
«Очередь для обработки входящего звонка» - при запросе обратного звонка с сайта вызов сперва поступит на эту очередь. Как только сотрудник ответит, вызов будет направлен клиенту.
«Ответственный за пропущенные звонки» - если на вызов никто не ответил, то для всех созданных сущностей будет назначен указанный ответственный.
«Загружать на портал историю звонков» - если опцию отключить, то будет работать только функция click2call и обратный звонок с сайта.
«Загружать файлы записей разговоров на портал в фоновом процессе» - Раньше загрузка файлов работала одним запросом. В теле запроса отправлялись закодированные данные. Теперь, если включить опцию, сперва от портала получаем ссылку, куда следует загрузить файл. Загрузка файла производится в отдельном процессе. Этот вариант архитектурно более правильный. Из минусов - есть не решенная проблема с прослушиванием такого файла в браузере Safari, в Google Chrome работает исправно.
Модуль позволяет отключить интеграцию и настроить открытие карточки звонка для конкретных сотрудников:
Варианты открытия карточки клиента:
Не открывать.
Открывать при звонке - будет открыта сразу, при поступлении звонка от клиента.
Открывать при ответе - карточка будет открыта при ответе на вызов от клиента.
Сквозная аналитика Bitrix24 доступна только на тарифах Команда и Компания. Подробнее можно почитать в статье. Функционал Внешних линий будет доступен в версии модуля 1.51+.
Сквозная аналитика помогает определить, какие рекламные каналы приносят результат и стоят потраченных денег. Для начала на АТС необходимо описать все номера телефонов компании на вкладке «Внешние линии».
В поле «Номер телефона» - указываем номер, Как он будет отображаться в Bitrix
В поле «Псевдонимы номера (DID)» описываем значение, которое присылает провайдер при входящем звонке, псевдонимом может являться логин или номер телефона без кодов города и страны. Подсмотреть его значение можно в истории звонков:
Синхронизация внешних линий с порталом произойдет после перезапуска модуля.
В детализации входящего звонка b24 будет видно, на какой номер позвонил клиент:
На сайт Bitrix24 возможно добавить форму заказа обратного звонка.
В MikoPBX, в настройках модуля на вкладке «Прочее» заполните поле «Очередь для обработки обратного звонка»:
В Bitrix24 перейдите в раздел «Телефония» - «CRM-Форма на сайт»:
Создайте новую форму.
В поле «Номер телефона» укажите «Приложение: Интеграция с бесплатной АТС MikoPBX».
Поле «Текст, который будет произнесен ответственному перед началом звонка» можно оставить пустым, оно не используется.
Используйте кнопку «Открыть сайт» для теста формы обратного звонка.
Если при попытке подключения модуля внутри MIKOPbx АТС пишет Отключен от Bitrix24 проверьте:
Адрес портала указан без указания протокола и ресурса, например mikopbxb24.ru
Проверьте из консоли АТС ping до вашего портала(в примере ping mikopbxb24.ru). Инструкция по доступу к консоли.
В случае, если используется «коробочная» версия Bitrix24, то настройка отличается. См. документацию. В «коробочной» версии нет возможности создать «Статичное локальное приложение»
На текущий момент не во всех регионах интеграция «Bitrix 24 и MikoPBX» доступна в маркетплэйс. В этом случае есть возможность ручной настройки.
Создадим на АТС «Локальное приложение»:
Перейдите в раздел «Разработчикам», на вкладку «Готовые сценарии» -> «Другое»:
Выберите пункт «Локальное приложение»:
Скачайте файл и упакуйте его в zip в архив.
Заполните настройки локального приложения:
Выполните действие «Сохранить»
Теперь приложение будет доступно в разделе «Маркет» - «Разработчикам» - «Интеграции»
Открыв настройки локального приложения вы сможете скопировать значения «client_id» и «client_secret». Они потребуются при настройке MikoPBX
В разделе «Маркет», станет доступен пункт «MikoPBX интеграция», в этом разделе можно получить новый «Refresh token»
В настройка модуля, на стороне АТС, в поле «Регион» выберите вариант «REST API»
Станут доступны два дополнительных поля «client_id» и «client_secret»
Заполните поля согласно настройкам «Локального приложения» на вашем портале Bitrix24