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

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


modules:b24crm:bitrixapp

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Предыдущая версия справа и слева Предыдущая версия
Следующая версия
Предыдущая версия
modules:b24crm:bitrixapp [2021/09/30 11:38]
Портнов Алексей
modules:b24crm:bitrixapp [2023/06/26 08:59] (текущий)
Портнов Алексей
Строка 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+
   - Перейдите в раздел "​**Телефония**" ​ - "​**Настройки телефонии**"​ - "​**Пользователи телефонии**"​ {{ :​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: Строка 87:
   - Синхронизация внешних линий с порталом произойдет после перезапуска модуля. ​   - Синхронизация внешних линий с порталом произойдет после перезапуска модуля. ​
   - В детализации входящего звонка 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: Строка 104:
   - Проверьте из консоли АТС пинг до вашего портала(в примере 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 |}}
modules/b24crm/bitrixapp.1633001905.txt.gz · Последние изменения: 2021/09/30 11:38 — Портнов Алексей