Инструменты пользователя

Инструменты сайта


modules:b24crm:bitrixapp

Bitrix24 Настройка интеграции с MIKOPBX

Если в вашем каталоге приложений нет интеграции с MikoPBX, то см. статью

Виды приложения для интеграции с MikoPBX:

  • «бесплатное» - можно установить без наличия подписки на маркетплейс
  • «подписка» - когда есть подписка на маркетплейс
  • "локальное" - если приложения нет в маркетплейс (и такое может быть)

Функционал всех вариантов установки идентичен.

Обратно к инструкциям...

Настройка Bitrix24

  1. Наше приложение в маркетплейс Bitrix 24.
  2. Выполните установку модуля «Интеграция с бесплатной АТС MIKOPBX на Asterisk»
  3. Перейдите в раздел «Телефония» - «Настройки телефонии» - «Пользователи телефонии»
  4. Назначьте сотрудникам внутренние номера ВАЖНО: Назначенные внутренние номера должны существовать на АТС, см. инструкции «Сотрудники на АТС».
  5. Перейдите в раздел «Телефония» - «Настройки телефонии» - «Общие настройки»
  6. В поле «Номер для исходящего звонка по-умолчанию» - укажите приложение «Интеграция с MIKOPBX» (следует выполнить после аутентификации модуля со стороны MikoPBX)

Настройка MIKOPBX

Оформить заказ модуля можно через форму обратной связи.

С АТС MikoPBX обязательно должны быть доступны:

  • Ваш портал bitrix 24 по порту 443
  • Сайт oauth.bitrix.info по порту 443

Пример проверки подключения из консоли:

openssl s_client -connect  oauth.bitrix.info:443

Настройка модуля

  1. Перейдите в меню «Модули» → «Управление модулями»
  2. Установите модуль «Интеграция с CRM Bitrix24». Инструкции по установке,
  3. Перейдите в интерфейс модуля
  4. Заполните «Адрес портала Bitrix24», без указания протокола https, пример miko.bitrix24.ru
  5. Сохраните настройки
  6. Включите модуль
  7. Выполните подключение к порталу:
Если на портал была установлена «Бесплатная» версия модуля и портал находится в РФ, то модуль будет работать только если выбран регион «Весь остальной мир»
Адрес портала Bitrix24 указывается без https/http.
Для сотрудников следует указать телефонные номера. Именно по ним происходит сопоставление сотрудника из интерфейса MikoPBX с сотрудником из Битрикс 24.

Общие настройки

На вкладке «Основные настройки»:

  • «Создавать в CRM сущности, связанные со звонком (Лид / сделка / контакт)» - если отключить эту опцию, то карточка звонка будет открываться, а Лид / Сделка созданы не будут
  • «Для каких звонков создавать лид» - можно ограничить создание лида, к примеру только для входящих
  • «Использовать перехват на ответственного» - при поступлении входящего звонка будет выполнен запрос в bitrix, если найден ответственный, то вызов сразу будет направлен на него
  • «Длительность попытки звонка на ответственного» - как долго пытаться дозвониться до ответственного сотрудника

На вкладке «Прочее» следует настроить:

  • «Очередь для обработки входящего звонка» - при запросе обратного звонка с сайта вызов сперва поступит на эту очередь. Как только сотрудник ответит, вызов будет направлен клиенту.
  • «Ответственный за пропущенные звонки» - если на вызов никто не ответил, то для всех созданных сущностей будет назначен указанный ответственный

 Прочие настройки интеграции с bitrix 24

  • «Загружать на портал историю звонков» - если опцию отключить, то будет работать только функция click2call и обратный звонок с сайта
  • «Загружать файлы записей разговоров на портал в фоновом процессе» - Раньше загрузка файлов работала одним запросом. В теле запроса отправлялись закодированные данные. Теперь, если включить опцию, сперва от портала получаем ссылку, куда следует загрузить файл. Загрузка файла производится в отдельном процессе. Этот вариант архитектурно более правильный. Из минусов - есть не решенная проблема с прослушиванием такого файла в браузере Safari, в Google Chrome работает исправно

