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

<note important>Если в вашем каталоге приложений нет интеграции с MikoPBX, то см. [[modules:b24crm:bitrixapp#regiona_net_v_spiske|статью]]</note>

Виды приложения для интеграции с MikoPBX:
  * "**бесплатное**" - можно установить без наличия подписки на маркетплейс
  * "**подписка**" - когда есть подписка на маркетплейс
  * [[modules:b24crm:bitrixapp#regiona_net_v_spiske|"локальное"]] - если приложения нет в маркетплейс (и такое может быть)

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

[[:module-bitrix24-integration|Обратно к инструкциям...]]

===== Настройка Bitrix24 =====

  - Наше приложение в **[[https://www.bitrix24.ru/apps/?app=miko.pbxaskozia | маркетплейс Bitrix 24]]**.
  - Выполните установку модуля "**Интеграция с бесплатной АТС MIKOPBX на Asterisk**" {{ :modules:b24crm:b24_install_app.png |}}
  - Перейдите в раздел "**Телефония**"  - "**Настройки телефонии**" - "**Пользователи телефонии**" {{ :modules:b24crm:b24_tel_users-2.png |}}
  - Назначьте сотрудникам внутренние номера {{ :modules:b24crm:b24_inner_number.png |}}**ВАЖНО**: Назначенные внутренние номера должны существовать на АТС, см. инструкции "[[:extensions|Сотрудники на АТС]]".
  - Перейдите в раздел "**Телефония**"  - "**Настройки телефонии**" - "**Общие настройки**" {{ :modules:b24crm:b24_tel_gen_settings-2.png |}}
  - В поле "**Номер для исходящего звонка по-умолчанию**" - укажите приложение "**Интеграция с MIKOPBX**" {{ :modules:b24crm:b24_def_num.png |}} (**следует выполнить после аутентификации модуля со стороны MikoPBX**)


===== Настройка MIKOPBX =====

<note important>Оформить заказ модуля можно через [[https://telefon.miko.ru/contacts/ | форму обратной связи]].</note>


С АТС MikoPBX обязательно должны быть доступны:
  * Ваш портал bitrix 24 по порту 443
  * Сайт **oauth.bitrix.info** по порту **443**

Пример проверки подключения из консоли: 
<code>
openssl s_client -connect  oauth.bitrix.info:443
</code>
==== Настройка модуля ====


  - Перейдите в меню "**Модули**" -> "**Управление модулями**"
  - Установите модуль "**Интеграция с CRM Bitrix24**". [[:pbx-extension-modules|Инструкции по установке]],
  - Перейдите в интерфейс модуля
  - Заполните "**Адрес портала Bitrix24**", без указания протокола **https**, пример miko.bitrix24.ru
  - Сохраните настройки
  - Включите модуль
  - Выполните подключение к порталу: {{ :modules:b24crm:b24-connect-1.png |}} 

<note warning>Если на портал была установлена "**Бесплатная**" версия модуля и портал находится в РФ, то модуль будет работать только если выбран регион "**Весь остальной мир**"</note>
<note warning>**Адрес портала Bitrix24** указывается без https/http.</note>
<note warning> **Для сотрудников следует указать телефонные номера.** Именно по ним происходит сопоставление сотрудника из интерфейса MikoPBX с сотрудником из Битрикс 24. 
  * [[:extensions|Инструкции по настройке на MikoPBX.]]
  * [[:modules: b24crm:bitrixapp|Инструкции по настройке Битрикс 24]]
</note>



==== Общие настройки ====
На вкладке "**Основные настройки**":
  * "**Создавать в CRM сущности, связанные со звонком (Лид / сделка / контакт)**" - если отключить эту опцию, то карточка звонка будет открываться, а Лид / Сделка созданы не будут
  * "**Для каких звонков создавать лид**" - можно ограничить создание лида, к примеру только для входящих
  * "**Использовать перехват на ответственного**" - при поступлении входящего звонка будет выполнен запрос в bitrix, если найден ответственный, то вызов сразу будет направлен на него
  * "**Длительность попытки звонка на ответственного**" - как долго пытаться дозвониться до ответственного сотрудника 
{{ :modules:b24crm:b24-connect-general-settings-2.png |}}
На вкладке "**Прочее**" следует настроить:
  * "**Очередь для обработки входящего звонка**" - при запросе обратного звонка с сайта вызов сперва поступит на эту очередь. Как только сотрудник ответит, вызов будет направлен клиенту.  
  * "**Ответственный за пропущенные звонки**" - если на вызов никто не ответил, то для всех созданных сущностей будет назначен указанный ответственный
{{ :modules:b24crm:b24-connect-other-settings-2.png | Прочие настройки интеграции с bitrix 24}}
  * "**Загружать на портал историю звонков**" - если опцию отключить, то будет работать только функция click2call и обратный звонок с сайта
  * "**Загружать файлы записей разговоров на портал в фоновом процессе**" - Раньше загрузка файлов работала одним запросом. В теле запроса отправлялись закодированные данные. Теперь, если включить опцию, сперва от портала получаем ссылку, куда следует загрузить файл. Загрузка файла производится в отдельном процессе. Этот вариант архитектурно более правильный. Из минусов - есть не решенная проблема с прослушиванием такого файла в браузере Safari, в Google Chrome работает исправно 


==== Ограничения работы по пользователям ====
Модуль позволяет отключить интеграцию и настроить открытие карточки звонка для конкретных сотрудников:
{{ :modules:b24crm:bitrix24-users-settings.png |}}

Варианты открытия карточки клиента:
  - **Не открывать**
  - **Открывать при звонке** - будет открыта сразу, при поступлении звонка от клиента
  - **Открывать при ответе** - карточка будет открыта при ответе на вызов от клиента

==== Внешние линии и сквозная аналитика B24 ====
<note important>Сквозная аналитика Bitrix24 доступна только на тарифах **Команда** и **Компания**. Подробнее можно почитать в [[https://helpdesk.bitrix24.ru/open/8726963/ | статье]]. Функционал Внешних линий будет доступен в версии модуля 1.51+. </note>
Сквозная аналитика помогает определить, какие рекламные каналы приносят результат и стоят потраченных денег. Для начала на АТС необходимо описать все номера телефонов компании на вкладке "**Внешние линии**". 
{{ :modules:b24crm:b24_mikopbx_external_lines.png |}}
  - В поле "**Номер телефона**" - указываем номер, Как он будет отображаться в Bitrix
  - В поле "**Псевдонимы номера (DID)**" описываем значение, которое присылает провайдер при входящем звонке, псевдонимом может являться логин или номер телефона без кодов города и страны. Подсмотреть его значение можно в истории звонков: {{ :modules:b24crm:b24_mikopbx_external_lines_cdr.png |}} 
  - Синхронизация внешних линий с порталом произойдет после перезапуска модуля. 
  - В детализации входящего звонка b24 будет видно, на какой номер позвонил клиент {{ :modules:b24crm:b24_mikopbx_external_lines_cdr_b24.png |}}

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

На сайт Bitrix24 возможно добавить форму заказа обратного звонка. 
  - В MikoPBX, в настройках модуля на вкладке "**Прочее**" заполните поле "**Очередь для обработки обратного звонка**" {{ :modules:b24crm:b24-callback-settings-3.png |}}
  - В Bitrix24 перейдите в раздел "**Телефония**" - "**CRM-Форма на сайт**" {{ :modules:b24crm:b24-callback-settings-1.png |}}
  - Создайте новую форму
  - В поле "**Номер телефона**" укажите "**Приложение: Интеграция с бесплатной АТС MikoPBX**"
  - Поле "**Текст, который будет произнесен ответственному перед началом звонка**" можно оставить пустым, оно не используется {{ :modules:b24crm:b24-callback-settings-2.png |}}
  - Используйте кнопку "**Открыть сайт**" для теста формы обратного звонка

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

Если при попытке подключения модуля внутри MIKOPbx АТС пишет **Отключен от Bitrix24** проверьте:
  - Адрес портала указан без указания протокола и ресурса, например mikopbxb24.ru
  - Проверьте из консоли АТС пинг до вашего портала(в примере ping mikopbxb24.ru). [[faq:putty|Инструкция]] по доступу к консоли.

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

<note important>**ВНИМАНИЕ**, если используется "**коробочная**" версия Bitrix24, то настройка отличается. См. [[https://dev.1c-bitrix.ru/learning/course/index.php?COURSE_ID=99&LESSON_ID=9289&LESSON_PATH=8771.8583.8593.9289 | документацию]]. В "коробочной" версии нет возможности создать "**Статичное локальное приложение**"</note>

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

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

  - Перейдите в раздел "**Разработчикам**", на вкладку "**Готовые сценарии**" "**Другое**" {{ :modules:b24crm:b24-region-2.png |}}
  - Выберите пункт "**Локальное приложение**" {{ :modules:b24crm:b24-region-3.png |}}
  - Скачайте [[https://github.com/mikopbx/ModuleBitrix24Integration/blob/aa5eca3b59c5f25d3c8e6a12df00674a03aa0638/BitrixVendorDistr/index.html#L31-L31 | файл]] и упакуйте его в zip в архив
  - Заполните настройки локального приложения: {{ :modules:b24crm:b24-region-4.png |}}
  - Выполните действие "**Сохранить**"
  - Теперь приложение будет доступно в разделе "**Маркет**" - "**Разработчикам**" - "**Интеграции**" {{ :modules:b24crm:b24-region-5.png |}}
  - Открыв настройки локального приложения вы сможете скопировать значения "**client_id**" и "**client_secret**". Они потребуются при настройке **MikoPBX** {{ :modules:b24crm:b24-region-8.png |}}
  - В разделе "**Маркет**", стенет доступен пункт "**MikoPBX интеграция**" {{ :modules:b24crm:b24-region-6.png |}} в этом разделе можно получить новый "**Refresh token**"
  - В настройка модуля, на стороне АТС, в поле "**Регион**" выберите вариант "**REST API**"
  - Станут доступны два дополнительных поля "**client_id**" и "**client_secret**"
  - Заполните поля согласно настройкам "**Локального приложения**" на вашем портале **b24** {{ :modules:b24crm:b24-region-1.png |}}


[[:module-bitrix24-integration|Обратно к инструкциям...]]