Здесь показаны различия между двумя версиями данной страницы.
Предыдущая версия справа и слева Предыдущая версия Следующая версия | Предыдущая версия Последняя версия Следующая версия справа и слева | ||
modules:b24crm:bitrixapp [2021/09/30 11:37] Портнов Алексей [Региона нет в списке] |
modules:b24crm:bitrixapp [2023/06/02 06:51] Портнов Алексей [Ограничения работы по пользователям] |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
====== Bitrix24 Настройка интеграции с MIKOPBX ====== | ====== Bitrix24 Настройка интеграции с MIKOPBX ====== | ||
- | <note important>Если в вашем каталоге приложений нет интеграции с MikoPBX, то см. [[modules:b24crm:bitrixapp|статью]]</note> | + | <note important>Если в вашем каталоге приложений нет интеграции с MikoPBX, то см. [[modules:b24crm:bitrixapp#regiona_net_v_spiske|статью]]</note> |
+ | |||
+ | Виды приложения для интеграции с MikoPBX: | ||
+ | * "**бесплатное**" - можно установить без наличия подписки на маркетплейс | ||
+ | * "**подписка**" - когда есть подписка на маркетплейс | ||
+ | * [[modules:b24crm:bitrixapp#regiona_net_v_spiske|"локальное"]] - если приложения нет в маркетплейс (и такое может быть) | ||
+ | |||
+ | Функционал всех вариантов установки идентичен. | ||
[[:module-bitrix24-integration|Обратно к инструкциям...]] | [[:module-bitrix24-integration|Обратно к инструкциям...]] | ||
Строка 8: | Строка 15: | ||
- Наше приложение в **[[https://www.bitrix24.ru/apps/?app=miko.pbxaskozia | маркетплейс Bitrix 24]]**. | - Наше приложение в **[[https://www.bitrix24.ru/apps/?app=miko.pbxaskozia | маркетплейс Bitrix 24]]**. | ||
- | - Выполните установку модуля "**Интеграция с MIKOPBX**" {{ :modules:b24crm:b24_install_app.png |}} | + | - Выполните установку модуля "**Интеграция с бесплатной АТС MIKOPBX на Asterisk**" {{ :modules:b24crm:b24_install_app.png |}} |
- | - Перейдите в интерфейс модуля и выполните действие "**Получить ключ к API**" {{ :modules:b24crm:b24_get_api_key.png |}} | + | |
- **Сохраните значение ключа**, он понадобиться для настройки со стороны АТС MIKOPBX | - **Сохраните значение ключа**, он понадобиться для настройки со стороны АТС MIKOPBX | ||
- Перейдите в раздел "**Телефония**" - "**Настройки телефонии**" - "**Пользователи телефонии**" {{ :modules:b24crm:b24_tel_users-2.png |}} | - Перейдите в раздел "**Телефония**" - "**Настройки телефонии**" - "**Пользователи телефонии**" {{ :modules:b24crm:b24_tel_users-2.png |}} | ||
- Назначьте сотрудникам внутренние номера {{ :modules:b24crm:b24_inner_number.png |}}**ВАЖНО**: Назначенные внутренние номера должны существовать на АТС, см. инструкции "[[:extensions|Сотрудники на АТС]]". | - Назначьте сотрудникам внутренние номера {{ :modules:b24crm:b24_inner_number.png |}}**ВАЖНО**: Назначенные внутренние номера должны существовать на АТС, см. инструкции "[[:extensions|Сотрудники на АТС]]". | ||
- Перейдите в раздел "**Телефония**" - "**Настройки телефонии**" - "**Общие настройки**" {{ :modules:b24crm:b24_tel_gen_settings-2.png |}} | - Перейдите в раздел "**Телефония**" - "**Настройки телефонии**" - "**Общие настройки**" {{ :modules:b24crm:b24_tel_gen_settings-2.png |}} | ||
- | - В поле "**Номер для исходящего звонка по-умолчанию**" - укажите приложение "**Интеграция с MIKOPBX**" {{ :modules:b24crm:b24_def_num.png |}} (**следует выполнить после получения API ключа**) | + | - В поле "**Номер для исходящего звонка по-умолчанию**" - укажите приложение "**Интеграция с MIKOPBX**" {{ :modules:b24crm:b24_def_num.png |}} (**следует выполнить после аутентификации модуля со стороны MikoPBX**) |
===== Настройка MIKOPBX ===== | ===== Настройка MIKOPBX ===== | ||
- | <note important>На текущий момент модуль является платным. Оформить заказ можно через [[https://telefon.miko.ru/contacts/ | форму обратной связи]].</note> | + | <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|Инструкции по установке]], | - Установите модуль "**Интеграция с CRM Bitrix24**". [[:pbx-extension-modules|Инструкции по установке]], | ||
- Перейдите в интерфейс модуля | - Перейдите в интерфейс модуля | ||
- | - Заполните поля "**Адрес портала Bitrix24**", "**Refresh token**" | + | - Заполните "**Адрес портала Bitrix24**", без указания протокола **https**, пример miko.bitrix24.ru |
- Сохраните настройки | - Сохраните настройки | ||
- Включите модуль | - Включите модуль | ||
+ | - Выполните подключение к порталу: {{ :modules:b24crm:b24-connect-1.png |}} | ||
+ | <note warning>Если на портал была установлена "**Бесплатная**" версия модуля и портал находится в РФ, то модуль будет работать только если выбран регион "**Весь остальной мир**"</note> | ||
<note warning>**Адрес портала Bitrix24** указывается без https/http.</note> | <note warning>**Адрес портала Bitrix24** указывается без https/http.</note> | ||
- | <note important>"**Refresh token**" следует получить из интерфейса б24. Для этого, в приложении "**Интеграция с MIKOPBX**" выполните действие "**Получить ключ API**" {{ :modules:b24crm:b24_get_api_key.png |}}</note> | + | <note warning> **Для сотрудников следует указать телефонные номера.** Именно по ним происходит сопоставление сотрудника из интерфейса MikoPBX с сотрудником из Битрикс 24. |
- | + | ||
- | <note warning>**Для сотрудников следует указать телефонные номера.** Именно по ним происходит сопоставление сотрудника из интерфейса MikoPBX с сотрудником из Битрикс 24. | + | |
* [[:extensions|Инструкции по настройке на MikoPBX.]] | * [[:extensions|Инструкции по настройке на MikoPBX.]] | ||
* [[:modules: b24crm:bitrixapp|Инструкции по настройке Битрикс 24]] | * [[:modules: b24crm:bitrixapp|Инструкции по настройке Битрикс 24]] | ||
</note> | </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:b24_filter_users.jpg |}} | + | {{ :modules:b24crm:bitrix24-users-settings.png |}} |
+ | |||
+ | Варианты открытия карточки клиента: | ||
+ | - **Не открывать** | ||
+ | - **Открывать при звонке** - будет открыта сразу, при поступлении звонка от клиента | ||
+ | - **Открывать при ответе** - карточка будет открыта при ответе на вызов от клиента | ||
==== Внешние линии и сквозная аналитика B24 ==== | ==== Внешние линии и сквозная аналитика B24 ==== | ||
- | <note important>Сквозная аналитика Bitrix24 доступна только на тарифах **Команда** и **Компания**. Подробнее можно почитать в [[https://helpdesk.bitrix24.ru/open/8726963/ | статье]]. Функционал Внешних линий будет доступен в версии модуля после 1.51. </note> | + | <note important>Сквозная аналитика Bitrix24 доступна только на тарифах **Команда** и **Компания**. Подробнее можно почитать в [[https://helpdesk.bitrix24.ru/open/8726963/ | статье]]. Функционал Внешних линий будет доступен в версии модуля 1.51+. </note> |
Сквозная аналитика помогает определить, какие рекламные каналы приносят результат и стоят потраченных денег. Для начала на АТС необходимо описать все номера телефонов компании на вкладке "**Внешние линии**". | Сквозная аналитика помогает определить, какие рекламные каналы приносят результат и стоят потраченных денег. Для начала на АТС необходимо описать все номера телефонов компании на вкладке "**Внешние линии**". | ||
{{ :modules:b24crm:b24_mikopbx_external_lines.png |}} | {{ :modules:b24crm:b24_mikopbx_external_lines.png |}} | ||
Строка 49: | Строка 88: | ||
- Синхронизация внешних линий с порталом произойдет после перезапуска модуля. | - Синхронизация внешних линий с порталом произойдет после перезапуска модуля. | ||
- В детализации входящего звонка b24 будет видно, на какой номер позвонил клиент {{ :modules:b24crm:b24_mikopbx_external_lines_cdr_b24.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 |}} | ||
+ | - Используйте кнопку "**Открыть сайт**" для теста формы обратного звонка | ||
===== Возможные решения проблем ===== | ===== Возможные решения проблем ===== | ||
Строка 56: | Строка 105: | ||
- Проверьте из консоли АТС пинг до вашего портала(в примере ping mikopbxb24.ru). [[faq:putty|Инструкция]] по доступу к консоли. | - Проверьте из консоли АТС пинг до вашего портала(в примере 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" доступна в маркетплэйс. В этом случае есть возможность ручной настройки. | + | На текущий момент не во всех регионах интеграция "**Bitrix 24 и MikoPBX**" доступна в маркетплэйс. В этом случае есть возможность ручной настройки. |
- | Создадим на АТС "Локальное приложение": | + | Создадим на АТС "**Локальное приложение**": |
- Перейдите в раздел "**Разработчикам**", на вкладку "**Готовые сценарии**" "**Другое**" {{ :modules:b24crm:b24-region-2.png |}} | - Перейдите в раздел "**Разработчикам**", на вкладку "**Готовые сценарии**" "**Другое**" {{ :modules:b24crm:b24-region-2.png |}} | ||
- Выберите пункт "**Локальное приложение**" {{ :modules:b24crm:b24-region-3.png |}} | - Выберите пункт "**Локальное приложение**" {{ :modules:b24crm:b24-region-3.png |}} | ||
- Скачайте [[https://github.com/mikopbx/ModuleBitrix24Integration/blob/aa5eca3b59c5f25d3c8e6a12df00674a03aa0638/BitrixVendorDistr/index.html#L31-L31 | файл]] и упакуйте его в zip в архив | - Скачайте [[https://github.com/mikopbx/ModuleBitrix24Integration/blob/aa5eca3b59c5f25d3c8e6a12df00674a03aa0638/BitrixVendorDistr/index.html#L31-L31 | файл]] и упакуйте его в zip в архив | ||
- | - Заполнните настройки локального приложения: {{ :modules:b24crm:b24-region-4.png |}} | + | - Заполните настройки локального приложения: {{ :modules:b24crm:b24-region-4.png |}} |
- Выполните действие "**Сохранить**" | - Выполните действие "**Сохранить**" | ||
- Теперь приложение будет доступно в разделе "**Маркет**" - "**Разработчикам**" - "**Интеграции**" {{ :modules:b24crm:b24-region-5.png |}} | - Теперь приложение будет доступно в разделе "**Маркет**" - "**Разработчикам**" - "**Интеграции**" {{ :modules:b24crm:b24-region-5.png |}} | ||
- Открыв настройки локального приложения вы сможете скопировать значения "**client_id**" и "**client_secret**". Они потребуются при настройке **MikoPBX** {{ :modules:b24crm:b24-region-8.png |}} | - Открыв настройки локального приложения вы сможете скопировать значения "**client_id**" и "**client_secret**". Они потребуются при настройке **MikoPBX** {{ :modules:b24crm:b24-region-8.png |}} | ||
- | - В разделе "**Маркет**", стенет доступен пункт "**MikoPBX интеграция**" {{ :modules:b24crm:b24-region-6.png |}} | + | - В разделе "**Маркет**", стенет доступен пункт "**MikoPBX интеграция**" {{ :modules:b24crm:b24-region-6.png |}} в этом разделе можно получить новый "**Refresh token**" |
- В настройка модуля, на стороне АТС, в поле "**Регион**" выберите вариант "**REST API**" | - В настройка модуля, на стороне АТС, в поле "**Регион**" выберите вариант "**REST API**" | ||
- Станут доступны два дополнительных поля "**client_id**" и "**client_secret**" | - Станут доступны два дополнительных поля "**client_id**" и "**client_secret**" |