Ограничения работы по пользователям

Модуль позволяет отключить интеграцию и настроить открытие карточки звонка для конкретных сотрудников:

Варианты открытия карточки клиента:

  1. Не открывать
  2. Открывать при звонке - будет открыта сразу, при поступлении звонка от клиента
  3. Открывать при ответе - карточка будет открыта при ответе на вызов от клиента

Внешние линии и сквозная аналитика B24

Сквозная аналитика Bitrix24 доступна только на тарифах Команда и Компания. Подробнее можно почитать в статье. Функционал Внешних линий будет доступен в версии модуля 1.51+.

Сквозная аналитика помогает определить, какие рекламные каналы приносят результат и стоят потраченных денег. Для начала на АТС необходимо описать все номера телефонов компании на вкладке «Внешние линии».

  1. В поле «Номер телефона» - указываем номер, Как он будет отображаться в Bitrix
  2. В поле «Псевдонимы номера (DID)» описываем значение, которое присылает провайдер при входящем звонке, псевдонимом может являться логин или номер телефона без кодов города и страны. Подсмотреть его значение можно в истории звонков:
  3. Синхронизация внешних линий с порталом произойдет после перезапуска модуля.
  4. В детализации входящего звонка b24 будет видно, на какой номер позвонил клиент

Обратный звонок с сайта

На сайт Bitrix24 возможно добавить форму заказа обратного звонка.

  1. В MikoPBX, в настройках модуля на вкладке «Прочее» заполните поле «Очередь для обработки обратного звонка»
  2. В Bitrix24 перейдите в раздел «Телефония» - «CRM-Форма на сайт»
  3. Создайте новую форму
  4. В поле «Номер телефона» укажите «Приложение: Интеграция с бесплатной АТС MikoPBX»
  5. Поле «Текст, который будет произнесен ответственному перед началом звонка» можно оставить пустым, оно не используется
  6. Используйте кнопку «Открыть сайт» для теста формы обратного звонка

Возможные решения проблем

Если при попытке подключения модуля внутри MIKOPbx АТС пишет Отключен от Bitrix24 проверьте:

  1. Адрес портала указан без указания протокола и ресурса, например mikopbxb24.ru
  2. Проверьте из консоли АТС пинг до вашего портала(в примере ping mikopbxb24.ru). Инструкция по доступу к консоли.

Приложения нет в Маркетплэйс

ВНИМАНИЕ, если используется «коробочная» версия Bitrix24, то настройка отличается. См. документацию. В «коробочной» версии нет возможности создать «Статичное локальное приложение»

На текущий момент не во всех регионах интеграция «Bitrix 24 и MikoPBX» доступна в маркетплэйс. В этом случае есть возможность ручной настройки.

Создадим на АТС «Локальное приложение»:

  1. Перейдите в раздел «Разработчикам», на вкладку «Готовые сценарии» «Другое»
  2. Выберите пункт «Локальное приложение»
  3. Скачайте файл и упакуйте его в zip в архив
  4. Заполните настройки локального приложения:
  5. Выполните действие «Сохранить»
  6. Теперь приложение будет доступно в разделе «Маркет» - «Разработчикам» - «Интеграции»
  7. Открыв настройки локального приложения вы сможете скопировать значения «client_id» и «client_secret». Они потребуются при настройке MikoPBX
  8. В разделе «Маркет», стенет доступен пункт «MikoPBX интеграция» в этом разделе можно получить новый «Refresh token»
  9. В настройка модуля, на стороне АТС, в поле «Регион» выберите вариант «REST API»
  10. Станут доступны два дополнительных поля «client_id» и «client_secret»
  11. Заполните поля согласно настройкам «Локального приложения» на вашем портале b24

Обратно к инструкциям...

modules/b24crm/bitrixapp.txt · Последние изменения: 2023/06/26 08:59 — Портнов Алексей